1.4.15 swcfmg_param_updateinfo (Parameter Information Update Command)

Description

Discovers information about parameters in the software installed on the managed server managed by Systemwalker Software Configuration Manager.

Synopsis

[Windows]

swcfmg_param_updateinfo.exe [ -serverid <Server ID>,... | -ip <IP address>,... | -lp <Server group name>] [-o <Output file path>]

[Linux]

swcfmg_param_updateinfo [ -serverid <Server ID>,... | -ip <IP address>,... | -lp <Server group name>] [-o <Output file path>]

Options

-serverid <Server ID>,... | -ip <IP address>,... | -lp <Server group name>

Specifies the managed servers to discover the parameter information for.

If this option is omitted, parameter information will be discovered for all managed servers.

Specify the managed servers using one of the following options:

Server ID specification
IP address specification
Server group name specification

[Server ID/IP address specification]

For IP address specification, the following specification method can be selected. For server ID specification, single and multiple specification methods can be selected.

Specified as	Entered as	Example	Remarks
Single specification	IP address	Discovers parameter information of the managed server at the IP address "10.10.10.10". 10.10.10.10
	Server ID	Discovers parameter information of the managed server with the server ID "0I6M73PAH@Direct". 0I6M73PAH@Direct
Multiple specification	IP address,IP address,...	Discovers parameter information of 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 (,), otherwise a parameter error will occur.
	Server ID, Server ID, ...	Discovers parameter information of 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.
Range specification	IP address-IP address Use hyphens (-) to connect the start (from) and end (to) of the IP address range	To discover the parameter information for managed servers from 10.10.10.10 to 10.10.10.15: 10.10.10.10-10.10.10.15	Do not specify any characters (such as halfwidth spaces) before or after the hyphen (-), otherwise, a parameter error will occur. If the end IP address (to) is smaller than the start IP address (from), a parameter error will occur.
Combination	A combination of single specification, multiple specification and range specification	To discover the parameter information for managed server 10.10.10.10 and for managed servers 10.10.11.10 to 10.10.11.15: 10.10.10.10, 10.10.11.10-10.10.11.15

[Server group name specification]: Specify the server group name. The command will discover the parameter information for managed servers belonging to the specified server group.

-o <Output file path>

If this option is specified, the content of the standard output is 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	Completed normally.
10	A parameter error has occurred.
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.
211	Warning: A warning was issued during parameter information collection for some servers.
212	Warning: A warning was issued during parameter information collection for some software.
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 for execution

[Windows]

Administrator privileges are required. Execute as an administrator.
The command can be executed on the admin server.

[Linux]

This command can only be executed by the system administrator (superuser).
The command can be executed on the admin server.

Notes

The following information is required for discovering parameter information. Perform the registration operation and discovery beforehand.

Information	Registration operation/Discovery
Software information managed by Systemwalker Software Configuration Manager	Predefinition Registered by Systemwalker Software Configuration Manager at product installation. User definition Registered by the user using swcfmg_software (Software Information Management command).
Parameter collection information for software managed by Systemwalker Software Configuration Manager	Predefinition Registered by Systemwalker Software Configuration Manager at product installation. User definition The user registers the parameter collection information using swcfmg_param_collectingdef (Parameter Collection Definition Management command). After registering the parameter collection information, the user uses swcfmg_param_defassoc (Software and Parameter Definitions Association command) to register the association between the managed software information and the parameter collection information.
Managed server information	ServerView Resource Orchestrator-managed server Registered by ServerView Resource Orchestrator when the user uses ServerView Resource Orchestrator to deploy the business server. Non ServerView Resource Orchestrator-managed server Registered by the user using swcfmg_server (Server Information Management command) or swcfmg_define_serverinfo (Managed Server Information Definition command)
Information about software installed on managed server	Discovery Regular discovery Regular discovery executed by Systemwalker Software Configuration Manager in accordance with schedule. Manual discovery Discovery executed by user using swcfmg_patch_updateinfo (patch information update command). To discover software information installed on a managed server, specify the "Option of command set to scheduler by regular discovery" and "Option of command executed by manual discovery"as follows: [-t option<Patch type>] -t middleware Omitted User definition Registered by the user using swcfmg_installedsoftware (installed software information management command)

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.
Refer to "Registering Discovery Schedules" in the Installation Guide for information about schedule settings for regular discovery and the time taken to execute discovery.
An error will occur if the specified server ID or IP address does not refer to a managed server.
If single specification was used, the parameter information update command will fail because it will deem that no target server exists, and the following message will be output:
```
Failed to update the parameter information on all servers.
```
If some other form of specification was used and none of specified IP addresses refers to a managed server, the parameter information update command will fail and the following message will be output:
```
Failed to update the parameter information on all servers.
```
When specifying other than single specification and some of the specified servers are not managed servers, information will only be updated for those servers for which parameter information was collected normally, and the following message will be output:
```
A warning occurred while parameter information was being updated.
```
If the same server ID or IP address is specified more than once, the duplicate will be removed and the parameter information will be updated.
If a non-existent server group name is specified, the parameter information update command will fail and the following message will be output:
```
Failed to update the parameter information on all servers.
```
If no servers belong to the specified server group, the parameter information update command will fail and the following message will be output:
```
Failed to update the parameter information on all servers.
```
The following warning message will be output if there is any information that could not be acquired for some reason (such as the target server not running or the software service not running) during discovery using the parameter information update command:
```
A warning has occurred while parameter information was being updated.
```
The information that could not be collected, and the reason, is output to the log file. Take corrective action accordingly.
[Log files to check]
- cfmgcommand_discovery_trace_log
If necessary, also refer to the following log output to the managed server:
- swcfmga_param_collecting_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).
Contact Fujitsu technical support if this warning message is output without the following message label:
[List of message labels]
- CFMGD05050
- CFMGD05051
- CFMGD05052
- CFMGD05053
- CFMGD05054
- CFMGD05055
- CFMGD05056
- CFMGD05057
- CFMGD05058
- CFMGD05059
- CFMGD05060
- CFMGD05061
- CFMGD05062
- CFMGD05063
- CFMGD05064
- CFMGD05065
- CFMGD05067
- CFMGD05068
- CFMGD05072
- CFMGD05073
The parameter information for the Solaris managed server cannot be discovered.
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 still executing.
Execute this command while Systemwalker Software Configuration Manager is running.
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)
```

Examples

[Windows]

swcfmg_param_updateinfo.exe

[Linux]

swcfmg_param_updateinfo