diff --git a/_topic_maps/_topic_map.yml b/_topic_maps/_topic_map.yml index 7b45903abc..3e3674ac44 100644 --- a/_topic_maps/_topic_map.yml +++ b/_topic_maps/_topic_map.yml @@ -2931,41 +2931,41 @@ 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: Image-based upgrade for single-node OpenShift clusters - File: ztp-image-based-upgrade +--- +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: Image-based upgrade for single-node OpenShift clusters + File: ztp-image-based-upgrade --- 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 52% 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 df70557038..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} precaching 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 precache 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] \ No newline at end of file +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/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-image-based-upgrade.adoc b/scalability_and_performance/ztp_far_edge/ztp-image-based-upgrade.adoc deleted file mode 100644 index 536cb2ce23..0000000000 --- a/scalability_and_performance/ztp_far_edge/ztp-image-based-upgrade.adoc +++ /dev/null @@ -1,73 +0,0 @@ -:_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:../../scalability_and_performance/ztp_far_edge/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[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[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:../../scalability_and_performance/ztp_far_edge/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:../../scalability_and_performance/ztp_far_edge/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:../../scalability_and_performance/ztp_far_edge/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[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/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]