Merge "Conditionalization done for only ds (dsr10, r10)"
This commit is contained in:
Zuul
Gerrit Code Review
commit
0432c2d78f
@ -0,0 +1,3 @@
|
|||||||
|
.. configuration-changes-begin
|
||||||
|
|
||||||
|
.. configuration-changes-end
|
||||||
@ -0,0 +1,19 @@
|
|||||||
|
|
||||||
|
.. dmnote-begin
|
||||||
|
.. dmnote-end
|
||||||
|
|
||||||
|
.. dm-playbook-overrides-begin
|
||||||
|
.. dm-playbook-overrides-end
|
||||||
|
|
||||||
|
.. deployment-config-begin
|
||||||
|
.. deployment-config-end
|
||||||
|
|
||||||
|
.. setup-stage-checks-begin
|
||||||
|
.. setup-stage-checks-end
|
||||||
|
|
||||||
|
.. bootstrap-values-begin
|
||||||
|
.. bootstrap-values-end
|
||||||
|
|
||||||
|
.. dmconfiguration-begin
|
||||||
|
.. dmconfiguration-end
|
||||||
|
|
||||||
@ -1,2 +1,5 @@
|
|||||||
.. deploy-begin
|
.. deploy-begin
|
||||||
.. deploy-end
|
.. deploy-end
|
||||||
|
|
||||||
|
.. number-of-cores-begin
|
||||||
|
.. number-of-cores-end
|
||||||
|
|||||||
@ -263,8 +263,13 @@ The host configuration files must be specified under
|
|||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
Only ``localhost.yml`` is provided as part of the base configuration. It is
|
Only ``localhost.yml`` is provided as part of the base configuration. It is
|
||||||
a sample placeholder that must be updated. The Deployment Manager
|
a sample placeholder that must be updated.
|
||||||
configuration and overrides file must be created.
|
|
||||||
|
.. only:: partner
|
||||||
|
|
||||||
|
.. include:: /_includes/enroll-a-factory-installed-nondc-standalone-system.rest
|
||||||
|
:start-after: dmnote-begin
|
||||||
|
:end-before: dmnote-end
|
||||||
|
|
||||||
**``localhost.yml``**
|
**``localhost.yml``**
|
||||||
|
|
||||||
@ -330,42 +335,17 @@ Example:
|
|||||||
system_local_ca_cert:
|
system_local_ca_cert:
|
||||||
system_local_ca_key
|
system_local_ca_key
|
||||||
|
|
||||||
**dm-playbook-overrides.yaml**
|
.. only:: partner
|
||||||
|
|
||||||
.. note::
|
.. include:: /_includes/enroll-a-factory-installed-nondc-standalone-system.rest
|
||||||
|
:start-after: dm-playbook-overrides-begin
|
||||||
|
:end-before: dm-playbook-overrides-end
|
||||||
|
|
||||||
This file name needs to be the same as given, otherwise automation services
|
.. only:: partner
|
||||||
will fail to find the file.
|
|
||||||
|
|
||||||
This file is only used to support the installation of Deployment Manager.
|
.. include:: /_includes/enroll-a-factory-installed-nondc-standalone-system.rest
|
||||||
|
:start-after: deployment-config-begin
|
||||||
.. code-block::
|
:end-before: deployment-config-end
|
||||||
|
|
||||||
deployment_config:/home/sysadmin/deployment-config.yaml
|
|
||||||
deployment_manager_overrides:
|
|
||||||
/usr/local/share/applications/overrides/wind-river-cloud-platform-deployment-manager-overrides.yaml
|
|
||||||
deployment_manager_chart:
|
|
||||||
/usr/local/share/applications/helm/wind-river-cloud-platform-deployment-manager-<version>.tgz
|
|
||||||
ansible_become_pass:#sysadminpassword
|
|
||||||
|
|
||||||
**deployment-config.yaml**
|
|
||||||
|
|
||||||
The ``deployment-config.yaml`` file contains configurations to be applied by
|
|
||||||
Deployment Manager to the system during the factory installation. The values in
|
|
||||||
``deployment-config.yaml`` can be used in different deployment options,
|
|
||||||
however, below are some of the guidelines that must be met:
|
|
||||||
|
|
||||||
- Only controller-0 will be provisioned and configured during the
|
|
||||||
factory installation. The other hosts profiles should be removed from
|
|
||||||
``deployment-config.yaml``.
|
|
||||||
|
|
||||||
- Controller-0 should be administratively unlocked before the enrollment process.
|
|
||||||
|
|
||||||
- Controller-0 should be reconciled at the end of the factory installation
|
|
||||||
process to be valid for enrollment.
|
|
||||||
|
|
||||||
- Storage backends, filesystems, memory, and processors should be specified in
|
|
||||||
the configuration.
|
|
||||||
|
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
(Optional) Prepare Custom Setup, Checks, and Tests Script
|
(Optional) Prepare Custom Setup, Checks, and Tests Script
|
||||||
@ -430,46 +410,11 @@ before proceeding with platform-automation.
|
|||||||
|
|
||||||
exit 0
|
exit 0
|
||||||
|
|
||||||
**Setup stage checks (Post-deployment-unlock)**
|
.. only:: partner
|
||||||
|
|
||||||
The scripts in ``nocloud-factory-install/factory-install/setup/`` are run after
|
.. include:: /_includes/enroll-a-factory-installed-nondc-standalone-system.rest
|
||||||
the host is unlocked by Deployment Manager during the setup stage. For example,
|
:start-after: setup-stage-checks-begin
|
||||||
``nocloud-factory-install/factory-install/setup/10-system-setup`` ensures that
|
:end-before: setup-stage-checks-end
|
||||||
the host is fully reconciled before proceeding.
|
|
||||||
|
|
||||||
.. code-block::
|
|
||||||
|
|
||||||
nocloud-factory-install/factory-install/setup/10-system-setup
|
|
||||||
echo "System Setup - Start"
|
|
||||||
|
|
||||||
echo "Wait - host goenabled"
|
|
||||||
until [ -f /var/run/goenabled ]; do
|
|
||||||
sleep 10
|
|
||||||
done
|
|
||||||
echo "Ready - host goenabled"
|
|
||||||
|
|
||||||
system_mode=$(awk - F= '/system_mode/ {print $2}' /etc/platform/platform.conf)
|
|
||||||
|
|
||||||
echo "Wait - system deployment reconciled"
|
|
||||||
while true; do
|
|
||||||
if [ "$system_mode" = "duplex" ]; then
|
|
||||||
SYSTEM_RECONCILED=true
|
|
||||||
else
|
|
||||||
SYSTEM_RECONCILED=$(kubectl --kubeconfig=/etc/kubernetes/admin.conf -n deployment
|
|
||||||
fi
|
|
||||||
|
|
||||||
HOST_RECONCILED=$(kubectl --kubeconfig=/etc/kubernetes/admin.conf -n deployment get ho
|
|
||||||
|
|
||||||
if [ "$SYSTEM_RECONCILED" = true ] && [ "$HOST_RECONCILED" = true ]; then
|
|
||||||
break
|
|
||||||
fi
|
|
||||||
sleep10
|
|
||||||
done
|
|
||||||
echo "Ready - system deployment reconciled"
|
|
||||||
|
|
||||||
echo "System Setup - Complete"
|
|
||||||
|
|
||||||
exit0
|
|
||||||
|
|
||||||
**Final checks**
|
**Final checks**
|
||||||
|
|
||||||
@ -671,39 +616,11 @@ controller and the subcloud via |OAM| network.
|
|||||||
bmc_username: bmc username
|
bmc_username: bmc username
|
||||||
bootstrap_vlan: vlanID for the bootstrap interface
|
bootstrap_vlan: vlanID for the bootstrap interface
|
||||||
|
|
||||||
**Bootstrap values**
|
.. only:: partner
|
||||||
|
|
||||||
Bootstrap values are used during the enrollment process to update the required
|
.. include:: /_includes/enroll-a-factory-installed-nondc-standalone-system.rest
|
||||||
configurations for essential services before Deployment Manager can update the
|
:start-after: bootstrap-values-begin
|
||||||
other configurations.
|
:end-before: bootstrap-values-end
|
||||||
|
|
||||||
.. code-block::
|
|
||||||
|
|
||||||
# values to be set to the oam network
|
|
||||||
external_oam_subnet
|
|
||||||
external_oam_gateway_address
|
|
||||||
external_oam_floating_address
|
|
||||||
external_oam_node_0_address
|
|
||||||
external_oam_node_1_address
|
|
||||||
|
|
||||||
# values to be set to the admin network
|
|
||||||
admin_subnet:
|
|
||||||
admin_start_address:
|
|
||||||
admin_end_address:
|
|
||||||
admin_gateway_address:
|
|
||||||
|
|
||||||
# MGMT network values are only updated on Simplex system without admin network configured.
|
|
||||||
# Cluster networks, pxeboot_subnet values are ignored
|
|
||||||
# system type, system mode, name are ignored
|
|
||||||
|
|
||||||
systemcontroller_gateway_address:
|
|
||||||
|
|
||||||
docker_http_proxy:
|
|
||||||
docker_no_proxy:
|
|
||||||
docker_registries:
|
|
||||||
dns_servers:
|
|
||||||
|
|
||||||
# The other values are ignored
|
|
||||||
|
|
||||||
**Deployment configurations**
|
**Deployment configurations**
|
||||||
|
|
||||||
@ -719,9 +636,11 @@ should be similar to the original deployment.
|
|||||||
|
|
||||||
- Hosts should be administratively unlocked in this configuration.
|
- Hosts should be administratively unlocked in this configuration.
|
||||||
|
|
||||||
- Deployment Manager will ignore any network change at this stage. The network
|
.. only:: partner
|
||||||
reconfiguration should be controlled by the bootstrap values.
|
|
||||||
|
|
||||||
|
.. include:: /_includes/enroll-a-factory-installed-nondc-standalone-system.rest
|
||||||
|
:start-after: dmconfiguration-begin
|
||||||
|
:end-before: dmconfiguration-end
|
||||||
|
|
||||||
***************************
|
***************************
|
||||||
Perform Subcloud Enrollment
|
Perform Subcloud Enrollment
|
||||||
|
|||||||
@ -10,49 +10,57 @@ Some configuration changes require a system or host re-add.
|
|||||||
|
|
||||||
.. _configuration-changes-requiring-re-installation-table-d2t-yjs-kfb:
|
.. _configuration-changes-requiring-re-installation-table-d2t-yjs-kfb:
|
||||||
|
|
||||||
.. table:: Table 1. Configuration Changes Requiring Reinstallation
|
.. only:: starlingx
|
||||||
:widths: auto
|
|
||||||
|
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
.. table:: Table 1. Configuration Changes Requiring Reinstallation
|
||||||
| Change | Reinstall | Comments |
|
:widths: auto
|
||||||
+==============================================================+=================+====================================================================================================================================================================================================================================================================================================================================+
|
|
||||||
| Product type change | System | To change between Standard and All-in-one, you must perform a system reinstallation. |
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| Change | Reinstall | Comments |
|
||||||
| PXE boot network addition or removal | System | You must perform a system reinstallation. |
|
+==============================================================+=================+====================================================================================================================================================================================================================================================================================================================================+
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| Product type change | System | To change between Standard and All-in-one, you must perform a system reinstallation. |
|
||||||
| Management network subnet or range changes | System | You must perform a system reinstallation. |
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| PXE boot network addition or removal | System | You must perform a system reinstallation. |
|
||||||
| Cluster-host subnet or range changes | System | You must perform a system reinstallation. |
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| Management network subnet or range changes | System | You must perform a system reinstallation. |
|
||||||
| Legacy BIOS to UEFI change | System | You must perform a system reinstallation. |
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| Cluster-host subnet or range changes | System | You must perform a system reinstallation. |
|
||||||
| Security profile change | System | You must perform a system reinstallation. |
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| Legacy BIOS to UEFI change | System | You must perform a system reinstallation. |
|
||||||
| Controller filesystem size decrease | System | To decrease the controller filesystem size, you must perform a system reinstallation. |
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| Security profile change | System | You must perform a system reinstallation. |
|
||||||
| Root disk replacement | Host (re-add) | To install the OpenStack application on a new disk, the host must be deleted and re-added (not merely reinstalled). |
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| Controller filesystem size decrease | System | To decrease the controller filesystem size, you must perform a system reinstallation. |
|
||||||
| Replacement of storage disk on SAS controller | Host (re-add) | Due to a limitation in **udev**, the device path of a disk connected through a SAS controller changes when the disk is replaced. You must lock, delete, and re-install the node. Once this is done, it is advisable to replace any storage profiles associated with the host, since the old storage profile is no longer accurate. |
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| Root disk replacement | Host (re-add) | To install the OpenStack application on a new disk, the host must be deleted and re-added (not merely reinstalled). |
|
||||||
| Aborted upgrade after controller-1 and controller-0 upgraded | System | You must perform a system reinstallation. |
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| Replacement of storage disk on SAS controller | Host (re-add) | Due to a limitation in **udev**, the device path of a disk connected through a SAS controller changes when the disk is replaced. You must lock, delete, and re-install the node. Once this is done, it is advisable to replace any storage profiles associated with the host, since the old storage profile is no longer accurate. |
|
||||||
| Subcloud delete and re-add | System | The subcloud system must be reinstalled. |
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| Aborted upgrade after controller-1 and controller-0 upgraded | System | You must perform a system reinstallation. |
|
||||||
| Configuration commands run from SSH | System | An error occurs if any of the :command:`sw-patch install-local` command is run from an SSH session. |
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
| | | |
|
| Subcloud delete and re-add | System | The subcloud system must be reinstalled. |
|
||||||
| | | To recover, you must reinstall the system. |
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| Configuration commands run from SSH | System | An error occurs if any of the :command:`sw-patch install-local` command is run from an SSH session. |
|
||||||
| Developer certificate or update removal | System | Required to correct Alarm 500.100 |
|
| | | |
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| | | To recover, you must reinstall the system. |
|
||||||
| Management network netmask correction on a Duplex system | System | On a Duplex system, the minimum management netmask is /28. |
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| Developer certificate or update removal | System | Required to correct Alarm 500.100 |
|
||||||
| Host version mismatch | Host (re-add) | Required to correct Alarm 900.003 |
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
| | | |
|
| Management network netmask correction on a Duplex system | System | On a Duplex system, the minimum management netmask is /28. |
|
||||||
| | | .. note:: |
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
| | | To register the new software version for Host Inventory management, the host must be deleted and re-added (not merely reinstalled) |
|
| Host version mismatch | Host (re-add) | Required to correct Alarm 900.003 |
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| | | |
|
||||||
| Host memory module addition or removal | Host (re-add) | For example, use ``system host-delete``, followed by ``system host-add``, or ``system host-update``, as the host may be re-added automatically by the system on discovery. Optionally, with Deployment Manager, follow the Node replacement procedure. |
|
| | | .. note:: |
|
||||||
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
| | | To register the new software version for Host Inventory management, the host must be deleted and re-added (not merely reinstalled) |
|
||||||
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
|
| Host memory module addition or removal | Host (re-add) | For example, use ``system host-delete``, followed by ``system host-add``, or ``system host-update``, as the host may be re-added automatically by the system on discovery. |
|
||||||
|
+--------------------------------------------------------------+-----------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||||
|
|
||||||
|
.. only:: partner
|
||||||
|
|
||||||
|
.. include:: /_includes/configuration-changes-requiring-re-installation.rest
|
||||||
|
:start-after: configuration-changes-begin
|
||||||
|
:end-before: configuration-changes-end
|
||||||
|
|
||||||
|
|
||||||
.. xbooklink - Comments in tables are not respected. These rows need to be restored as the xrefs come available:
|
.. xbooklink - Comments in tables are not respected. These rows need to be restored as the xrefs come available:
|
||||||
|
|||||||
@ -30,8 +30,11 @@ System Engineering Guidelines.
|
|||||||
|
|
||||||
During an upgrade process, the CPU platform configuration will be retained.
|
During an upgrade process, the CPU platform configuration will be retained.
|
||||||
|
|
||||||
The number of cores allocated to the platform function can be changed through
|
.. only:: partner
|
||||||
the system API and thru deployment manager.
|
|
||||||
|
.. include:: /_includes/single-physical-core-for-platform-function-in-all-in-one-deployments-bec61d5a13f4.rest
|
||||||
|
:start-after: number-of-cores-begin
|
||||||
|
:end-before: number-of-cores-end
|
||||||
|
|
||||||
System API:
|
System API:
|
||||||
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user