Discovering Managed Instance Groups
Identify the manage instance groups to create in OS Management Hub and resolve any compatibility issues before migrating instances.
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
- Open the navigation menu and click Compute. Under OS Management, click Managed Instance Groups.
- In the List Scope section, select the compartment that contains the managed instance group.
- Find the managed instance group and click its name.
- On the Managed Instance Group Details page, view the instances associated with the group.
-
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. -
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>" } ],
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.