Description
Exports information about software parameters. Also, downloads parameter packages for those parameters.
Synopsis
[Windows]
swcfmg_param_export.exe { -csv {-serverid <Server ID> | -ip <IP address>} [-snap <Snapshot name>] -file <Output file path> [-e <Character encoding>] | -csv { -serverid <Server ID> | -ip <IP address> } -softid <Software ID> [-snap <Snapshot name>] -file <Output file path> [-e <Character encoding>] | -pkg { -serverid Server ID | -ip <IP address> } [-snap <Snapshot name>] -dir <Output directory path> | -pkg { -serverid Server ID | -ip <IP address> } -softid <Software ID> [-snap <Snapshot name>] -dir <Output directory path> } |
[Linux]
swcfmg_param_export { -csv {-serverid <Server ID> | -ip <IP address>} [-snap <Snapshot name>] -file <Output file path> [-e <Character encoding>] | -csv { -serverid <Server ID> | -ip <IP address> } -softid <Software ID> [-snap <Snapshot name>] -file <Output file path> [-e <Character encoding>] | -pkg { -serverid Server ID | -ip <IP address> } [-snap <Snapshot name>] -dir <Output directory path> | -pkg { -serverid Server ID | -ip <IP address> } -softid <Software ID> [-snap <Snapshot name>] -dir <Output directory path> } |
Options
The parameters for the software installed on the specified server are output to the output file path. The output file is a CSV file (for listing software and parameters) output in units to the specified server (refer to "2.5.6 Software and Parameter List CSV File" for details).
If the specified file does not exist, a new file will be created. If the file exists, the existing file will be overwritten.
If the file cannot be output because of an error, either a new file will not be created or, if an existing file was to be overwritten, the existing file will be kept as it is, without being overwritten.
The parameters for the specified software are output to the output file path. The output files are CSV files (parameter list) - one file per software will be created (refer to "2.5.7 Parameter List CSV File" for details).
If the specified file does not exist, a new file will be created. If the file exists, the existing file will be overwritten.
If the file cannot be output because of an error, either a new file will not be created or, if an existing file was to be overwritten, the existing file will be kept as it is, without being overwritten.
Downloads parameter packages for the parameters of the software installed on the specified server. Outputs parameter package zip files to the output directory path. Downloads parameter packages according to the software on the specified server. For this reason, a directory is created for each software into which to download the parameter packages. No directories are created unless there are existing parameter packages.
Ensure that no files exist in the output directory, or an error will occur.
Directory naming convention
<Software ID>
Downloads parameter packages for parameters of the specified software. Outputs parameter package zip files to the output directory path.
Ensure that no files exist in the output directory, or an error will occur.
When the snapshot name is specified, acquires the current parameters for the specified snapshot, or the parameter package.
Specify the character encoding for the file.
The character encodings below can be specified (single-byte uppercase characters must be used):
UTF-8
If this option is omitted, the character encoding of the execution environment of this command will be used.
Return value
Return value | Meaning |
|---|---|
0 | Completed normally. |
10 | A parameter error has occurred. |
20 | The specified I/O path is incorrect. |
30 | The specified character encoding is incorrect. |
40 | Unable to analyze the file. |
70 | The specified ID does not exist. |
72 | The package has not been registered in the specified ID. |
73 | The package has not been correctly registered in the specified ID. |
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. |
110 | A write error has occurred. |
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.
[Linux]
This command can only be executed by the system administrator (superuser).
This command can be executed on the admin server.
Notes
Execute this command while Systemwalker Software Configuration Manager is running.
Examples
Export as CSV
[Windows]
swcfmg_param_export.exe -csv -ip 10.10.10.10 -file C:\work\param_export.csv |
[Linux]
swcfmg_param_export -csv -ip 10.10.10.10 -file /tmp/parampredef.csv |
Export as package
[Windows]
swcfmg_param_export.exe -pkg -ip 10.10.10.10 -dir C:\work\param_export |
[Linux]
swcfmg_param_export -pkg -ip 10.10.10.10 -dir /tmp/parampredef |
