Replicate Proxy updates in R4 install guides

This review is a follow-on to: 714538, 720252, 726468
Copied updates from R3 install guides into R4 guides.
Changed tabs to spaces in some guides.

Change-Id: I28191b0cd69c0a86d134a2fe9453928d02ce9042
Signed-off-by: MCamp859 <maryx.camp@intel.com>

doc/source/configuration/docker_proxy_config.rst

@@ -38,8 +38,8 @@ The items labeled *a* and *b* in the figure indicate two configuration files:
     *   {controller OAM gateway IP/floating IP/host IP}
     *   {controller management floating IP/host IP}
     *   {controller cluster gateway IP}
-    *   10.96.0.1
+    *   10.96.0.1 {apiserver cluster IP for Kubernetes}
-    *   10.96.0.10
+    *   10.96.0.10 {coredns cluster IP for Kubernetes}
     *   `*.cluster.local`
 
 *   Configuration file *b* lists container runtime proxy variables

doc/source/deploy_install_guides/r4_release/bare_metal/aio_duplex_install_kubernetes.rst

@@ -116,11 +116,20 @@ Bootstrap system on controller-0
         admin_username: admin
         admin_password: <admin-password>
         ansible_become_pass: <sysadmin-password>
+
+        # Add these lines to configure Docker to use a proxy server
+        # docker_http_proxy: http://my.proxy.com:1080
+        # docker_https_proxy: https://my.proxy.com:1443
+        # docker_no_proxy:
+        #   - 1.2.3.4
+
         EOF
 
    Refer to :doc:`/deploy_install_guides/r4_release/ansible_bootstrap_configs`
    for information on additional Ansible bootstrap configurations for advanced
-   Ansible bootstrap scenarios.
+   Ansible bootstrap scenarios, such as Docker proxies when deploying behind a
+   firewall, etc. Refer to :doc:`/../../configuration/docker_proxy_config` for
+   details about Docker proxy settings.
 
 #. Run the Ansible bootstrap playbook:
 
@@ -250,6 +259,18 @@ Configure controller-0
       system host-disk-list controller-0 | awk '/\/dev\/sdb/{print $2}' | xargs -i system host-stor-add controller-0 {}
       system host-stor-list controller-0
 
+#. If required, and not already done as part of bootstrap, configure Docker to
+   use a proxy server.
+
+   #. List Docker proxy parameters:
+
+      ::
+
+       system service-parameter-list platform docker
+
+   #. Refer to :doc:`/../../configuration/docker_proxy_config` for
+      details about Docker proxy settings.
+
 *************************************
 OpenStack-specific host configuration
 *************************************

doc/source/deploy_install_guides/r4_release/bare_metal/aio_simplex_install_kubernetes.rst

@@ -131,11 +131,20 @@ Bootstrap system on controller-0
         admin_username: admin
         admin_password: <admin-password>
         ansible_become_pass: <sysadmin-password>
+
+        # Add these lines to configure Docker to use a proxy server
+        # docker_http_proxy: http://my.proxy.com:1080
+        # docker_https_proxy: https://my.proxy.com:1443
+        # docker_no_proxy:
+        #   - 1.2.3.4
+
         EOF
 
    Refer to :doc:`/deploy_install_guides/r4_release/ansible_bootstrap_configs`
    for information on additional Ansible bootstrap configurations for advanced
-   Ansible bootstrap scenarios.
+   Ansible bootstrap scenarios, such as Docker proxies when deploying behind a
+   firewall, etc. Refer to :doc:`/../../configuration/docker_proxy_config` for
+   details about Docker proxy settings.
 
 #. Run the Ansible bootstrap playbook:
 
@@ -256,6 +265,18 @@ Configure controller-0
      system host-disk-list controller-0 | awk '/\/dev\/sdb/{print $2}' | xargs -i system host-stor-add controller-0 {}
      system host-stor-list controller-0
 
+#. If required, and not already done as part of bootstrap, configure Docker to
+   use a proxy server.
+
+   #. List Docker proxy parameters:
+
+      ::
+
+       system service-parameter-list platform docker
+
+   #. Refer to :doc:`/../../configuration/docker_proxy_config` for
+      details about Docker proxy settings.
+
 *************************************
 OpenStack-specific host configuration
 *************************************

