Systemwalker Runbook Automation Reference Guide

1.4.10 ciexport (Configuration Item Export Command)

Description

This command exports configuration items from the CMDB. The results are sent to a specified file or to standard output in XML format.

Synopsis

[Windows]

ciexport.exe -q xpath=condition specified [-x output file]

[Linux]

ciexport.sh -q xpath=condition specified [-x output file]

Options

-q xpath=condition specified

Specifies the output conditions in XPath format. XPath is a language used to specify particular components of an XML document. It can be specified as follows:

• To search for all logical servers:

  /%LogicalServer

• To search for a logical server that has the name svr001:

  /%LogicalServer[./#observed/rc:LogicalServer/@name = 'svr001']

• To search for a logical server that has Systemwalker Centric Manager installed:

  /%InstalledSoftware[./#observed/rc:InstalledSoftware/@productName = 'Systemwalker Centric Manager Enterprise Edition V13.2.0']/&GRelation/%LogicalServer

Point

• CMDB-specific extensions that use '%', '&', and '#' are added to the normal XPath axis.

• '%' indicates the configuration item. Specify the type name for the configuration item after %. For example, '%LogicalServer' indicates the configuration item 'LogicalServer'.

• '&' indicates the relation. Specify the type name for the relation after &. In normal cases, specify '&GRelation'.

• By defining /%LogicalServer/&GRelation/%InstalledSoftware, it is possible to search InstalledSoftware that is related to LogicalServer (the search result will be InstalledSoftware).

• '#' indicates the record. '#expected' indicates the expected record, and '#observed' indicates the observed record.

• Refer to "Chapter 6 Configuration Item Format" for more details on configuration item definitions.

-x Output file

Specifies a name for the file that outputs the results. If this is omitted, the results will be displayed to standard output.

Return Values

0:

Normal termination

Value other than 0:

Abnormal termination

Command Location

[Windows]

<Systemwalker Runbook Automation installation directory>\CMDB\FJSVcmdbm\bin
Note: The default location is C:\Fujitsu\Systemwalker\SWRBAM

[Linux]

/opt/FJSVcmdbm/bin

Privilege Required/Execution Environment

[Windows]

• The Administrator authority is necessary. Execute this command as an administrator when use OS is Windows Server 2008 or later.

• This command can be executed on a Management Server.

[Linux]

• This command can only be executed by a system administrator (superuser).

• This command can be executed on a Management Server.