[enterprise-4.8] OSDOCS-2014 Installing VMC IPI into restricted network

_topic_map.yml

@@ -310,6 +310,8 @@ Topics:
     File: installing-vmc-customizations
   - Name: Installing a cluster on VMC with network customizations
     File: installing-vmc-network-customizations
+  - Name: Installing a cluster on VMC in a restricted network
+    File: installing-restricted-networks-vmc
   - Name: Installing a cluster on VMC with user-provisioned infrastructure
     File: installing-vmc-user-infra
   - Name: Installing a cluster on VMC with user-provisioned infrastructure and network customizations

installing/installing-preparing.adoc

@@ -150,7 +150,7 @@ endif::openshift-origin[]
 |xref:../installing/installing_rhv/installing-rhv-restricted-network.adoc#installing-rhv-restricted-network[X]
 |
 |xref:../installing/installing_vsphere/installing-restricted-networks-installer-provisioned-vsphere.adoc#installing-restricted-networks-installer-provisioned-vsphere[X]
-|
+|xref:../installing/installing_vmc/installing-restricted-networks-vmc.adoc#installing-restricted-networks-vmc[X]
 |
 |
 

installing/installing_vmc/installing-restricted-networks-vmc.adoc

@@ -0,0 +1,77 @@
+[id="installing-restricted-networks-vmc"]
+= Installing a cluster on VMC in a restricted network
+include::modules/common-attributes.adoc[]
+:context: installing-restricted-networks-vmc
+
+toc::[]
+
+In {product-title} version {product-version}, you can install a cluster on VMware vSphere infrastructure in a restricted network by deploying it to link:https://cloud.vmware.com/vmc-aws[VMware Cloud (VMC) on AWS].
+
+Once you configure your VMC environment for {product-title} deployment, you use the {product-title} installation program from the bastion management host, co-located in the VMC environment. The installation program and control plane automates the process of deploying and managing the resources needed for the {product-title} cluster.
+
+include::modules/setting-up-vmc-for-vsphere.adoc[leveloffset=+1]
+include::modules/vmc-sizer-tool.adoc[leveloffset=+2]
+
+[id="vsphere-prerequisites_installing-restricted-networks-vmc"]
+== vSphere prerequisites
+
+* xref:../../installing/install_config/installing-restricted-networks-preparations.adoc#installing-restricted-networks-preparations[Create a registry on your mirror host] and obtain the `imageContentSources` data for your version of {product-title}.
++
+[IMPORTANT]
+====
+Because the installation media is on the mirror host, you can use that computer to complete all installation steps.
+====
+* Provision xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#installation-registry-storage-block-recreate-rollout_configuring-registry-storage-vsphere[block registry storage]. For more information on persistent storage, see xref:../../storage/understanding-persistent-storage.adoc#understanding-persistent-storage[Understanding persistent storage].
+* Review details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes.
+* If you use a firewall and plan to use telemetry, you must xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configure the firewall to allow the sites] that your cluster requires access to.
++
+[NOTE]
+====
+If you are configuring a proxy, be sure to also review this site list.
+====
+
+include::modules/installation-about-restricted-network.adoc[leveloffset=+1]
+
+include::modules/cluster-entitlements.adoc[leveloffset=+1]
+
+include::modules/installation-vsphere-infrastructure.adoc[leveloffset=+1]
+
+include::modules/installation-vsphere-installer-infra-requirements.adoc[leveloffset=+1]
+
+include::modules/ssh-agent-using.adoc[leveloffset=+1]
+
+include::modules/installation-adding-vcenter-root-certificates.adoc[leveloffset=+1]
+
+include::modules/installation-creating-image-restricted.adoc[leveloffset=+1]
+
+include::modules/installation-initializing.adoc[leveloffset=+1]
+
+include::modules/installation-configuration-parameters.adoc[leveloffset=+2]
+
+include::modules/installation-installer-provisioned-vsphere-config-yaml.adoc[leveloffset=+2]
+
+include::modules/installation-configure-proxy.adoc[leveloffset=+2]
+
+include::modules/installation-launching-installer.adoc[leveloffset=+1]
+
+include::modules/cli-installing-cli.adoc[leveloffset=+1]
+
+include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1]
+
+[id="installing-vmc-restricted-networks-installer-provisioned-customizations-registry"]
+== Creating registry storage
+
+After you install the cluster, you must create storage for the Registry Operator.
+
+include::modules/registry-removed.adoc[leveloffset=+2]
+
+include::modules/installation-registry-storage-config.adoc[leveloffset=+2]
+
+include::modules/registry-configuring-storage-vsphere.adoc[leveloffset=+3]
+
+[id="next-steps_installing-restricted-networks-vmc"]
+== Next steps
+
+* xref:../../installing/install_config/installing-customizing.adoc#installing-customizing[Customize your cluster].
+* If necessary, you can xref:../../support/remote_health_monitoring/opting-out-of-remote-health-reporting.adoc#opting-out-remote-health-reporting_opting-out-remote-health-reporting[opt out of remote health reporting].
+* xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#configuring-registry-storage-vsphere[Set up your registry and configure registry storage].