doc/source/deploy_install_guides/r4_release/bare_metal/controller_storage_install_kubernetes.rst

@@ -137,11 +137,20 @@ Bootstrap system on controller-0
         admin_username: admin
         admin_password: <admin-password>
         ansible_become_pass: <sysadmin-password>
+
+        # Add these lines to configure Docker to use a proxy server
+        # docker_http_proxy: http://my.proxy.com:1080
+        # docker_https_proxy: https://my.proxy.com:1443
+        # docker_no_proxy:
+        #   - 1.2.3.4
+
         EOF
 
    Refer to :doc:`/deploy_install_guides/r4_release/ansible_bootstrap_configs`
    for information on additional Ansible bootstrap configurations for advanced
-   Ansible bootstrap scenarios.
+   Ansible bootstrap scenarios, such as Docker proxies when deploying behind a
+   firewall, etc. Refer to :doc:`/../../configuration/docker_proxy_config` for
+   details about Docker proxy settings.
 
 #. Run the Ansible bootstrap playbook:
 
@@ -206,6 +215,18 @@ Configure controller-0
 
     system storage-backend-add ceph --confirmed
 
+#. If required, and not already done as part of bootstrap, configure Docker to
+   use a proxy server.
+
+   #. List Docker proxy parameters:
+
+      ::
+
+       system service-parameter-list platform docker
+
+   #. Refer to :doc:`/../../configuration/docker_proxy_config` for
+      details about Docker proxy settings.
+
 *************************************
 OpenStack-specific host configuration
 *************************************
@@ -593,7 +614,7 @@ Add Ceph OSDs to controllers
 
    .. important::
 
-      This step requires a configured Ceph storage backend
+      This step requires a configured Ceph storage backend.
 
    ::
 
@@ -612,7 +633,7 @@ Add Ceph OSDs to controllers
 
    .. important::
 
-      This step requires a configured Ceph storage backend
+      This step requires a configured Ceph storage backend.
 
    ::
 

doc/source/deploy_install_guides/r4_release/bare_metal/dedicated_storage_install_kubernetes.rst

@@ -45,7 +45,7 @@ Configure controller-0
 Unlock controller-0
 -------------------
 
-   .. important::
+.. important::
 
   Make sure the Ceph storage backend is configured. If it is
   not configured, you will not be able to configure storage

doc/source/deploy_install_guides/r4_release/bare_metal/ironic.rst

@@ -14,8 +14,14 @@ End user applications can be deployed on bare metal servers (instead of
 virtual machines) by configuring OpenStack Ironic and deploying a pool of 1 or
 more bare metal servers.
 
+.. note::
+
+   If you are behind a corporate firewall or proxy, you need to set proxy
+   settings. Refer to :doc:`/../../configuration/docker_proxy_config` for
+   details.
+
 .. figure:: ../figures/starlingx-deployment-options-ironic.png
-   :scale: 90%
+   :scale: 50%
    :alt: Standard with Ironic deployment configuration
 
    *Figure 1: Standard with Ironic deployment configuration*

doc/source/deploy_install_guides/r4_release/desc_aio_duplex.txt

@@ -16,6 +16,12 @@ An AIO-DX configuration provides the following benefits:
   * All controller HA services go active on the remaining healthy server
   * All virtual machines are recovered on the remaining healthy server
 
+.. note::
+
+   If you are behind a corporate firewall or proxy, you need to set proxy
+   settings. Refer to :doc:`/../../configuration/docker_proxy_config` for
+   details.
+
 .. figure:: ../figures/starlingx-deployment-options-duplex.png
    :scale: 50%
    :alt: All-in-one Duplex deployment configuration

doc/source/deploy_install_guides/r4_release/desc_aio_simplex.txt

@@ -7,6 +7,12 @@ following benefits:
   single pair of physical servers
 * A storage backend solution using a single-node CEPH deployment
 
