Description
Discovers the information about stacks and instances managed using OpenStack.
Synopsis
[Windows]
swcfmg_openstack_updateinfo.exe [ { -stackid <Stack ID> | -instanceid <Instance ID> } [-projectid <Project ID>] [-monitor <Monitoring time>] ][Linux]
swcfmg_openstack_updateinfo [ { -stackid <Stack ID> | -instanceid <Instance ID> } [-projectid <Project ID>] [-monitor <Monitoring time>] ]Options
Discovers the specified stack or instance. When a stack is specified, the instance information in that stack is also discovered. When omitted, information about all stacks and instances managed by OpenStack is discovered.
The discovery scope can be specified using the following methods:
Scope | Specification Method | |
|---|---|---|
All | Omit the option. | |
Single | Stack | Specify the "-stackid" option. |
Instance | Specify the "-instanceid" option. | |
For single stack/instance discovery, it is also possible to specify the discovery method using the following option:
Specify the ID of the project to which the stacks or instances for discovery belongs. If this option is omitted, discovery will be performed by searching in all projects for the corresponding stacks or instances. When a large number of (50 or more) projects are managed by the target OpenStack, specifying this option reduces the time taken for the discovery process. If neither stacks nor instances exist in the specified project, an error occurs.
When the target stack or instance for discovery is in the process of being deployed, discovery is performed after waiting for completion of the deployment within the specified monitoring time. During the specified monitoring time, whether deployment has been completed is checked at one-minute intervals. When completion of deployment is confirmed, discovery is performed. When the completion of deployment cannot be confirmed during the monitoring time, the process ends abnormally. When this option is omitted, the monitoring time is zero minutes.
Discovery of OpenStack information cannot collect information about stacks or instances being deployed. Specify this option when performing discovery immediately after deploying a stack or instance. Specify the monitoring time using a number between 0 and 1440 in minutes.
Return value
Return value | Meaning |
|---|---|
0 | The command has terminated normally. |
10 | A parameter error has occurred. |
11 | The specified project, stack, or instance does not exist. |
49 | OpenStack site information has not been registered. |
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 | Discovery is being executed for the specified stack or instance. |
210 | Warning: The command terminated with an error. |
211 | Warning: There is a warning. |
250 | All discovery operations have failed. |
200 | Setup has not been performed. |
255 | A system error has occurred. |
Command location
Windows | [Systemwalker Software Configuration Manager installation directory]\SWCFMGM\bin |
Linux | /opt/FJSVcfmgm/bin |
Privilege required
[Windows]
Administrator privileges are required. Execute as an administrator.
This command can be executed on the admin server.
This command can be executed at the same time as other commands.
[Linux]
This command can only be executed by the system administrator (superuser).
This command can be executed on the admin server.
This command can be executed at the same time as other commands.
Notes
Execute this command while Systemwalker Software Configuration Manager is running.
Discovery of the same stack or instance cannot be performed at the same time.
When performing discovery of a single instance, do not specify the instance in the stack.
In order to discover OpenStack information, the information of the OpenStack site and the service access user must be correctly configured in the discovery definition file beforehand. Otherwise, the following error message will be output:
CFMGD00001 Failed to read the discovery definition file. Path={Discovery definition file path}Configure the OpenStack site information and the service access user correctly, referring to "Discovery Definition File".
When canceling the link with OpenStack, set the value of the "enable-OpenStack" key in the discovery definition file to "false", and then perform discovery of OpenStack information. Server groups and servers managed by OpenStack will be deleted.
When some of the information cannot be acquired, the following warning message is output:
CFMGD00019 A warning occurred while information was being updated.
The information that could not be collected, and the reason, is output to the log file. Take corrective action accordingly.
[Log files to check]
cfmgcommand_discovery_trace_log
Example
[Windows]
swcfmg_openstack_updateinfo.exe
[Linux]
swcfmg_openstack_updateinfo