Skip to content

https://issues.redhat.com/browse/ACM-24014 Add manage hub doc #8320

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: 2.15_stage
Choose a base branch
from
Open

https://issues.redhat.com/browse/ACM-24014 Add manage hub doc #8320

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ef6a4c3
https://issues.redhat.com/browse/ACM-24014 Add manage hub doc
oafischer Oct 23, 2025
7ecfa31
https://issues.redhat.com/browse/ACM-24014 Add manage hub doc
oafischer Oct 28, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion clusters/assisted_installer/ai_cancel_host.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ For example, you can cancel the installation if a production environment host be

.Prerequisites

You are using the late binding feature on your managed cluster.
- You are using the late binding feature on your managed cluster.

.Procedure

Expand Down
5 changes: 2 additions & 3 deletions clusters/assisted_installer/ai_create_cli.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,9 @@ You can create a host inventory (infrastructure environment) to discover physica
- Pass additional certificates that you want the host to trust during the discovery phase
- Select a Red Hat CoreOS version to boot for testing that is not the default option of the newest version

[#create-host-inventory-prereqs-cli]
== Prerequisites
.Prerequisites

You must enable the {cim} service. See xref:../assisted_installer/ai_enable_cim.adoc#enable-cim[Enabling the {cim} service] for more information.
- You must enable the {cim} service. See xref:../assisted_installer/ai_enable_cim.adoc#enable-cim[Enabling the {cim} service] for more information.

[#create-host-inventory-cli-steps]
== Creating a host inventory
Expand Down
1 change: 1 addition & 0 deletions clusters/assisted_installer/ai_intro.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ Continue reading to learn more about host inventories and {cim}:
* xref:../assisted_installer/ai_add_host.adoc#add-host-host-inventory[Adding hosts to the host inventory by using the Discovery Image]
* xref:../assisted_installer/ai_auto_add_host.adoc#auto-add-host-host-inventory[Automatically adding bare metal hosts to the host inventory]
* xref:../assisted_installer/ai_manage.adoc#manage-host-inv[Managing your host inventory]
* xref:../assisted_installer/ai_manage_hub.adoc#manage-hub-cim[Managing a hub cluster by using {cim}]
* xref:../assisted_installer/ai_mirror_reg.adoc#config-mirror-reg-cluster[Configuring mirror registries for each cluster]
* xref:../cluster_lifecycle/create_cluster_on_prem.adoc#creating-a-cluster-on-premises[Creating a cluster in an on-premises environment]
* xref:../cluster_lifecycle/import_ocp.adoc#import-ocp-cluster[Importing an on-premises {ocp} cluster manually by using {cim}]
36 changes: 36 additions & 0 deletions clusters/assisted_installer/ai_manage_hub.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
[#manage-hub-cim]
= Managing a hub cluster by using {cim}

Importing and managing a hub cluster by using {cim} can simplify your cluster management by providing a single point of control.

By default, {cim} does not automatically manage your hub cluster. Enable the feature to add and manage additional hosts on the hub cluster by using {cim}.

.Prerequisites

- You must enable the {cim} service. See xref:../assisted_installer/ai_enable_cim.adoc#enable-cim[Enabling the {cim} service] for more information.

[#manage-hub-cim-steps]
== Enabling hub cluster management by using {cim}

Complete the following step to enable {cim} to manage your hub cluster:

. Annotate the `AgentServiceConfig` custom resource to enable `local-cluster` import. Run the following command:

+
[source,bash]
----
oc annotate agentserviceconfig agent agent-install.openshift.io/enable-local-cluster-import=true
----
+
Verify that the feature is enabled by checking if an `InfraEnv` custom resource is created for the `local-cluster`. Run the following command:
+
[source,bash]
----
oc get infraenv -n multicluster-engine
----

[#additional-resources-auto-add-host]
== Additional resources

- See xref:../assisted_installer/ai_add_host.adoc#add-host-host-inventory[Adding hosts to the host inventory by using the Discovery Image]
- See xref:../assisted_installer/ai_auto_add_host.adoc#auto-add-host-host-inventory[Automatically adding bare metal hosts to the host inventory]
1 change: 1 addition & 0 deletions clusters/main.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -102,6 +102,7 @@ include::assisted_installer/ai_add_host.adoc[leveloffset=+3]
include::assisted_installer/ai_auto_add_host.adoc[leveloffset=+3]
include::assisted_installer/ai_cancel_host.adoc[leveloffset=+3]
include::assisted_installer/ai_manage.adoc[leveloffset=+3]
include::assisted_installer/ai_manage_hub.adoc[leveloffset=+3]
include::assisted_installer/ai_mirror_reg.adoc[leveloffset=+3]
include::cluster_api/cluster_api_intro.adoc[leveloffset=+2]
include::cluster_api/install_capi_managed.adoc[leveloffset=+3]
Expand Down
Loading