installing/installing_vsphere/installing-restricted-networks-installer-provisioned-vsphere.adoc

@@ -45,6 +45,8 @@ include::modules/installation-configuration-parameters.adoc[leveloffset=+2]
 
 include::modules/installation-installer-provisioned-vsphere-config-yaml.adoc[leveloffset=+2]
 
+include::modules/installation-configure-proxy.adoc[leveloffset=+2]
+
 include::modules/installation-launching-installer.adoc[leveloffset=+1]
 
 include::modules/cli-installing-cli.adoc[leveloffset=+1]

modules/cli-installing-cli.adoc

@@ -25,6 +25,7 @@
 // * installing/installing_vmc/installing-vmc.adoc
 // * installing/installing_vmc/installing-vmc-customizations.adoc
 // * installing/installing_vmc/installing-vmc-network-customizations.adoc
+// * installing/installing_vmc/installing-restricted-networks-vmc.adoc
 // * installing/installing_vsphere/installing-vsphere.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc

modules/cli-logging-in-kubeadmin.adoc

@@ -32,6 +32,7 @@
 // * installing/installing_vmc/installing-vmc.adoc
 // * installing/installing_vmc/installing-vmc-customizations.adoc
 // * installing/installing_vmc/installing-vmc-network-customizations.adoc
+// * installing/installing_vmc/installing-restricted-networks-vmc.adoc
 // * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
 // * installing/installing_vsphere/installing-vsphere-network-customizations.adoc
 // * installing/installing_vsphere/installing-vsphere.adoc

modules/cluster-entitlements.adoc

@@ -25,6 +25,7 @@
 // * installing/installing_aws/installing-restricted-networks-aws.adoc
 // * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
 // * installing/installing_rhv/installing-rhv-restricted-network.adoc
+// * installing/installing_vmc/installing-restricted-networks-vmc.adoc
 // * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
 // * installing/installing_vmc/installing-vmc-user-infra.adoc
 // * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
@@ -46,6 +47,9 @@ endif::[]
 ifeval::["{context}" == "installing-restricted-networks-vsphere"]
 :restricted:
 endif::[]
+ifeval::["{context}" == "installing-restricted-networks-vmc"]
+:restricted:
+endif::[]
 ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
 :restricted:
 endif::[]
@@ -90,6 +94,9 @@ endif::[]
 ifeval::["{context}" == "installing-restricted-networks-vsphere"]
 :!restricted:
 endif::[]
+ifeval::["{context}" == "installing-restricted-networks-vmc"]
+:!restricted:
+endif::[]
 ifeval::["{context}" == "installing-restricted-networks-vmc-user-infra"]
 :!restricted:
 endif::[]

modules/installation-about-restricted-network.adoc

@@ -2,6 +2,7 @@
 //
 // * installing/installing_aws/installing-restricted-networks-aws.adoc
 // * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
+// * installing/installing_vmc/installing-restricted-networks-vmc.adoc
 // * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
 // * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
 // * installing/installing_ibm_z/installing-restricted-networks-ibm-z.adoc 
@@ -25,6 +26,9 @@ endif::[]
 ifeval::["{context}" == "installing-restricted-networks-installer-provisioned-vsphere"]
 :ipi:
 endif::[]
+ifeval::["{context}" == "installing-restricted-networks-vmc"]
+:ipi:
+endif::[]
 
 [id="installation-about-restricted-networks_{context}"]
 = About installations in restricted networks
@@ -82,3 +86,6 @@ endif::[]
 ifeval::["{context}" == "installing-restricted-networks-installer-provisioned-vsphere"]
 :!ipi:
 endif::[]
+ifeval::["{context}" == "installing-restricted-networks-vmc"]
+:!ipi:
+endif::[]

modules/installation-adding-vcenter-root-certificates.adoc

@@ -3,6 +3,7 @@
 // * installing/installing_vmc/installing-vmc.adoc
 // * installing/installing_vmc/installing-vmc-customizations.adoc
 // * installing/installing_vmc/installing-vmc-network-customizations.adoc
