You run the sm_getinfo utility from the BASEDIR/smarts/bin directory. The options that you specify on the invocation command line determine which files are included in the sm_getinfo-created tar archive.

Here is the command line syntax for sm_getinfo:

sm_perl sm_getinfo.pl
| --server <server name> --pid <server process ID>
| --broker <location>
| --log [<number of latest logs>]
| --nolog
| --repos [--latest]
| --norps
| --core
| --all
| --version
| --help
| --smmonitor “<sm_monitor options>”
| --flush
| --smconfigscan

where:

  • <> Angle brackets are user-supplied parameter values (variables).

  • [ ] Square brackets are optional entries.

  • | Vertical bar symbols are alternate selections.

    The command-line options are described in Command-line options for the sm_getinfo utility .

Table 1. Command-line options for the sm_getinfo utility

Option

Description

--server <server name> --pid <server process ID> | -s <server name> -p <server process ID>

Specifies the server name and PID against which the sm_getinfo utility will collect information. To dump a core file for a running server on CentOS or Linux, the pid option must be provided. Also, the server name is used to invoke the sm_monitor tool.

--broker <location> | -b <location>

Specifies an alternate broker location as host:port.

--pid <pid> | -p <pid>

PID of Domain Manager used to run gcore.

--log [<number of latest logs>] | -l [<number of latest logs>]

For each server, collects and stores a user-specified number of latest logs or all generated log files that are in the BASEDIR/smarts/local/logs directory.

Note that whenever collecting a log, the related .audit and .archive files should be collected as well.

If a server name is specified, only the files that correspond to the server will be collected. To avoid generating a too-large tar archive (too large to email), any log file that is larger than 700 MB will be excluded and its information will be logged in smgetinfo-versions.log<date>.

--nolog | -g

Excludes log files when collecting local files. This option and --log are mutually exclusive.

--repos [--latest] | -r [-t]

For each server, collects and stores the latest repository file or all repository files. If a server name is specified, only the file corresponding to the server will be collected. Any repository file that is larger than 700 MB will be excluded and its information will be logged in smgetinfo-versions.log<date>.

--norps | -n

Excludes repository files when collecting local files. This option and --repos are mutually exclusive.

--core | -c

Collects and stores the core files (CentOS, Linux) that are generated by the software, and the corresponding logs.

--all | -a

All data and files in BASEDIR/smarts/local and BASEDIR/smarts/setup directories will be collected and stored. If --all option is specified, the other options will be ignored except --server and --pid.

--version | -v

Print version information and exit.

--help | -h

Print usage information and exit.

--smmonitor “<sm_monitor options>” | -m “<sm_monitor options>”

Specifies the options for running sm_monitor, which will override the default options “-m run-all -z.”

Approximately two cycles are run to collect the required information. The collected information is output to the BASEDIR/smarts/local/logs/SM-Monitor-<server name> directory.

--flush | -f

Force a flush. Needed when the sm_getinfo utility is invoked from a remote host.

--smconfigscan | -k

Note:

This option is available for IP Manager only.

Invokes the configuration scanner tool to provide a snapshot of all the customizations introduced by you in your current installation. “Configuration Scanner Tool” on page 116 provides more information on how to use the tool.