+.. note::
+
+   If you are behind a corporate firewall or proxy, you need to set proxy
+   settings. Refer to :doc:`/../../configuration/docker_proxy_config` for
+   details.
+
 .. figure:: ../figures/starlingx-deployment-options-simplex.png
    :scale: 50%
    :alt: All-in-one Simplex deployment configuration

doc/source/deploy_install_guides/r4_release/desc_controller_storage.txt

@@ -15,6 +15,12 @@ A Standard with Controller Storage configuration provides the following benefits
   * On overall worker node failure, virtual machines and containers are
     recovered on the remaining healthy worker nodes
 
+.. note::
+
+   If you are behind a corporate firewall or proxy, you need to set proxy
+   settings. Refer to :doc:`/../../configuration/docker_proxy_config` for
+   details.
+
 .. figure:: ../figures/starlingx-deployment-options-controller-storage.png
    :scale: 50%
    :alt: Standard with Controller Storage deployment configuration

doc/source/deploy_install_guides/r4_release/desc_dedicated_storage.txt

@@ -8,7 +8,14 @@ A Standard with Dedicated Storage configuration provides the following benefits:
   across the controller nodes in either active/active or active/standby mode
 * A storage back end solution using a two-to-9x node HA CEPH storage cluster
   that supports a replication factor of two or three
-* Up to four groups of 2x storage nodes, or up to three groups of 3x storage nodes
+* Up to four groups of 2x storage nodes, or up to three groups of 3x storage
+  nodes
+
+.. note::
+
+   If you are behind a corporate firewall or proxy, you need to set proxy
+   settings. Refer to :doc:`/../../configuration/docker_proxy_config` for
+   details.
 
 .. figure:: ../figures/starlingx-deployment-options-dedicated-storage.png
    :scale: 50%

doc/source/deploy_install_guides/r4_release/openstack/install.rst

@@ -36,12 +36,21 @@ Install application manifest and helm-charts
      recommended StarlingX configuration of OpenStack services.
 
 #. Apply the stx-openstack application in order to bring StarlingX OpenStack into
-   service.
+   service. If your environment is preconfigured with a proxy server, then
+   make sure HTTPS proxy is set before applying stx-openstack.
 
    ::
 
      system application-apply stx-openstack
 
+   .. note::
+
+        To set the HTTPS proxy at bootstrap time, refer to
+        `Ansible Bootstrap Configurations <https://docs.starlingx.io/deploy_install_guides/r3_release/ansible_bootstrap_configs.html#docker-proxy>`_.
+
+        To set the HTTPS proxy after installation, refer to
+        `Docker Proxy Configuration <https://docs.starlingx.io/configuration/docker_proxy_config.html>`_.
+
 #. Wait for the activation of stx-openstack to complete.
 
    This can take 5-10 minutes depending on the performance of your host machine.

doc/source/deploy_install_guides/r4_release/virtual/aio_duplex_install_kubernetes.rst

@@ -117,11 +117,20 @@ On virtual controller-0:
         admin_username: admin
         admin_password: <admin-password>
         ansible_become_pass: <sysadmin-password>
+
+        # Add these lines to configure Docker to use a proxy server
+        # docker_http_proxy: http://my.proxy.com:1080
+        # docker_https_proxy: https://my.proxy.com:1443
+        # docker_no_proxy:
+        #   - 1.2.3.4
+
         EOF
 
    Refer to :doc:`/deploy_install_guides/r4_release/ansible_bootstrap_configs`
    for information on additional Ansible bootstrap configurations for advanced
-   Ansible bootstrap scenarios.
+   Ansible bootstrap scenarios, such as Docker proxies when deploying behind a
+   firewall, etc. Refer to :doc:`/../../configuration/docker_proxy_config` for
+   details about Docker proxy settings.
 
 #. Run the Ansible bootstrap playbook:
 
@@ -233,7 +242,7 @@ On virtual controller-0:
 
    .. important::
 
-      This step requires a configured Ceph storage backend
+        This step requires a configured Ceph storage backend.
 
    ::
 
