:_mod-docs-content-type: ASSEMBLY
[id="preparing-to-install-with-agent-based-installer"]
= Preparing to install with the Agent-based Installer
include::_attributes/common-attributes.adoc[]
:context: preparing-to-install-with-agent-based-installer

toc::[]

[role="_abstract"]
The Agent-based Installer provides the flexibility to boot your on-premise servers in any way that you choose. It combines the ease of use of the Assisted Installation service with the ability to run offline, including in air-gapped environments.

The Agent-based Installer uses a subcommand of the {product-title} installation program.
It generates a bootable ISO image containing all of the information required to deploy an {product-title} cluster, with an available release image.

The configuration is in the same format as for the installer-provisioned infrastructure and user-provisioned infrastructure installation methods.
The Agent-based Installer can also optionally generate or accept Zero Touch Provisioning (ZTP) custom resources. ZTP allows you to provision new edge sites with declarative configurations of bare-metal equipment.

[NOTE]
====
To deploy clusters with virtualized control planes running on {VirtProductName} VMs, you can use KubeVirt Redfish to expose VMs as Redfish-compatible endpoints.
For more information about using virtualized control planes, see "Using virtualized control planes".
====

.Agent-based Installer supported architectures
|===
|CPU architecture |Connected installation |Disconnected installation

|`64-bit x86`
|&#10003;
|&#10003;

|`64-bit ARM`
|&#10003;
|&#10003;

|`ppc64le`
|&#10003;
|&#10003;

|`s390x`
|&#10003;
|&#10003;
|===

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

* xref:../../vcp/vcp-overview.adoc#vcp-overview[Understanding virtualized control planes]

//Understanding Agent-based Installer
include::modules/understanding-agent-install.adoc[leveloffset=+1]

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

* xref:../../installing/overview/cluster-capabilities.adoc#cluster-capabilities[Cluster capabilities]

* link:https://access.redhat.com/articles/4207611[Deploying OpenShift 4.x on non-tested platforms using the bare metal install method (Red{nbsp}Hat Knowledgebase article)]

* xref:../../installing/installing_with_agent_based_installer/preparing-to-install-with-agent-based-installer.adoc#installation-requirements-platform-none_preparing-to-install-with-agent-based-installer[Requirements for a cluster using the platform "none" option]

* xref:../installing_bare_metal/ipi/ipi-install-prerequisites.adoc#network-requirements-increase-mtu_ipi-install-prerequisites[Increase the network MTU]

* xref:../../nodes/nodes/nodes-sno-worker-nodes.adoc#nodes-sno-worker-nodes[Adding worker nodes to {sno} clusters]

* xref:../../installing/installing_with_agent_based_installer/preparing-to-install-with-agent-based-installer.adoc#installing-ocp-agent-local-arbiter-node_preparing-to-install-with-agent-based-installer[About a local arbiter node]

//About FIPS compliance
include::modules/agent-installer-fips-compliance.adoc[leveloffset=+1]

//Configuring FIPS through the Agent-based Installer
include::modules/agent-installer-configuring-fips-compliance.adoc[leveloffset=+1]

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

* link:https://access.redhat.com/articles/5059881[OpenShift Security Guide Book]

* xref:../../installing/overview/installing-fips.adoc#installing-fips[Support for FIPS cryptography]

// Host configuration
include::modules/agent-host-config.adoc[leveloffset=+1]

// Host roles
include::modules/agent-host-roles.adoc[leveloffset=+2]

// About root device hints
include::modules/agent-install-ipi-install-root-device-hints.adoc[leveloffset=+2]

//About networking
include::modules/agent-install-networking.adoc[leveloffset=+1]

//Requirements for a cluster using the platform "none" option
include::modules/agent-install-requirements-none.adoc[leveloffset=+1]

//Platform "none" DNS requirements
include::modules/agent-install-dns-none.adoc[leveloffset=+2]

//Platform "none" Load balancing requirements
include::modules/agent-install-load-balancing-none.adoc[leveloffset=+2]

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

* xref:../../installing/installing_with_agent_based_installer/preparing-to-install-with-agent-based-installer.adoc#agent-install-networking-ports_preparing-to-install-with-agent-based-installer[Port requirements for the rendezvous host]

* xref:../../installing/overview/cluster-capabilities.adoc#cluster-capabilities[Cluster capabilities]

* link:https://access.redhat.com/articles/4207611[Deploying OpenShift 4.x on non-tested platforms using the bare metal install method (Red{nbsp}Hat Knowledgebase article)]

// About a local arbiter node
include::modules/installing-ocp-agent-local-arbiter-node.adoc[leveloffset=+1]

//Example: Bonds and VLAN interface node network configuration
include::modules/agent-install-sample-config-bonds-vlans.adoc[leveloffset=+1]

//Example: Bonds and SR-IOV dual-nic node network configuration
include::modules/agent-install-sample-config-bond-sriov.adoc[leveloffset=+1]

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

* link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/configuring_and_managing_networking/configuring-network-bonding_configuring-and-managing-networking[Configuring network bonding]

//Sample install-config.yaml file for bare metal
include::modules/installation-bare-metal-agent-installer-config-yaml.adoc[leveloffset=+1]

//Validation checks before agent ISO creation
include::modules/validations-before-agent-iso-creation.adoc[leveloffset=+1]

[role="_additional-resources"]
[id="additional-resources_{context}"]
== Additional resources

* xref:../../installing/installing_with_agent_based_installer/installing-with-agent-basic.adoc#installing-with-agent-basic[Installing a cluster]

* xref:../../installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc#installing-with-agent-based-installer[Installing a cluster with customizations]