sm_getinfo command-line
syntax
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 .
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
/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
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.
|