diff --git a/doc/source/deploy_install_guides/r3_release/ansible_bootstrap_configs.rst b/doc/source/deploy_install_guides/r3_release/ansible_bootstrap_configs.rst
index b87719814..998411791 100644
--- a/doc/source/deploy_install_guides/r3_release/ansible_bootstrap_configs.rst
+++ b/doc/source/deploy_install_guides/r3_release/ansible_bootstrap_configs.rst
@@ -2,13 +2,110 @@
Ansible Bootstrap Configurations
================================
-This section describes additional Ansible bootstrap configurations for advanced
-Ansible bootstrap scenarios.
+This section describes Ansible bootstrap configuration options.
.. contents::
:local:
:depth: 1
+
+.. _install-time-only-params:
+
+----------------------------
+Install-time-only parameters
+----------------------------
+
+Some Ansible bootstrap parameters can not be changed or are very difficult to
+change after installation is complete.
+
+Review the set of install-time-only parameters before installation and confirm
+that your values for these parameters are correct for the desired installation.
+
+.. note::
+
+ If you notice an incorrect install-time-only parameter value *before you
+ unlock controller-0 for the first time*, you can re-run the Ansible bootstrap
+ playbook with updated override values and the updated values will take effect.
+
+****************************
+Install-time-only parameters
+****************************
+
+**System Properties**
+
+* ``system_mode``
+* ``distributed_cloud_role``
+
+**Network Properties**
+
+* ``pxeboot_subnet``
+* ``pxeboot_start_address``
+* ``pxeboot_end_address``
+* ``management_subnet``
+* ``management_start_address``
+* ``management_end_address``
+* ``cluster_host_subnet``
+* ``cluster_host_start_address``
+* ``cluster_host_end_address``
+* ``cluster_pod_subnet``
+* ``cluster_pod_start_address``
+* ``cluster_pod_end_address``
+* ``cluster_service_subnet``
+* ``cluster_service_start_address``
+* ``cluster_service_end_address``
+* ``management_multicast_subnet``
+* ``management_multicast_start_address``
+* ``management_multicast_end_address``
+
+**Docker Proxies**
+
+* ``docker_http_proxy``
+* ``docker_https_proxy``
+* ``docker_no_proxy``
+
+**Docker Registries**
+
+* ``docker_registries``
+
+ * ``k8s.gcr.io``
+
+ * ``url``
+
+ * ``gcr.io``
+
+ * ``url``
+
+ * ``quay.io``
+
+ * ``url``
+
+ * ``docker.io``
+
+ * ``url``
+
+ * ``docker.elastic.co``
+
+ * ``url``
+
+ * ``defaults``
+
+ * ``url``
+
+ * ``secure``
+
+**Certificates**
+
+* ``k8s_root_ca_cert``
+* ``k8s_root_ca_key``
+
+**Kubernetes Parameters**
+
+* ``apiserver_oidc``
+
+ * ``client_id``
+ * ``issuer_id``
+ * ``username_claim``
+
----
IPv6
----
@@ -45,7 +142,7 @@ Example IPv6 override values are shown below:
Private registry
----------------
-To bootstrap StarlingX requires pulling container images for multiple system
+To bootstrap StarlingX you must pull container images for multiple system
services. By default these container images are pulled from public registries:
k8s.gcr.io, gcr.io, quay.io, and docker.io.
@@ -63,7 +160,7 @@ controller-0, and on :command:`system application-apply` of application packages
The `docker_registries` structure is a map of public registries and the
alternate registry values for each public registry. For each public registry the
key is a fully scoped registry name of a public registry (for example "k8s.gcr.io")
-and the alternate registry URL and username/password (if authenticated).
+and the alternate registry URL and username/password (if authenticated).
url
The fully scoped registry name (and optionally namespace/) for the alternate
diff --git a/doc/source/deploy_install_guides/r3_release/ansible_install_time_only.txt b/doc/source/deploy_install_guides/r3_release/ansible_install_time_only.txt
new file mode 100644
index 000000000..931d61a45
--- /dev/null
+++ b/doc/source/deploy_install_guides/r3_release/ansible_install_time_only.txt
@@ -0,0 +1,7 @@
+.. important::
+
+ Some Ansible bootstrap parameters can not be changed or are very difficult to change after installation is complete.
+
+ Review the set of install-time-only parameters before installation and confirm that your values for these parameters are correct for the desired installation.
+
+ Refer to :ref:`Ansible install-time-only parameters <install-time-only-params>` for details.
\ No newline at end of file
diff --git a/doc/source/deploy_install_guides/r3_release/bare_metal/aio_duplex_install_kubernetes.rst b/doc/source/deploy_install_guides/r3_release/bare_metal/aio_duplex_install_kubernetes.rst
index 7eaae796d..ce0433f3e 100644
--- a/doc/source/deploy_install_guides/r3_release/bare_metal/aio_duplex_install_kubernetes.rst
+++ b/doc/source/deploy_install_guides/r3_release/bare_metal/aio_duplex_install_kubernetes.rst
@@ -73,10 +73,12 @@ Bootstrap system on controller-0
``/usr/share/ansible/stx-ansible/playbooks/host_vars/bootstrap/default.yml``
The default configuration values for the bootstrap playbook.
- sysadmin home directory ($HOME)
+ ``sysadmin home directory ($HOME)``
The default location where Ansible looks for and imports user
configuration override files for hosts. For example: ``$HOME/<hostname>.yml``.
+ .. include:: ../ansible_install_time_only.txt
+
Specify the user configuration override file for the Ansible bootstrap
playbook using one of the following methods:
diff --git a/doc/source/deploy_install_guides/r3_release/bare_metal/aio_simplex_install_kubernetes.rst b/doc/source/deploy_install_guides/r3_release/bare_metal/aio_simplex_install_kubernetes.rst
index 69e99f458..82de9d3df 100644
--- a/doc/source/deploy_install_guides/r3_release/bare_metal/aio_simplex_install_kubernetes.rst
+++ b/doc/source/deploy_install_guides/r3_release/bare_metal/aio_simplex_install_kubernetes.rst
@@ -91,10 +91,12 @@ Bootstrap system on controller-0
``/usr/share/ansible/stx-ansible/playbooks/host_vars/bootstrap/default.yml``
The default configuration values for the bootstrap playbook.
- sysadmin home directory ($HOME)
+ ``sysadmin home directory ($HOME)``
The default location where Ansible looks for and imports user
configuration override files for hosts. For example: ``$HOME/<hostname>.yml``.
+ .. include:: ../ansible_install_time_only.txt
+
Specify the user configuration override file for the Ansible bootstrap
playbook using one of the following methods:
diff --git a/doc/source/deploy_install_guides/r3_release/bare_metal/controller_storage_install_kubernetes.rst b/doc/source/deploy_install_guides/r3_release/bare_metal/controller_storage_install_kubernetes.rst
index bad677554..fd3819d3f 100644
--- a/doc/source/deploy_install_guides/r3_release/bare_metal/controller_storage_install_kubernetes.rst
+++ b/doc/source/deploy_install_guides/r3_release/bare_metal/controller_storage_install_kubernetes.rst
@@ -95,10 +95,12 @@ Bootstrap system on controller-0
``/usr/share/ansible/stx-ansible/playbooks/host_vars/bootstrap/default.yml``
The default configuration values for the bootstrap playbook.
- sysadmin home directory ($HOME)
+ ``sysadmin home directory ($HOME)``
The default location where Ansible looks for and imports user
configuration override files for hosts. For example: ``$HOME/<hostname>.yml``.
+ .. include:: ../ansible_install_time_only.txt
+
Specify the user configuration override file for the Ansible bootstrap
playbook using one of the following methods:
diff --git a/doc/source/deploy_install_guides/r3_release/virtual/aio_duplex_install_kubernetes.rst b/doc/source/deploy_install_guides/r3_release/virtual/aio_duplex_install_kubernetes.rst
index 39a1d0d25..e86b107b5 100644
--- a/doc/source/deploy_install_guides/r3_release/virtual/aio_duplex_install_kubernetes.rst
+++ b/doc/source/deploy_install_guides/r3_release/virtual/aio_duplex_install_kubernetes.rst
@@ -81,10 +81,11 @@ On virtual controller-0:
``/usr/share/ansible/stx-ansible/playbooks/bootstrap/host_vars/default.yml``
The default configuration values for the bootstrap playbook.
- sysadmin home directory ($HOME)
+ ``sysadmin home directory ($HOME)``
The default location where Ansible looks for and imports user
configuration override files for hosts. For example: ``$HOME/<hostname>.yml``.
+ .. include:: ../ansible_install_time_only.txt
Specify the user configuration override file for the Ansible bootstrap
playbook using one of the following methods:
diff --git a/doc/source/deploy_install_guides/r3_release/virtual/aio_simplex_install_kubernetes.rst b/doc/source/deploy_install_guides/r3_release/virtual/aio_simplex_install_kubernetes.rst
index 9828701e0..3bf9513ef 100644
--- a/doc/source/deploy_install_guides/r3_release/virtual/aio_simplex_install_kubernetes.rst
+++ b/doc/source/deploy_install_guides/r3_release/virtual/aio_simplex_install_kubernetes.rst
@@ -81,10 +81,11 @@ On virtual controller-0:
``/usr/share/ansible/stx-ansible/playbooks/bootstrap/host_vars/default.yml``
The default configuration values for the bootstrap playbook.
- sysadmin home directory ($HOME)
+ ``sysadmin home directory ($HOME)``
The default location where Ansible looks for and imports user
configuration override files for hosts. For example: ``$HOME/<hostname>.yml``.
+ .. include:: ../ansible_install_time_only.txt
Specify the user configuration override file for the Ansible bootstrap
playbook using one of the following methods:
diff --git a/doc/source/deploy_install_guides/r3_release/virtual/controller_storage_install_kubernetes.rst b/doc/source/deploy_install_guides/r3_release/virtual/controller_storage_install_kubernetes.rst
index 1a91219ac..8e20999ea 100644
--- a/doc/source/deploy_install_guides/r3_release/virtual/controller_storage_install_kubernetes.rst
+++ b/doc/source/deploy_install_guides/r3_release/virtual/controller_storage_install_kubernetes.rst
@@ -86,10 +86,11 @@ On virtual controller-0:
``/usr/share/ansible/stx-ansible/playbooks/bootstrap/host_vars/default.yml``
The default configuration values for the bootstrap playbook.
- sysadmin home directory ($HOME)
+ ``sysadmin home directory ($HOME)``
The default location where Ansible looks for and imports user
configuration override files for hosts. For example: ``$HOME/<hostname>.yml``.
+ .. include:: ../ansible_install_time_only.txt
Specify the user configuration override file for the Ansible bootstrap
playbook using one of the following methods: