Oracle Cloud Infrastructure Documentation

Discovering Managed Instance Groups

Identify the manage instance groups to create in OS Management Hub and resolve any compatibility issues before migrating instances.

Tip

For simplicity and efficiency, we recommend that you use the migration assistant tool to perform this task. For more information, see Installing the Migration Assistant.

Using the Migration Assistant

Use the osms-to-osmh discover managed-instance-group command and required parameters to examine managed instance groups in a compartment or tenancy that need to be migrated to OS Management Hub.

For example, to discover all managed instance groups you have in OS Management:

osms-to-osmh discover managed-instance-group

The output for the command displays the following information about managed instance groups in a tenancy or compartment:

  • The OCID assigned to the managed instance group.
  • The name of the managed instance group.
  • The number of instances that are members of the managed instance group.
  • The number of associated scheduled jobs for the managed instance group.
  • The compartment where the managed instance group resides.
  • The architecture the managed instance group supports.
  • Whether the managed instance group has been migrated to OS Management Hub. A migrated managed instance group is a group that has been added to OS Management Hub.

The following is sample output:

$ osms-to-osmh discover managed-instance-group
Discovering Groups ......
OCID                                             Name                Instances  Jobs  Compartment             Compatible  Migrated                                                               
----------------------------------------------   ------------------  ---------  ----  ----------------------  ----------  --------  
ocid1.osmsmanagedinstancegroup.oc1..<unique_ID>  ol6-osms            2          0     compartment-a           Yes         No        
ocid1.osmsmanagedinstancegroup.oc1..<unique_ID>  ol7-osms            2          0     compartment-a           Yes         No        
ocid1.osmsmanagedinstancegroup.oc1..<unique_ID>  ol8-osms            2          2     compartment-b           Yes         No        
ocid1.osmsmanagedinstancegroup.oc1..<unique_ID>  ol8-osms-mixedarch  2          0     compartment-b           No          No

Use the --verbose option if the migration assistant reports incompatible resources. For more information, see Resolving Incompatible Managed Instance Groups.

Usage

osms-to-osmh discover managed-instance-group [-c | --compartment name] [-v | --verbose] [--managed-instance-group-id ocid] [--migrated] [--notmigrated] [--export-json] [ --help]

Option Details

Parameter Description
-c | --compartment name

Displays information about managed instance groups in the specified compartment. For name, specify either the name of the compartment or the OCID assigned to the compartment.

If no compartment is specified, managed instance groups from all compartments are displayed.
-v | --verbose Displays details about incompatible managed instance groups and suggests actions you can take to make the groups compatible.
--managed-instance-group-id ocid Displays information about the specified managed instance group. For ocid, specify the OCID assigned to the managed instance group.
--migrated Displays managed instance groups that have been created in OS Management Hub.
--notmigrated Displays managed instance groups that haven't been created in OS Management Hub.
--export-json Exports results to a JSON file.
--help Displays help information about the migration assistant command, such as the available options and the supported values for each option.

Using the Console

  1. Open the navigation menu and click Compute. Under OS Management, click Managed Instance Groups.
  2. In the List Scope section, select the compartment that contains the managed instance group.
  3. Find the managed instance group and click its name.
  4. On the Managed Instance Group Details page, view the instances associated with the group.

  5. Review and record the instances that are members of the group, their OS versions, and attached software sources.

    Important

    OS Management Hub groups require all members to be the same OS version and architecture. If your OS Management groups aren't compatible, see Resolving Incompatible Managed Instance Groups.

  6. Use the oci os-management scheduled-job list command to list scheduled jobs associated with the managed instance group.

    oci os-management scheduled-job list --compartment-id compartment_ocid --managed-instance-group-id managed_instance_group_ocid

    The following is sample output from a managed instance groups with two associated scheduled groups:

    $ oci os-management scheduled-job list --compartment-id ocid1.compartment.oc1..<unique_ID> --managed-instance-group-id ocid1.osmsmanagedinstancegroup.oc1..<unique_ID>
{
  "data": [
    {
      "compartment-id": "ocid1.compartment.oc1..<unique_ID>",
      "defined-tags": {},
      "display-name": "Install Security Updates (Weekly)",
      "freeform-tags": {},
      "id": "ocid1.osmsscheduledjob.oc1..<unique_ID>",
      "is-restricted": false,
      "lifecycle-state": "ACTIVE",
      "managed-instance-groups": [
        {
          "display-name": "ol8-osms",
          "id": "ocid1.osmsmanagedinstancegroup.oc1..<unique_ID>"
        }
      ],
      "managed-instances": [],
      "operation-type": "UPDATEALL",
      "os-family": "LINUX",
      "schedule-type": "RECURRING",
      "time-last-execution": "2024-04-21T23:00:00+00:00",
      "time-next-execution": "2024-04-28T23:00:00+00:00"
    },
    {
      "compartment-id": "ocid1.compartment.oc1..<unique_ID>",
      "defined-tags": {},
      "display-name": "Install Ksplice Updates (Daily)",
      "freeform-tags": {},
      "id": "ocid1.osmsscheduledjob.oc1...",
      "is-restricted": false,
      "lifecycle-state": "ACTIVE",
      "managed-instance-groups": [
        {
          "display-name": "ol8-osms",
          "id": "ocid1.osmsmanagedinstancegroup.oc1..<unique_ID>"
        }
      ],
Note

Repeat the previous steps for every managed instance group in the compartment that you plan to migrate. If you are managing instances groups that reside in other compartments, repeat these steps on the groups in those compartments in the tenancy. We recommend that you use the migration assistant to simplify this task.