Description
This command registers, updates, deletes, and lists server information managed by Systemwalker Software Configuration Manager.
It cannot register, update, or delete servers managed by ServerView Resource Orchestrator.
Synopsis
[Windows]
swcfmg_server.exe |
[Linux]
swcfmg_server |
Options
Registers server information using the data entered in the specified server information file.
The server information file is in CSV format (refer to "2.2.5 Server Information File" for details).
Updates server information using the data entered in the specified server information file.
The server information file is in CSV format (refer to "2.2.5 Server Information File" for details).
Specify an IP address for deleting a registered server. Multiple IP addresses can be specified by delimiting them with ',' (comma).
Outputs, in CSV format, the server information registered using this command and swcfmg_define_serverinfo (Managed Server Information Definition command).
If -file <output file> is omitted, the information is output to the standard output for this command.
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.
Refer to "2.2.5 Server Information File" for information on the output file.
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.
Performs the connection test. If this option is specified, the connection test will be performed after server information is registered or updated. If this option is omitted, the connection test will not be performed (refer to "1.2.8 swcfmg_connectiontest (Connection Test Command)" for details).
Outputs server information managed by ServerView Resource Orchestrator in addition to server information registered using this command and swcfmg_define_serverinfo (Managed Server Information Definition command).
If this option is specified, server information is displayed in ascending "L-Platform ID" order.
Return value
Return value | Meaning |
|---|---|
0 | The command has terminated normally. |
10 | A parameter error has occurred. |
20 | The specified I/O path is incorrect. |
30 | The specified character encoding is incorrect. |
50 | The file description is incorrect. |
70 | The specified IP address does not exist. |
80 | The connection test failed. |
81 | The L-Platform or server managed by ServerView Resource Orchestrator cannot be operated. |
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. |
103 | Connection to the directory service failed. |
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. When using Windows Server 2008 or later, run this command as an administrator.
This command can be executed on the admin server.
[Linux]
System administrator (superuser) privileges are required.
This command can be executed on the admin server.
Notes
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.
Execute this command while Systemwalker Software Configuration Manager is running.
This command cannot be used to update or delete servers managed by ServerView Resource Orchestrator.
Server information is registered in accordance with the server information file.
Specify an "IP address" that is unique within the product. In addition, when linking to ServerView Resource Orchestrator, also specify the servers that are to be managed and that were registered by ServerView Resource Orchestrator so that they are unique.
A server cannot be added to an L-Platform managed by ServerView Resource Orchestrator.
Behavior is not guaranteed if the character encoding specified for this command does not match the character encoding specified for the server information file. These character encodings must match.
When updating registered server information, it is recommended that you edit the listed file and use the edited file as the input file for update.
A server managed by ServerView Resource Orchestrator cannot be updated.
Use this command to delete server information that is no longer required for Systemwalker Software Configuration Manager.
A server managed by ServerView Resource Orchestrator cannot be deleted.
If no server information is registered, only header information is output.
#ipaddress,server-name,lplatform-id,host-name,os-type,os-architecture,os-name |
To include servers managed by ServerView Resource Orchestrator in the list display, specify the "-all" option.
If a server information file is invalid, the registration or update of the server information will be canceled. An error message similar to the following will be output to the trace log:
CFMGC20005 The file description is incorrect. [Line number:<n>][Cause:<Cause>] |
One of the following messages will be output in <Cause>:
Message | Meaning |
|---|---|
Number of elements. | Review the number of elements in the line indicated. |
The specified elements are invalid. () | The values of elements within "()" in the given line are invalid. Enter the correct values (refer to the "2.2.5 Server Information File" for details). |
The specified elements cannot be changed. () | Elements within "()" in the given line cannot be changed. |
Mandatory elements are not specified. | Enter the mandatory elements in the given line. |
The same Server is specified in another line. | The same IP address is already defined in one of the preceding lines. |
The specified L-Platform does not exist. | There is no L-Platform corresponding to <lplatform-id> in the given line. Specify the L-Platform ID of an existing L-Platform. |
The Server has already been registered. | The server information in the given line is already registered. |
The specified server does not exist. | There is no server information corresponding to <IP address> in the given line. Specify the IP address of an existing server. |
The Server cannot be operated. | The server information in the given line is for a server managed by ServerView Resource Orchestrator. This command cannot update this type of server information. |
The Server cannot be added to the specified L-Platform. | The L-Platform corresponding to "lplatform-id" in the given line is an L-Platform managed by ServerVIew Resource Orchestrator. This command cannot add a server to this type of L-Platform. |
Example
Registration
[Windows]
swcfmg_server.exe -add -file C:\work\serverinfo.csv |
[Linux]
swcfmg_server -add -file /tmp/serverinfo.csv |
Update
[Windows]
swcfmg_server.exe -update -file C:\work\serverinfo.csv |
[Linux]
swcfmg_server -update -file /tmp/serverinfo.csv |
Deletion
[Windows]
swcfmg_server.exe -delete -ip 192.168.1.1,192.168.1.2 |
[Linux]
swcfmg_server -delete -ip 192.168.1.1,192.168.1.2 |
List
[Windows]
swcfmg_server.exe -list -file C:\work\serverinfo.csv |
[Linux]
swcfmg_server -list -file /tmp/serverinfo.csv |
Execution results/output format
List
Standard output
#ipaddress,server-name,lplatform-id,host-name,os-type,os-architecture,os-name 192.168.1.1,developmentserver1,tenant1-CFMG-2JHV3DDBF,kaihatsu1,Windows,x64,Windows Server 2008 R2 192.168.1.2,developmentserver2,tenant1-CFMG-S97LT3315,kaihatsu2,Windows,x64,Windows Server 2008 R2
File output
CFMGC30151 The server information management command has completed normally.
Note that the following header information is output as the first line of the CSV file that is output.
#ipaddress,server-name,lplatform-id,host-name,os-type,os-architecture,os-name
