The database library provides the following classes:
Article number/class name |
Configuration Management Database is abbreviated to CMDB hereafter.
Configuration item, stored in the CMDB, is abbreviated to CI hereafter.
Class Name
Swrba_CMDB
List of Methods
Method | Description |
String get_info(String searchxpath, String xpath, String hostname, String username, String password, String execusername, String execpassword, String ostype) | Acquire a specific configuration item. If acquisition is successful, configuration items are output to an XML text string. An exception is returned if acquisition failed. |
String set_info(String searchxpath, String xpath, String content, String hostname, String username, String password, String execusername, String execpassword, String ostype) | Update a specific configuration item. "Success" is returned if update was successful. An exception is returned if update failed. |
Integer return_code() | Return the return value of the acquisition/update results of the configuration item. |
Input Information
searchxpath Specify conditional expressions for acquiring/updating specific configuration items.
xpath Specify conditional expressions for updating attribute information from specific configuration items.
content Specify the content to be updated.
hostname Specify the host name or IP address of the host requesting acquisition/update of configuration items.
username Specify the name of the user using SSH to connect the host requesting acquisition/update of configuration items.
If the operation component connects with the file transfer infrastructure, the connected user name will be fixed at either of the following names and cannot be changed. In this case, the user name is ignored even if specified.
- If the Business Server is running on Windows: SYSTEM user
- If the Business Server is running on Linux: root
password Specify the password of the user using SSH to connect to the host requesting acquisition/update of configuration items.
If the operation component connects with the file transfer infrastructure, the password is ignored even if specified.
execusername Specify the name of the user acquiring/updating configuration items.
If the host specified by the "hostname" option is running on Windows and the connection is made using the file transfer infrastructure, execute the command as a SYSTEM user. In this case, the user name is ignored even if specified.
execpassword This library does not use the value of "execpassword".
The value of "execpassword" is ignored even if specified.
ostype Specify the operating system of the host requesting acquisition/update of configuration items. Specify Windows or Linux.
Notes
If the information except for the Management Server has been entered for "hostname", this library uses the file transfer infrastructure or SSH communication to perform its operations. Set either at least to be able to communicate. Refer to the "3.16 Notes of Each Communication Method" for the notes of each communication method.
When acquiring or updating configuration items stored in a Configuration Management Database on a server other than the Management Server, it is necessary to store the work file in the folder (directory) on the server where the Configuration Management Database is located. Specify the directory path for the location where the work file is stored as the "SWRBA_CMDB_WORK_HOME" environment variable of the server where the Configuration Management Database is located.
When using this library to create operation components, make sure that the Management Server installation directory does not contain whitespace characters or the result cannot be guaranteed.
File Location
Windows | <Installation directory>\SWRBAM\rbaope\bin\parts\lib\ standard\swrba_cmdb.rb |
Linux | /opt/FJSVswrbam/rbaope//bin/parts/lib/standard/swrba_cmdb.rb |