diff options
author | whoami-rajat <rajatdhasmana@gmail.com> | 2018-10-19 13:53:15 +0530 |
---|---|---|
committer | Matt Riedemann <mriedem.os@gmail.com> | 2018-10-22 14:19:36 +0000 |
commit | ba4e54589d4c33687da6c6925c40f931954611f0 (patch) | |
tree | bb77770629454aaec25a90fd6f8bdabf925265d8 /doc | |
parent | 63bff7408ad9ba95284c6af63228ddf96b981ae4 (diff) | |
download | heat-ba4e54589d4c33687da6c6925c40f931954611f0.tar.gz |
Add heat-status upgrade check command framework
This adds basic framework for heat-status upgrade
check commands. For now it has only "check_placeholder"
check implemented.
Real checks can be added to this tool in the future.
Change-Id: I83629184b49a6cf91928df702db23156433d99f6
Story: 2003657
Task: 26131
Diffstat (limited to 'doc')
-rw-r--r-- | doc/source/man/heat-status.rst | 78 | ||||
-rw-r--r-- | doc/source/man/index.rst | 1 |
2 files changed, 79 insertions, 0 deletions
diff --git a/doc/source/man/heat-status.rst b/doc/source/man/heat-status.rst new file mode 100644 index 000000000..9673bf205 --- /dev/null +++ b/doc/source/man/heat-status.rst @@ -0,0 +1,78 @@ +=========== +heat-status +=========== + +Synopsis +======== + +:: + + heat-status <category> <command> [<args>] + +Description +=========== + +:program:`heat-status` is a tool that provides routines for checking the +status of a Heat deployment. + +Options +======= + +The standard pattern for executing a :program:`heat-status` command is:: + + heat-status <category> <command> [<args>] + +Run without arguments to see a list of available command categories:: + + heat-status + +Categories are: + +* ``upgrade`` + +Detailed descriptions are below. + +You can also run with a category argument such as ``upgrade`` to see a list of +all commands in that category:: + + heat-status upgrade + +These sections describe the available categories and arguments for +:program:`heat-status`. + +Upgrade +~~~~~~~ + +.. _heat-status-checks: + +``heat-status upgrade check`` + Performs a release-specific readiness check before restarting services with + new code. This command expects to have complete configuration and access + to databases and services. + + **Return Codes** + + .. list-table:: + :widths: 20 80 + :header-rows: 1 + + * - Return code + - Description + * - 0 + - All upgrade readiness checks passed successfully and there is nothing + to do. + * - 1 + - At least one check encountered an issue and requires further + investigation. This is considered a warning but the upgrade may be OK. + * - 2 + - There was an upgrade status check failure that needs to be + investigated. This should be considered something that stops an + upgrade. + * - 255 + - An unexpected error occurred. + + **History of Checks** + + **12.0.0 (Stein)** + + * Placeholder to be filled in with checks as they are added in Stein. diff --git a/doc/source/man/index.rst b/doc/source/man/index.rst index 1dbea361e..f00ea5c7d 100644 --- a/doc/source/man/index.rst +++ b/doc/source/man/index.rst @@ -24,3 +24,4 @@ Heat utilities heat-db-setup heat-keystone-setup heat-keystone-setup-domain + heat-status |