docs/doc/source/dist_cloud/kubernetes/reviewing-update-status-for-distributed-cloud-using-the-cli.rst
Elisamara Aoki Gonçalves 9e5b12cae9 Upgrade Support doc update (r10.1)
Story: 2010676
Task: 51423

Change-Id: I2e15fd4645c7661ab838a4ed0e69f7167a1cce79
Signed-off-by: Elisamara Aoki Gonçalves <elisamaraaoki.goncalves@windriver.com>
2024-12-06 13:57:40 +00:00

91 lines
4.2 KiB
ReStructuredText

.. hxt1558615716368
.. _reviewing-update-status-for-distributed-cloud-using-the-cli:
========================================================
Review Update Status for Distributed Cloud Using the CLI
========================================================
You can use the CLI to review the updates in the central update repository and
their synchronization status across the subclouds of the |prod-dc|.
.. rubric:: |context|
To use the Horizon Web interface instead, see :ref:`Reviewing Update Status for
Distributed Cloud Using Horizon
<reviewing-update-status-for-distributed-cloud-using-horizon>`.
.. rubric:: |proc|
.. _reviewing-update-status-for-distributed-cloud-using-the-cli-steps-unordered-d53-dlx-fdb:
- To check the status of updates in the central update repository, use the
query option on the SystemController region.
For example:
.. code-block:: none
~(keystone_admin)]$ software --os-region-name SystemController list
+-------------------+-------+----------+
| Release | RR | State |
+-------------------+-------+----------+
| starlingx-24.09.0 | True | deployed |
| starlingx-24.09.1 | False | deployed |
+-------------------+-------+----------+
The **State** column indicates whether the release is available, or
deployed. **deployed** indicates that the release has been installed on all
hosts of the cloud (SystemController in this case).
- To identify which subclouds are update-current (**in-sync**), use the
.. code-block:: none
~(keystone_admin)]$ dcmanager subcloud list
+----+-----------+--------------+--------------------+-------------+
| id | name | management | availability | sync |
+----+-----------+--------------+--------------------+-------------+
| 1 | subcloud1 | managed | online | in-sync |
| 2 | subcloud2 | managed | online | in-sync |
| 3 | subcloud3 | managed | online | out-of-sync |
+----+-----------+--------------+--------------------+-------------+
.. note::
The **sync** status is the rolled up sync status of
**platform-sync-status**, **identity-sync-status**, and
**software-sync-status**.
- To see synchronization details for a subcloud:
.. code-block:: none
~(keystone_admin)]$ dcmanager subcloud show subcloud1
+-----------------------------+----------------------------+
| Field | Value |
+-----------------------------+----------------------------+
| id | 1 |
| name | subcloud1 |
| description | None |
| location | None |
| software_version | nn.nn |
| management | managed |
| availability | online |
| deploy_status | complete |
| management_subnet | fd01:82::0/64 |
| management_start_ip | fd01:82::2 |
| management_end_ip | fd01:82::11 |
| management_gateway_ip | fd01:82::1 |
| systemcontroller_gateway_ip | fd01:81::1 |
| group_id | 1 |
| created_at | 2020-07-15 19:23:50.966984 |
| updated_at | 2020-07-17 12:36:28.815655 |
| dc-cert_sync_status | in-sync |
| identity_sync_status | in-sync |
| load_sync_status | not-available |
| patching_sync_status | not-available |
| software_sync_status | in-sync |
| platform_sync_status | in-sync |
+-----------------------------+----------------------------+