dcmanager is the command-line interface for the Distributed Cloud Manager APIs. dcmanager is applicable only in the SystemController region of the central cloud in a distributed cloud configuration.
This page documents the dcmanager command.
dcmanager [--version] [-v] [--log-file LOG_FILE] [-q] [-h] [--debug] [--dcmanager-url DCMANAGER_URL] [--dcmanager-api-version DCMANAGER_VERSION] [--dcmanager-service-type SERVICE_TYPE] [--os-endpoint-type ENDPOINT_TYPE] [--os-username USERNAME] [--os-password PASSWORD] [--os-tenant-id TENANT_ID] [--os-project-id PROJECT_ID] [--os-tenant-name TENANT_NAME] [--os-project-name PROJECT_NAME] [--os-auth-token TOKEN] [--os-project-domain-name PROJECT_DOMAIN_NAME] [--os-project-domain-id PROJECT_DOMAIN_ID] [--os-user-domain-name USER_DOMAIN_NAME] [--os-user-domain-id USER_DOMAIN_ID] [--os-auth-url AUTH_URL] [--os-cacert CACERT] [--insecure] [--profile HMAC_KEY] <subcommand> ...
For a list of all dcmanager subcommands and options, enter:
For a full description of usage and optional arguments for a specific dcmanager command, enter:
dcmanager help COMMAND
Distributed cloud centralized alarms¶
Displays the aggregated counts of critical, major, minor, and warning alarms across all subclouds.
List alarm summaries of subclouds.
Distributed subcloud management¶
This set of commands provides subcloud management, including basic add, delete, list, show, and update operations on a subcloud.
Add a new subcloud.
Note that this command will create the subcloud in the central cloud’s database, run the Ansible bootstrap playbook on the new subcloud, and optionally run a deployment playbook.
Delete subcloud details from the database.
Show the uploaded deployment files.
Upload the subcloud deployment files.
Add a new subcloud group.
Delete subcloud group details from the database.
List subcloud groups.
List subclouds referencing a subcloud group.
Show the details of a subcloud group.
Update attributes of a subcloud group.
Manage a subcloud. Enables the active synchronization of data between the central cloud and the subcloud.
Re-run the deployment playbook on a subcloud using an updated configuration file.
Reinstall a subcloud.
Restore a subcloud.
Show the details of a subcloud.
Unmanage a subcloud. Disables the active synchronization of data between the central cloud and the subcloud.
Update attributes of a subcloud.
Distributed cloud patching/updating¶
The following commands are not supported upstream.
The patch-strategy commands create, apply, and monitor the orchestration of software patch application (or updates) across all subclouds and all hosts of subclouds. patch-strategy commands orchestrate software updates across an entire distributed cloud solution.
Abort a patch strategy.
Apply a patch strategy.
Create a patch strategy.
Delete patch strategy from the database.
Show the details of a patch strategy for a subcloud.
Delete per subcloud patch options.
List patch options.
Show patch options, defaults or per subcloud.
Update patch options, defaults or per subcloud.
List strategy steps.
Show the details of a strategy step.
Distributed cloud firmware updating¶
The following set of commands create, apply, and monitor the orchestration of N3000 FPGA firmware load updating across all subclouds and all hosts of subclouds.
Abort a firmware update strategy.
Apply a firmware update strategy.
Create a firmware update strategy.
Delete firmware update strategy from the database.
Show the details of a firmware update strategy for a subcloud.
Distributed cloud Kubernetes version upgrading¶
The following set of commands create, apply, and monitor the orchestration of Kubernetes version upgrading across all subclouds and all hosts of subclouds.
Abort a Kubernetes upgrade strategy.
Apply a Kubernetes upgrade strategy.
Create a Kubernetes upgrade strategy.
Delete Kubernetes upgrade strategy from the database.
Show the details of a Kubernetes upgrade strategy for a subcloud.