90 docs tagged with "System Administrator"

Supplemental procedures for post-installation tasks such as migrating the Unix Agent to a different SAM socket number.

Step-by-step instructions for modifying the Unix Agent configuration file using the LSAM configuration program.

Reference for Unix Agent configuration parameters covering job handling, user impersonation, health monitoring, and privilege settings.

Overview of Agent Configuration Parameters — a reference guide to all Unix Agent lsam.conf parameter groups and their settings.

Reference for Unix Agent environment variables passed to jobs at runtime, including path, job identity, schedule, and file I/O variables.

Instructions for configuring the Unix Agent to start and stop automatically during system boot and shutdown using symbolic links to init.d and rc directories.

Reference for Unix Agent-specific exit codes returned when jobs complete, including agent error codes, signal values, and File Arrival job exit codes.

Describes the continuous daemon processes that make up the Unix Agent, including their roles in job submission, communication, logging, file monitoring, and job output retrieval.

Reference for the required SMA_RM CONFIG section, which sets global parameters such as scan interval, CPU alarm thresholds, user-defined monitor timeouts, and log event behavior.

The SMA_RM configuration file defines the structure and rules for disk, process, and user-defined monitoring sections, including window, log, and comment syntax.

Overview of Configuration — all steps required to configure the Unix Agent after installation, including control scripts, security, startup, and job execution settings.

Instructions for setting the TZ environment variable in the root profile or agent startup script to ensure the Unix Agent uses the correct time zone.

Overview of the SMA FAD Control File, an XML-formatted ASCII configuration file that defines the directories to monitor and the OpCon events to forward to the SAM.

Reference for all supported SMA FAD Control File XML elements, their nesting structure, required versus optional status, valid values, and a complete annotated example.

Steps to deactivate the optional sma_cronmon and sma_filein components of the Unix Agent by commenting out lines in the start and stop scripts.

Reference for the SMA FAD directory layout, including the control, snapshot, and pid subdirectories and their roles in file monitoring and event processing.

Reference for the SMA_RM DISK section, which specifies disk monitoring parameters including name, mount point, usage thresholds, alarm levels, and event variables.

Reference for Unix Agent dispatcher configuration parameters, including the message timeout setting that controls TCP/IP socket behavior when SMANetCom communication is delayed.

Reference for SMA_RM exception-handling specifications, covering event, action, and sleep tags, as well as multi-level alarm processing for disk, process, and user-defined monitors.

Reference for the exit_codes utility, which executes a job and displays its return values, exit code, exit signal, and core image status for debugging purposes.

Reference for the Unix Agent FAD parameter that controls whether the File Activity Detection monitor detects files created while the agent was down.

Reference of all file monitoring capabilities supported by the SMA File Activity Detection Daemon, including file creation, deletion, size change, modification detection, and configurable event timing.

Step-by-step procedures for placing the Unix Agent installation tar file onto the target UNIX machine via DVD copy or FTP transfer.

Overview of the File Activity Detection (FAD) Daemon.

Overview of the SMA File Activity Detection Daemon (FAD), which monitors directories for file changes and forwards OpCon events to the SAM.

SMAFT supports optional file compression using the UNIX tar and gzip utilities, configurable as PREFERRED or REQUIRED for each agent installation.

SMAFT supports optional file encryption using DES, 3DES, and AES-128 algorithms in ECB and CBC modes, configurable per agent installation as PREFERRED or REQUIRED.

Reference for the file_check utility, which validates that specified files meet existence, access, size, and age criteria before an OpCon job executes.

Guidelines and examples for formatting SMA FAD Control Files, including whitespace handling, comment syntax, and recommended layout for readability.

Reference for the genericpgm utility, a dummy test program that sleeps for a configurable duration and exits with a specified exit code and signal disposition.

Reference for the get_errno utility, which translates a numeric UNIX error code into its symbolic constant and descriptive text for use in job debugging.

Reference for Unix Agent hidden configuration parameters, including lsam_root_directory, check_CRC, and close_SAM_socket, which are only editable directly in the lsam.conf file.

Step-by-step procedure for starting the Unix Agent after a new or upgrade installation and verifying that all required processes are running.

Reference for the install_lsam script, which creates an operational Unix Agent instance with default configuration, a tracking directory, and a properly permissioned control script.

Reference for the install_lsam_service script, which creates symbolic links in the system startup directory so the Unix Agent starts automatically on reboot.

Overview of Installation — everything you need to install and start the Unix Agent on a supported UNIX platform.

Hardware, software, disk space, memory, and privilege requirements for installing the Unix Agent on a supported UNIX platform.

Reference for OpCon field codes and descriptions returned per job when Unix Agent resource-usage reporting is enabled via the LSAM_job_statistics configuration parameter.

Reference for status messages and job information displayed in Enterprise Manager Operation while Unix Agent jobs are actively running.

Reference for Unix Agent JORS and SMAFT parameters, including settings that control STDOUT and STDERR redirection and Job Output Retrieval System and SMA File Transfer behavior.

Reference for JORS and FTServer error messages recorded in the UNIXLSAM log file, including socket initialization and process spawning failures.

Reference for known defects and limitations in Unix Agent versions, including affected platforms, symptoms, and available workarounds.

Step-by-step procedures for performing a new or upgrade Unix Agent installation using the legacy manual method.

