Synopsis
[Collection of maintenance information] swcolinf [-i Name] -o OutPath [-c Comment] [Setting of generation management for maintenance information] swcolinf -w Count [List display of maintenance information] swcolinf -1 OutPath
Description
This command collects information required for troubleshooting of Systemwalker Operation Manager. The number of generations of information to be collected can be defined to enable generation management. In addition, information on collected resources (collection date, collected function, etc.) can be displayed by generation with the list display option.
If no environment has been created due to installation failure etc., this information can be collected using commands in the product media.
Options
-i Name
Select a function used to collect information. The functions that can be specified in the Name option are listed below. When specifying more than one function, delimit the functions with a comma. You must specify "all" alone. It cannot be specified with other functions.
Normally, specify "all" to collect information about all Systemwalker Operation Manager functions. Collect information about a specific function only when the function to be collected is clarified or a Fujitsu engineer gives instructions to do so.
If this option is omitted, information about all the functions is collected just like specifying the -i all option.
When using commands in the product media, only "all" can be specified.
Collects information about all functions.
Collects fundamental information, such as information on security and scripts.
Collects information about the functions installed on servers, such as Jobscheduler, Job Execution Control, Calendar, and Power Control.
Collects information about installation, backup, and maintenance tools.
-o OutPath
Specify the directory in which the collected information is to be stored with a full path using alphanumeric characters with up to 50 bytes for OutPath. The full path must not contain any blanks.
-c Comment
Specify a comment, if needed, to be attached to the information that is collected.
Specify a comment with up to 50 bytes using alphanumeric characters and "_". If this option is omitted, no comment is attached to the collected information.
-w Count
Specify the number of generations of information to be stored. Specify a number with range from 1 to 10. The initial value is set to 3 generations.
This option is not available when using commands in the product media.
If you do not want generation management, set the value to 1.
-l OutPath
Specify to display a list of the collected information. Specify for OutPath the directory that contains the collected information. The dates of collection, collection functions, and comments in the collected information stored under the specified directory are listed by generations.
Return Values
Return value | Meaning |
---|---|
0 | Normal termination |
Value other than 0 | Abnormal termination |
Command Location
Solaris | /opt/FJSVftlo/swcolinf |
HP-UX | /opt/FJSVftlo/swcolinf |
AIX | /opt/FJSVftlo/swcolinf |
Linux | /opt/FJSVftlo/swcolinf |
Product media (Solaris) | <drive>/Solaris/tool_unx/swcolinf |
Product media (Linux) | <drive>/Linux/tool_unx/swcolinf |
Privilege Required
System administrator (superuser) privileges are required.
Cautions
If collection of information about a function fails, a failure message is displayed. Manually copy the applicable file to the storage destination as directed in the window.
Since this is a silent command, if an error occurs, that error is recorded to the following log.
For command option error: Specify the correct option
[Solaris]
/var/tmp/swcolinf.log |
[HP-UX, AIX, Linux]
/tmp/swcolinf.log |
For other errors: Copy the failed file to the storage destination manually
Storage destination directory/OperationManager/Generation number/swcolinf.log |
Example 1
The following example collects server function and tool information, and stores it in /work:
/opt/FJSVftlo/swcolinf/swcolinf -i server.tool -o /work
Example 2
The following example collects information about all functions and stores it with a comment attached, in /work:
/opt/FJSVftlo/swcolinf/swcolinf -i all -o /work -c 2002.2.2_all_SE001
Example 3
The following example displays a list of information about the collected data stored under /work:
/opt/FJSVftlo/swcolinf/swcolinf -l /work
Execution Result
*** Systemwalker Operation Manager Information *** OUTPATH: /work FOLDER DATE FUNCTION COMMENT /work/Operation Manager/0001 2002/05/05 10:10:10 all all /work/Operation Manager/0002 2002/05/06 10:10:10 tool tool :error
The output items are explained below:
Specified directory that contains the collected information
Generation directory in which information is stored
Date of collection
Function for which information was collected
Comment specified by the command