Registering an OCI Instance
Register an OCI instance with OS Management Hub by enabling the Oracle Cloud Agent service plugin and selecting a profile.
Important
OS Management Hub requires minimum Oracle Cloud Agent version 1.40. For instances using platform images released before April 2024, upgrade the Oracle Cloud Agent to 1.40 or later.
OS Management Hub requires minimum Oracle Cloud Agent version 1.40. For instances using platform images released before April 2024, upgrade the Oracle Cloud Agent to 1.40 or later.
For more information about how to enable and run plugins, see Managing Plugins with Oracle Cloud Agent.
See also Video: Creating and Registering OCI Compute Instances.
Before You Begin
Before you register an OCI instance with OS Management Hub:
-
Complete the Getting Started tasks.
- Identify the networking information needed for the instance, such as the public IP address or service gateway.
- Identify a compatible registration profile. Either create a profile or use a service-provided profile.
Note
Turn off the Console's Redwood preview when following these procedures. Otherwise, the steps won't match the interface. See Opting In and Out of the New Experience.
Turn off the Console's Redwood preview when following these procedures. Otherwise, the steps won't match the interface. See Opting In and Out of the New Experience.
New OCI Instance
- Follow the steps to create an instance, but use the following settings.
-
Enable the OS Management Hub Agent plugin.
- Select Show Advanced Options.
- On the Oracle Cloud Agent tab, select the OS Management Hub Agent.
- Select a profile to register the instance.
- Select Create.
Existing OCI Instance
- Install the Oracle Cloud Agent software, if it's not already installed. Verify the version is 1.40.0 or later.
- Open the navigation menu, select Compute, and then select Instances.
- Select the instance that you want to register.
- Select the Oracle Cloud Agent tab.
- Enable the OS Management Hub Agent.
-
Select a profile to use to register the instance.
You can select the service-provided profile in the root compartment or a user-created profile.
Note
For custom images or instances upgraded with Leapp, select the OS version and architecture of the instance to identify a valid profile for the instance. - Wait up to 10 minutes for the Oracle Cloud Agent to enable the OS Management Hub Agent plugin.
Verify Instance Registration and Details
Verify the instance registered with OS Management Hub.
What's Next
After registering an instance, consider:
- For standalone instances, update the instance.
- For an instance that's a member of group, update the instances in the group.
- For an instance that's part of a lifecycle environment, promote content to a lifecycle stage.