From 3a9f1c7cf13b41551a5fa2ad4cbad8fe787fca98 Mon Sep 17 00:00:00 2001 From: Silke Niemann Date: Wed, 22 Jul 2026 13:23:55 +0200 Subject: [PATCH] IBM Z CQA work --- .../installing_ibm_z/ibmz-post-install.adoc | 17 +++--- .../installation-config-parameters-ibm-z.adoc | 1 + .../preparing-to-install-on-ibm-z.adoc | 55 ++++++++++++++----- .../upi/installing-ibm-z-kvm.adoc | 31 ++++------- .../upi/installing-ibm-z-lpar.adoc | 27 ++++----- .../upi/installing-ibm-z-reqs.adoc | 20 ++++--- .../upi/installing-ibm-z.adoc | 30 ++++------ ...talling-restricted-networks-ibm-z-kvm.adoc | 38 ++++--------- ...alling-restricted-networks-ibm-z-lpar.adoc | 37 ++++--------- .../installing-restricted-networks-ibm-z.adoc | 39 ++++--------- .../upi/upi-ibm-z-preparing-to-install.adoc | 10 +++- ...bm-z-configure-boot-volume-encryption.adoc | 3 +- modules/ibm-z-configure-devices-manually.adoc | 3 +- modules/ibm-z-configure-encryption-kvm.adoc | 3 +- .../ibm-z-enable-multipathing-fcp-luns.adoc | 5 +- modules/ibm-z-roce-network-cards.adoc | 10 ++++ modules/ibm-z-secure-execution.adoc | 16 +++--- ...ibm-z-kvm-user-infra-installing-rhcos.adoc | 3 + modules/installation-requirements-ibm-z.adoc | 13 +++-- ...erred-installation-requirements-ibm-z.adoc | 9 ++- .../prereqs-ibm-z-kvm-upi-disconnected.adoc | 29 ++++++++++ modules/prereqs-ibm-z-kvm-upi.adoc | 23 ++++++++ modules/prereqs-ibm-z-upi-disconnected.adoc | 29 ++++++++++ modules/prereqs-ibm-z-upi.adoc | 23 ++++++++ 24 files changed, 287 insertions(+), 187 deletions(-) create mode 100644 modules/ibm-z-roce-network-cards.adoc create mode 100644 modules/prereqs-ibm-z-kvm-upi-disconnected.adoc create mode 100644 modules/prereqs-ibm-z-kvm-upi.adoc create mode 100644 modules/prereqs-ibm-z-upi-disconnected.adoc create mode 100644 modules/prereqs-ibm-z-upi.adoc diff --git a/installing/installing_ibm_z/ibmz-post-install.adoc b/installing/installing_ibm_z/ibmz-post-install.adoc index dca7efd0bf5d..c277144abb17 100644 --- a/installing/installing_ibm_z/ibmz-post-install.adoc +++ b/installing/installing_ibm_z/ibmz-post-install.adoc @@ -6,6 +6,7 @@ include::_attributes/common-attributes.adoc[] toc::[] +[role="_abstract"] After installing {product-title}, you can configure additional devices for your cluster in an {ibm-z-name} or {ibm-linuxone-name} environment, which is installed with z/VM. The following devices can be configured: * Fibre Channel Protocol (FCP) host @@ -13,7 +14,7 @@ After installing {product-title}, you can configure additional devices for your * DASD * qeth -You can configure devices by adding udev rules using the Machine Config Operator (MCO) or you can configure devices manually. +You can configure devices by adding udev rules by using the Machine Config Operator (MCO) or you can configure devices manually. [NOTE] ==== @@ -27,7 +28,8 @@ The procedures described here apply only to z/VM installations. If you have inst include::modules/ibm-z-configure-devices-mco.adoc[leveloffset=+1] -.Next steps +[role="_additional-resources"] +.Additional resources * xref:../../storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[Install and configure the Local Storage Operator] * xref:../../networking/k8s_nmstate/k8s-nmstate-updating-node-network-config.adoc#k8s-nmstate-updating-node-network-config[Observing and updating the node network state and configuration] @@ -37,17 +39,16 @@ include::modules/ibm-z-configure-devices-manually.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* link:https://www.ibm.com/docs/en/linux-on-systems?topic=commands-chzdev[chzdev - Configure {ibm-z-name} devices] ({ibm-name} Documentation) +* link:https://www.ibm.com/docs/en/linux-on-systems?topic=commands-chzdev[chzdev - Configure {ibm-z-name} devices ({ibm-name} Documentation)] -* link:https://www.ibm.com/docs/en/linux-on-systems?topic=linuxonibm/com.ibm.linux.z.ludd/ludd_c_perscfg.html[Persistent device configuration] ({ibm-name} Documentation) +* link:https://www.ibm.com/docs/en/linux-on-systems?topic=linuxonibm/com.ibm.linux.z.ludd/ludd_c_perscfg.html[Persistent device configuration ({ibm-name} Documentation)] -[id="roce-network-cards"] -== RoCE network Cards -RoCE (RDMA over Converged Ethernet) network cards do not need to be enabled and their interfaces can be configured with the Kubernetes NMState Operator whenever they are available in the node. For example, RoCE network cards are available if they are attached in a z/VM environment or passed through in a {op-system-base} KVM environment. +include::modules/ibm-z-roce-network-cards.adoc[leveloffset=+1] include::modules/ibm-z-enable-multipathing-fcp-luns.adoc[leveloffset=+1] -.Next steps +[role="_additional-resources"] +.Additional resources * xref:../../storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[Install and configure the Local Storage Operator] * xref:../../networking/k8s_nmstate/k8s-nmstate-updating-node-network-config.adoc#k8s-nmstate-updating-node-network-config[Observing and updating the node network state and configuration] diff --git a/installing/installing_ibm_z/installation-config-parameters-ibm-z.adoc b/installing/installing_ibm_z/installation-config-parameters-ibm-z.adoc index 8b71ef1abef9..e45ba328fbff 100644 --- a/installing/installing_ibm_z/installation-config-parameters-ibm-z.adoc +++ b/installing/installing_ibm_z/installation-config-parameters-ibm-z.adoc @@ -7,6 +7,7 @@ include::_attributes/common-attributes.adoc[] toc::[] +[role="_abstract"] Before you deploy an {product-title} cluster, you provide a customized `install-config.yaml` installation configuration file that describes the details for your environment. [NOTE] diff --git a/installing/installing_ibm_z/preparing-to-install-on-ibm-z.adoc b/installing/installing_ibm_z/preparing-to-install-on-ibm-z.adoc index 1615a98a4b6d..130acdc538fc 100644 --- a/installing/installing_ibm_z/preparing-to-install-on-ibm-z.adoc +++ b/installing/installing_ibm_z/preparing-to-install-on-ibm-z.adoc @@ -6,7 +6,8 @@ include::_attributes/common-attributes.adoc[] toc::[] -You can install an {product-title} cluster on {ibm-z-name} and {ibm-linuxone-name} using a variety of different installation methods. +[role="_abstract"] +You can install an {product-title} cluster on {ibm-z-name} and {ibm-linuxone-name} by using a variety of different installation methods. Each method has qualities that can make them more suitable for different use cases, such as installing a cluster in a disconnected environment or installing a cluster with minimal configuration and provisioning. //moved prerequisites to ibm z cluster installation assemblies zvm, lpar, kvm @@ -21,9 +22,9 @@ While this document refers only to {ibm-z-name}, all information in it also appl The {product-title} installation program offers the following methods for deploying a cluster on {ibm-z-name}: -* *Interactive*: You can deploy a cluster with the web-based link:https://access.redhat.com/documentation/en-us/assisted_installer_for_openshift_container_platform[{ai-full}]. This method requires no setup for the installer, and is ideal for connected environments like {ibm-z-name}. +* *Interactive*: You can deploy a cluster with the web-based {ai-full}. This method requires no setup for the installation program, and is ideal for connected environments such as {ibm-z-name}. -* *Local Agent-based*: You can deploy a cluster locally with the xref:../../installing/installing_with_agent_based_installer/preparing-to-install-with-agent-based-installer.adoc#preparing-to-install-with-agent-based-installer[Agent-based Installer]. It provides many of the benefits of the {ai-full}, but you must download and configure the link:https://console.redhat.com/openshift/install/ibmz/agent-based[Agent-based Installer] first. Configuration is done with a command-line interface (CLI). This approach is ideal for disconnected networks. +* *Local Agent-based*: You can deploy a cluster locally with the Agent-based Installer. It provides many of the benefits of the {ai-full}, but you must download and configure the Agent-based Installer first. Configuration is done with a command-line interface (CLI). This approach is ideal for disconnected networks. * *Full control*: You can deploy a cluster on infrastructure that you prepare and maintain, which provides maximum customizability. You can deploy clusters in connected or disconnected environments. @@ -36,31 +37,31 @@ The {product-title} installation program offers the following methods for deploy |{ibm-z-name} with z/VM |✓ |✓ -|xref:../../installing/installing_ibm_z/upi/installing-ibm-z.adoc#installing-ibm-z[✓] +|✓ | |Restricted network {ibm-z-name} with z/VM | |✓ -|xref:../../installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z.adoc#installing-restricted-networks-ibm-z[✓] +|✓ | |{ibm-z-name} with {op-system-base} KVM |✓ |✓ -|xref:../../installing/installing_ibm_z/upi/installing-ibm-z-kvm.adoc#installing-ibm-z-kvm[✓] +|✓ | |Restricted network {ibm-z-name} with {op-system-base} KVM | |✓ -|xref:../../installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-kvm.adoc#installing-restricted-networks-ibm-z-kvm[✓] +|✓ | |{ibm-z-name} in an LPAR |✓ |✓ -|xref:../../installing/installing_ibm_z/upi/installing-ibm-z-lpar.adoc#installing-ibm-z-lpar[✓] +|✓ | |Restricted network {ibm-z-name} in an LPAR @@ -70,7 +71,7 @@ The {product-title} installation program offers the following methods for deploy | |=== -For more information about the installation process, see the xref:../../architecture/architecture-installation.adoc#installation-process_architecture-installation[Installation process]. +For more information about the installation process, see Installation process in the Additional resources section. == User-provisioned infrastructure installation of {product-title} on {ibm-z-title} @@ -81,14 +82,38 @@ User-provisioned infrastructure requires the user to provision all resources req The steps for performing a user-provisioned infrastructure installation are provided as an example only. Installing a cluster with infrastructure you provide requires knowledge of the {ibm-z-name} platform and the installation process of {product-title}. Use the user-provisioned infrastructure installation instructions as a guide; you are free to create the required resources through other methods. ==== -* **xref:../../installing/installing_ibm_z/upi/installing-ibm-z.adoc#installing-ibm-z[Installing a cluster with z/VM on {ibm-z-name} and {ibm-linuxone-name}]**: You can install {product-title} with z/VM on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision. +* *Installing a cluster with z/VM on {ibm-z-name} and {ibm-linuxone-name}*: You can install {product-title} with z/VM on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision. + +* *Installing a cluster with z/VM on {ibm-z-title} and {ibm-linuxone-title} in a disconnected environment*: You can install {product-title} with z/VM on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision in a restricted or disconnected network by using an internal mirror of the installation release content. You can use this method to install a cluster that does not require an active internet connection to obtain the software components. You can also use this installation method to ensure that your clusters only use container images that satisfy your organizational controls on external content. + +* *Installing a cluster with {op-system-base} KVM on {ibm-z-name} and {ibm-linuxone-name}*: You can install {product-title} with KVM on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision. + +* *Installing a cluster with {op-system-base} KVM on {ibm-z-name} and {ibm-linuxone-name} in a disconnected environment*: You can install {product-title} with {op-system-base} KVM on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision in a restricted or disconnected network by using an internal mirror of the installation release content. You can use this method to install a cluster that does not require an active internet connection to obtain the software components. You can also use this installation method to ensure that your clusters only use container images that satisfy your organizational controls on external content. + +* *Installing a cluster in an LPAR on {ibm-z-name} and {ibm-linuxone-name}*: You can install {product-title} in a logical partition (LPAR) on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision. + +* *Installing a cluster in an LPAR on {ibm-z-name} and {ibm-linuxone-name} in a disconnected environment*: You can install {product-title} in an LPAR on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision in a restricted or disconnected network by using an internal mirror of the installation release content. You can use this method to install a cluster that does not require an active internet connection to obtain the software components. You can also use this installation method to ensure that your clusters only use container images that satisfy your organizational controls on external content. + +[role="_additional-resources"] +[id="additional-resources_{context}"] +== Additional resources + +* link:https://access.redhat.com/documentation/en-us/assisted_installer_for_openshift_container_platform[{ai-full}] + +* xref:../../installing/installing_with_agent_based_installer/preparing-to-install-with-agent-based-installer.adoc#preparing-to-install-with-agent-based-installer[Preparing to install with the Agent-based Installer] + +* link:https://console.redhat.com/openshift/install/ibmz/agent-based[Agent-based Installer for {ibm-z-name}] + +* xref:../../architecture/architecture-installation.adoc#installation-process_architecture-installation[Installation process] + +* xref:../../installing/installing_ibm_z/upi/installing-ibm-z.adoc#installing-ibm-z[Installing a cluster with z/VM on {ibm-z-name} and {ibm-linuxone-name}] -* **xref:../../installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z.adoc#installing-restricted-networks-ibm-z[Installing a cluster with z/VM on {ibm-z-title} and {ibm-linuxone-title} in a disconnected environment]**: You can install {product-title} with z/VM on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision in a restricted or disconnected network by using an internal mirror of the installation release content. You can use this method to install a cluster that does not require an active internet connection to obtain the software components. You can also use this installation method to ensure that your clusters only use container images that satisfy your organizational controls on external content. +* xref:../../installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z.adoc#installing-restricted-networks-ibm-z[Installing a cluster with z/VM on {ibm-z-title} and {ibm-linuxone-title} in a disconnected environment] -* **xref:../../installing/installing_ibm_z/upi/installing-ibm-z-kvm.adoc#installing-ibm-z-kvm[Installing a cluster with RHEL KVM on {ibm-z-name} and {ibm-linuxone-name}]**: You can install {product-title} with KVM on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision. +* xref:../../installing/installing_ibm_z/upi/installing-ibm-z-kvm.adoc#installing-ibm-z-kvm[Installing a cluster with {op-system-base} KVM on {ibm-z-name} and {ibm-linuxone-name}] -* **xref:../../installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-kvm.adoc#installing-restricted-networks-ibm-z-kvm[Installing a cluster with {op-system-base} KVM on {ibm-z-name} and {ibm-linuxone-name} in a disconnected environment]**: You can install {product-title} with {op-system-base} KVM on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision in a restricted or disconnected network by using an internal mirror of the installation release content. You can use this method to install a cluster that does not require an active internet connection to obtain the software components. You can also use this installation method to ensure that your clusters only use container images that satisfy your organizational controls on external content. +* xref:../../installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-kvm.adoc#installing-restricted-networks-ibm-z-kvm[Installing a cluster with {op-system-base} KVM on {ibm-z-name} and {ibm-linuxone-name} in a disconnected environment] -* **xref:../../installing/installing_ibm_z/upi/installing-ibm-z-lpar.adoc#installing-ibm-z-lpar[Installing a cluster in an LPAR on {ibm-z-name} and {ibm-linuxone-name}]**: You can install {product-title} in a logical partition (LPAR) on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision. +* xref:../../installing/installing_ibm_z/upi/installing-ibm-z-lpar.adoc#installing-ibm-z-lpar[Installing a cluster in an LPAR on {ibm-z-name} and {ibm-linuxone-name}] -* **xref:../../installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-lpar.adoc#installing-restricted-networks-ibm-z-lpar[Installing a cluster in an LPAR on {ibm-z-name} and {ibm-linuxone-name} in a disconnected environment]**: You can install {product-title} in an LPAR on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision in a restricted or disconnected network by using an internal mirror of the installation release content. You can use this method to install a cluster that does not require an active internet connection to obtain the software components. You can also use this installation method to ensure that your clusters only use container images that satisfy your organizational controls on external content. +* xref:../../installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-lpar.adoc#installing-restricted-networks-ibm-z-lpar[Installing a cluster in an LPAR on {ibm-z-name} and {ibm-linuxone-name} in a disconnected environment] diff --git a/installing/installing_ibm_z/upi/installing-ibm-z-kvm.adoc b/installing/installing_ibm_z/upi/installing-ibm-z-kvm.adoc index 9812b1de4f9e..17ac62c49703 100644 --- a/installing/installing_ibm_z/upi/installing-ibm-z-kvm.adoc +++ b/installing/installing_ibm_z/upi/installing-ibm-z-kvm.adoc @@ -7,29 +7,22 @@ include::_attributes/common-attributes.adoc[] toc::[] [role="_abstract"] -In {product-title} version {product-version}, you can install a cluster on -{ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision. +In {product-title} version {product-version}, you can install a cluster on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision. [NOTE] ==== While this document refers only to {ibm-z-name}, all information in it also applies to {ibm-linuxone-name}. ==== -[id="prerequisites-ibm-z-kvm_{context}"] -== Prerequisites +include::modules/prereqs-ibm-z-kvm-upi.adoc[leveloffset=+1] -* You have completed the tasks in xref:../../../installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc#upi-ibm-z-preparing-to-install[Preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure]. -* You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. -* You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* Before you begin the installation process, you must clean the installation directory. This ensures that the required installation files are created and updated during the installation process. -* 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. -* If you use a firewall, you xref:../../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[configured it to allow the sites] that your cluster requires access to. -+ -[NOTE] -==== -Be sure to also review this site list if you are configuring a proxy. -==== -* You provisioned a {op-system-base} Kernel Virtual Machine (KVM) system that is hosted on the logical partition (LPAR) and based on {op-system-base} 8.6 or later. See link:https://access.redhat.com/support/policy/updates/errata#RHEL8_and_9_Life_Cycle[Red Hat Enterprise Linux 8 and 9 Life Cycle]. +[role="_additional-resources"] +.Additional resources +* xref:../../../installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc#upi-ibm-z-preparing-to-install[Preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure] +* xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] +* xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[Selecting a cluster installation method and preparing it for users] +* xref:../../../storage/persistent_storage/persistent-storage-ocs.adoc#persistent-storage-ocs[Persistent storage using {rh-storage}] +* xref:../../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[Configuring your firewall] include::modules/installation-infrastructure-user-infra.adoc[leveloffset=+1] @@ -119,7 +112,8 @@ include::modules/installation-complete-user-infra.adoc[leveloffset=+1] include::modules/cluster-telemetry.adoc[leveloffset=+1] [role="_additional-resources"] -.Additional resources +[id="additional-resources_{context}"] +== Additional resources * xref:../../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] @@ -127,7 +121,4 @@ include::modules/cluster-telemetry.adoc[leveloffset=+1] * xref:../../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting] -[id="next-steps_ibm-z-kvm"] -== Next steps - * xref:../../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster] \ No newline at end of file diff --git a/installing/installing_ibm_z/upi/installing-ibm-z-lpar.adoc b/installing/installing_ibm_z/upi/installing-ibm-z-lpar.adoc index 475d774c7d18..b43a6a30a73d 100644 --- a/installing/installing_ibm_z/upi/installing-ibm-z-lpar.adoc +++ b/installing/installing_ibm_z/upi/installing-ibm-z-lpar.adoc @@ -14,20 +14,15 @@ In {product-title} version {product-version}, you can install a cluster in a log While this document refers only to {ibm-z-name}, all information in it also applies to {ibm-linuxone-name}. ==== -[id="prerequisites-ibm-z-lpar_{context}"] -== Prerequisites +include::modules/prereqs-ibm-z-upi.adoc[leveloffset=+1] -* You have completed the tasks in xref:../../../installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc#upi-ibm-z-preparing-to-install[Preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure]. -* You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. -* You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* Before you begin the installation process, you must clean the installation directory. This ensures that the required installation files are created and updated during the installation process. -* 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. -* If you use a firewall, you xref:../../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[configured it to allow the sites] that your cluster requires access to. - -[NOTE] -==== -Be sure to also review this site list if you are configuring a proxy. -==== +[role="_additional-resources"] +.Additional resources +* xref:../../../installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc#upi-ibm-z-preparing-to-install[Preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure] +* xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] +* xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[Selecting a cluster installation method and preparing it for users] +* xref:../../../storage/persistent_storage/persistent-storage-ocs.adoc#persistent-storage-ocs[Persistent storage using {rh-storage}] +* xref:../../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[Configuring your firewall] include::modules/installation-infrastructure-user-infra.adoc[leveloffset=+1] @@ -102,7 +97,8 @@ include::modules/installation-complete-user-infra.adoc[leveloffset=+1] include::modules/cluster-telemetry.adoc[leveloffset=+1] [role="_additional-resources"] -.Additional resources +[id="additional-resources_{context}"] +== Additional resources * xref:../../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] @@ -110,9 +106,6 @@ include::modules/cluster-telemetry.adoc[leveloffset=+1] * xref:../../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting] -[id="next-steps_ibm-z-lpar"] -== Next steps - * xref:../../../machine_configuration/machine-configs-configure.adoc#rhcos-enabling-multipath-day-2_machine-configs-configure[Enabling multipathing with kernel arguments on {op-system}] * xref:../../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster] \ No newline at end of file diff --git a/installing/installing_ibm_z/upi/installing-ibm-z-reqs.adoc b/installing/installing_ibm_z/upi/installing-ibm-z-reqs.adoc index 0b52f91542c6..1ded8382893c 100644 --- a/installing/installing_ibm_z/upi/installing-ibm-z-reqs.adoc +++ b/installing/installing_ibm_z/upi/installing-ibm-z-reqs.adoc @@ -6,6 +6,7 @@ include::_attributes/common-attributes.adoc[] toc::[] +[role="_abstract"] Before you begin an installation on {ibm-z-name} infrastructure, be sure that your {ibm-z-name} environment meets the following installation requirements. For a cluster that contains user-provisioned infrastructure, you must deploy all of the required machines. @@ -15,17 +16,18 @@ include::modules/installation-machine-requirements.adoc[leveloffset=+1] include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2] [role="_additional-resources"] -.Additional resources +[id="additional-resources_resource-requirements_{context}"] +== Additional resources -* See link:https://www.ibm.com/docs/en/zvm/latest?topic=networks-bridging-hipersockets-lan-zvm-virtual-switch[Bridging a HiperSockets LAN with a z/VM Virtual Switch] in {ibm-name} Documentation. +* link:https://www.ibm.com/docs/en/zvm/latest?topic=networks-bridging-hipersockets-lan-zvm-virtual-switch[Bridging a HiperSockets LAN with a z/VM Virtual Switch ({ibm-name} Documentation)] -* See link:https://public.dhe.ibm.com/software/dw/linux390/perf/zvm_hpav00.pdf[Scaling HyperPAV alias devices on Linux guests on z/VM] for performance optimization. +* link:https://public.dhe.ibm.com/software/dw/linux390/perf/zvm_hpav00.pdf[Scaling HyperPAV alias devices on Linux guests on z/VM] -* 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. +* link:https://www.ibm.com/docs/en/systems-hardware/zsystems/3932-A02?topic=library-prsm-planning-guide[Processors Resource/Systems Manager Planning Guide ({ibm-name} Documentation)] -* 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. +* 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 ({ibm-name} Documentation)] -* link:https://www.vm.ibm.com/library/presentations/lparperf.pdf[Topics in LPAR performance] for LPAR weight management and entitlements. +* link:https://www.vm.ibm.com/library/presentations/lparperf.pdf[Topics in LPAR performance] * 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] @@ -34,7 +36,8 @@ include::modules/installation-requirements-ibm-z.adoc[leveloffset=+2] include::modules/preferred-installation-requirements-ibm-z.adoc[leveloffset=+2] [role="_additional-resources"] -.Additional resources +[id="additional-resources_storage_{context}"] +== Additional resources * xref:../../../scalability_and_performance/optimization/optimizing-storage.adoc#optimizing-storage[Optimizing storage] @@ -43,7 +46,8 @@ include::modules/csr-management.adoc[leveloffset=+2] include::modules/installation-network-user-infra.adoc[leveloffset=+2] [role="_additional-resources"] -.Additional resources +[id="additional-resources_network_{context}"] +== Additional resources * xref:../../../installing/install_config/installing-customizing.adoc#installation-special-config-chrony_installing-customizing[Configuring chrony time service] diff --git a/installing/installing_ibm_z/upi/installing-ibm-z.adoc b/installing/installing_ibm_z/upi/installing-ibm-z.adoc index 47461727bfb8..ba94606ec4b0 100644 --- a/installing/installing_ibm_z/upi/installing-ibm-z.adoc +++ b/installing/installing_ibm_z/upi/installing-ibm-z.adoc @@ -7,28 +7,22 @@ include::_attributes/common-attributes.adoc[] toc::[] [role="_abstract"] -In {product-title} version {product-version}, you can install a cluster on -{ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision. +In {product-title} version {product-version}, you can install a cluster on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision. [NOTE] ==== While this document refers only to {ibm-z-name}, all information in it also applies to {ibm-linuxone-name}. ==== -[id="prerequisites-ibm-z_{context}"] -== Prerequisites +include::modules/prereqs-ibm-z-upi.adoc[leveloffset=+1] -* You have completed the tasks in xref:../../../installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc#upi-ibm-z-preparing-to-install[Preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure]. -* You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. -* You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* Before you begin the installation process, you must clean the installation directory. This ensures that the required installation files are created and updated during the installation process. -* 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. -* If you use a firewall, you xref:../../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[configured it to allow the sites] that your cluster requires access to. - -[NOTE] -==== -Be sure to also review this site list if you are configuring a proxy. -==== +[role="_additional-resources"] +.Additional resources +* xref:../../../installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc#upi-ibm-z-preparing-to-install[Preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure] +* xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] +* xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[Selecting a cluster installation method and preparing it for users] +* xref:../../../storage/persistent_storage/persistent-storage-ocs.adoc#persistent-storage-ocs[Persistent storage using {rh-storage}] +* xref:../../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[Configuring your firewall] include::modules/installation-infrastructure-user-infra.adoc[leveloffset=+1] @@ -103,7 +97,8 @@ include::modules/installation-complete-user-infra.adoc[leveloffset=+1] include::modules/cluster-telemetry.adoc[leveloffset=+1] [role="_additional-resources"] -.Additional resources +[id="additional-resources_{context}"] +== Additional resources * xref:../../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] @@ -111,9 +106,6 @@ include::modules/cluster-telemetry.adoc[leveloffset=+1] * xref:../../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting] -[id="next-steps_ibm-z-vm"] -== Next steps - * xref:../../../machine_configuration/machine-configs-configure.adoc#rhcos-enabling-multipath-day-2_machine-configs-configure[Enabling multipathing with kernel arguments on {op-system}] * xref:../../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster] diff --git a/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-kvm.adoc b/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-kvm.adoc index 2902171f6195..0241f0c2b910 100644 --- a/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-kvm.adoc +++ b/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-kvm.adoc @@ -7,35 +7,23 @@ include::_attributes/common-attributes.adoc[] toc::[] [role="_abstract"] -In {product-title} version {product-version}, you can install a cluster on -{ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision in a disconnected environment. +In {product-title} version {product-version}, you can install a cluster on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision in a disconnected environment. [NOTE] ==== While this document refers to only {ibm-z-name}, all information in it also applies to {ibm-linuxone-name}. ==== -[id="prerequisites-ibm-z-kvm-restricted_{context}"] -== Prerequisites +include::modules/prereqs-ibm-z-kvm-upi-disconnected.adoc[leveloffset=+1] -* You have completed the tasks in xref:../../../installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc#upi-ibm-z-preparing-to-install[Preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure]. -* You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. -* You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. -* You must move or remove any existing installation files, before you begin the installation process. This ensures that the required installation files are created and updated during the installation process. -+ -[IMPORTANT] -==== -Ensure that installation steps are done from a machine with access to the installation media. -==== -* 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. -* If you use a firewall, you xref:../../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[configured it to allow the sites] that your cluster requires access to. -+ -[NOTE] -==== -Be sure to also review this site list if you are configuring a proxy. -==== -* You provisioned a {op-system-base} Kernel Virtual Machine (KVM) system that is hosted on the logical partition (LPAR) and based on {op-system-base} 8.6 or later. See link:https://access.redhat.com/support/policy/updates/errata#RHEL8_and_9_Life_Cycle[Red Hat Enterprise Linux 8 and 9 Life Cycle]. +[role="_additional-resources"] +.Additional resources +* xref:../../../installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc#upi-ibm-z-preparing-to-install[Preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure] +* xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] +* xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[Selecting a cluster installation method and preparing it for users] +* xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation] +* xref:../../../storage/persistent_storage/persistent-storage-ocs.adoc#persistent-storage-ocs[Persistent storage using {rh-storage}] +* xref:../../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[Configuring your firewall] include::modules/installation-about-restricted-network.adoc[leveloffset=+1] @@ -123,7 +111,8 @@ include::modules/installation-registry-storage-non-production.adoc[leveloffset=+ include::modules/installation-complete-user-infra.adoc[leveloffset=+1] [role="_additional-resources"] -.Additional resources +[id="additional-resources_{context}"] +== Additional resources * link:https://access.redhat.com/solutions/4387261[How to generate SOSREPORT within {product-title} version 4 nodes without SSH] @@ -132,7 +121,4 @@ include::modules/installation-complete-user-infra.adoc[leveloffset=+1] * xref:../../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting] -[id="next-steps_ibm-z-kvm-restricted"] -== Next steps - * xref:../../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster] diff --git a/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-lpar.adoc b/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-lpar.adoc index ba26987085ec..65afb3dcd52b 100644 --- a/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-lpar.adoc +++ b/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-lpar.adoc @@ -14,26 +14,16 @@ In {product-title} version {product-version}, you can install a cluster in a log While this document refers to only {ibm-z-name}, all information in it also applies to {ibm-linuxone-name}. ==== -[id="prerequisites-ibm-z-lpar-restricted_{context}"] -== Prerequisites - -* You have completed the tasks in xref:../../../installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc#upi-ibm-z-preparing-to-install[Preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure]. -* You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. -* You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. -* 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. -+ -[IMPORTANT] -==== -Ensure that installation steps are done from a machine with access to the installation media. -==== -* 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. -* If you use a firewall and plan to use the Telemetry service, you xref:../../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[configured the firewall to allow the sites] that your cluster requires access to. -+ -[NOTE] -==== -Be sure to also review this site list if you are configuring a proxy. -==== +include::modules/prereqs-ibm-z-upi-disconnected.adoc[leveloffset=+1] + +[role="_additional-resources"] +.Additional resources +* xref:../../../installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc#upi-ibm-z-preparing-to-install[Preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure] +* xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] +* xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[Selecting a cluster installation method and preparing it for users] +* xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation] +* xref:../../../storage/persistent_storage/persistent-storage-ocs.adoc#persistent-storage-ocs[Persistent storage using {rh-storage}] +* xref:../../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[Configuring your firewall] include::modules/installation-about-restricted-network.adoc[leveloffset=+1] @@ -110,7 +100,8 @@ include::modules/installation-registry-storage-non-production.adoc[leveloffset=+ include::modules/installation-complete-user-infra.adoc[leveloffset=+1] [role="_additional-resources"] -.Additional resources +[id="additional-resources_{context}"] +== Additional resources * link:https://access.redhat.com/solutions/4387261[How to generate SOSREPORT within {product-title} version 4 nodes without SSH] @@ -118,8 +109,4 @@ include::modules/installation-complete-user-infra.adoc[leveloffset=+1] * xref:../../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting] - -[id="next-steps_ibm-z-lpar-restricted"] -== Next steps - * xref:../../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster] \ No newline at end of file diff --git a/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z.adoc b/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z.adoc index a42bf29f302c..341941582b1c 100644 --- a/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z.adoc +++ b/installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z.adoc @@ -7,34 +7,23 @@ include::_attributes/common-attributes.adoc[] toc::[] [role="_abstract"] -In {product-title} version {product-version}, you can install a cluster on -{ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision in a disconnected environment. +In {product-title} version {product-version}, you can install a cluster on {ibm-z-name} or {ibm-linuxone-name} infrastructure that you provision in a disconnected environment. [NOTE] ==== While this document refers to only {ibm-z-name}, all information in it also applies to {ibm-linuxone-name}. ==== -[id="prerequisites-ibm-z-restricted_{context}"] -== Prerequisites +include::modules/prereqs-ibm-z-upi-disconnected.adoc[leveloffset=+1] -* You have completed the tasks in xref:../../../installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc#upi-ibm-z-preparing-to-install[Preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure]. -* You reviewed details about the xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. -* You read the documentation on xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. -* You xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[mirrored the images for a disconnected installation] to your registry and obtained the `imageContentSources` data for your version of {product-title}. -* 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. -+ -[IMPORTANT] -==== -Ensure that installation steps are done from a machine with access to the installation media. -==== -* 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. -* If you use a firewall and plan to use the Telemetry service, you xref:../../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[configured the firewall to allow the sites] that your cluster requires access to. -+ -[NOTE] -==== -Be sure to also review this site list if you are configuring a proxy. -==== +[role="_additional-resources"] +.Additional resources +* xref:../../../installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc#upi-ibm-z-preparing-to-install[Preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure] +* xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] +* xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[Selecting a cluster installation method and preparing it for users] +* xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation] +* xref:../../../storage/persistent_storage/persistent-storage-ocs.adoc#persistent-storage-ocs[Persistent storage using {rh-storage}] +* xref:../../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[Configuring your firewall] include::modules/installation-about-restricted-network.adoc[leveloffset=+1] @@ -65,7 +54,6 @@ include::modules/ibm-z-configure-hw-based-cex-encryption.adoc[leveloffset=+2] include::modules/ibm-z-configure-nbde-with-static-ip.adoc[leveloffset=+2] [role="_additional-resources"] -[id="additional-resources_Configure-nbde-ibm-z-restricted"] .Additional resources * xref:../../../installing/install_config/installing-customizing.adoc#installation-special-config-butane_installing-customizing[Creating machine configs with Butane] @@ -112,7 +100,8 @@ include::modules/installation-registry-storage-non-production.adoc[leveloffset=+ include::modules/installation-complete-user-infra.adoc[leveloffset=+1] [role="_additional-resources"] -.Additional resources +[id="additional-resources_{context}"] +== Additional resources * link:https://access.redhat.com/solutions/4387261[How to generate SOSREPORT within {product-title} version 4 nodes without SSH] @@ -120,8 +109,4 @@ include::modules/installation-complete-user-infra.adoc[leveloffset=+1] * xref:../../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting] - -[id="next-steps_ibm-z-zvm-restricted"] -== Next steps - * xref:../../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster] \ No newline at end of file diff --git a/installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc b/installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc index f337ffd61a7f..5911bbe5c813 100644 --- a/installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc +++ b/installing/installing_ibm_z/upi/upi-ibm-z-preparing-to-install.adoc @@ -6,6 +6,7 @@ include::_attributes/common-attributes.adoc[] toc::[] +[role="_abstract"] You prepare to install an {product-title} cluster on {ibm-z-name} and {ibm-linuxone-name} by completing the following steps: * Verifying internet connectivity for your cluster. @@ -14,7 +15,7 @@ You prepare to install an {product-title} cluster on {ibm-z-name} and {ibm-linux + [NOTE] ==== -If you are installing in a disconnected environment, you extract the installation program from the mirrored content. For more information, see xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation]. +If you are installing in a disconnected environment, you extract the installation program from the mirrored content. For more information, see Mirroring images for a disconnected installation in the Additional resources section. ==== * Installing the {oc-first}. @@ -51,6 +52,9 @@ include::modules/installation-user-provisioned-validating-dns.adoc[leveloffset=+ // include::modules/cluster-telemetry.adoc[leveloffset=+1] [role="_additional-resources"] -.Additional resources +[id="additional-resources_{context}"] +== Additional resources -* See xref:../../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] for more information about the Telemetry service. \ No newline at end of file +* xref:../../../disconnected/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation] + +* xref:../../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] \ No newline at end of file diff --git a/modules/ibm-z-configure-boot-volume-encryption.adoc b/modules/ibm-z-configure-boot-volume-encryption.adoc index fde20f291947..23b366479032 100644 --- a/modules/ibm-z-configure-boot-volume-encryption.adoc +++ b/modules/ibm-z-configure-boot-volume-encryption.adoc @@ -5,10 +5,11 @@ // * installing/installing_ibm_z/installing-ibm-z-lpar.adoc // * installing/installing_ibm_z/installing-restricted-networks-ibm-z-lpar.adoc -:_mod-docs-content-type: PROCEDURE +:_mod-docs-content-type: CONCEPT [id="configuring-boot-volume-encryption-ibm-z-linuxone-environment_{context}"] = Configuring boot volume encryption in an {ibm-z-title} or {ibm-linuxone-title} environment +[role="_abstract"] You can choose between two methods to optionally encrypt the boot volumes of your {product-title} control plane and compute nodes on {ibm-z-name} or {ibm-linuxone-name}: * Linux Unified Key Setup (LUKS) encryption via {ibm-name} Crypto Express (CEX) diff --git a/modules/ibm-z-configure-devices-manually.adoc b/modules/ibm-z-configure-devices-manually.adoc index fae22e7a27c1..049c7b8754cb 100644 --- a/modules/ibm-z-configure-devices-manually.adoc +++ b/modules/ibm-z-configure-devices-manually.adoc @@ -6,6 +6,7 @@ [id="configure-additional-devices-manually_{context}"] = Configuring additional devices manually +[role="_abstract"] Tasks in this section describe how to manually configure additional devices in an {ibm-z-name} or {ibm-linuxone-name} environment. This configuration method is persistent over node restarts but not {product-title} native and you need to redo the steps if you replace the node. .Prerequisites @@ -35,4 +36,4 @@ $ oc debug node/ [source,terminal] ---- $ sudo chzdev -e ----- \ No newline at end of file +---- diff --git a/modules/ibm-z-configure-encryption-kvm.adoc b/modules/ibm-z-configure-encryption-kvm.adoc index b1ed4d91d0d4..7c3632d896a8 100644 --- a/modules/ibm-z-configure-encryption-kvm.adoc +++ b/modules/ibm-z-configure-encryption-kvm.adoc @@ -3,10 +3,11 @@ // * installing/installing_ibm_z/installing-ibm-z-kvm.adoc // * installing/installing_ibm_z/installing-restricted-networks-ibm-z-kvm.adoc -:_mod-docs-content-type: PROCEDURE +:_mod-docs-content-type: CONCEPT [id="configuring-encryption-kvm-ibm-z-linuxone-environment_{context}"] = Configuring encryption for nodes in an {ibm-z-title} or {ibm-linuxone-title} environment +[role="_abstract"] You can choose between three methods to optionally secure your {product-title} control plane and compute nodes on {ibm-z-name} or {ibm-linuxone-name}: * {ibm-name} Secure Execution diff --git a/modules/ibm-z-enable-multipathing-fcp-luns.adoc b/modules/ibm-z-enable-multipathing-fcp-luns.adoc index 8f6f9e7a714b..3a4ed73b885f 100644 --- a/modules/ibm-z-enable-multipathing-fcp-luns.adoc +++ b/modules/ibm-z-enable-multipathing-fcp-luns.adoc @@ -6,6 +6,7 @@ [id="enabling-multipathing-fcp-luns_{context}"] = Enabling multipathing for FCP LUNs +[role="_abstract"] Tasks in this section describe how to manually configure additional devices in an {ibm-z-name} or {ibm-linuxone-name} environment. This configuration method is persistent over node restarts but not {product-title} native and you need to redo the steps if you replace the node. [IMPORTANT] @@ -64,7 +65,7 @@ $ sudo fdisk /dev/mapper/mpatha $ sudo multipath -ll ---- + -.Example output +For example: + [source,terminal] ---- @@ -75,4 +76,4 @@ mpatha (20017380030290197) dm-1 IBM,2810XIV |- 1:0:1:6 sdf 69:24 active ready running |- 0:0:0:6 sdg 8:80 active ready running `- 0:0:1:6 sdh 66:48 active ready running ----- \ No newline at end of file +---- diff --git a/modules/ibm-z-roce-network-cards.adoc b/modules/ibm-z-roce-network-cards.adoc new file mode 100644 index 000000000000..27148609b3a0 --- /dev/null +++ b/modules/ibm-z-roce-network-cards.adoc @@ -0,0 +1,10 @@ +// Module included in the following assemblies: +// +// * installing/installing_ibm_z/ibmz-post-install.adoc + +:_mod-docs-content-type: CONCEPT +[id="ibm-z-roce-network-cards_{context}"] += RoCE network cards + +[role="_abstract"] +RoCE (RDMA over Converged Ethernet) network cards do not need to be enabled and their interfaces can be configured with the Kubernetes NMState Operator whenever they are available in the node. For example, RoCE network cards are available if they are attached in a z/VM environment or passed through in a {op-system-base} KVM environment. diff --git a/modules/ibm-z-secure-execution.adoc b/modules/ibm-z-secure-execution.adoc index 5d372f7e107e..2e2ab01aea33 100644 --- a/modules/ibm-z-secure-execution.adoc +++ b/modules/ibm-z-secure-execution.adoc @@ -7,6 +7,7 @@ [id="installing-rhcos-using-ibm-secure-execution_{context}"] = Installing {op-system} using {ibm-title} Secure Execution +[role="_abstract"] Before you install {op-system} using {ibm-name} Secure Execution, you must prepare the underlying infrastructure. .Prerequisites @@ -23,7 +24,7 @@ Before you install {op-system} using {ibm-name} Secure Execution, you must prepa ** By default, KVM hosts do not support guests in {ibm-name} Secure Execution mode. To support guests in {ibm-name} Secure Execution mode, KVM hosts must boot in LPAR mode with the kernel parameter specification `prot_virt=1`. To enable `prot_virt=1` on {op-system-base} 8, follow these steps: -.. Navigate to `/boot/loader/entries/` to modify your bootloader configuration file `*.conf`. +.. Navigate to `/boot/loader/entries/` to modify your boot loader configuration file `*.conf`. .. Add the kernel command line parameter `prot_virt=1`. .. Run the `zipl` command and reboot your system. + @@ -40,12 +41,13 @@ prot_virt: Reserving MB as ultravisor base storage. # cat /sys/firmware/uv/prot_virt_host ---- + -.Example output +For example: + [source,terminal] ---- 1 ---- ++ The value of this attribute is 1 for Linux instances that detect their environment as consistent with that of a secure host. For other instances, the value is 0. . Add your host keys to the KVM guest via Ignition. @@ -68,14 +70,14 @@ For example: { "path": "/etc/se-hostkeys/ibm-z-hostkey-.crt", "contents": { - "source": "data:;base64," + "source": "" }, "mode": 420 }, { "path": "/etc/se-hostkeys/ibm-z-hostkey-.crt", "contents": { - "source": "data:;base64," + "source": "" }, "mode": 420 } @@ -85,9 +87,11 @@ For example: ``` ---- + +Replace `` with an Ignition data URI containing the Base64 encoded host key document. ++ [NOTE] ==== -You can add as many host keys as required if you want your node to be able to run on multiple {ibm-z-name} machines. +You can add as many host keys as needed if you want your node to be able to run on multiple {ibm-z-name} machines. ==== . To generate the Base64 encoded string, run the following command: + @@ -126,7 +130,6 @@ When you have completed the fast-track installation of {op-system} and Ignition ** If the decryption is successful, you can expect an output similar to the following example: + -.Example output [source,terminal] ---- [ 2.801433] systemd[1]: Starting coreos-ignition-setup-user.service - CoreOS Ignition User Config Setup... @@ -138,7 +141,6 @@ When you have completed the fast-track installation of {op-system} and Ignition ** If the decryption fails, you can expect an output similar to the following example: + -.Example output [source,terminal] ---- Starting coreos-ignition-s…reOS Ignition User Config Setup... diff --git a/modules/installation-ibm-z-kvm-user-infra-installing-rhcos.adoc b/modules/installation-ibm-z-kvm-user-infra-installing-rhcos.adoc index 8b3273ddf01d..708e2978b402 100644 --- a/modules/installation-ibm-z-kvm-user-infra-installing-rhcos.adoc +++ b/modules/installation-ibm-z-kvm-user-infra-installing-rhcos.adoc @@ -7,6 +7,9 @@ [id="installation-ibm-z-kvm-user-infra-installing-rhcos_{context}"] = Installing {op-system} and starting the {product-title} bootstrap process + +[role="_abstract"] + To install {product-title} on {ibm-z-name} infrastructure that you provision, you must install {op-system-first} as {op-system-base-full} guest virtual machines. When you install {op-system}, you must provide the Ignition config file that was generated by the {product-title} installation program for the type of machine you are installing. If you have configured suitable networking, DNS, and load balancing infrastructure, the {product-title} bootstrap process begins automatically after the {op-system} machines have rebooted. You can perform a fast-track installation of {op-system} that uses a prepackaged QEMU copy-on-write (QCOW2) disk image. Alternatively, you can perform a full installation on a new QCOW2 disk image. diff --git a/modules/installation-requirements-ibm-z.adoc b/modules/installation-requirements-ibm-z.adoc index 0d6975de3c09..41f68e26bfc2 100644 --- a/modules/installation-requirements-ibm-z.adoc +++ b/modules/installation-requirements-ibm-z.adoc @@ -11,6 +11,7 @@ [id="minimum-ibm-z-system-requirements_{context}"] = Minimum {ibm-z-title} system environment +[role="_abstract"] The following {ibm-name} hardware is supported with {product-title} version {product-version}. .Supported {ibm-name} hardware @@ -19,8 +20,8 @@ The following {ibm-name} hardware is supported with {product-title} version {pro | |z/VM -|LPAR ^[1]^ -|{op-system-base} KVM ^[2]^ +|LPAR +|{op-system-base} KVM |{ibm-name} z17 (all models) |supported @@ -68,8 +69,10 @@ The following {ibm-name} hardware is supported with {product-title} version {pro |supported |=== -1. When running {product-title} on {ibm-z-name} without a hypervisor use the Dynamic Partition Manager (DPM) to manage your machine. -2. The {op-system-base} KVM host in your environment must meet certain requirements to host the virtual machines that you plan for the {product-title} environment. See link:https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/configuring_and_managing_virtualization/assembly_enabling-virtualization-in-rhel-9_configuring-and-managing-virtualization#enabling-virtualization-on-ibm-z_assembly_enabling-virtualization-in-rhel-9[Enabling virtualization on {ibm-z-name}]. + +When running {product-title} on {ibm-z-name} in an LPAR without a hypervisor, use the Dynamic Partition Manager (DPM) to manage your machine. + +The {op-system-base} KVM host in your environment must meet certain requirements to host the virtual machines that you plan for the {product-title} environment. See link:https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/configuring_and_managing_virtualization/assembly_enabling-virtualization-in-rhel-9_configuring-and-managing-virtualization#enabling-virtualization-on-ibm-z_assembly_enabling-virtualization-in-rhel-9[Enabling virtualization on {ibm-z-name}]. [NOTE] ==== @@ -164,7 +167,7 @@ See link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/ [id="ibm-z-disk-storage_{context}"] -=== Disk storage +== Disk storage .Disk storage requirements [cols="2,2,2,2",options="header"] diff --git a/modules/preferred-installation-requirements-ibm-z.adoc b/modules/preferred-installation-requirements-ibm-z.adoc index 00ec9e435882..295d65dc3756 100644 --- a/modules/preferred-installation-requirements-ibm-z.adoc +++ b/modules/preferred-installation-requirements-ibm-z.adoc @@ -11,6 +11,7 @@ [id="preferred-ibm-z-system-requirements_{context}"] = Preferred {ibm-z-title} system environment +[role="_abstract"] The preferred system environment for running {product-title} version {product-version} on {ibm-z-name} hardware is as follows: @@ -36,7 +37,7 @@ When installing in a z/VM environment, you can also bridge HiperSockets with one |=== | -|z/VM ^[1]^ +|z/VM |LPAR |{op-system-base} KVM @@ -61,6 +62,10 @@ When installing in a z/VM environment, you can also bridge HiperSockets with one |One machine |=== -1. To ensure the availability of integral components in an overcommitted environment, increase the priority of the control plane by using the CP command `SET SHARE`. Do the same for infrastructure nodes, if they exist. See link:https://www.ibm.com/docs/en/zvm/latest?topic=commands-set-share[SET SHARE] ({ibm-name} Documentation). + +[NOTE] +==== +When working in a z/VM environment, to ensure the availability of integral components in an overcommitted environment, increase the priority of the control plane by using the CP command `SET SHARE`. Do the same for infrastructure nodes, if they exist. See link:https://www.ibm.com/docs/en/zvm/latest?topic=commands-set-share[SET SHARE] ({ibm-name} Documentation). +==== //Alex: Two Infrastructure nodes \ No newline at end of file diff --git a/modules/prereqs-ibm-z-kvm-upi-disconnected.adoc b/modules/prereqs-ibm-z-kvm-upi-disconnected.adoc new file mode 100644 index 000000000000..33d2786c0dd1 --- /dev/null +++ b/modules/prereqs-ibm-z-kvm-upi-disconnected.adoc @@ -0,0 +1,29 @@ +// Module included in the following assemblies: +// +// * installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-kvm.adoc + +:_mod-docs-content-type: REFERENCE +[id="prereqs-ibm-z-kvm-upi-disconnected_{context}"] += Prerequisites + +[role="_abstract"] +Before beginning your cluster installation, you must complete prerequisite tasks that prepare your environment. + +* You have completed the tasks in preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure. +* You reviewed details about the {product-title} installation and update processes. +* You read the documentation on selecting a cluster installation method and preparing it for users. +* You mirrored the images for a disconnected installation to your registry and obtained the `imageContentSources` data for your version of {product-title}. +* 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. ++ +[IMPORTANT] +==== +Ensure that installation steps are done from a machine with access to the installation media. +==== +* You provisioned persistent storage by 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. +* If you use a firewall, you configured it to allow the sites that your cluster requires access to. ++ +[NOTE] +==== +Be sure to also review this site list if you are configuring a proxy. +==== +* You provisioned a {op-system-base} Kernel Virtual Machine (KVM) system that is hosted on the logical partition (LPAR) and based on {op-system-base} 8.6 or later. See link:https://access.redhat.com/support/policy/updates/errata#RHEL8_and_9_Life_Cycle[Red Hat Enterprise Linux 8 and 9 Life Cycle]. diff --git a/modules/prereqs-ibm-z-kvm-upi.adoc b/modules/prereqs-ibm-z-kvm-upi.adoc new file mode 100644 index 000000000000..c454bf5110a7 --- /dev/null +++ b/modules/prereqs-ibm-z-kvm-upi.adoc @@ -0,0 +1,23 @@ +// Module included in the following assemblies: +// +// * installing/installing_ibm_z/upi/installing-ibm-z-kvm.adoc + +:_mod-docs-content-type: REFERENCE +[id="prereqs-ibm-z-kvm-upi_{context}"] += Prerequisites + +[role="_abstract"] +Before beginning your cluster installation, you must complete prerequisite tasks that prepare your environment. + +* You have completed the tasks in preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure. +* You reviewed details about the {product-title} installation and update processes. +* You read the documentation on selecting a cluster installation method and preparing it for users. +* Before you begin the installation process, you must clean the installation directory. This ensures that the required installation files are created and updated during the installation process. +* You provisioned persistent storage by 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. +* If you use a firewall, you configured it to allow the sites that your cluster requires access to. ++ +[NOTE] +==== +Be sure to also review this site list if you are configuring a proxy. +==== +* You provisioned a {op-system-base} Kernel Virtual Machine (KVM) system that is hosted on the logical partition (LPAR) and based on {op-system-base} 8.6 or later. See link:https://access.redhat.com/support/policy/updates/errata#RHEL8_and_9_Life_Cycle[Red Hat Enterprise Linux 8 and 9 Life Cycle]. diff --git a/modules/prereqs-ibm-z-upi-disconnected.adoc b/modules/prereqs-ibm-z-upi-disconnected.adoc new file mode 100644 index 000000000000..5d9ab26eca49 --- /dev/null +++ b/modules/prereqs-ibm-z-upi-disconnected.adoc @@ -0,0 +1,29 @@ +// Module included in the following assemblies: +// +// * installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z.adoc +// * installing/installing_ibm_z/upi/installing-restricted-networks-ibm-z-lpar.adoc + +:_mod-docs-content-type: REFERENCE +[id="prereqs-ibm-z-upi-disconnected_{context}"] += Prerequisites + +[role="_abstract"] +Before beginning your cluster installation, you must complete prerequisite tasks that prepare your environment. + +* You have completed the tasks in preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure. +* You reviewed details about the {product-title} installation and update processes. +* You read the documentation on selecting a cluster installation method and preparing it for users. +* You mirrored the images for a disconnected installation to your registry and obtained the `imageContentSources` data for your version of {product-title}. +* 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. ++ +[IMPORTANT] +==== +Ensure that installation steps are done from a machine with access to the installation media. +==== +* You provisioned persistent storage by 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. +* If you use a firewall and plan to use the Telemetry service, you configured the firewall to allow the sites that your cluster requires access to. ++ +[NOTE] +==== +Be sure to also review this site list if you are configuring a proxy. +==== diff --git a/modules/prereqs-ibm-z-upi.adoc b/modules/prereqs-ibm-z-upi.adoc new file mode 100644 index 000000000000..db03ce559940 --- /dev/null +++ b/modules/prereqs-ibm-z-upi.adoc @@ -0,0 +1,23 @@ +// Module included in the following assemblies: +// +// * installing/installing_ibm_z/upi/installing-ibm-z.adoc +// * installing/installing_ibm_z/upi/installing-ibm-z-lpar.adoc + +:_mod-docs-content-type: REFERENCE +[id="prereqs-ibm-z-upi_{context}"] += Prerequisites + +[role="_abstract"] +Before beginning your cluster installation, you must complete prerequisite tasks that prepare your environment. + +* You have completed the tasks in preparing to install a cluster on {ibm-z-title} using user-provisioned infrastructure. +* You reviewed details about the {product-title} installation and update processes. +* You read the documentation on selecting a cluster installation method and preparing it for users. +* Before you begin the installation process, you must clean the installation directory. This ensures that the required installation files are created and updated during the installation process. +* You provisioned persistent storage by 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. +* If you use a firewall, you configured it to allow the sites that your cluster requires access to. ++ +[NOTE] +==== +Be sure to also review this site list if you are configuring a proxy. +====