+// * installing/installing_vmc/installing-restricted-networks-vmc.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc

modules/installation-configuration-parameters.adoc

@@ -21,6 +21,7 @@
 // * installing/installing_rhv/installing-rhv-custom.adoc
 // * installing/installing_vmc/installing-vmc-customizations.adoc
 // * installing/installing_vmc/installing-vmc-network-customizations.adoc
+// * installing/installing_vmc/installing-restricted-networks-vmc.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
 // * installing/installing_vsphere/installing-restricted-networks-installer-provisioned-vsphere.adoc
@@ -101,6 +102,9 @@ endif::[]
 ifeval::["{context}" == "installing-vmc-network-customizations"]
 :vmc:
 endif::[]
+ifeval::["{context}" == "installing-restricted-networks-vmc"]
+:vmc:
+endif::[]
 ifeval::["{context}" == "installing-openstack-installer-restricted"]
 :osp:
 :osp-custom:
@@ -928,6 +932,9 @@ endif::[]
 ifeval::["{context}" == "installing-vmc-network-customizations"]
 :!vmc:
 endif::[]
+ifeval::["{context}" == "installing-restricted-networks-vmc"]
+:!vmc:
+endif::[]
 ifeval::["{context}" == "installing-openstack-installer-restricted"]
 :!osp:
 :!osp-custom:

modules/installation-creating-image-restricted.adoc

@@ -1,6 +1,7 @@
 //Module included in the following assemblies:
 //
 // * installing/installing_openstack/installing-openstack-installer-restricted.adoc
+// * installing/installing_vmc/installing-restricted-networks-vmc.adoc
 // * installing/installing_vsphere/installing-restricted-networks-installer-provisioned-vsphere.adoc
 
 ifeval::["{context}" == "installing-openstack-installer-restricted"]
@@ -9,13 +10,16 @@ endif::[]
 ifeval::["{context}" == "installing-restricted-networks-installer-provisioned-vsphere"]
 :vsphere:
 endif::[]
+ifeval::["{context}" == "installing-restricted-networks-vmc"]
+:vmc:
+endif::[]
 
 [id="installation-creating-image-restricted_{context}"]
 = Creating the {op-system} image for restricted network installations
 
 Download the {op-system-first} image to install {product-title} on a restricted network
 ifdef::osp[{rh-openstack-first}]
-ifdef::vsphere[VMware vSphere]
+ifdef::vsphere,vmc[VMware vSphere]
 environment.
 
 .Prerequisites
@@ -39,9 +43,9 @@ your {product-title} version if they are available.
 ifdef::osp[]
 . Download the *{op-system-first} - OpenStack Image (QCOW)* image.
 endif::osp[]
-ifdef::vsphere[]
+ifdef::vsphere,vmc[]
 . Download the *{op-system-first} - vSphere* image.
-endif::vsphere[]
+endif::vsphere,vmc[]
 
 ifdef::osp[]
 . Decompress the image.
@@ -72,9 +76,9 @@ Depending on your {rh-openstack} environment, you might be able to upload the im
 If the installation program finds multiple images with the same name, it chooses one of them at random. To avoid this behavior, create unique names for resources in {rh-openstack}.
 ====
 endif::osp[]
-ifdef::vsphere[]
+ifdef::vsphere,vmc[]
 . Upload the image you downloaded to a location that is accessible from the bastion server.
-endif::vsphere[]
+endif::vsphere,vmc[]
 
 The image is now available for a restricted installation. Note the image name or location for use in {product-title} deployment.
 
@@ -84,3 +88,6 @@ endif::[]
 ifeval::["{context}" == "installing-restricted-networks-installer-provisioned-vsphere"]
 :!vsphere:
 endif::[]
+ifeval::["{context}" == "installing-restricted-networks-vmc"]
+:!vmc:
+endif::[]

modules/installation-initializing.adoc

@@ -20,6 +20,7 @@
 // * installing/installing_rhv/installing-rhv-customizations.adoc
 // * installing/installing_vmc/installing-vmc-customizations.adoc
 // * installing/installing_vmc/installing-vmc-network-customizations.adoc
+// * installing/installing_vmc/installing-restricted-networks-vmc.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
 // * installing/installing_vsphere/installing-restricted-networks-installer-provisioned-vsphere.adoc
