Oracle Cloud Infrastructure Documentation

Discovering Vendor Software Sources

Identify the vendor software sources to add to OS Management Hub 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 vendor-software-source command and required parameters to examine the vendor software sources that are attached to OS Management managed instances in a compartment or tenancy. Use this information to determine which vendor software sources to add to OS Management Hub before migration.

For example, to discover all vendor software sources you are using in OS Management:

osms-to-osmh discover vendor-software-source

The output for the command displays the following information about vendor software software sources that are in use by OS Management instances:

  • The OCID assigned to the vendor software source.
  • The name of the vendor software source.
  • The compartment where the vendor software source resides.
  • The architecture the vendor softwares source supports.
  • Whether the vendor software source has been migrated to OS Management Hub. A migrated vendor software source is a vendor software source that has been added to OS Management Hub.
Note

In OS Management, all vendor software sources are available in the root compartment by default. In OS Management Hub, you must explicitly add the vendor software sources to the service. For more information, see Vendor Software Sources in the OS Management Hub documentation.

The following is sample output:

$ osms-to-osmh discover vendor-software-source 
Discovering vendor software sources ......
OCID                                        Name                                                        OS Family       Arch    Compartment             Migrated                                                                                                                                                                          
------------------------------------------  ----------------------------------------------------------  --------------  ------  ----------------------  --------  
ocid1.osmssoftwaresource.oc1..<unique_ID>   Oracle Linux 8 UEK Release 7 (x86_64)                       ORACLE_LINUX_8  X86_64  linuxandvirtualization  Yes       
ocid1.osmssoftwaresource.oc1..<unique_ID>   MySQL 8.0 for Oracle Linux 8 (x86_64)                       ORACLE_LINUX_8  X86_64  linuxandvirtualization  Yes       
ocid1.osmssoftwaresource.oc1..<unique_ID>   MySQL 8.0 Tools Community for Oracle Linux 8 (x86_64)       ORACLE_LINUX_8  X86_64  linuxandvirtualization  Yes       
ocid1.osmssoftwaresource.oc1..<unique_ID>   MySQL 8.0 Connectors Community for Oracle Linux 8 (x86_64)  ORACLE_LINUX_8  X86_64  linuxandvirtualization  Yes       
ocid1.osmssoftwaresource.oc1..<unique_ID>   Ksplice for Oracle Linux 8 (x86_64)                         ORACLE_LINUX_8  X86_64  linuxandvirtualization  Yes       
ocid1.osmssoftwaresource.oc1..<unique_ID>   Oracle Linux 8 Application Stream (x86_64)                  ORACLE_LINUX_8  X86_64  linuxandvirtualization  Yes       
ocid1.osmssoftwaresource.oc1..<unique_ID>   Oracle Linux 8 Addons (x86_64)                              ORACLE_LINUX_8  X86_64  linuxandvirtualization  Yes       
ocid1.osmssoftwaresource.oc1..<unique_ID>   Oracle Software for OCI users on Oracle Linux 8 (x86_64)    ORACLE_LINUX_8  X86_64  linuxandvirtualization  Yes       
ocid1.osmssoftwaresource.oc1..<unique_ID>   Oracle Linux 8 BaseOS Latest (x86_64)                       ORACLE_LINUX_8  X86_64  linuxandvirtualization  Yes       
                                                                                                                                                                                                                  
ocid1.osmssoftwaresource.oc1..<unique_ID>   Oracle Linux 9 Addons (x86_64)                              ORACLE_LINUX_9  X86_64  linuxandvirtualization  Yes       
ocid1.osmssoftwaresource.oc1..<unique_ID>   Oracle Software for OCI users on Oracle Linux 9 (x86_64)    ORACLE_LINUX_9  X86_64  linuxandvirtualization  No        
ocid1.osmssoftwaresource.oc1..<unique_ID>   Oracle Linux 9 UEK Release 7 (x86_64)                       ORACLE_LINUX_9  X86_64  linuxandvirtualization  Yes       
ocid1.osmssoftwaresource.oc1..<unique_ID>   Oracle Linux 9 Application Stream Packages (x86_64)         ORACLE_LINUX_9  X86_64  linuxandvirtualization  Yes       
ocid1.osmssoftwaresource.oc1..<unique_ID>   Ksplice for Oracle Linux 9 (x86_64)                         ORACLE_LINUX_9  X86_64  linuxandvirtualization  No        
ocid1.osmssoftwaresource.oc1..<unique_ID>   Oracle Linux 9 BaseOS Latest  (x86_64)                      ORACLE_LINUX_9  X86_64  linuxandvirtualization  Yes       



Elapsed time: 93.2825174331665

Usage

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

Option Details

Parameter Description
-c | --managed-instance-compartment name

Displays information about vendor software sources attached to managed instances in the specified compartment. For name, specify either the name of the compartment or the OCID assigned to compartment.

If no compartment is specified, vendor software sources from all compartments are displayed.
-v | --verbose Displays detailed information about incompatible vendor software sources and lists instances attached to each vendor software source.
--vendor-software-source-id ocid Displays information about the specified vendor software source. For ocid, specify the OCID assigned to the vendor software source.
--migrated Displays vendor software sources that have been added to OS Management Hub.
--notmigrated Displays vendor software sources that haven't been added to 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, click Compute, and then click Instances.
  2. Under List Scope, select the compartment that contains the instance.
  3. Find the instance and click its name.
  4. On the Instance Details page, under Resources, click OS Management.
  5. Click the Actions icon (three dots) and click View OS Management Details.
  6. Click Software Sources.
  7. Review and record the vendor software sources attached to the instance.
Note

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