Administering and Configuring the UNIX/Linux Agent

• The UNIX/Linux agent installs to the directory: /opt/microsoft/scx/

• The UNIX/Linux agent maintains log files in the directory: /var/opt/microsoft/scx/log/

• Agent configuration files, including certificates, are stored in the directory: /etc/opt/microsoft/scx/

In this section, tools to administer and configure the UNIX/Linux agent are described.

The scxadmin tool is used to control the state of the UNIX/Linux agent (start, stop, or restart) as well as control logging performed by the agent. The usage of the tool can be displayed with the following command: scxadmin -?

        # /opt/microsoft/scx/bin/tools/scxadmin -?

Usage: scxadmin
Generic options (for all commands)
  [-quiet]      Set quiet mode (no output)

        General Options
scxadmin -version

        Service Management
scxadmin {-start|-stop|-restart|-status}  [all|cimom|provider]

        Providers Management
scxadmin -config-list {RunAs}
scxadmin -config-set {RunAs} {CWD=<directory>|ChRootPath=<directory>|AllowRoot={true|false}}
scxadmin -config-reset {RunAs} [CWD|ChRootPath|AllowRoot]

        Log Configuration Management
scxadmin {-log-list|-log-rotate|-log-reset} [all|cimom|provider]
scxadmin -log-set [all|cimom|provider] {verbose|intermediate|errors}
scxadmin -log-set provider {{FILE:<path>|STDOUT}:<module-id>={SUPPRESS|ERROR|WARNING|INFO|TRACE|HYSTERICAL}}
scxadmin {-log-reset|-log-remove} provider [{FILE:<path>|STDOUT}]

The scxsslconfig tool is used to generate the certificate in /etc/opt/Microsoft/scx/ssl/. This tool is useful in correcting issues in which the fully-qualified domain name cannot be determined from the UNIX or Linux host itself, or the FQDN known to the UNIX/Linux host does not match the FQDN used by the Operations Manager server to reach the host.

Usage for the scxsslconfig tool can be displayed with the following command: scxsslconfig -?

# /opt/microsoft/scx/bin/tools/scxsslconfig -?
Usage: /opt/microsoft/scx/bin/tools/.scxsslconfig [-v] [-s days] [-e days] [-d domain] [-h host] [-g targetpath]

-v             - toggle debug flag
-g targetpath  - generate certificates in targetpath
-s days        - days to offset valid start date with (0)
-e days        - days to offset valid end date with (3650)
-f             - force certificate to be generated even if one exists
-d domain      - domain name
-h host        - host name
-b bits        - number of key bits
-?             - this help message