Description
This command sets software parameters.
Synopsis
[Windows]
swcfmg_param_startsetting.exe |
[Linux]
swcfmg_param_startsetting |
Options
Set parameters as the user specified by the user ID. Specify the server ID or IP address of the target server.
Use the Job Management window or the Job Information Management command to check the execution status.
For the software ID, specify the software for which parameters are to be set. In addition, for the parameter information ID, specify the predefined parameters to be used for setting parameters.
Multiple software IDs and parameter information IDs can be specified by delimiting them with ',' (commas). If specifying multiple IDs, set the parameters for multiple software products on the same server in the order in which you specified the IDs. Therefore, specify software products for software ID in the same order of the predefined parameters for parameter information ID.
Parameters cannot be set for multiple instances of software using this option. To set parameters for multiple instances of software, use the -file option.
Setting order | Software | Predefined parameter |
|---|---|---|
1 | Software A | Predefined parameter A |
2 | Software B | Predefined parameter B |
3 | Software C | Predefined parameter C |
Example
-softid <software A>,<software B>,<software C> -predefid <predefined parameter A>,<predefined parameter B>,<predefined parameter C> |
You can specify the execution method by specifying the options below:
Specify the monitoring time of the server operation check for the parameter setting job. Specify the monitoring time using a number between 0 and 1440 in minutes. When 0 is specified, an operation check will be performed once. When a numeric value larger than 0 is specified, the operation check is performed at three-minute intervals within the range of the specified monitoring time. When it is confirmed that the server is operating, the job completes normally. When the operation check cannot be performed during the monitoring time, the process ends abnormally. If this option is omitted, the monitoring time is zero minutes.
Specify the script to be run before parameters are set. If this option is omitted, no script is executed before parameters are set.
Specify the script to be run after parameters are set. If this option is omitted, no script is executed after parameters are set.
This option restarts the server after parameter setting. If this option is omitted, the server is not restarted.
Whether the software of the configuration target has already been installed on the server is not checked. When configuring the parameter settings with this option specified, check whether the software of the configuration target has already been installed in advance. The parameter that has been configured specifying this option cannot be managed as the configured value. The value is not displayed as the configured value in the Parameter Details window of the management console. Check the configured values from the predefined parameter using the "-get" option of swcfmg_param_predef (Predefined Parameter Management command). When omitting this option, check if the software of the configuration target has already been installed.
When the job turns to the following status, the command returns. When this option is omitted, after the job starts, the command returns immediately.
selecting_abnormal: Selecting (abnormal)
completed: Completed
completed_abnormal: Completed (abnormal)
canceled: Canceled
After this command completes, parameter setting is executed as a job. The job ID of the job to be executed is output to the standard output.
Output format for standard output:
[Job ID] |
Return value
Return value | Meaning |
|---|---|
0 | The command has terminated normally. [When specifying the "-wait" option] The status of the job turned to Complete. |
10 | A parameter error has occurred. |
20 | The specified I/O path is incorrect. |
50 | The file description is incorrect. |
70 | The specified ID does not exist. |
71 | The specified user ID does not exist. |
72 | The package has not been registered. |
73 | The specified server ID or IP address does not exist. |
81 | You do not have the privileges required to set parameters. |
90 | [When specifying the "-wait" option] The status of the job turned to Selecting (abnormal). |
91 | [When specifying the "-wait" option] The status of the job turned to Completed (abnormal). |
92 | [When specifying the "-wait" option] The status of the job turned to Canceled. |
100 | Systemwalker Software Configuration Manager is not running. |
103 | Connection to the directory service failed. |
104 | The operation is not permitted for the admin server. |
200 | Setup has not been performed. |
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.
This command can be executed at the same time as other commands.
[Linux]
System administrator (superuser) privileges are required.
This command can be executed on the admin server.
This command can be executed at the same time as other commands.
Notes
Execute this command while Systemwalker Software Configuration Manager is running.
Parameters cannot be set for the admin server.
Example
[Windows]
swcfmg_param_startsetting.exe -userid user001 -ip 192.168.1.1 -softid UDP00001 -predefid PM00000001 |
[Linux]
swcfmg_param_startsetting -userid user001 -ip 192.168.1.1 -softid UDP00001 -predefid PM00000001 |
