:_mod-docs-content-type: ASSEMBLY

[id="installing-azure-stack-hub-network-customizations"]
= Installing a cluster on Azure Stack Hub with network customizations
include::_attributes/common-attributes.adoc[]
:context: installing-azure-stack-hub-network-customizations

toc::[]

In {product-title} version {product-version}, you can install a cluster with a customized network configuration on infrastructure that the installation program provisions on Azure Stack Hub. By customizing your network configuration, your cluster can coexist with existing IP address allocations in your environment and integrate with existing MTU and VXLAN configurations.

[NOTE]
====
While you can select `azure` when using the installation program to deploy a cluster using installer-provisioned infrastructure, this option is only supported for the Azure Public Cloud.
====

[id="prerequisites_installing-azure-stack-hub-network-customizations"]
== Prerequisites

* 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 have installed Azure Stack Hub version 2008 or later. 
* You xref:../../../installing/installing_azure_stack_hub/installing-azure-stack-hub-account.adoc#installing-azure-stack-hub-account[configured an Azure Stack Hub account] to host the cluster.
* 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.
* You verified that you have approximately 16 GB of local disk space. Installing the cluster requires that you download the {op-system} virtual hard drive (VHD) cluster image and upload it to your Azure Stack Hub environment so that it is accessible during deployment. Decompressing the VHD files requires this amount of local disk space.

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

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

[role="_additional-resources"]
.Additional resources
* xref:../../../installing/installing_azure_stack_hub/installation-config-parameters-ash.adoc#installation-config-parameters-ash[Installation configuration parameters for Azure Stack Hub]

include::modules/installation-azure-stack-hub-config-yaml.adoc[leveloffset=+2]

include::modules/manually-create-identity-access-management.adoc[leveloffset=+1]

[role="_additional-resources"]
[id="additional-resources_installing-azure-stack-hub-network-customizations-cco"]
.Additional resources
* xref:../../../updating/updating_a_cluster/updating-cluster-web-console.adoc#manually-maintained-credentials-upgrade_updating-cluster-web-console[Updating a cluster using the web console]
* xref:../../../updating/updating_a_cluster/updating-cluster-cli.adoc#manually-maintained-credentials-upgrade_updating-cluster-cli[Updating a cluster using the CLI]

include::modules/azure-stack-hub-internal-ca.adoc[leveloffset=+1]

//include::modules/installation-launching-installer.adoc[leveloffset=+1]
//Leaving this stubbed in case future might remove the requirement to manually configure the install configuration file.

// Network Operator specific configuration
include::modules/nw-network-config.adoc[leveloffset=+1]

include::modules/nw-modifying-operator-install-config.adoc[leveloffset=+1]

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

include::modules/configuring-hybrid-ovnkubernetes.adoc[leveloffset=+1]

[NOTE]
====
For more information about using Linux and Windows nodes in the same cluster, see xref:../../../windows_containers/understanding-windows-container-workloads.adoc#understanding-windows-container-workloads[Understanding Windows container workloads].
====

include::modules/installation-launching-installer.adoc[leveloffset=+1]

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

include::modules/logging-in-by-using-the-web-console.adoc[leveloffset=+1]

[role="_additional-resources"]
[id="additional-resources_installing-azure-stack-hub-network-customizations-console"]
.Additional resources
* xref:../../../web_console/web-console.adoc#web-console[Accessing the web console]

[role="_additional-resources"]
[id="additional-resources_installing-azure-stack-hub-network-customizations-telemetry"]

[id="next-steps_installing-azure-stack-hub-network-customizations"]
== Next steps

* xref:../../../installing/validation_and_troubleshooting/validating-an-installation.adoc#validating-an-installation[Validating an installation]
* xref:../../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster]
* Optional: xref:../../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting]
* Optional: xref:../../../post_installation_configuration/changing-cloud-credentials-configuration.adoc#manually-removing-cloud-creds_changing-cloud-credentials-configuration[Remove cloud provider credentials]