@@ -241,6 +250,19 @@ On virtual controller-0:
       system host-disk-list controller-0 | awk '/\/dev\/sdb/{print $2}' | xargs -i system host-stor-add controller-0 {}
       system host-stor-list controller-0
 
+#. If required, and not already done as part of bootstrap, configure Docker to
+   use a proxy server.
+
+   #. List Docker proxy parameters:
+
+      ::
+
+       system service-parameter-list platform docker
+
+   #. Refer to :doc:`/../../configuration/docker_proxy_config` for
+      details about Docker proxy settings.
+
+
 *************************************
 OpenStack-specific host configuration
 *************************************

doc/source/deploy_install_guides/r4_release/virtual/aio_simplex_install_kubernetes.rst

@@ -116,11 +116,20 @@ On virtual controller-0:
         admin_username: admin
         admin_password: <admin-password>
         ansible_become_pass: <sysadmin-password>
+
+        # Add these lines to configure Docker to use a proxy server
+        # docker_http_proxy: http://my.proxy.com:1080
+        # docker_https_proxy: https://my.proxy.com:1443
+        # docker_no_proxy:
+        #   - 1.2.3.4
+
         EOF
 
    Refer to :doc:`/deploy_install_guides/r4_release/ansible_bootstrap_configs`
    for information on additional Ansible bootstrap configurations for advanced
-   Ansible bootstrap scenarios.
+   Ansible bootstrap scenarios, such as Docker proxies when deploying behind a
+   firewall, etc. Refer to :doc:`/../../configuration/docker_proxy_config` for
+   details about Docker proxy settings.
 
 #. Run the Ansible bootstrap playbook:
 
@@ -232,6 +241,18 @@ On virtual controller-0:
     system host-disk-list controller-0 | awk '/\/dev\/sdb/{print $2}' | xargs -i system host-stor-add controller-0 {}
     system host-stor-list controller-0
 
+#. If required, and not already done as part of bootstrap, configure Docker to
+   use a proxy server.
+
+   #. List Docker proxy parameters:
+
+      ::
+
+       system service-parameter-list platform docker
+
+   #. Refer to :doc:`/../../configuration/docker_proxy_config` for
+      details about Docker proxy settings.
+
 *************************************
 OpenStack-specific host configuration
 *************************************

doc/source/deploy_install_guides/r4_release/virtual/controller_storage_install_kubernetes.rst

@@ -122,11 +122,20 @@ On virtual controller-0:
         admin_username: admin
         admin_password: <admin-password>
         ansible_become_pass: <sysadmin-password>
+
+        # Add these lines to configure Docker to use a proxy server
+        # docker_http_proxy: http://my.proxy.com:1080
+        # docker_https_proxy: https://my.proxy.com:1443
+        # docker_no_proxy:
+        #   - 1.2.3.4
+
         EOF
 
    Refer to :doc:`/deploy_install_guides/r4_release/ansible_bootstrap_configs`
    for information on additional Ansible bootstrap configurations for advanced
-   Ansible bootstrap scenarios.
+   Ansible bootstrap scenarios, such as Docker proxies when deploying behind a
+   firewall, etc. Refer to :doc:`/../../configuration/docker_proxy_config` for
+   details about Docker proxy settings.
 
 #. Run the Ansible bootstrap playbook:
 
@@ -197,6 +206,18 @@ On virtual controller-0:
 
     system storage-backend-add ceph --confirmed
 
+#. If required, and not already done as part of bootstrap, configure Docker to
+   use a proxy server.
+
+   #. List Docker proxy parameters:
+
+      ::
+
+       system service-parameter-list platform docker
+
+   #. Refer to :doc:`/../../configuration/docker_proxy_config` for
+      details about Docker proxy settings.
+
 *************************************
 OpenStack-specific host configuration
 *************************************

doc/source/deploy_install_guides/r4_release/virtual/dedicated_storage_install_kubernetes.rst

@@ -61,7 +61,7 @@ Configure controller-0
 Unlock controller-0
 -------------------
 
-    .. important::
+.. important::
 
    Make sure the Ceph storage backend is configured. If it is
    not configured, you will not be able to configure storage