Resolving Incompatible Managed Instance Groups
Some OS Management managed instance groups might be incompatible with OS Management Hub. Use the migration assistant to identify incompatibilities and resolve any issues before migration.
Managed instance groups can be incompatible with OS Management Hub for the following reasons:
Required vendor software sources not yet added
Before an OS Management managed instance group can be created in OS Management Hub, all vendor software sources attached to the group in OS Management must be added to OS Management Hub.
If misisng vendor software source are detected, the migration assistant reports the following issue and suggests the following action:
ISSUE: This group has Vendor Software Sources not yet created in OSMH.
ACTION: Use 'osms-to-osmh create vendor-software-source' to create the following Vendor Software Sources in OSMH.
To resolve this issue:
Required custom software sources not yet created
Before a OS Management managed instance group can be created in OS Management Hub, all custom software sources attached to the group in OS Management must be added to OS Management Hub.
If missing custom software sources are detected, the migration assistant reports the following issue and suggests the following action:
ISSUE: This group has Custom Software Sources not yet created in OSMH.
ACTION: Create the following Custom Software Sources in OSMH:
<list of custom software sources>
...
To resolve this issue:
Group contains instances with different OS versions, architectures, or software sources
An OS Management managed instance group is incompatible with OS Management Hub when the instances that are in the group aren't the same OS version and architecture or have different software sources attached to them.
If detected, the migration assistant reports one of the following issues and suggests the following actions:
ISSUE: This group contains instances with different OS versions, which is disallowed in OSMH.
ISSUE: This group contains instances with different system architectures, which is disallowed in OSMH.
ISSUE: This group contains instances with differing software sources, which is disallowed in OSMH.
ACTION: Create separate OSMH groups consisting of instances with the same OS version, Architecture, ALX requirments, Event Collection, Notification Topic id and Software sources.
ACTION: Remove the instances from the incompatible OSMS group. At migration time, you can attach the instance to an OSMH group.
To resolve this issue:
- Create separate groups with the same OS version, architecture, and software sources in OS Management Hub.
- Create registration profiles in OS Management Hub to use for registering the instances with the appropriate group in OS Management Hub at migration time.
- Create scheduled jobs for the groups in OS Management Hub as required to match the jobs scheduled for the group in OS Management.
- At migration time, use the appropriate group registration profile to register instances with OS Management Hub. See Migrating Managed Instances to OS Management Hub.
For example, suppose the osms-to-osmh discover managed-instance-group command with the --verbose
option reports following incompatibility:
ISSUE: This group contains instances with different system architectures, which is disallowed in OSMH.
ACTION: Create separate OSMH groups consisting of instances with the same OS version, Architecture, ALX requirments, Event Collection, Notification Topic id and Software sources.
ACTION: Remove the instances from the incompatible OSMS group. At migration time, you can attach the instance to an OSMH group.
...
The following set of OSMH groups will satisfy the OS Version, Architecture, Software Source, ALX requirments, Event Collection and Notification Topic id needs of the instances in this OSMS group.
OSMH 'Group 1':
- Create OSMH 'Group 1' with the following properties:
Vendor Version Arch ALX Software sources Migrated
------ -------------- ------ --- ---------------------------------------------------------- --------
ORACLE ORACLE_LINUX_8 X86_64 NO Ksplice for Oracle Linux 8 (x86_64) No
MySQL 8.0 Connectors Community for Oracle Linux 8 (x86_64) No
MySQL 8.0 Tools Community for Oracle Linux 8 (x86_64) No
...
- At migration time, use the 'Group 1' registration profile to migrate the following instances to 'Group 1':
OCID Name ALX Event Collection Notification Topic Id Compartment
------------------------------- -------- --- ---------------- --------------------- ---------------
ocid1.instance.oc1..<unique_ID> ol8-mi01 NO NO None ol8-compartment
OSMH 'Group 2':
- Create OSMH 'Group 2' with the following properties:
Vendor Version Arch ALX Software sources Migrated
------ -------------- ------- --- --------------------------------------------------------- --------
ORACLE ORACLE_LINUX_8 AARCH64 NO Ksplice for Oracle Linux 8 (aarch64) No
MySQL 8.0 Connectors for Oracle Linux 8 (aarch64) No
MySQL 8.0 Tools Community for Oracle Linux 8 (aarch64) No
...
- At migration time, use the 'Group 2' registration profile to migrate the following instances to 'Group 2':
OCID Name ALX Event Collection Notification Topic Id Compartment
------------------------------ -------- --- ---------------- --------------------- --------------
ocid1.instance.oc1..<unique_ID> ol8-mi04 NO NO None ol8-compartment
To resolve this issue:
- Create an Oracle Linux 8 group whose members are based on the x86 architecture and a registration profile in OS Management Hub.
- Create an Oracle Linux 8 group whose members are based on the aarch64 (ARM) architecture and a registration profile in OS Management Hub.
- Create any scheduled jobs for the groups to match the OS Management incompatible group in OS Management Hub.
- At migration, use the appropriate registration profile to register instances that were members of the incompatible OS Management group.