Switching to Another Module Stream on an Instance

Change the module stream that's enabled on an Oracle Linux instance in OS Management Hub.

Important

If an instance is a member of a group or assigned to a lifecycle environment, you can't change its contents directly. Instead, manage its content through its associated group or lifecycle environment.
    1. Open the navigation menu and click Observability & Management. Under OS Management Hub, click Instances.
    2. Under List scope, select the compartment that contains the instance.
    3. Click the name of the instance.
    4. Under Resources, click Modules.
    5. On the row of a module, click the Actions menu (Actions icon) and select Edit Module.
    6. Under Module Stream, select the stream to manage.
    7. Under Action, select the appropriate option:
      • Enable the selected module stream for this instance
      • Disable the selected module stream for this instance
        Note

        You must remove installed profiles before you can disable a module stream.
    8. Specify the job schedule:

      Schedule: Choose when to run the job.

      • Run immediately: Select this option to run the job now.
      • Schedule: Select this option to run the job at a future date and time. Click the calendar icon to select a date and time.
        • Automatic Retry: When selected, if the initial execution of the job fails, the service retries the job up three times. Each retry is five minutes apart.
        • Show advanced options: Click to add tags to this resource.

          If you have permissions to create a resource, then you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, ask an administrator or skip this option. You can apply tags later.

    9. Click Save changes.
  • Use the oci os-management-hub managed-instance switch-module-stream commands and required parameters to switch module streams.

    oci os-management-hub managed-instance switch-module-stream --managed-instance-id ocid --module-name name --stream-name name [OPTIONS]

    For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

  • Run the SwitchModuleStreamOnManagedInstance operation to switch the module stream used by an instance.