Description
This command outputs update requests to the Agent, and updates the observed records that are managed in CMDB. There are two types of update: a full update and a differential update. A full update collects all information from scratch, regardless of whether it has already been collected up to that point. A differential update collects information that differs from previously collected information.
If all observed records are specified for update, the update may not be reflected in deleted observed records (the observed records might remain in CMDB), therefore all records should only be updated in the following cases:
when re-creating CMDB
when configuration items were deleted from the Configuration Management window by mistake
This command can be executed in both the Manager and the Linked Server.
Synopsis
[Windows]
cmdbrefresh.exe [-a] -q [server=Host name | type=Agent type] |
[Linux]
cmdbrefresh.sh [-a] -q [server=Host name | type=Agent type] |
Options
This option updates all observed records (update all). If this option is omitted, update differences will apply. In normal cases, omit this option so that update differences will apply.
To execute this option on the Manager, specify the host name of the update target Linked Server. At the time of the Agent installation, specify the value that was entered for the host name used by the CMDB Agent.
If this option is omitted, all Linked Server recognized by the Manager will be update targets.
This option specifies the type of update target Agent when this command is executed on the Agent. The Agent types that can be specified are shown below. Specify an Agent type that has already been set up. If this option is omitted, all Agents that have been set up will be updated.
AGT_CENTINV
An agent that collects the Systemwalker Centric Manager inventory information.
AGT_CENTREP
An agent that collects the Systemwalker Centric Manager node information.
AGT_INV
An agent that automatically collects inventory information about the servers connected to the network.
AGT_ADSC
An agent that detects node automatically and collects node information
Combining options
The options that can be combined are different for the Manager and the Linked Server, as shown below:
Management Server
cmdbrefresh.[exe|sh] -q
cmdbrefresh.[exe|sh] -q server=Host name
cmdbrefresh.[exe|sh] -q type=Agent type
cmdbrefresh.[exe|sh] -a -q
cmdbrefresh.[exe|sh] -a -q server=Host name
cmdbrefresh.[exe|sh] -a -q type=Agent type
Linked Server
cmdbrefresh.[exe|sh] -q
cmdbrefresh.[exe|sh] -q type=Agent type
cmdbrefresh.[exe|sh] -a -q
cmdbrefresh.[exe|sh] -a -q type=Agent type
Additionally, when this command is executed on the Manager, the agents that can be specified in server=host name are those that have a record of having notified the Manager at least once about the information that was collected. The reason for this is that the Manager can recognize the existence of the Agents in the first notification of information.
Return Values
Normal termination
Abnormal termination
Command Location
Management Server
[Windows]
<Systemwalker Runbook Automation installation directory>\CMDB\FJSVcmdbm\bin |
[Linux]
/opt/FJSVcmdbm/bin |
Linked Server
[Windows]
%SWCMDB_INSTALL_PATH%\FJSVcmdba\bin Note: The installation destination of the CMDB agent included in the agent of Systemwalker Runbook Automation is set to environment variable %SWCMDB_INSTALL_PATH%. |
[Linux]
/opt/FJSVcmdba/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 and Linked Server.
[Linux]
This can only be executed by a system administrator (superuser).
This command can be executed on a Management Server and Linked Server.
Note
This command and the update process on the target server are performed asynchronously. For this reason, the update process may be running on the agent side even after this command returns. Refer to event log and system log message on the Agent side to check for the completion of update processing.
