Description
This command discovers information relating to patch management.
Windows patch information
This command discovers information about Windows patches released by Microsoft.
Linux patch information
This command discovers information about RPM packages.
Solaris OS patch information
This command discovers information about Solaris patches.
Software patch information
This command discovers software information and patch information from information collection sources such as UpdateAdvisor.
Synopsis
[Windows]
swcfmg_patch_updateinfo.exe [-t <Patch type>] [{-serverid <Server ID>,... | -ip <IP address>,...}][-repository] [-cleanup] [-o <Output file path>] |
[Linux]
swcfmg_patch_updateinfo [-t <Patch type>] [{-serverid <Server ID>,... | -ip <IP address>,...}][-repository] [-cleanup] [-o <Output file path>] |
Options
This option specifies a patch type.
Information relating to the specified patch type will be discovered.
If this option is omitted, information will be discovered for all patch types.
Specifying this patch type discovers information relating to patch management for Windows operating systems.
Specifying this patch type discovers information relating to patch management for Linux operating systems.
Specifying this patch type discovers information relating to patch management for Solaris operating systems.
Discovers information related to software patch management. Discovers information about the software installed on business servers and applied patches from information collection sources. Information is collected from enabled sources only. The information collection sources that are enabled can be confirmed using swcfmg_source_def (Information Collection Source Management Command). For details, refer to "swcfmg_source_def (Information Collection Source Management Command)" in the Developer's Guide.
Discovery of the following information can be performed for the specified managed server.
Information relating to patch management for Linux operating systems
Information relating to patch management for Solaris operating systems
Information relating to software patch management
If this option is omitted, information will be discovered for all managed servers.
This option is effective only when "-t linux", "-t solaris", or, "-t middleware" is specified. If "-t windows" is specified, the command will fail with a parameter error.
Specified as | Entered as | Example | Remarks |
---|---|---|---|
Single specification | IP address | Discovers the managed server at the IP address "10.10.10.10". 10.10.10.10 | |
Server ID | Discovers the managed server with the server ID "0I6M73PAH@Direct". 0I6M73PAH@Direct | ||
Multiple specification | IP address,IP address,... | Discovers the managed servers at the IP addresses "10.10.10.10", "10.10.10.11", and "10.10.10.12". 10.10.10.10,10.10.10.11,10.10.10.12 | Do not specify any characters such as halfwidth spaces before or after the comma (,). If any character other than the IP address is specified, a parameter error will occur. |
Server ID, Server ID, ... | Discovers the managed servers with the server IDs "0I6M73PAH@Direct", "CUIYJJGBF@Direct", and "SAZYVGV5U@Direct". 0I6M73PAH@Direct,CUIYJJGBF@Direct,SAZYVGV5U@Direct | Do not specify half-width spaces or any characters that are not a server ID before or after the comma (,). Otherwise a parameter error will occur. |
Specifying this option discovers patch information from the repository server.
This option can be omitted. If this option is omitted, information will not be discovered from the repository server.
Specify this option in the following case:
Discovering patch information for Windows operating systems by linking to the Microsoft Windows Server Update Services (WSUS)
If repository server information has not been set up using a discovery definition file, the following error message will be output to the trace log if this option is specified (refer to "2.2.14 Discovery Definition File" for information on the discovery definition file).
Repository information has not been set up in the discovery definition file.
This option sends a cleanup update request to the agent. Specify this option in the following case. This option will have no effect if it is specified at a time other than the explicitly specified timing. No error will occur.
When a Microsoft Windows Server Update Services (WSUS) server has been cleaned up
This option is used to output the content of the standard output to the specified file rather than the standard output.
If the specified file does not exist, a new file will be created. If the file exists, additional data will be output to the existing file.
Return value
Return value | Meaning |
---|---|
0 | The command has terminated normally. |
10 | A parameter error has occurred. |
11 | The specified server ID or IP address does not exist. |
49 | Reading the action definition file has failed. |
100 | Systemwalker Software Configuration Manager is not running. |
101 | A command that cannot be executed at the same time as this command is already running. |
102 | You do not have the privileges required to execute this command. |
200 | Setup has not been performed. |
210 | Warning: The command terminated with an error. |
211 | Warning: There is a warning. |
250 | All discovery operations have failed. |
255 | A system error has occurred. |
Command location
Admin server
[Windows]
<Systemwalker Software Configuration Manager installation directory>\SWCFMGM\bin |
[Linux]
/opt/FJSVcfmgm/bin |
Privilege required/execution environment
[Windows]
Administrator privileges are required. Execute as an administrator.
This command can be executed on the admin server.
[Linux]
This command can only be executed by the system administrator (superuser).
This command can be executed on the admin server.
Cautions
This command can be executed at the same time as other commands only for the following patch type combinations:
Executed patch type | Specifiable patch types | ||||
---|---|---|---|---|---|
Omitted | windows | linux | solaris | middleware | |
Omitted | - | - | - | - | - |
windows | - | - | Yes | Yes | Yes |
linux | - | Yes | - | Yes | - |
solaris | - | Yes | Yes | - | - |
middleware | - | Yes | - | - | - |
Yes: Can be executed simultaneously
-: Cannot be executed simultaneously
This command can be executed at any desired timing, but it is recommended that the command be executed during a gap in business activities.
For example, execute regular discovery once a day in the middle of the night (out of normal business hours).
Refer to "Registering a Configuration Baseline Creation Schedule" in the Installation Guide for information about schedule settings for regular discovery and the time taken to execute discovery.
If you specify multiple server IDs or IP addresses, or if you specify one or more server IDs or IP addresses of non-managed servers, discovery will not be performed. In this case, the following error message will be output.
The specified server could not be found. [Server:{0}] |
The server ID or IP address of the server that is not a managed server is displayed in {0}. If there are IP addresses of multiple servers, they are displayed in CSV format.
The patch information update command will output the following warning message if there are any business servers for which information could not be collected during discovery for some reason (such as the target server not running):
A warning has occurred while patch information was being updated. |
Information about the servers for which information could not be collected and the reason why the information could not be collected are output to log files, so take the necessary action based on the information in the log files.
[Log files to check]
cfmgcommand_discovery_trace_log
cfmgcommand_discovery_wsus_trace_log
cfmgcommand_discovery_yum_trace_log
cfmgcommand_discovery_fjmw_trace_log
cfmgcommand_discovery_sol_trace_log
This warning message is triggered by messages with the following message labels (refer to the Message Guide for information on how to take action).
If this warning message is output without a message with one of the following message labels being output, contact Fujitsu technical support.
[List of message labels]
CFMGD04012
CFMGD04014
CFMGD04015
CFMGD04016
CFMGD04018
CFMGD05006
CFMGD05007
CFMGD05008
CFMGD05009
CFMGD05010
CFMGD05011
CFMGD05012
CFMGD05013
CFMGD05014
CFMGD05015
CFMGD05016
CFMGD05017
CFMGD05018
CFMGD05019
CFMGD05020
CFMGD08002
CFMGD08003
CFMGD08004
CFMGD10005
CFMGD10006
CFMGD10007
CFMGD11002
CFMGD11003
CFMGD11004
CFMGD12001
CFMGD12002
CFMGD12003
CFMGD12004
CFMGD12005
This command cannot be executed at the same time as other commands. An exclusive control error will occur if a command is executed while another command is executing.
When an admin server is communicating with a managed server during an operation such as discovery, on the Linux and Solaris business server consoles, the following message may be displayed. However, this does not affect the operation.
FJSVlnkcf:INFO:Host name:FL24021:Completion notification - command_name(f3jtrspjob)
Example
Discovering all information
[Windows]
swcfmg_patch_updateinfo.exe -repository |
[Linux]
swcfmg_patch_updateinfo -repository |
Discovering information relating to patch management for Windows operating systems
[Windows]
swcfmg_patch_updateinfo.exe -t windows -repository |
[Linux]
swcfmg_patch_updateinfo -t windows -repository |
Discovering information relating to patch management for Linux operating systems
[Windows]
swcfmg_patch_updateinfo.exe -t linux |
[Linux]
swcfmg_patch_updateinfo -t linux |
Discovers information relating to patch management for Solaris operating systems.
[Windows]
swcfmg_patch_updateinfo.exe -t solaris |
[Linux]
swcfmg_patch_updateinfo -t solaris |
Discovers information related to software patches.
[Windows]
swcfmg_patch_updateinfo.exe -t middleware |
[Linux]
swcfmg_patch_updateinfo -t middleware |
Discover information relating to patch management for Linux operating systems by specifying the IP address.
[Windows]
swcfmg_patch_updateinfo.exe -t linux -ip 10.10.10.10 |
[Linux]
swcfmg_patch_updateinfo -t linux -ip 10.10.10.10 |
Discovering information relating to patch management for Solaris operating by systems specifying the IP address.
[Windows]
swcfmg_patch_updateinfo.exe -t solaris -ip 10.10.10.10 |
[Linux]
swcfmg_patch_updateinfo -t solaris -ip 10.10.10.10 |
Discovers information related to software patches by specifying the IP address.
[Windows]
swcfmg_patch_updateinfo.exe -t middleware -ip 10.10.10.10 |
[Linux]
swcfmg_patch_updateinfo -t middleware -ip 10.10.10.10 |