Oracle Cloud Infrastructure Documentation

Creating Custom Software Sources

Create custom software sources in OS Management Hub before migrating instances to the service.

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 create custom-software-source command and required parameters to create custom software sources in OS Management Hub, add associated packages, and make them available for use in the service.

For example, to create all custom software sources you have in OS Management:

osms-to-osmh create custom-software-source

The command first runs the discovery operation in case your environment has changed and then creates the custom software sources in OS Management Hub.

Note

The migration assistant creates the OS Management Hub custom software source in the same compartment as the OS Management custom software source.

The following is sample output:

$ osms-to-osmh create custom-software-source 
Discovering Custom Software Source(s)....
                                                                                                                                                                                                                                                  
OCID                                       Name                    Arch     Used  Compartment             Compatible  Migrated
-----------------------------------------  ----------------------  -------  ----  ----------------------  ----------  --------  
ocid1.osmssoftwaresource.oc1..<unique_ID>  ol8-x86-2023.12.13      X86_64   Yes   compartment-a           Yes         No      
ocid1.osmssoftwaresource.oc1..<unique_ID>  ol8-x86-2024.01.10      X86_64   No    compartment-a           Yes         No      
ocid1.osmssoftwaresource.oc1..<unique_ID>  ol9-aarch64-2023.12.08  AARCH64  Yes   compartment-b           Yes         No      

Add ol9-aarch64-2023.12.08 in OS Management Hub?  [y/n]  y
Creating custom software source ....
Custom Software Source created successfully
Added packages to software source successfully

Creation Details:
OCID: ocid1.osmhsoftwaresource.oc1...<unique_ID>
Name: ol9-aarch64-2023.12.08
Packages: 769
Vendor Software Sources: 
 Oracle Linux 9 Application Stream Packages (aarch64)
 Oracle Linux 9 BaseOS Latest  (aarch64)
 Ksplice for Oracle Linux 9 (aarch64)
 Oracle Software for OCI users on Oracle Linux 9 (aarch64)
 Oracle Linux 9 Addons (aarch64)
...

Usage

osms-to-osmh create custom-software-source [-c | --compartment name] [-y | --yes] [-v | --verbose] [--custom-software-source-id ocid] [ --help]

Option Details

Parameter Description
-c | --compartment name

Examines a compartment for OS Management custom software sources and creates them in OS Management Hub. For name, specify either the name of the compartment or the OCID assigned to compartment.

If no compartment is specified, all compartments in the tenancy are examined.
-y | --yes Proceeds with creating all compatible custom software sources without prompting you for confirmation.
-v | --verbose Displays details about incompatible custom software sources.
--custom-software-source-id ocid

Creates the specified custom software source in OS Management Hub. For ocid, specify the OCID associated with the OS Management custom software source.

If this optional parameter isn't specified, the command prompts you to create all compatible custom software sources that haven't been migrated to OS Management Hub.
--help Displays help information about the migration assistant command, such as the available options and the supported values for each option.

Using the Console

Using the information gathered in discovery, create custom software sources and add associated packages in OS Management Hub using the Console. See Creating a Custom Software Source in the OS Management Hub documentation.