:_mod-docs-content-type: ASSEMBLY
include::_attributes/common-attributes.adoc[]
[id="installing-ibm-z"]
= Installing a cluster with z/VM on {ibm-z-title} and {ibm-linuxone-title}
:context: installing-ibm-z

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.

[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

* 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.
====

include::modules/installation-infrastructure-user-infra.adoc[leveloffset=+1]

include::modules/installation-load-balancing-user-infra-example.adoc[leveloffset=+2]

include::modules/installation-initializing-manual.adoc[leveloffset=+1]

[role="_additional-resources"]
.Additional resources
* xref:../../../installing/installing_ibm_z/installation-config-parameters-ibm-z.adoc#installation-config-parameters-ibm-z[Installation configuration parameters for {ibm-z-name}]

include::modules/installation-bare-metal-config-yaml.adoc[leveloffset=+2]

include::modules/installation-configure-proxy.adoc[leveloffset=+2]

include::modules/installation-three-node-cluster.adoc[leveloffset=+2]

include::modules/nw-operator-cr.adoc[leveloffset=+1]

include::modules/installation-user-infra-generate-k8s-manifest-ignition.adoc[leveloffset=+1]

include::modules/ibm-z-configure-boot-volume-encryption.adoc[leveloffset=+1]

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"]
.Additional resources

* xref:../../../installing/install_config/installing-customizing.adoc#installation-special-config-butane_installing-customizing[Creating machine configs with Butane]

include::modules/installation-ibm-z-user-infra-machines-iso.adoc[leveloffset=+1]

include::modules/installation-user-infra-machines-static-network.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources

* link:https://www.man7.org/linux/man-pages/man7/dracut.cmdline.7.html[`dracut.cmdline` manual page]

include::modules/configuring-dhcp-or-static-ip-addresses.adoc[leveloffset=+3]

include::modules/configuring-ip-address-without-static-hostname.adoc[leveloffset=+3]

include::modules/specifying-multiple-network-interfaces.adoc[leveloffset=+3]

include::modules/configuring-default-gateway-route.adoc[leveloffset=+3]

include::modules/configuring-vlans-individual-interfaces.adoc[leveloffset=+3]

include::modules/bonding-multiple-network-interfaces-to-single-interface.adoc[leveloffset=+3]

include::modules/bonding-multiple-sriov-network-interfaces-to-dual-port.adoc[leveloffset=+3]

include::modules/installation-installing-bare-metal.adoc[leveloffset=+1]

include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1]

include::modules/installation-approve-csrs.adoc[leveloffset=+1]

include::modules/installation-operators-config.adoc[leveloffset=+1]

include::modules/installation-registry-storage-config.adoc[leveloffset=+2]

include::modules/registry-configuring-storage-baremetal.adoc[leveloffset=+3]

include::modules/installation-registry-storage-non-production.adoc[leveloffset=+3]

include::modules/installation-complete-user-infra.adoc[leveloffset=+1]

include::modules/cluster-telemetry.adoc[leveloffset=+1]

[role="_additional-resources"]
.Additional resources

* xref:../../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring]

* link:https://access.redhat.com/solutions/4387261[How to generate SOSREPORT within {product-title} version 4 nodes without SSH]

* 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]

