Systemwalker Software Configuration Manager Reference Guide

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 [-ip <IP address>,... | -lp <L-Platform name>] [-o <Output file path>]

[Linux]

swcfmg_param_updateinfo [-ip <IP address>,... | -lp <L-Platform name>] [-o <Output file path>]

Options

-ip <IP address,... | -lp <L-Platform 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:

• IP address specification

• L-Platform name specification

[IP address specification]

Possible IP address specifications are shown below:

Specified as	Entered as	Example	Remarks
Single specification	IP address	To discover the parameter information for the managed server 10.10.10.10: 10.10.10.10
Multiple specification	IP address,IP address,...	To discover the parameter information for the managed servers 10.10.10.10, and 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.
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

[L-Platform name specification]

Specify the L-Platform name. The command will discover the parameter information for managed servers belonging to the specified L-Platform.

-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. When using Windows Server 2008 or later, run 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 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 IP address is specified more than once, the duplication will be removed and the parameter information will be updated.

• If a non-existent L-Platform 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 L-Platform, 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.

  Information about the parameter information that could not be collected, and why, is output in the log files, so take action as required.

  [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.

Examples

[Windows]

swcfmg_param_updateinfo.exe

[Linux]

swcfmg_param_updateinfo