Instructions for using SMA Technologies-provided setup scripts and the userinfo program to load a user's operating environment before the Unix Agent executes a job.

Reference for Unix Agent logging configuration parameters, including log file rollover size and maximum archived log file count settings.

Reference for the lsam_killjob command, which forcibly terminates a running OpCon job on the Unix Agent by sending a SIGKILL signal to the identified process.

Overview of Machine Messages.

Reference for the maintain_ofiles utility, which deletes job output files, tracking files, and temporary agent files older than a specified number of days.

Start, stop, and verify the status of the Unix Agent using agent commands from the command line.

Overview of Unix Agent operations.

Step-by-step instructions for installing, upgrading, or adding Unix Agent instances using the install_agent script.

Reference for the SMA_RM PROCESS section, which configures process monitoring conditions — including IGNORE, MUST_RUN, MUST_NOT_RUN, and CPU_CHECK — along with alarm levels and event variables.

Reference for redirecting STDOUT output from Unix Agent jobs, including use of the captureSTDOUT script and behavior differences based on the path_to_su parameter.

Overview of Reference.

Steps to completely remove the Unix Agent from a system, including stopping the agent, deleting its directory, and disabling automatic startup.

Instructions for simultaneously running multiple Unix Agent instances on a single system, covering environment variable configuration and OpCon machine registration for each instance.

Reference for the Unix Agent SFTP parameter that configures the port used for SFTP-based file transfer, including fallback behavior to SMAFT.

SMAFT reliably transfers files across multiple platforms as part of an OpCon job, with support for compression, encryption, SFTP fallback, and transfers larger than 2 GB.

SMA_RM monitors system resources — including disk space, processes, and user-defined metrics — and triggers OpCon events or local actions when alarm conditions are detected.

Reference for the Unix Agent sma_filein parameter that defines the sleep interval between checks of the MSGIN directory.

Reference for the sma_job_step utility, which logs named job steps to the SAM to enable job restart at a specific step from the OpCon Enterprise Manager.

Reference for the sma_LSAM_feedback utility, which sends a message from the Unix Agent to the Detailed Job Messages field in the OpCon Enterprise Manager.

Reference for the sma_ppscript utility, which registers a post-processing analysis script to determine job success or failure after the job's executable finishes.

Reference for the sma_status utility, which sends a short status message from a running job to the OpCon Enterprise Manager to display alongside the job's status.

Reference for STDERR pre-processing error messages written when file transfer job requirements cannot be met before the transfer begins.

Reference for STDERR processing error messages output by FTServer and FTAgent during active file transfer operations, including network, file, and communication errors.

Reference for STDOUT messages output by the Unix Agent FTAgent component during file transfer operations, including backup, transfer result, and completion messages.

SMAFT includes a UNIX-specific feature that preserves the record structure of files transferred from non-UNIX platforms, enabling round-trip transfers with record structure intact.

A reference table of UNIX operating systems and processor architectures supported by the Unix Agent.

Reference for directories and files created in the Unix Agent root directory upon initial agent startup.

Overview of System Modification and Environment Variables.

Reference for Unix Agent TCP/IP configuration parameters, including allowed SMANetCom IP addresses, NIC binding, and TLS certificate settings.

Reference for the XML terminology and nesting structure used in SMA FAD Control Files, including definitions of elements, tags, and parent-child relationships.

Reference for Unix Agent trace option parameters that enable or disable diagnostic tracing for the dispatcher, agent, and other internal processes.

Reference for the uninstall_lsam script, which removes a Unix Agent instance by deleting its output, tracking, and log directories along with its startup and SMAFT scripts.

Documentation for the Unix Agent, an OpCon agent that schedules and runs jobs in UNIX environments.

Complete reference of all Unix Agent control script parameters, including start, stop, status, certificate management, and troubleshooting commands.

Overview of the configuration steps required to set up the Unix Agent, including the control script, configuration file, and root profile.

Reference catalog of Unix Agent log and error messages, including message IDs, system error codes, and recommended corrective actions.

Version history and change details for the Unix Agent, including new features, improvements, and bug fixes.

Reference for UNIX SMAFT exit codes returned by the Unix Agent and Server during SMA file transfer operations.

Reference for the script formatting rules that OpCon jobs executed by the Unix Agent must follow, including shell invocation, child process handling, and exit codes.

Reference for configuring black list and white list security settings in the Unix Agent to control which users are permitted to run jobs.

Procedures for enabling and configuring TLS-secured communication between the Unix Agent and OpCon/SAM, including certificate creation and lsam.conf file changes.

Reference for common UNIX system error symbols returned by the Unix Agent, including probable causes and corrective actions for each error condition.

Reference and procedures for reviewing and editing the Unix Agent control script variables, including LSAM_ROOT, SAM_SOCKET, and PATH, after running the install_lsam installation script.

Reference and procedures for reviewing and editing the SMAFT control script variables to ensure they match the Unix Agent control script settings.

Reference for the SMA_RM USER_DEFINED section, which allows custom scripts or programs to report normal/alarm status and return loggable values during each scan cycle.

Overview of the Unix Agent utility programs available in the agent bin directory, covering installation, job management, file checking, and status reporting tools.

Reference for the SMA FAD event string variables and condition variables, including token substitutions for file path, name, and extension, as well as supported file condition types.