Uploaded image for project: 'Red Hat Advanced Cluster Management'
  1. Red Hat Advanced Cluster Management
  2. ACM-24014

Document importing local cluster to Central Infrastructure Manager (CIM)

XMLWordPrintable

    • Incidents & Support
    • 6
    • False
    • Hide

      None

      Show
      None
    • False
    • None

      Describe the changes in the doc and link to your dev story:

      1. - [x] Mandatory: Add the required version to the Fix version/s field.

      2. - [x] Mandatory: Choose the type of documentation change or review.

      • [x] We need to add a new document to an existing section

      3. - [x] Mandatory: Find the link to where the documentation update
      should go and add it to the recommended changes. You can either use the
      published doc or the staged repo for this step: See proposed section below

      4. - [x] Mandatory for GA content:

      • [x] Add steps, the diff, known issue, and/or other important
        conceptual information in the following space: See content below
      • [x] *Add Required access level *(example, *Cluster
        Administrator*) for the user to complete the task: Cluster Administrator
      • [x] Add verification at the end of the task, how does the user
        verify success (a command to run or a result to see?)
      • [x] Add link to dev story here:

      5. - [ ] Mandatory for bugs: What is the diff? Clearly define what the
      problem is, what the change is, and link to the current documentation. Only
      use this for a documentation bug.


      Proposed content{}

      Proposed section: New sub-section in 1.9 Host inventory introduction 

      https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.14/html/clusters/cluster_mce_overview#cim-intro 

      OR new sub-section under 1.7.4 Cluster import https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.14/html/clusters/cluster_mce_overview#import-intro

       

      Proposed Title: Managing your hub with central infrastructure management

      OR Importing your hub using central infrastructure management

      Content:

      Central infrastructure management does not automatically manage your hub cluster. You can enable this feature by doing the following:

      Prerequisites:

      You've enabled central infrastructure management (CIM - link to https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.14/html/clusters/cluster_mce_overview#enable-cim )

      To enable this feature:

      Annotate the AgentServiceConfig CR to enable local cluster import

       

      oc annotate agentserviceconfig agent agent-install.openshift.io/enable-local-cluster-import=true 

       

      To verify this feature was enabled:

      Check if an InfraEnv CR for the `local-cluster` was created

       

      oc get infraenv -n multicluster-engine 

       

       

      Now you are able to add and manage additional hosts to the hub cluster through central infrastructure management.

      For more details about adding hosts, see

      Adding hosts using discovery image: https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.14/html/clusters/cluster_mce_overview#add-host-host-inventory

      Automatically adding bare metal hosts: https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.14/html/clusters/cluster_mce_overview#auto-add-host-host-inventory

       

       


      Relevant links

      PR that caused the change: https://github.com/openshift/assisted-service/pull/6606

      https://issues.redhat.com//browse/MGMT-18448 

      note: this change has been in since ACM 2.11 and was never documented. I've only added fix versions up to ACM 2.12 due to the n-2 note

      Slack threads:

      https://redhat-internal.slack.com/archives/CUPJTHQ5P/p1757320852366019

      https://redhat-internal.slack.com/archives/CTDEY6EEA/p1753365831385369?thread_ts=1753257362.433809&cid=CTDEY6EEA

       

              rh-ee-ofischer Oliver Fischer
              cchun@redhat.com Crystal Chun
              Aditya Kulkarni, Logan Corder, Nick Carboni, Scott Berens
              Votes:
              2 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated: