diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index bcc9ff5485..a40a5cf7c5 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -2931,39 +2931,39 @@ Topics: - Name: Using the Node Observability Operator File: node-observability-operator Distros: openshift-origin,openshift-enterprise -- Name: Clusters at the network far edge - Dir: ztp_far_edge - Distros: openshift-origin,openshift-enterprise - Topics: - - Name: Challenges of the network far edge - File: ztp-deploying-far-edge-clusters-at-scale - - Name: Preparing the hub cluster for ZTP - File: ztp-preparing-the-hub-cluster - - Name: Updating GitOps ZTP - File: ztp-updating-gitops - - Name: Installing managed clusters with RHACM and SiteConfig resources - File: ztp-deploying-far-edge-sites - - Name: Configuring managed clusters with policies and PolicyGenTemplate resources - File: ztp-configuring-managed-clusters-policies - - Name: Manually installing a single-node OpenShift cluster with ZTP - File: ztp-manual-install - - Name: Recommended single-node OpenShift cluster configuration for vDU application workloads - File: ztp-reference-cluster-configuration-for-vdu - - Name: Validating cluster tuning for vDU application workloads - File: ztp-vdu-validating-cluster-tuning - - Name: Advanced managed cluster configuration with SiteConfig resources - File: ztp-advanced-install-ztp - - Name: Advanced managed cluster configuration with PolicyGenTemplate resources - File: ztp-advanced-policy-config - - Name: Updating managed clusters with the Topology Aware Lifecycle Manager - File: cnf-talm-for-cluster-upgrades - Distros: openshift-origin,openshift-enterprise - - Name: Updating managed clusters in a disconnected environment with the Topology Aware Lifecycle Manager - File: ztp-talm-updating-managed-policies - - Name: Expanding single-node OpenShift clusters with GitOps ZTP - File: ztp-sno-additional-worker-node - - Name: Pre-caching images for single-node OpenShift deployments - File: ztp-precaching-tool +--- +Name: Edge computing +Dir: edge_computing +Distros: openshift-origin,openshift-enterprise +Topics: +- Name: Challenges of the network far edge + File: ztp-deploying-far-edge-clusters-at-scale +- Name: Preparing the hub cluster for ZTP + File: ztp-preparing-the-hub-cluster +- Name: Updating GitOps ZTP + File: ztp-updating-gitops +- Name: Installing managed clusters with RHACM and SiteConfig resources + File: ztp-deploying-far-edge-sites +- Name: Configuring managed clusters with policies and PolicyGenTemplate resources + File: ztp-configuring-managed-clusters-policies +- Name: Manually installing a single-node OpenShift cluster with ZTP + File: ztp-manual-install +- Name: Recommended single-node OpenShift cluster configuration for vDU application workloads + File: ztp-reference-cluster-configuration-for-vdu +- Name: Validating cluster tuning for vDU application workloads + File: ztp-vdu-validating-cluster-tuning +- Name: Advanced managed cluster configuration with SiteConfig resources + File: ztp-advanced-install-ztp +- Name: Advanced managed cluster configuration with PolicyGenTemplate resources + File: ztp-advanced-policy-config +- Name: Updating managed clusters with the Topology Aware Lifecycle Manager + File: cnf-talm-for-cluster-upgrades +- Name: Updating managed clusters in a disconnected environment with the Topology Aware Lifecycle Manager + File: ztp-talm-updating-managed-policies +- Name: Expanding single-node OpenShift clusters with GitOps ZTP + File: ztp-sno-additional-worker-node +- Name: Pre-caching images for single-node OpenShift deployments + File: ztp-precaching-tool --- Name: Reference design specifications Dir: telco_ref_design_specs diff --git a/architecture/mce-overview-ocp.adoc b/architecture/mce-overview-ocp.adoc index beec551aa2..bc5981d09f 100644 --- a/architecture/mce-overview-ocp.adoc +++ b/architecture/mce-overview-ocp.adoc @@ -19,7 +19,7 @@ When you enable multicluster engine on {product-title}, you gain the following c * xref:../architecture/control-plane.adoc#hosted-control-planes-overview_control-plane[Hosted control planes], which is a feature that is based on the HyperShift project. With a centralized hosted control plane, you can operate {product-title} clusters in a hyperscale manner. * Hive, which provisions self-managed {product-title} clusters to the hub and completes the initial configurations for those clusters. * klusterlet agent, which registers managed clusters to the hub. -* Infrastructure Operator, which manages the deployment of the Assisted Service to orchestrate on-premise bare metal and vSphere installations of {product-title}, such as SNO on bare metal. The Infrastructure Operator includes xref:../scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-clusters-at-scale.adoc#ztp-challenges-of-far-edge-deployments_ztp-deploying-far-edge-clusters-at-scale[{ztp-first}], which fully automates cluster creation on bare metal and vSphere provisioning with GitOps workflows to manage deployments and configuration changes. +* Infrastructure Operator, which manages the deployment of the Assisted Service to orchestrate on-premise bare metal and vSphere installations of {product-title}, such as {sno} on bare metal. The Infrastructure Operator includes xref:../edge_computing/ztp-deploying-far-edge-clusters-at-scale.adoc#ztp-challenges-of-far-edge-deployments_ztp-deploying-far-edge-clusters-at-scale[{ztp-first}], which fully automates cluster creation on bare metal and vSphere provisioning with GitOps workflows to manage deployments and configuration changes. * Open cluster management, which provides resources to manage Kubernetes clusters. The multicluster engine is included with your {product-title} support subscription and is delivered separately from the core payload. To start to use multicluster engine, you deploy the {product-title} cluster and then install the operator. For more information, see link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.9/html/clusters/cluster_mce_overview#mce-install-intro[Installing and upgrading multicluster engine operator]. diff --git a/edge_computing/_attributes b/edge_computing/_attributes new file mode 120000 index 0000000000..f27fd275ea --- /dev/null +++ b/edge_computing/_attributes @@ -0,0 +1 @@ +../_attributes/ \ No newline at end of file diff --git a/scalability_and_performance/ztp_far_edge/cnf-talm-for-cluster-upgrades.adoc b/edge_computing/cnf-talm-for-cluster-upgrades.adoc similarity index 74% rename from scalability_and_performance/ztp_far_edge/cnf-talm-for-cluster-upgrades.adoc rename to edge_computing/cnf-talm-for-cluster-upgrades.adoc index 77415b6c34..107dad139b 100644 --- a/scalability_and_performance/ztp_far_edge/cnf-talm-for-cluster-upgrades.adoc +++ b/edge_computing/cnf-talm-for-cluster-upgrades.adoc @@ -27,7 +27,7 @@ include::modules/cnf-topology-aware-lifecycle-manager-policies-concept.adoc[leve [role="_additional-resources"] .Additional resources -For more information about the `PolicyGenTemplate` CRD, see xref:../../scalability_and_performance/ztp_far_edge/ztp-configuring-managed-clusters-policies.adoc#ztp-the-policygentemplate_ztp-configuring-managed-clusters-policies[About the PolicyGenTemplate CRD]. +For more information about the `PolicyGenTemplate` CRD, see xref:../edge_computing/ztp-configuring-managed-clusters-policies.adoc#ztp-the-policygentemplate_ztp-configuring-managed-clusters-policies[About the PolicyGenTemplate CRD]. include::modules/cnf-topology-aware-lifecycle-manager-about-subscription-crs.adoc[leveloffset=+2] @@ -50,8 +50,8 @@ include::modules/cnf-topology-aware-lifecycle-manager-troubleshooting.adoc[level [role="_additional-resources"] .Additional resources -* For information about troubleshooting, see xref:../../support/troubleshooting/troubleshooting-operator-issues.adoc[OpenShift Container Platform Troubleshooting Operator Issues]. +* For information about troubleshooting, see xref:../support/troubleshooting/troubleshooting-operator-issues.adoc#troubleshooting-operator-issues[OpenShift Container Platform Troubleshooting Operator Issues]. -* For more information about using {cgu-operator-full} in the ZTP workflow, see xref:../../scalability_and_performance/ztp_far_edge/ztp-talm-updating-managed-policies.adoc#ztp-topology-aware-lifecycle-manager[Updating managed policies with {cgu-operator-full}]. +* For more information about using {cgu-operator-full} in the ZTP workflow, see xref:../edge_computing/ztp-talm-updating-managed-policies.adoc#ztp-topology-aware-lifecycle-manager[Updating managed policies with {cgu-operator-full}]. -* For more information about the `PolicyGenTemplate` CRD, see xref:../../scalability_and_performance/ztp_far_edge/ztp-configuring-managed-clusters-policies.adoc#ztp-the-policygentemplate_ztp-configuring-managed-clusters-policies[About the PolicyGenTemplate CRD] \ No newline at end of file +* For more information about the `PolicyGenTemplate` CRD, see xref:../edge_computing/ztp-configuring-managed-clusters-policies.adoc#ztp-the-policygentemplate_ztp-configuring-managed-clusters-policies[About the PolicyGenTemplate CRD] diff --git a/edge_computing/images b/edge_computing/images new file mode 120000 index 0000000000..e4c5bd02a1 --- /dev/null +++ b/edge_computing/images @@ -0,0 +1 @@ +../images/ \ No newline at end of file diff --git a/edge_computing/modules b/edge_computing/modules new file mode 120000 index 0000000000..43aab75b53 --- /dev/null +++ b/edge_computing/modules @@ -0,0 +1 @@ +../modules/ \ No newline at end of file diff --git a/edge_computing/snippets b/edge_computing/snippets new file mode 120000 index 0000000000..9d58b92e50 --- /dev/null +++ b/edge_computing/snippets @@ -0,0 +1 @@ +../snippets/ \ No newline at end of file diff --git a/scalability_and_performance/ztp_far_edge/ztp-advanced-install-ztp.adoc b/edge_computing/ztp-advanced-install-ztp.adoc similarity index 100% rename from scalability_and_performance/ztp_far_edge/ztp-advanced-install-ztp.adoc rename to edge_computing/ztp-advanced-install-ztp.adoc diff --git a/scalability_and_performance/ztp_far_edge/ztp-advanced-policy-config.adoc b/edge_computing/ztp-advanced-policy-config.adoc similarity index 61% rename from scalability_and_performance/ztp_far_edge/ztp-advanced-policy-config.adoc rename to edge_computing/ztp-advanced-policy-config.adoc index c38549caaf..545e744d01 100644 --- a/scalability_and_performance/ztp_far_edge/ztp-advanced-policy-config.adoc +++ b/edge_computing/ztp-advanced-policy-config.adoc @@ -13,7 +13,7 @@ include::modules/ztp-deploying-additional-changes-to-clusters.adoc[leveloffset=+ [role="_additional-resources"] .Additional resources -* xref:../../scalability_and_performance/ztp_far_edge/ztp-advanced-install-ztp.adoc#ztp-customizing-the-install-extra-manifests_ztp-advanced-install-ztp[Customizing extra installation manifests in the {ztp} pipeline] +* xref:../edge_computing/ztp-advanced-install-ztp.adoc#ztp-customizing-the-install-extra-manifests_ztp-advanced-install-ztp[Customizing extra installation manifests in the {ztp} pipeline] include::modules/ztp-using-pgt-to-update-source-crs.adoc[leveloffset=+1] @@ -26,16 +26,16 @@ include::modules/ztp-creating-a-validator-inform-policy.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../scalability_and_performance/ztp_far_edge/ztp-updating-gitops.adoc#ztp-updating-gitops[Upgrading {ztp}] +* xref:../edge_computing/ztp-updating-gitops.adoc#ztp-updating-gitops[Upgrading {ztp}] include::modules/ztp-using-pgt-to-configure-power-states.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../scalability_and_performance/cnf-low-latency-tuning.adoc#cnf-understanding-workload-hints_cnf-master[Understanding workload hints] +* xref:../scalability_and_performance/cnf-low-latency-tuning.adoc#cnf-understanding-workload-hints_cnf-master[Understanding workload hints] -* xref:../../scalability_and_performance/cnf-low-latency-tuning.adoc#configuring-workload-hints_cnf-master[Configuring workload hints manually] +* xref:../scalability_and_performance/cnf-low-latency-tuning.adoc#configuring-workload-hints_cnf-master[Configuring workload hints manually] include::modules/ztp-using-pgt-to-configure-performance-mode.adoc[leveloffset=+2] @@ -46,11 +46,11 @@ include::modules/ztp-using-pgt-to-configure-power-saving-mode.adoc[leveloffset=+ [role="_additional-resources"] .Additional resources -* xref:../../scalability_and_performance/cnf-low-latency-tuning.adoc#node-tuning-operator-pod-power-saving-config_cnf-master[Enabling critical workloads for power saving configurations] +* xref:../scalability_and_performance/cnf-low-latency-tuning.adoc#node-tuning-operator-pod-power-saving-config_cnf-master[Enabling critical workloads for power saving configurations] -* xref:../../scalability_and_performance/ztp_far_edge/ztp-reference-cluster-configuration-for-vdu.adoc#ztp-du-configuring-host-firmware-requirements_sno-configure-for-vdu[Configuring host firmware for low latency and high performance] +* xref:../edge_computing/ztp-reference-cluster-configuration-for-vdu.adoc#ztp-du-configuring-host-firmware-requirements_sno-configure-for-vdu[Configuring host firmware for low latency and high performance] -* xref:../../scalability_and_performance/ztp_far_edge/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-ztp-git-repository_ztp-preparing-the-hub-cluster[Preparing the {ztp} site configuration repository] +* xref:../edge_computing/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-ztp-git-repository_ztp-preparing-the-hub-cluster[Preparing the {ztp} site configuration repository] include::modules/ztp-using-pgt-to-maximize-power-saving-mode.adoc[leveloffset=+2] @@ -68,15 +68,15 @@ include::modules/ztp-configuring-ptp-fast-events.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* xref:../../scalability_and_performance/ztp_far_edge/ztp-advanced-policy-config.adoc#ztp-using-pgt-to-update-source-crs_ztp-advanced-policy-config[Using PolicyGenTemplate CRs to override source CRs content] +* xref:../edge_computing/ztp-advanced-policy-config.adoc#ztp-using-pgt-to-update-source-crs_ztp-advanced-policy-config[Using PolicyGenTemplate CRs to override source CRs content] include::modules/ztp-configuring-ptp-fast-events-amqp.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* xref:../../networking/ptp/using-ptp-events.adoc#cnf-installing-amq-interconnect-messaging-bus_using-ptp-events[Installing the AMQ messaging bus] -* For more information about container image registries, see xref:../../registry/index.adoc#registry-overview[{product-registry} overview]. +* xref:../networking/ptp/using-ptp-events.adoc#cnf-installing-amq-interconnect-messaging-bus_using-ptp-events[Installing the AMQ messaging bus] +* For more information about container image registries, see xref:../registry/index.adoc#registry-overview[{product-registry} overview]. [id="ztp-advanced-policy-config-bare-metal_{context}"] == Configuring bare-metal events with PolicyGenTemplate CRs @@ -90,9 +90,9 @@ include::modules/ztp-configuring-hwevents-using-pgt.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* xref:../../scalability_and_performance/using-rfhe.adoc#nw-rfhe-installing-operator-cli_using-rfhe[Installing the {redfish-operator} using the CLI] +* xref:../scalability_and_performance/using-rfhe.adoc#nw-rfhe-installing-operator-cli_using-rfhe[Installing the {redfish-operator} using the CLI] -* xref:../../scalability_and_performance/using-rfhe.adoc#nw-rfhe-creating-hardware-event_using-rfhe[Creating the bare-metal event and Secret CRs] +* xref:../scalability_and_performance/using-rfhe.adoc#nw-rfhe-creating-hardware-event_using-rfhe[Creating the bare-metal event and Secret CRs] include::modules/ztp-creating-hwevents-amqp.adoc[leveloffset=+2] @@ -101,7 +101,7 @@ include::modules/ztp-add-local-reg-for-sno-duprofile.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../registry/index.adoc#registry-overview[{product-title} registry overview]. +* xref:../registry/index.adoc#registry-overview[{product-title} registry overview]. include::modules/ztp-configuring-disk-partitioning.adoc[leveloffset=+2] @@ -110,7 +110,7 @@ include::modules/ztp-configuring-pgt-image-registry.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* xref:../../registry/accessing-the-registry.adoc#accessing-the-registry[Accessing the registry] +* xref:../registry/accessing-the-registry.adoc#accessing-the-registry[Accessing the registry] include::modules/ztp-using-hub-cluster-templates.adoc[leveloffset=+1] diff --git a/scalability_and_performance/ztp_far_edge/ztp-configuring-managed-clusters-policies.adoc b/edge_computing/ztp-configuring-managed-clusters-policies.adoc similarity index 77% rename from scalability_and_performance/ztp_far_edge/ztp-configuring-managed-clusters-policies.adoc rename to edge_computing/ztp-configuring-managed-clusters-policies.adoc index 551629a8a0..e52160f223 100644 --- a/scalability_and_performance/ztp_far_edge/ztp-configuring-managed-clusters-policies.adoc +++ b/edge_computing/ztp-configuring-managed-clusters-policies.adoc @@ -29,14 +29,14 @@ include::modules/ztp-policygentemplates-for-ran.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../scalability_and_performance/ztp_far_edge/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-ztp-git-repository_ztp-preparing-the-hub-cluster[Preparing the {ztp} site configuration repository] +* xref:../edge_computing/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-ztp-git-repository_ztp-preparing-the-hub-cluster[Preparing the {ztp} site configuration repository] include::modules/ztp-customizing-a-managed-site-using-pgt.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../scalability_and_performance/ztp_far_edge/ztp-advanced-policy-config.adoc#ztp-creating-a-validator-inform-policy_ztp-advanced-policy-config[Signalling ZTP cluster deployment completion with validator inform policies] +* xref:../edge_computing/ztp-advanced-policy-config.adoc#ztp-creating-a-validator-inform-policy_ztp-advanced-policy-config[Signalling ZTP cluster deployment completion with validator inform policies] include::modules/ztp-monitoring-policy-deployment-progress.adoc[leveloffset=+1] @@ -48,7 +48,7 @@ include::modules/ztp-restarting-policies-reconciliation.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* For information about using {cgu-operator-first} to construct your own `ClusterGroupUpgrade` CR, see xref:../../scalability_and_performance/ztp_far_edge/cnf-talm-for-cluster-upgrades.adoc#talo-about-cgu-crs_cnf-topology-aware-lifecycle-manager[About the ClusterGroupUpgrade CR]. +* For information about using {cgu-operator-first} to construct your own `ClusterGroupUpgrade` CR, see xref:../edge_computing/cnf-talm-for-cluster-upgrades.adoc#talo-about-cgu-crs_cnf-topology-aware-lifecycle-manager[About the ClusterGroupUpgrade CR]. include::modules/ztp-removing-content-from-managed-clusters.adoc[leveloffset=+1] diff --git a/scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-clusters-at-scale.adoc b/edge_computing/ztp-deploying-far-edge-clusters-at-scale.adoc similarity index 81% rename from scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-clusters-at-scale.adoc rename to edge_computing/ztp-deploying-far-edge-clusters-at-scale.adoc index 22db0e5fcc..1d6dfe112e 100644 --- a/scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-clusters-at-scale.adoc +++ b/edge_computing/ztp-deploying-far-edge-clusters-at-scale.adoc @@ -19,4 +19,4 @@ include::modules/ztp-configuring-cluster-policies.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* For more information about extracting the reference `SiteConfig` and `PolicyGenTemplate` CRs from the `ztp-site-generate` container image, see xref:../../scalability_and_performance/ztp_far_edge/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-ztp-git-repository_ztp-preparing-the-hub-cluster[Preparing the ZTP Git repository]. +* For more information about extracting the reference `SiteConfig` and `PolicyGenTemplate` CRs from the `ztp-site-generate` container image, see xref:../edge_computing/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-ztp-git-repository_ztp-preparing-the-hub-cluster[Preparing the ZTP Git repository]. diff --git a/scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-sites.adoc b/edge_computing/ztp-deploying-far-edge-sites.adoc similarity index 50% rename from scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-sites.adoc rename to edge_computing/ztp-deploying-far-edge-sites.adoc index 742bd1c7f0..09b2caedd8 100644 --- a/scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-sites.adoc +++ b/edge_computing/ztp-deploying-far-edge-sites.adoc @@ -14,7 +14,7 @@ include::modules/ztp-ztp-building-blocks.adoc[leveloffset=+1] [IMPORTANT] ==== -The target bare-metal host must meet the networking, firmware, and hardware requirements listed in xref:../../scalability_and_performance/ztp_far_edge/ztp-reference-cluster-configuration-for-vdu.adoc#sno-configure-for-vdu[Recommended {sno} cluster configuration for vDU application workloads]. +The target bare-metal host must meet the networking, firmware, and hardware requirements listed in xref:../edge_computing/ztp-reference-cluster-configuration-for-vdu.adoc#sno-configure-for-vdu[Recommended {sno} cluster configuration for vDU application workloads]. ==== include::modules/ztp-creating-the-site-secrets.adoc[leveloffset=+1] @@ -26,26 +26,26 @@ include::modules/ztp-deploying-a-site.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-sites.adoc#ztp-sno-siteconfig-config-reference_ztp-deploying-far-edge-sites[{sno-caps} SiteConfig CR installation reference] +* xref:../edge_computing/ztp-deploying-far-edge-sites.adoc#ztp-sno-siteconfig-config-reference_ztp-deploying-far-edge-sites[{sno-caps} SiteConfig CR installation reference] include::modules/ztp-sno-siteconfig-config-reference.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* xref:../../scalability_and_performance/ztp_far_edge/ztp-advanced-install-ztp.adoc#ztp-customizing-the-install-extra-manifests_ztp-advanced-install-ztp[Customizing extra installation manifests in the {ztp} pipeline] +* xref:../edge_computing/ztp-advanced-install-ztp.adoc#ztp-customizing-the-install-extra-manifests_ztp-advanced-install-ztp[Customizing extra installation manifests in the {ztp} pipeline] -* xref:../../scalability_and_performance/ztp_far_edge/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-ztp-git-repository_ztp-preparing-the-hub-cluster[Preparing the {ztp} site configuration repository] +* xref:../edge_computing/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-ztp-git-repository_ztp-preparing-the-hub-cluster[Preparing the {ztp} site configuration repository] -* xref:../../scalability_and_performance/ztp_far_edge/ztp-preparing-the-hub-cluster.adoc#ztp-configuring-hub-cluster-with-argocd_ztp-preparing-the-hub-cluster[Configuring the hub cluster with ArgoCD] +* xref:../edge_computing/ztp-preparing-the-hub-cluster.adoc#ztp-configuring-hub-cluster-with-argocd_ztp-preparing-the-hub-cluster[Configuring the hub cluster with ArgoCD] -* xref:../../scalability_and_performance/ztp_far_edge/ztp-advanced-policy-config.adoc#ztp-creating-a-validator-inform-policy_ztp-advanced-policy-config[Signalling ZTP cluster deployment completion with validator inform policies] +* xref:../edge_computing/ztp-advanced-policy-config.adoc#ztp-creating-a-validator-inform-policy_ztp-advanced-policy-config[Signalling ZTP cluster deployment completion with validator inform policies] -* xref:../../scalability_and_performance/ztp_far_edge/ztp-manual-install.adoc#ztp-creating-the-site-secrets_ztp-manual-install[Creating the managed bare-metal host secrets] +* xref:../edge_computing/ztp-manual-install.adoc#ztp-creating-the-site-secrets_ztp-manual-install[Creating the managed bare-metal host secrets] -* xref:../../installing/installing_bare_metal_ipi/ipi-install-installation-workflow.adoc#bmc-addressing_ipi-install-installation-workflow[BMC addressing] +* xref:../installing/installing_bare_metal_ipi/ipi-install-installation-workflow.adoc#bmc-addressing_ipi-install-installation-workflow[BMC addressing] -* xref:../../installing/installing_with_agent_based_installer/preparing-to-install-with-agent-based-installer.adoc#root-device-hints_preparing-to-install-with-agent-based-installer[About root device hints] +* xref:../installing/installing_with_agent_based_installer/preparing-to-install-with-agent-based-installer.adoc#root-device-hints_preparing-to-install-with-agent-based-installer[About root device hints] include::modules/ztp-monitoring-installation-progress.adoc[leveloffset=+1] diff --git a/edge_computing/ztp-image-based-upgrade.adoc b/edge_computing/ztp-image-based-upgrade.adoc new file mode 100644 index 0000000000..22ba2a1610 --- /dev/null +++ b/edge_computing/ztp-image-based-upgrade.adoc @@ -0,0 +1,73 @@ +:_mod-docs-content-type: ASSEMBLY +[id="ztp-image-based-upgrade-for-sno"] += Image-based upgrade for {sno} clusters +include::_attributes/common-attributes.adoc[] +:context: ztp-image-based-upgrade + +toc::[] + +You can use the {lcao} to perform an image-based upgrade on managed {sno} clusters. + +:FeatureName: The Lifecycle Agent + +// Lifecycle Agent (LCAO) + +include::modules/ztp-image-based-upgrade.adoc[leveloffset=+1] + +include::modules/ztp-image-based-upgrade-installing-lifecycle-agent-using-cli.adoc[leveloffset=+2] + +include::modules/ztp-image-based-upgrade-installing-lifecycle-agent-using-web-console.adoc[leveloffset=+2] + +include::modules/ztp-image-based-upgrade-share-container-directory.adoc[leveloffset=+2] + +[role="_additional-resources"] +.Additional resources + +* link:https://www.redhat.com/en/blog/a-guide-to-creating-a-separate-disk-partition-at-installation-time[A Guide for Creating a Separate-disk Partition at Installation Time] + +include::modules/ztp-image-based-upgrade-generate-seed-image.adoc[leveloffset=+2] + +[role="_additional-resources"] +.Additional resources + +* link:https://www.redhat.com/en/blog/a-guide-to-creating-a-separate-disk-partition-at-installation-time[A Guide for Creating a Separate-disk Partition at Installation Time] + +* xref:../edge_computing/ztp-talm-updating-managed-policies.adoc#ztp-image-based-upgrade-shared-container-directory_ztp-image-based-upgrade[Sharing the container directory between `ostree` stateroots] + +* xref:../backup_and_restore/application_backup_and_restore/installing/oadp-installing-operator.adoc#oadp-installing-operator-doc[Installing the OADP Operator] + +include::modules/ztp-image-based-upgrade-prep.adoc[leveloffset=+2] + +[role="_additional-resources"] +.Additional resources + +* link:https://www.redhat.com/en/blog/a-guide-to-creating-a-separate-disk-partition-at-installation-time[A Guide for Creating a Separate-disk Partition at Installation Time] + +* xref:../scalability_and_performance/scalability_and_performance/ztp_far_edge/ztp-image-based-upgrade#ztp-image-based-upgrade-shared-container-directory_ztp-image-based-upgrade[Sharing the container directory between `ostree` stateroots] + +* xref:../backup_and_restore/application_backup_and_restore/installing/installing-oadp-ocs.adoc#oadp-about-backup-snapshot-locations_installing-oadp-ocs[About backup and snapshot locations and their secrets] + +* xref:../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/oadp-creating-backup-cr.adoc#oadp-creating-backup-cr-doc[Creating a Backup CR] + +* xref:../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/restoring-applications.adoc#oadp-creating-restore-cr_restoring-applications[Creating a Restore CR] + +include::modules/ztp-image-based-upgrade-with-backup.adoc[leveloffset=+2] + +include::modules/ztp-image-based-upgrade-rollback.adoc[leveloffset=+2] + +include::modules/ztp-image-based-upgrade-talm.adoc[leveloffset=+2] + +[role="_additional-resources"] +.Additional resources + +* xref:../edge_computing/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-ztp-git-repository-ver-ind_ztp-preparing-the-hub-cluster[Preparing the GitOps ZTP site configuration repository for version independence] + +* xref:../edge_computing/ztp_far_edge/ztp-image-based-upgrade#ztp-image-based-upgrade-prep_ztp-image-based-upgrade[Preparing the single-node OpenShift cluster for the image-based upgrade] + +* xref:../edge_computing/ztp_far_edge/ztp-image-based-upgrade#ztp-image-based-upgrade-shared-container-directory_ztp-image-based-upgrade[Sharing the container directory between `ostree` stateroots] + +* xref:../backup_and_restore/application_backup_and_restore/installing/installing-oadp-ocs.adoc#oadp-about-backup-snapshot-locations_installing-oadp-ocs[About backup and snapshot locations and their secrets] + +* xref:../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/oadp-creating-backup-cr.adoc#oadp-creating-backup-cr-doc[Creating a Backup CR] + +* xref:../backup_and_restore/application_backup_and_restore/backing_up_and_restoring/restoring-applications.adoc#oadp-creating-restore-cr_restoring-applications[Creating a Restore CR] diff --git a/edge_computing/ztp-manual-install.adoc b/edge_computing/ztp-manual-install.adoc new file mode 100644 index 0000000000..e78d675a99 --- /dev/null +++ b/edge_computing/ztp-manual-install.adoc @@ -0,0 +1,53 @@ +:_mod-docs-content-type: ASSEMBLY +[id="ztp-manual-install"] += Manually installing a {sno} cluster with ZTP +include::_attributes/common-attributes.adoc[] +:context: ztp-manual-install + +toc::[] + +You can deploy a managed {sno} cluster by using {rh-rhacm-first} and the assisted service. + +[NOTE] +==== +If you are creating multiple managed clusters, use the `SiteConfig` method described in xref:../edge_computing/ztp-deploying-far-edge-sites.adoc#ztp-deploying-far-edge-sites[Deploying far edge sites with ZTP]. +==== + +[IMPORTANT] +==== +The target bare-metal host must meet the networking, firmware, and hardware requirements listed in xref:../edge_computing/ztp-reference-cluster-configuration-for-vdu.adoc#sno-configure-for-vdu[Recommended cluster configuration for vDU application workloads]. +==== + +include::modules/ztp-generating-install-and-config-crs-manually.adoc[leveloffset=+1] + +[role="_additional-resources"] +.Additional resources + +* xref:../edge_computing/ztp-reference-cluster-configuration-for-vdu.adoc#ztp-sno-du-enabling-workload-partitioning_sno-configure-for-vdu[Workload partitioning] + +* xref:../installing/installing_bare_metal_ipi/ipi-install-installation-workflow.adoc#bmc-addressing_ipi-install-installation-workflow[BMC addressing] + +* xref:../installing/installing_with_agent_based_installer/preparing-to-install-with-agent-based-installer.adoc#root-device-hints_preparing-to-install-with-agent-based-installer[About root device hints] + +* xref:../edge_computing/ztp-deploying-far-edge-sites.adoc#ztp-sno-siteconfig-config-reference_ztp-deploying-far-edge-sites[{sno-caps} SiteConfig CR installation reference] + +include::modules/ztp-creating-the-site-secrets.adoc[leveloffset=+1] + +include::modules/ztp-configuring-kernel-arguments-for-discovery-iso-in-manual-installations.adoc[leveloffset=+1] + +include::modules/ztp-manually-install-a-single-managed-cluster.adoc[leveloffset=+1] + +[role="_additional-resources"] +.Additional resources + +* xref:../edge_computing/ztp-reference-cluster-configuration-for-vdu.adoc#ztp-managed-cluster-network-prereqs_sno-configure-for-vdu[Connectivity prerequisites for managed cluster networks] + +* xref:../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#lvms-preface-sno-ran_logical-volume-manager-storage[Deploying LVM Storage on single-node OpenShift clusters] + +* xref:../edge_computing/ztp-advanced-policy-config.adoc#ztp-provisioning-lvm-storage_ztp-advanced-policy-config[Configuring LVM Storage using PolicyGenTemplate CRs] + +include::modules/ztp-checking-the-managed-cluster-status.adoc[leveloffset=+1] + +include::modules/ztp-troubleshooting-the-managed-cluster.adoc[leveloffset=+1] + +include::modules/ztp-installation-crs.adoc[leveloffset=+1] diff --git a/scalability_and_performance/ztp_far_edge/ztp-precaching-tool.adoc b/edge_computing/ztp-precaching-tool.adoc similarity index 81% rename from scalability_and_performance/ztp_far_edge/ztp-precaching-tool.adoc rename to edge_computing/ztp-precaching-tool.adoc index aabeb3a2b7..1449d91e48 100644 --- a/scalability_and_performance/ztp_far_edge/ztp-precaching-tool.adoc +++ b/edge_computing/ztp-precaching-tool.adoc @@ -30,11 +30,11 @@ include::modules/ztp-precaching-booting-from-live-os.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* For more information about the `butane` utility, see xref:../../installing/install_config/installing-customizing.adoc#installation-special-config-butane-about_installing-customizing[About Butane]. -* For more information about creating a custom live {op-system} ISO, see xref:../../installing/installing_sno/install-sno-installing-sno.adoc#create-custom-live-rhcos-iso_install-sno-installing-sno-with-the-assisted-installer[Creating a custom live {op-system} ISO for remote server access]. +* For more information about the `butane` utility, see xref:../installing/install_config/installing-customizing.adoc#installation-special-config-butane-about_installing-customizing[About Butane]. +* For more information about creating a custom live {op-system} ISO, see xref:../installing/installing_sno/install-sno-installing-sno.adoc#create-custom-live-rhcos-iso_install-sno-installing-sno-with-the-assisted-installer[Creating a custom live {op-system} ISO for remote server access]. * For more information about using the Dell RACADM tool, see link:https://www.dell.com/support/manuals/en-ie/poweredge-r440/idrac9_6.xx_racadm_pub/supported-racadm-interfaces?guid=guid-a5747353-fc88-4438-b617-c50ca260448e&lang=en-us[Integrated Dell Remote Access Controller 9 RACADM CLI Guide]. * For more information about using the HP HPONCFG tool, see link:https://support.hpe.com/hpesc/public/docDisplay?docId=emr_na-a00007610en_us[Using HPONCFG]. -* For more information about using the Redfish BMC API, see xref:../../installing/installing_sno/install-sno-installing-sno.adoc#install-booting-from-an-iso-over-http-redfish_install-sno-installing-sno-with-the-assisted-installer[Booting from an HTTP-hosted ISO image using the Redfish API]. +* For more information about using the Redfish BMC API, see xref:../installing/installing_sno/install-sno-installing-sno.adoc#install-booting-from-an-iso-over-http-redfish_install-sno-installing-sno-with-the-assisted-installer[Booting from an HTTP-hosted ISO image using the Redfish API]. include::modules/ztp-precaching-partitioning.adoc[leveloffset=+1] diff --git a/scalability_and_performance/ztp_far_edge/ztp-preparing-the-hub-cluster.adoc b/edge_computing/ztp-preparing-the-hub-cluster.adoc similarity index 69% rename from scalability_and_performance/ztp_far_edge/ztp-preparing-the-hub-cluster.adoc rename to edge_computing/ztp-preparing-the-hub-cluster.adoc index e11a610f36..1674ae386c 100644 --- a/scalability_and_performance/ztp_far_edge/ztp-preparing-the-hub-cluster.adoc +++ b/edge_computing/ztp-preparing-the-hub-cluster.adoc @@ -24,18 +24,18 @@ include::modules/ztp-acm-installing-disconnected-rhacm.adoc[leveloffset=+1] * link:https://docs.openshift.com/gitops/latest/installing_gitops/installing-openshift-gitops.html#installing-openshift-gitops[Installing OpenShift GitOps] -* xref:../../scalability_and_performance/ztp_far_edge/cnf-talm-for-cluster-upgrades.adoc#installing-topology-aware-lifecycle-manager-using-cli_cnf-topology-aware-lifecycle-manager[Installing {cgu-operator}] +* xref:../edge_computing/cnf-talm-for-cluster-upgrades.adoc#installing-topology-aware-lifecycle-manager-using-cli_cnf-topology-aware-lifecycle-manager[Installing {cgu-operator}] -* xref:../../operators/admin/olm-restricted-networks.adoc#olm-mirror-catalog_olm-restricted-networks[Mirroring an Operator catalog] +* xref:../operators/admin/olm-restricted-networks.adoc#olm-mirror-catalog_olm-restricted-networks[Mirroring an Operator catalog] include::modules/ztp-acm-adding-images-to-mirror-registry.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* xref:../../installing/disconnected_install/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry] +* xref:../installing/disconnected_install/installing-mirroring-creating-registry.adoc#installing-mirroring-creating-registry[Creating a mirror registry] -* xref:../../installing/disconnected_install/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation] +* xref:../installing/disconnected_install/installing-mirroring-installation-images.adoc#installing-mirroring-installation-images[Mirroring images for a disconnected installation] include::modules/ztp-enabling-assisted-installer-service-on-bare-metal.adoc[leveloffset=+1] @@ -44,7 +44,7 @@ include::modules/ztp-configuring-the-cluster-for-a-disconnected-environment.adoc [role="_additional-resources"] .Additional resources -* xref:../../installing/disconnected_install/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the OpenShift Container Platform image repository] +* xref:../installing/disconnected_install/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the OpenShift Container Platform image repository] include::modules/ztp-configuring-the-hub-cluster-to-use-unauthenticated-registries.adoc[leveloffset=+1] diff --git a/scalability_and_performance/ztp_far_edge/ztp-reference-cluster-configuration-for-vdu.adoc b/edge_computing/ztp-reference-cluster-configuration-for-vdu.adoc similarity index 76% rename from scalability_and_performance/ztp_far_edge/ztp-reference-cluster-configuration-for-vdu.adoc rename to edge_computing/ztp-reference-cluster-configuration-for-vdu.adoc index 44a87224fb..47d0b3c0bb 100644 --- a/scalability_and_performance/ztp_far_edge/ztp-reference-cluster-configuration-for-vdu.adoc +++ b/edge_computing/ztp-reference-cluster-configuration-for-vdu.adoc @@ -11,9 +11,9 @@ Use the following reference information to understand the {sno} configurations r [role="_additional-resources"] .Additional resources -* To deploy a single cluster by hand, see xref:../../scalability_and_performance/ztp_far_edge/ztp-manual-install.adoc#ztp-manual-install[Manually installing a {sno} cluster with {ztp}]. +* To deploy a single cluster by hand, see xref:../edge_computing/ztp-manual-install.adoc#ztp-manual-install[Manually installing a {sno} cluster with {ztp}]. -* To deploy a fleet of clusters using {ztp-first}, see xref:../../scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-sites.adoc#ztp-deploying-far-edge-sites[Deploying far edge sites with {ztp}]. +* To deploy a fleet of clusters using {ztp-first}, see xref:../edge_computing/ztp-deploying-far-edge-sites.adoc#ztp-deploying-far-edge-sites[Deploying far edge sites with {ztp}]. include::modules/ztp-low-latency.adoc[leveloffset=+1] @@ -28,7 +28,7 @@ include::modules/ztp-enabling-workload-partitioning-sno.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* For the recommended {sno} workload partitioning configuration, see xref:../../scalability_and_performance/ztp_far_edge/ztp-reference-cluster-configuration-for-vdu.adoc#ztp-sno-du-enabling-workload-partitioning_sno-configure-for-vdu[Workload partitioning]. +* For the recommended {sno} workload partitioning configuration, see xref:../edge_computing/ztp-reference-cluster-configuration-for-vdu.adoc#ztp-sno-du-enabling-workload-partitioning_sno-configure-for-vdu[Workload partitioning]. [id="ztp-sno-install-time-cluster-config"] == Recommended cluster install manifests @@ -40,7 +40,7 @@ The ZTP pipeline applies the following custom resources (CRs) during cluster ins When using the {ztp} plugin and `SiteConfig` CRs for cluster deployment, the following `MachineConfig` CRs are included by default. ==== -Use the `SiteConfig` `extraManifests` filter to alter the CRs that are included by default. For more information, see xref:../../scalability_and_performance/ztp_far_edge/ztp-advanced-install-ztp.adoc#ztp-advanced-install-ztp[Advanced managed cluster configuration with SiteConfig CRs]. +Use the `SiteConfig` `extraManifests` filter to alter the CRs that are included by default. For more information, see xref:../edge_computing/ztp-advanced-install-ztp.adoc#ztp-advanced-install-ztp[Advanced managed cluster configuration with SiteConfig CRs]. include::modules/ztp-sno-du-enabling-workload-partitioning.adoc[leveloffset=+2] @@ -65,7 +65,7 @@ When the cluster installation is complete, the ZTP pipeline applies the followin [NOTE] ==== -In {ztp} v4.10 and earlier, you configure UEFI secure boot with a `MachineConfig` CR. This is no longer required in {ztp} v4.11 and later. In v4.11, you configure UEFI secure boot for {sno} clusters by updating the `spec.clusters.nodes.bootMode` field in the `SiteConfig` CR that you use to install the cluster. For more information, see xref:../../scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-sites.adoc#ztp-deploying-a-site_ztp-deploying-far-edge-sites[Deploying a managed cluster with SiteConfig and {ztp}]. +In {ztp} v4.10 and earlier, you configure UEFI secure boot with a `MachineConfig` CR. This is no longer required in {ztp} v4.11 and later. In v4.11, you configure UEFI secure boot for {sno} clusters by updating the `spec.clusters.nodes.bootMode` field in the `SiteConfig` CR that you use to install the cluster. For more information, see xref:../edge_computing/ztp-deploying-far-edge-sites.adoc#ztp-deploying-a-site_ztp-deploying-far-edge-sites[Deploying a managed cluster with SiteConfig and {ztp}]. ==== include::modules/ztp-sno-du-configuring-the-operators.adoc[leveloffset=+2] @@ -97,4 +97,4 @@ include::modules/ztp-sno-du-disabling-network-diagnostics.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* xref:../../scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-sites.adoc#ztp-deploying-far-edge-sites[Deploying far edge sites using ZTP] +* xref:../edge_computing/ztp-deploying-far-edge-sites.adoc#ztp-deploying-far-edge-sites[Deploying far edge sites using ZTP] diff --git a/scalability_and_performance/ztp_far_edge/ztp-sno-additional-worker-node.adoc b/edge_computing/ztp-sno-additional-worker-node.adoc similarity index 85% rename from scalability_and_performance/ztp_far_edge/ztp-sno-additional-worker-node.adoc rename to edge_computing/ztp-sno-additional-worker-node.adoc index 41f9833fa5..37f4270e14 100644 --- a/scalability_and_performance/ztp_far_edge/ztp-sno-additional-worker-node.adoc +++ b/edge_computing/ztp-sno-additional-worker-node.adoc @@ -24,9 +24,9 @@ include::snippets/technology-preview.adoc[] [role="_additional-resources"] .Additional resources -* For more information about {sno} clusters tuned for vDU application deployments, see xref:../../scalability_and_performance/ztp_far_edge/ztp-reference-cluster-configuration-for-vdu.adoc#sno-configure-for-vdu[Reference configuration for deploying vDUs on {sno}]. +* For more information about {sno} clusters tuned for vDU application deployments, see xref:../edge_computing/ztp-reference-cluster-configuration-for-vdu.adoc#sno-configure-for-vdu[Reference configuration for deploying vDUs on {sno}]. -* For more information about worker nodes, see xref:../../nodes/nodes/nodes-sno-worker-nodes.adoc[Adding worker nodes to single-node OpenShift clusters]. +* For more information about worker nodes, see xref:../nodes/nodes/nodes-sno-worker-nodes.adoc#nodes-sno-worker-nodes[Adding worker nodes to {sno} clusters]. include::modules/ztp-worker-node-applying-du-profile.adoc[leveloffset=+1] diff --git a/scalability_and_performance/ztp_far_edge/ztp-talm-updating-managed-policies.adoc b/edge_computing/ztp-talm-updating-managed-policies.adoc similarity index 51% rename from scalability_and_performance/ztp_far_edge/ztp-talm-updating-managed-policies.adoc rename to edge_computing/ztp-talm-updating-managed-policies.adoc index f11b6a3492..1058b61673 100644 --- a/scalability_and_performance/ztp_far_edge/ztp-talm-updating-managed-policies.adoc +++ b/edge_computing/ztp-talm-updating-managed-policies.adoc @@ -13,38 +13,38 @@ You can use the {cgu-operator-first} to manage the software lifecycle of {produc [role="_additional-resources"] .Additional resources -* For more information about the {cgu-operator-full}, see xref:../../scalability_and_performance/ztp_far_edge/cnf-talm-for-cluster-upgrades.adoc#cnf-about-topology-aware-lifecycle-manager-config_cnf-topology-aware-lifecycle-manager[About the {cgu-operator-full}]. +* For more information about the {cgu-operator-full}, see xref:../edge_computing/cnf-talm-for-cluster-upgrades.adoc#cnf-about-topology-aware-lifecycle-manager-config_cnf-topology-aware-lifecycle-manager[About the {cgu-operator-full}]. include::modules/cnf-topology-aware-lifecycle-manager-preparing-for-updates.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* For more information about how to update {ztp-first}, see xref:../../scalability_and_performance/ztp_far_edge/ztp-updating-gitops.adoc#ztp-updating-gitops[Upgrading {ztp}]. +* For more information about how to update {ztp-first}, see xref:../edge_computing/ztp-updating-gitops.adoc#ztp-updating-gitops[Upgrading {ztp}]. -* For more information about how to mirror an {product-title} image repository, see xref:../../installing/disconnected_install/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository]. +* For more information about how to mirror an {product-title} image repository, see xref:../installing/disconnected_install/installing-mirroring-installation-images.adoc#installation-mirror-repository_installing-mirroring-installation-images[Mirroring the {product-title} image repository]. -* For more information about how to mirror Operator catalogs for disconnected clusters, see xref:../../installing/disconnected_install/installing-mirroring-installation-images.adoc#olm-mirror-catalog_installing-mirroring-installation-images[Mirroring Operator catalogs for use with disconnected clusters]. +* For more information about how to mirror Operator catalogs for disconnected clusters, see xref:../installing/disconnected_install/installing-mirroring-installation-images.adoc#olm-mirror-catalog_installing-mirroring-installation-images[Mirroring Operator catalogs for use with disconnected clusters]. -* For more information about how to prepare the disconnected environment and mirroring the desired image repository, see xref:../../scalability_and_performance/ztp_far_edge/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-hub-cluster[Preparing the disconnected environment]. +* For more information about how to prepare the disconnected environment and mirroring the desired image repository, see xref:../edge_computing/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-hub-cluster[Preparing the disconnected environment]. -* For more information about update channels and releases, see xref:../../updating/understanding_updates/understanding-update-channels-release.adoc#understanding-update-channels-releases[Understanding update channels and releases]. +* For more information about update channels and releases, see xref:../updating/understanding_updates/understanding-update-channels-release.adoc#understanding-update-channels-releases[Understanding update channels and releases]. include::modules/cnf-topology-aware-lifecycle-manager-platform-update.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* For more information about mirroring the images in a disconnected environment, see xref:../../scalability_and_performance/ztp_far_edge/ztp-preparing-the-hub-cluster.adoc#ztp-acm-adding-images-to-mirror-registry_ztp-preparing-the-hub-cluster[Preparing the disconnected environment]. +* For more information about mirroring the images in a disconnected environment, see xref:../edge_computing/ztp-preparing-the-hub-cluster.adoc#ztp-acm-adding-images-to-mirror-registry_ztp-preparing-the-hub-cluster[Preparing the disconnected environment]. include::modules/cnf-topology-aware-lifecycle-manager-operator-update.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* For more information about updating {ztp}, see xref:../../scalability_and_performance/ztp_far_edge/ztp-updating-gitops.adoc#ztp-updating-gitops[Upgrading {ztp}]. +* For more information about updating {ztp}, see xref:../edge_computing/ztp-updating-gitops.adoc#ztp-updating-gitops[Upgrading {ztp}]. -* xref:../../scalability_and_performance/ztp_far_edge/ztp-talm-updating-managed-policies.adoc#cnf-topology-aware-lifecycle-manager-operator-troubleshooting_ztp-talm[Troubleshooting missed Operator updates due to out-of-date policy compliance states]. +* xref:../edge_computing/ztp-talm-updating-managed-policies.adoc#cnf-topology-aware-lifecycle-manager-operator-troubleshooting_ztp-talm[Troubleshooting missed Operator updates due to out-of-date policy compliance states]. include::modules/cnf-topology-aware-lifecycle-manager-operator-troubleshooting.adoc[leveloffset=+3] @@ -59,6 +59,6 @@ include::modules/cnf-topology-aware-lifecycle-manager-creating-custom-resources. [role="_additional-resources"] .Additional resources -* For more information about the {cgu-operator} pre-caching workflow, see xref:../../scalability_and_performance/ztp_far_edge/cnf-talm-for-cluster-upgrades.adoc#talo-precache-feature-concept_cnf-topology-aware-lifecycle-manager[Using the container image pre-cache feature]. +* For more information about the {cgu-operator} precaching workflow, see xref:../edge_computing/cnf-talm-for-cluster-upgrades.adoc#talo-precache-feature-concept_cnf-topology-aware-lifecycle-manager[Using the container image precache feature]. include::modules/cnf-topology-aware-lifecycle-manager-autocreate-cgu-cr-ztp.adoc[leveloffset=+1] diff --git a/scalability_and_performance/ztp_far_edge/ztp-updating-gitops.adoc b/edge_computing/ztp-updating-gitops.adoc similarity index 72% rename from scalability_and_performance/ztp_far_edge/ztp-updating-gitops.adoc rename to edge_computing/ztp-updating-gitops.adoc index b8dea82c2b..04e62409ec 100644 --- a/scalability_and_performance/ztp_far_edge/ztp-updating-gitops.adoc +++ b/edge_computing/ztp-updating-gitops.adoc @@ -30,6 +30,6 @@ include::modules/ztp-roll-out-the-configuration-changes.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* For information about the {cgu-operator-first}, see xref:../../scalability_and_performance/ztp_far_edge/cnf-talm-for-cluster-upgrades.adoc#cnf-about-topology-aware-lifecycle-manager-config_cnf-topology-aware-lifecycle-manager[About the {cgu-operator-full} configuration]. +* For information about the {cgu-operator-first}, see xref:../edge_computing/cnf-talm-for-cluster-upgrades.adoc#cnf-about-topology-aware-lifecycle-manager-config_cnf-topology-aware-lifecycle-manager[About the {cgu-operator-full} configuration]. -* For information about creating `ClusterGroupUpgrade` CRs, see xref:../../scalability_and_performance/ztp_far_edge/ztp-talm-updating-managed-policies.adoc#talo-precache-autocreated-cgu-for-ztp_ztp-talm[About the auto-created ClusterGroupUpgrade CR for ZTP]. +* For information about creating `ClusterGroupUpgrade` CRs, see xref:../edge_computing/ztp-talm-updating-managed-policies.adoc#talo-precache-autocreated-cgu-for-ztp_ztp-talm[About the auto-created ClusterGroupUpgrade CR for ZTP]. diff --git a/scalability_and_performance/ztp_far_edge/ztp-vdu-validating-cluster-tuning.adoc b/edge_computing/ztp-vdu-validating-cluster-tuning.adoc similarity index 64% rename from scalability_and_performance/ztp_far_edge/ztp-vdu-validating-cluster-tuning.adoc rename to edge_computing/ztp-vdu-validating-cluster-tuning.adoc index f0ef25cace..77c386bd19 100644 --- a/scalability_and_performance/ztp_far_edge/ztp-vdu-validating-cluster-tuning.adoc +++ b/edge_computing/ztp-vdu-validating-cluster-tuning.adoc @@ -11,9 +11,9 @@ Before you can deploy virtual distributed unit (vDU) applications, you need to t [role="_additional-resources"] .Additional resources -* xref:../../scalability_and_performance/ztp_far_edge/ztp-reference-cluster-configuration-for-vdu.adoc#ztp-workload-partitioning-sno_sno-configure-for-vdu[Workload partitioning in {sno} with {ztp}] +* xref:../edge_computing/ztp-reference-cluster-configuration-for-vdu.adoc#ztp-workload-partitioning-sno_sno-configure-for-vdu[Workload partitioning in {sno} with {ztp}] -* xref:../../scalability_and_performance/ztp_far_edge/ztp-reference-cluster-configuration-for-vdu.adoc#sno-configure-for-vdu[Reference configuration for deploying vDUs on {sno}] +* xref:../edge_computing/ztp-reference-cluster-configuration-for-vdu.adoc#sno-configure-for-vdu[Reference configuration for deploying vDUs on {sno}] include::modules/ztp-du-firmware-config-reference.adoc[leveloffset=+1] @@ -27,9 +27,9 @@ include::modules/ztp-recommended-cluster-mc-crs.adoc[leveloffset=+2] [role="_additional-resources"] .Additional resources -* xref:../../scalability_and_performance/ztp_far_edge/ztp-reference-cluster-configuration-for-vdu.adoc#ztp-workload-partitioning-sno_sno-configure-for-vdu[Workload partitioning in {sno} with {ztp}] +* xref:../edge_computing/ztp-reference-cluster-configuration-for-vdu.adoc#ztp-workload-partitioning-sno_sno-configure-for-vdu[Workload partitioning in {sno} with {ztp}] -* xref:../../scalability_and_performance/ztp_far_edge/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-ztp-git-repository_ztp-preparing-the-hub-cluster[Extracting source CRs from the ztp-site-generate container] +* xref:../edge_computing/ztp-preparing-the-hub-cluster.adoc#ztp-preparing-the-ztp-git-repository_ztp-preparing-the-hub-cluster[Extracting source CRs from the ztp-site-generate container] include::modules/ztp-recommended-cluster-operators.adoc[leveloffset=+2] diff --git a/installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc b/installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc index d1c36c77d5..d4efce6be0 100644 --- a/installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc +++ b/installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc @@ -47,7 +47,7 @@ include::modules/installing-ocp-agent-ZTP.adoc[leveloffset=+2] .Additional resources * xref:../../installing/installing_with_agent_based_installer/installing-with-agent-based-installer.adoc#sample-ztp-custom-resources_installing-with-agent-based-installer[Sample {ztp} custom resources]. -* See xref:../../scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-clusters-at-scale.adoc#ztp-deploying-far-edge-clusters-at-scale[Challenges of the network far edge] to learn more about {ztp-first}. +* See xref:../../edge_computing/ztp-deploying-far-edge-clusters-at-scale.adoc#ztp-deploying-far-edge-clusters-at-scale[Challenges of the network far edge] to learn more about {ztp-first}. // Optional: Encrypting the disk include::modules/installing-ocp-agent-encrypt.adoc[leveloffset=+2] @@ -79,7 +79,7 @@ include::modules/sample-ztp-custom-resources.adoc[leveloffset=+1] [role="_additional-resources"] .Additional resources -* See xref:../../scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-clusters-at-scale.adoc#ztp-deploying-far-edge-clusters-at-scale[Challenges of the network far edge] to learn more about {ztp-first}. +* See xref:../../edge_computing/ztp-deploying-far-edge-clusters-at-scale.adoc#ztp-deploying-far-edge-clusters-at-scale[Challenges of the network far edge] to learn more about {ztp-first}. // Gathering log data from a failed Agent-based installation diff --git a/installing/installing_with_agent_based_installer/preparing-an-agent-based-installed-cluster-for-mce.adoc b/installing/installing_with_agent_based_installer/preparing-an-agent-based-installed-cluster-for-mce.adoc index c530e3cc6b..91a3480db3 100644 --- a/installing/installing_with_agent_based_installer/preparing-an-agent-based-installed-cluster-for-mce.adoc +++ b/installing/installing_with_agent_based_installer/preparing-an-agent-based-installed-cluster-for-mce.adoc @@ -13,7 +13,7 @@ The following procedure is partially automated and requires manual steps after t * You have read the following documentation: ** link:https://access.redhat.com/documentation/en-us/red_hat_advanced_cluster_management_for_kubernetes/2.9/html/clusters/cluster_mce_overview[Cluster lifecycle with multicluster engine operator overview]. ** xref:../../storage/persistent_storage/persistent_storage_local/persistent-storage-local.adoc#persistent-storage-using-local-volume[Persistent storage using local volumes]. -** xref:../../scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-clusters-at-scale.adoc#about-ztp_ztp-deploying-far-edge-clusters-at-scale[Using ZTP to provision clusters at the network far edge]. +** xref:../../edge_computing/ztp-deploying-far-edge-clusters-at-scale.adoc#about-ztp_ztp-deploying-far-edge-clusters-at-scale[Using {ztp} to provision clusters at the network far edge]. ** 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]. ** xref:../../installing/disconnected_install/index.adoc#installing-mirroring-disconnected-about[About disconnected installation mirroring]. * You have access to the internet to obtain the necessary container images. diff --git a/release_notes/ocp-4-15-release-notes.adoc b/release_notes/ocp-4-15-release-notes.adoc index daa39ed8ea..6ef6170dd6 100644 --- a/release_notes/ocp-4-15-release-notes.adoc +++ b/release_notes/ocp-4-15-release-notes.adoc @@ -999,7 +999,7 @@ You can set the control plane hardware speed to one of `"Standard"`, `"Slower"`, ==== Hub-side templating for PolicyGenTemplate CRs You can manage the configuration of fleets of clusters by using hub templates to populate the group and site values in the generated policies that get applied to managed clusters. By using hub templates in group and site `PolicyGenTemplate` (PGT) CRs you can significantly reduce the number of policies on the hub cluster. -For more information, see xref:../scalability_and_performance/ztp_far_edge/ztp-advanced-policy-config.adoc#ztp-specifying-nics-in-pgt-crs-with-hub-cluster-templates_ztp-advanced-policy-config[Specifying group and site configuration in group PolicyGenTemplate CRs with hub templates]. +For more information, see xref:../edge_computing/ztp-advanced-policy-config.adoc#ztp-specifying-nics-in-pgt-crs-with-hub-cluster-templates_ztp-advanced-policy-config[Specifying group and site configuration in group PolicyGenTemplate CRs with hub templates]. [id="ocp-4-15-nto-latency-testing"] ==== Node Tuning Operator (NTO) diff --git a/scalability_and_performance/cnf-low-latency-tuning.adoc b/scalability_and_performance/cnf-low-latency-tuning.adoc index 539df10e73..5fdab5f6c9 100644 --- a/scalability_and_performance/cnf-low-latency-tuning.adoc +++ b/scalability_and_performance/cnf-low-latency-tuning.adoc @@ -20,7 +20,7 @@ include::modules/cnf-provisioning-real-time-and-low-latency-workloads.adoc[level [role="_additional-resources"] .Additional resources -* For more information about recommended firmware configuration, see xref:../scalability_and_performance/ztp_far_edge/ztp-vdu-validating-cluster-tuning.adoc#ztp-du-firmware-config-reference_vdu-config-ref[Recommended firmware configuration for vDU cluster hosts]. +* For more information about recommended firmware configuration, see xref:../edge_computing/ztp-vdu-validating-cluster-tuning.adoc#ztp-du-firmware-config-reference_vdu-config-ref[Recommended firmware configuration for vDU cluster hosts]. include::modules/cnf-managing-device-interrupt-processing-for-guaranteed-pod-isolated-cpus.adoc[leveloffset=+2] diff --git a/scalability_and_performance/enabling-workload-partitioning.adoc b/scalability_and_performance/enabling-workload-partitioning.adoc index d74f21fd57..7b2efeb0d9 100644 --- a/scalability_and_performance/enabling-workload-partitioning.adoc +++ b/scalability_and_performance/enabling-workload-partitioning.adoc @@ -61,4 +61,4 @@ When workload partitioning is enabled, the `management.workload.openshift.io/cor [role="_additional-resources"] .Additional resources -* For the recommended workload partitioning configuration for {sno} clusters, see xref:../scalability_and_performance/ztp_far_edge/ztp-reference-cluster-configuration-for-vdu.adoc#ztp-sno-du-enabling-workload-partitioning_sno-configure-for-vdu[Workload partitioning]. +* For the recommended workload partitioning configuration for {sno} clusters, see xref:../edge_computing/ztp-reference-cluster-configuration-for-vdu.adoc#ztp-sno-du-enabling-workload-partitioning_sno-configure-for-vdu[Workload partitioning]. diff --git a/scalability_and_performance/ztp_far_edge/_attributes b/scalability_and_performance/ztp_far_edge/_attributes deleted file mode 120000 index 5b32de1e01..0000000000 --- a/scalability_and_performance/ztp_far_edge/_attributes +++ /dev/null @@ -1 +0,0 @@ -../../_attributes \ No newline at end of file diff --git a/scalability_and_performance/ztp_far_edge/images b/scalability_and_performance/ztp_far_edge/images deleted file mode 120000 index 5fa6987088..0000000000 --- a/scalability_and_performance/ztp_far_edge/images +++ /dev/null @@ -1 +0,0 @@ -../../images \ No newline at end of file diff --git a/scalability_and_performance/ztp_far_edge/modules b/scalability_and_performance/ztp_far_edge/modules deleted file mode 120000 index 8b0e854007..0000000000 --- a/scalability_and_performance/ztp_far_edge/modules +++ /dev/null @@ -1 +0,0 @@ -../../modules \ No newline at end of file diff --git a/scalability_and_performance/ztp_far_edge/snippets b/scalability_and_performance/ztp_far_edge/snippets deleted file mode 120000 index 7bf6da9a51..0000000000 --- a/scalability_and_performance/ztp_far_edge/snippets +++ /dev/null @@ -1 +0,0 @@ -../../snippets \ No newline at end of file diff --git a/scalability_and_performance/ztp_far_edge/ztp-manual-install.adoc b/scalability_and_performance/ztp_far_edge/ztp-manual-install.adoc deleted file mode 100644 index 4be76c0eb3..0000000000 --- a/scalability_and_performance/ztp_far_edge/ztp-manual-install.adoc +++ /dev/null @@ -1,53 +0,0 @@ -:_mod-docs-content-type: ASSEMBLY -[id="ztp-manual-install"] -= Manually installing a {sno} cluster with ZTP -include::_attributes/common-attributes.adoc[] -:context: ztp-manual-install - -toc::[] - -You can deploy a managed {sno} cluster by using {rh-rhacm-first} and the assisted service. - -[NOTE] -==== -If you are creating multiple managed clusters, use the `SiteConfig` method described in xref:../../scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-sites.adoc#ztp-deploying-far-edge-sites[Deploying far edge sites with ZTP]. -==== - -[IMPORTANT] -==== -The target bare-metal host must meet the networking, firmware, and hardware requirements listed in xref:../../scalability_and_performance/ztp_far_edge/ztp-reference-cluster-configuration-for-vdu.adoc#sno-configure-for-vdu[Recommended cluster configuration for vDU application workloads]. -==== - -include::modules/ztp-generating-install-and-config-crs-manually.adoc[leveloffset=+1] - -[role="_additional-resources"] -.Additional resources - -* xref:../../scalability_and_performance/ztp_far_edge/ztp-reference-cluster-configuration-for-vdu.adoc#ztp-sno-du-enabling-workload-partitioning_sno-configure-for-vdu[Workload partitioning] - -* xref:../../installing/installing_bare_metal_ipi/ipi-install-installation-workflow.adoc#bmc-addressing_ipi-install-installation-workflow[BMC addressing] - -* xref:../../installing/installing_with_agent_based_installer/preparing-to-install-with-agent-based-installer.adoc#root-device-hints_preparing-to-install-with-agent-based-installer[About root device hints] - -* xref:../../scalability_and_performance/ztp_far_edge/ztp-deploying-far-edge-sites.adoc#ztp-sno-siteconfig-config-reference_ztp-deploying-far-edge-sites[{sno-caps} SiteConfig CR installation reference] - -include::modules/ztp-creating-the-site-secrets.adoc[leveloffset=+1] - -include::modules/ztp-configuring-kernel-arguments-for-discovery-iso-in-manual-installations.adoc[leveloffset=+1] - -include::modules/ztp-manually-install-a-single-managed-cluster.adoc[leveloffset=+1] - -[role="_additional-resources"] -.Additional resources - -* xref:../../scalability_and_performance/ztp_far_edge/ztp-reference-cluster-configuration-for-vdu.adoc#ztp-managed-cluster-network-prereqs_sno-configure-for-vdu[Connectivity prerequisites for managed cluster networks] - -* xref:../../storage/persistent_storage/persistent_storage_local/persistent-storage-using-lvms.adoc#lvms-preface-sno-ran_logical-volume-manager-storage[Deploying LVM Storage on single-node OpenShift clusters] - -* xref:../../scalability_and_performance/ztp_far_edge/ztp-advanced-policy-config.adoc#ztp-provisioning-lvm-storage_ztp-advanced-policy-config[Configuring LVM Storage using PolicyGenTemplate CRs] - -include::modules/ztp-checking-the-managed-cluster-status.adoc[leveloffset=+1] - -include::modules/ztp-troubleshooting-the-managed-cluster.adoc[leveloffset=+1] - -include::modules/ztp-installation-crs.adoc[leveloffset=+1]