Description
CMDB imports IPMI information about managed servers by this command. File format for input is CSV.
You can update and add IPMI information by editing IPMI information that was exported by swrba_ipmiexport and importing IPMI information by using swrba_ipmiimport.
Synopsis
swrba_ipmiimport -f Input file [-e Character code of Input file] |
Options
Specify the file for input that has IPMI information of server that is registration object. File format for input is CSV.
The example of the input file is shows below.
192.168.0.1,192.168.1.1,user001,xe3539caeb |
The specifications of CSV are shown below.
Delimit column by comma (,).
You can't input linefeed character in the column data.
The positions of column in CSV are shown below.
1 column | 2 column | 3 column | 4 column | |
|---|---|---|---|---|
Item | IP address of server | IP address of IPMI | User | Password |
example | 192.168.0.1 | 192.168.1.1 | user001 | xe3539caeb |
The definition rule of each column is shown below.
column | item | Omission | Omission Value | Inputted Contents | Check Contents | Condition |
|---|---|---|---|---|---|---|
1 | IP address | NG | - | Specify the IP address of server. | Number of input characters | From 1 to 255 characters |
Type of characters | Normal-width alphabetic character (It distinguishes capital letter and small letter), the normal-width figure, and the normal-width sign. | |||||
Contents | When LogicalServer-CI of specified Internet Protocol address is not registered in CMDB, an error is displayed. | |||||
2 | IP address | NG | - | Specify the IPMI IP address | Number of input characters | From 1 to 255 characters |
Type of characters | Normal-width alphabetic character (It distinguishes capital letter and small letter), the normal-width figure, and the normal-width sign. | |||||
3 | User | NG | - | Specify the user account for the authentication server. | Number of input characters | From 1 to 255 characters |
Type of characters | The one-byte character and the em-size character can be used. The blank cannot be used. | |||||
uniqueness | Two or more same users cannot be registered in a server concerned. | |||||
4 | Password | OK | - | Specify the password for the user. When you omit password, this command operates as follows.
| Number of input characters | From 1 to 255 characters |
Point
If the IPMI information entered in the input file contains an error, the IPMI information with the error fails to be imported. All other IPMI information is imported.
When the configuration information is automatically collected, the IP address of the LogicalServer-CI of the IPv6 environment is stored in the RFC 5952 format. In this case, the IP address specified in the input file should also be written in the RFC 5952 format. For all other cases, use the same format as registered in the CMDB.
Refer to "Settings for Automatically Collecting Configuration Information" in the Systemwalker Runbook Automation Installation Guide for details.
Specify the character code of the inputted file. The following character-codes can be specified.
UTF-8
SJIS
EUC
If this option is omitted, the character code of the input file will be as follows:
[Windows]
SJIS
[Linux]
The character code specified in the LANG environment variable
If the LANG environment variable has not been set, or character code cannot be recognized, then UTF-8 will be used.
Return Values
Normal termination
Warning termination
IPMI information that fails in import exists.
Parameter error
Errors other than 1 and 2
Notification of Error Information
When there is an error in information to be imported, error information is notified to the standard error output.
Correct IPMI information on the input file referring to error information output to the standard error output, and do the import again by this command.
Example: If the error occurs on multiple lines, then these multiple lines will be notified.
> swrba_ipmiimport -f importcsv.txt Error: Failed to register the IPMI information. Detail=The registration destination LogicalServer[192.168.0.1] cannot be found. Error: Failed to register the IPMI information. Detail=The registration destination LogicalServer[192.168.0.2] cannot be found. IPMI information was successfully registered. LogicalServer=192.168.0.3 IPAddress=192.168.1.3 User=user001 IPMI information was successfully registered. LogicalServer=192.168.0.4 IPAddress=192.168.1.4 User=user002 Failed to execute all or part of the processing. |
Command Location
[Windows]
<Systemwalker Runbook Automation installation directory>\bin |
[Linux]
/opt/FJSVswrbam/bin |
Privilege Required/Execution Environment
[Windows]
This command requires administrator privileges. When using Windows Server 2008 or later operating system, run as an administrator.
This command can be executed on a Management Server.
[Linux]
This can only be executed by a system administrator (superuser).
This command can be executed on a Management Server.
Note
As for IPMI information, information on the input file becomes effective.
When IPMI information has already been registered on CMDB, this command replaces IPMI information registered on CMDB by IPMI information described in the input file.
swrba_ipmiexport and swrba_ipmiimport cannot run at the same time. For this reason, an error will occur if one command is executed while the other command is already under execution.
Execute this command when Systemwalker Runbook Automation is running.
If this command is used before the setup (swrba_setup) is complete, it will fail because of the following error:
Error: An internal error occurred. Detail=com.fujitsu.cmdb.CMDBUncheckedException: Property file not found. |
If this command is used before Systemwalker Runbook Automation has started ups, it will fail because of the following error:
Error: Failed to register the IPMI information. Detail=com.ctc.wstx.exc.WstxUnexpectedCharException: Unexpected character '"' (code 34) in DOCTYPE declaration; expected a space between public and system identifiers at [row,col {unknown-source}]: [1,50] |
If the character code that was specified in this command and the character code that was specified in the input file are different, then the behavior cannot be guaranteed. Enter the character code so that it matches.
