|
| 1 | +:_mod-docs-content-type: ASSEMBLY |
| 2 | +[id="installing-restricted-networks-ibm-z-lpar"] |
| 3 | += Installing a cluster in an LPAR on {ibm-z-title} and {ibm-linuxone-title} in a restricted network |
| 4 | +include::_attributes/common-attributes.adoc[] |
| 5 | +:context: installing-restricted-networks-ibm-z-lpar |
| 6 | + |
| 7 | +toc::[] |
| 8 | + |
| 9 | +[role="_abstract"] |
| 10 | +In {product-title} version {product-version}, you can install a cluster in a logical partition (LPAR) on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision in a restricted network. |
| 11 | + |
| 12 | +[NOTE] |
| 13 | +==== |
| 14 | +While this document refers to only {ibm-z-name}, all information in it also applies to {ibm-linuxone-name}. |
| 15 | +==== |
| 16 | + |
| 17 | +[IMPORTANT] |
| 18 | +==== |
| 19 | +Additional considerations exist for non-bare metal platforms. Review the information in the |
| 20 | +link:https://access.redhat.com/articles/4207611[guidelines for deploying {product-title} on non-tested platforms] before you install an {product-title} cluster. |
| 21 | +==== |
| 22 | + |
| 23 | +== Prerequisites |
| 24 | + |
| 25 | +* You reviewed details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. |
| 26 | +* You read the documentation on xref:../../installing/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. |
| 27 | +* You xref:../../installing/disconnected_install/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[created a mirror registry for installation in a restricted network] and obtained the `imageContentSources` data for your version of {product-title}. |
| 28 | +* Before you begin the installation process, you must move or remove any existing installation files. This ensures that the required installation files are created and updated during the installation process. |
| 29 | ++ |
| 30 | +[IMPORTANT] |
| 31 | +==== |
| 32 | +Ensure that installation steps are done from a machine with access to the installation media. |
| 33 | +==== |
| 34 | +* You provisioned xref:../../storage/persistent_storage/persistent-storage-ocs.adoc#persistent-storage-ocs[persistent storage using {rh-storage}] or other supported storage protocols for your cluster. To deploy a private image registry, you must set up persistent storage with `ReadWriteMany` access. |
| 35 | +* If you use a firewall and plan to use the Telemetry service, you xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configured the firewall to allow the sites] that your cluster requires access to. |
| 36 | ++ |
| 37 | +[NOTE] |
| 38 | +==== |
| 39 | +Be sure to also review this site list if you are configuring a proxy. |
| 40 | +==== |
| 41 | + |
| 42 | +include::modules/installation-about-restricted-network.adoc[leveloffset=+1] |
| 43 | + |
| 44 | +include::modules/cluster-entitlements.adoc[leveloffset=+1] |
| 45 | + |
| 46 | +[id="installation-requirements-user-infra_{context}"] |
| 47 | +== Requirements for a cluster with user-provisioned infrastructure |
| 48 | + |
| 49 | +For a cluster that contains user-provisioned infrastructure, you must deploy all |
| 50 | +of the required machines. |
| 51 | + |
| 52 | +This section describes the requirements for deploying {product-title} on user-provisioned infrastructure. |
| 53 | + |
| 54 | +include::modules/installation-machine-requirements.adoc[leveloffset=+2] |
| 55 | +include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2] |
| 56 | + |
| 57 | +[role="_additional-resources"] |
| 58 | +.Additional resources |
| 59 | + |
| 60 | +* xref:../../scalability_and_performance/optimization/optimizing-storage.adoc#optimizing-storage[Optimizing storage] |
| 61 | + |
| 62 | +include::modules/minimum-ibm-z-system-requirements.adoc[leveloffset=+2] |
| 63 | + |
| 64 | +[role="_additional-resources"] |
| 65 | +.Additional resources |
| 66 | + |
| 67 | +* link:https://www.ibm.com/docs/en/systems-hardware/zsystems/3932-A02?topic=library-prsm-planning-guide[Processors Resource/Systems Manager Planning Guide] in {ibm-name} Documentation for PR/SM mode considerations. |
| 68 | + |
| 69 | +* link:https://www.ibm.com/docs/en/systems-hardware/zsystems/3932-A02?topic=library-dynamic-partition-manager-dpm-guide[IBM Dynamic Partition Manager (DPM) Guide] in {ibm-name} Documentation for DPM mode considerations. |
| 70 | + |
| 71 | +* link:https://www.vm.ibm.com/library/presentations/lparperf.pdf[Topics in LPAR performance] for LPAR weight management and entitlements. |
| 72 | + |
| 73 | +* xref:../../scalability_and_performance/ibm-z-recommended-host-practices.adoc#ibm-z-recommended-host-practices[Recommended host practices for {ibm-z-name} & {ibm-linuxone-name} environments] |
| 74 | + |
| 75 | +include::modules/preferred-ibm-z-system-requirements.adoc[leveloffset=+2] |
| 76 | +include::modules/csr-management.adoc[leveloffset=+2] |
| 77 | +include::modules/installation-network-user-infra.adoc[leveloffset=+2] |
| 78 | + |
| 79 | +[role="_additional-resources"] |
| 80 | +.Additional resources |
| 81 | + |
| 82 | +* xref:../../installing/install_config/installing-customizing.adoc#installation-special-config-chrony_installing-customizing[Configuring chrony time service] |
| 83 | + |
| 84 | +include::modules/installation-dns-user-infra.adoc[leveloffset=+2] |
| 85 | + |
| 86 | +include::modules/installation-load-balancing-user-infra.adoc[leveloffset=+2] |
| 87 | + |
| 88 | +include::modules/installation-infrastructure-user-infra.adoc[leveloffset=+1] |
| 89 | + |
| 90 | +include::modules/installation-user-provisioned-validating-dns.adoc[leveloffset=+1] |
| 91 | + |
| 92 | +include::modules/ssh-agent-using.adoc[leveloffset=+1] |
| 93 | + |
| 94 | +//You extract the installation program from the mirrored content. |
| 95 | + |
| 96 | +//You install the CLI on the mirror host. |
| 97 | + |
| 98 | +include::modules/installation-initializing-manual.adoc[leveloffset=+1] |
| 99 | + |
| 100 | +[role="_additional-resources"] |
| 101 | +.Additional resources |
| 102 | +* xref:../../installing/installing_ibm_z/installation-config-parameters-ibm-z.adoc#installation-config-parameters-ibm-z[Installation configuration parameters for {ibm-z-name}] |
| 103 | + |
| 104 | +include::modules/installation-bare-metal-config-yaml.adoc[leveloffset=+2] |
| 105 | + |
| 106 | +include::modules/installation-configure-proxy.adoc[leveloffset=+2] |
| 107 | + |
| 108 | +include::modules/installation-three-node-cluster.adoc[leveloffset=+2] |
| 109 | + |
| 110 | +include::modules/nw-operator-cr.adoc[leveloffset=+1] |
| 111 | + |
| 112 | +include::modules/installation-user-infra-generate-k8s-manifest-ignition.adoc[leveloffset=+1] |
| 113 | + |
| 114 | +include::modules/ibmz-configure-nbde-with-static-ip.adoc[leveloffset=+1] |
| 115 | + |
| 116 | +[role="_additional-resources"] |
| 117 | +.Additional resources |
| 118 | + |
| 119 | +* xref:../../installing/install_config/installing-customizing.adoc#installation-special-config-butane_installing-customizing[Creating machine configs with Butane] |
| 120 | + |
| 121 | +include::modules/installation-ibm-z-user-infra-machines-iso.adoc[leveloffset=+1] |
| 122 | + |
| 123 | +include::modules/installation-user-infra-machines-static-network.adoc[leveloffset=+2] |
| 124 | + |
| 125 | +include::modules/installation-installing-bare-metal.adoc[leveloffset=+1] |
| 126 | + |
| 127 | +include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1] |
| 128 | + |
| 129 | +include::modules/installation-approve-csrs.adoc[leveloffset=+1] |
| 130 | + |
| 131 | +include::modules/installation-operators-config.adoc[leveloffset=+1] |
| 132 | + |
| 133 | +include::modules/olm-restricted-networks-configuring-operatorhub.adoc[leveloffset=+2] |
| 134 | + |
| 135 | +include::modules/installation-registry-storage-config.adoc[leveloffset=+2] |
| 136 | + |
| 137 | +include::modules/registry-configuring-storage-baremetal.adoc[leveloffset=+3] |
| 138 | + |
| 139 | +include::modules/installation-registry-storage-non-production.adoc[leveloffset=+3] |
| 140 | + |
| 141 | +include::modules/installation-complete-user-infra.adoc[leveloffset=+1] |
| 142 | + |
| 143 | +[role="_additional-resources"] |
| 144 | +.Additional resources |
| 145 | + |
| 146 | +* link:https://access.redhat.com/solutions/4387261[How to generate SOSREPORT within {product-title} version 4 nodes without SSH]. |
| 147 | + |
| 148 | +[id="next-steps_ibmz-lpar-restricted"] |
| 149 | +== Next steps |
| 150 | + |
| 151 | +* xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster]. |
| 152 | +* If the mirror registry that you used to install your cluster has a trusted CA, add it to the cluster by xref:../../openshift_images/image-configuration.adoc#images-configuration-cas_image-configuration[configuring additional trust stores]. |
| 153 | +* 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]. |
| 154 | +* If necessary, see xref:../../support/remote_health_monitoring/opting-out-of-remote-health-reporting.adoc#insights-operator-register-disconnected-cluster_opting-out-remote-health-reporting[Registering your disconnected cluster] |
0 commit comments