@@ -94,10 +95,10 @@ ifeval::["{context}" == "installing-vsphere-installer-provisioned-network-custom
 :vsphere:
 endif::[]
 ifeval::["{context}" == "installing-vmc-customizations"]
-:vmc:
+:vsphere:
 endif::[]
 ifeval::["{context}" == "installing-vmc-network-customizations"]
-:vmc:
+:vsphere:
 endif::[]
 ifeval::["{context}" == "installing-openstack-installer-restricted"]
 :osp:
@@ -107,6 +108,10 @@ ifeval::["{context}" == "installing-restricted-networks-installer-provisioned-vs
 :vsphere:
 :restricted:
 endif::[]
+ifeval::["{context}" == "installing-restricted-networks-vmc"]
+:vsphere:
+:restricted:
+endif::[]
 
 [id="installation-initializing_{context}"]
 = Creating the installation configuration file
@@ -470,10 +475,10 @@ ifeval::["{context}" == "installing-vsphere-installer-provisioned-network-custom
 :!vsphere:
 endif::[]
 ifeval::["{context}" == "installing-vmc-customizations"]
-:vmc:
+:!vsphere:
 endif::[]
 ifeval::["{context}" == "installing-vmc-network-customizations"]
-:vmc:
+:!vsphere:
 endif::[]
 ifeval::["{context}" == "installing-openstack-installer-restricted"]
 :!osp:
@@ -483,3 +488,7 @@ ifeval::["{context}" == "installing-restricted-networks-installer-provisioned-vs
 :!vsphere:
 :!restricted:
 endif::[]
+ifeval::["{context}" == "installing-restricted-networks-vmc"]
+:!vsphere:
+:!restricted:
+endif::[]

modules/installation-installer-provisioned-vsphere-config-yaml.adoc

@@ -2,6 +2,7 @@
 //
 // * installing/installing_vmc/installing-vmc-customizations.adoc
 // * installing/installing_vmc/installing-vmc-network-customizations.adoc
+// * installing/installing_vmc/installing-restricted-networks-vmc.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
 // * installing/installing_vsphere/installing-restricted-networks-installer-provisioned-vsphere.adoc
@@ -15,6 +16,9 @@ endif::[]
 ifeval::["{context}" == "installing-restricted-networks-installer-provisioned-vsphere"]
 :restricted:
 endif::[]
+ifeval::["{context}" == "installing-restricted-networks-vmc"]
+:restricted:
+endif::[]
 
 [id="installation-installer-provisioned-vsphere-config-yaml_{context}"]
 = Sample install-config.yaml file for an installer-provisioned VMware vSphere cluster
@@ -150,3 +154,6 @@ endif::[]
 ifeval::["{context}" == "installing-restricted-networks-installer-provisioned-vsphere"]
 :!restricted:
 endif::[]
+ifeval::["{context}" == "installing-restricted-networks-vmc"]
+:!restricted:
+endif::[]

modules/installation-launching-installer.adoc

@@ -23,6 +23,7 @@
 // * installing/installing_vmc/installing-vmc.adoc
 // * installing/installing_vmc/installing-vmc-network-customizations.adoc
 // * installing/installing_vmc/installing-vmc-customizations.adoc
+// * installing/installing_vmc/installing-restricted-networks-vmc.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
@@ -129,6 +130,10 @@ ifeval::["{context}" == "installing-restricted-networks-installer-provisioned-vs
 :custom-config:
 :vsphere:
 endif::[]
+ifeval::["{context}" == "installing-restricted-networks-vmc"]
+:custom-config:
+:vmc:
+endif::[]
 
 [id="installation-launching-installer_{context}"]
 = Deploying the cluster
@@ -504,3 +509,7 @@ ifeval::["{context}" == "installing-restricted-networks-installer-provisioned-vs
 :!custom-config:
 :!vsphere:
 endif::[]
+ifeval::["{context}" == "installing-restricted-networks-vmc"]
+:!custom-config:
+:!vmc:
+endif::[]

modules/installation-registry-storage-config.adoc

@@ -15,6 +15,7 @@
 // * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
 // * installing/installing_vmc/installing-vmc-user-infra.adoc
 // * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc
+// * installing/installing_vmc/installing-restricted-networks-vmc.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned.adoc

modules/installation-vsphere-infrastructure.adoc

@@ -7,6 +7,7 @@
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
 // * installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
 // * installing/installing_vsphere/installing-restricted-networks-installer-provisioned-vsphere.adoc
+// * installing/installing_vmc/installing-restricted-networks-vmc.adoc
 // * installing/installing_vmc/installing-restricted-networks-vmc-user-infra.adoc
 // * installing/installing_vmc/installing-vmc-user-infra.adoc
 // * installing/installing_vmc/installing-vmc-network-customizations-user-infra.adoc