Editing a Module on an Instance

Edit a module on an Oracle Linux instance in OS Management Hub to enable or disable a module stream, install or remove a stream profile, or switch to a different module stream.

You can manage the module stream content on an instance in the following ways:

  • Enable a module stream.
  • Install module stream profiles.
  • Switch to another module stream.
  • Remove module stream profiles.
  • Disable a module stream.
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. Under Install or remove profiles, select or clear the module stream profiles to install or remove profiles from the instance.
      Note

      • The module stream must be enabled to install profiles. See Enabling a Module Stream on an Instance.
      • If you're switching streams, you can't change the profiles until the switch operation is complete.
    9. 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.

    10. Click Save changes.
  • Use the oci os-management-hub managed-instance enable-module-stream command and required parameters to enable a module stream on a managed instance.

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

    Use the oci os-management-hub managed-instance disable-module-stream command and required parameters to disable a module stream on a managed instance.

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

    Use the oci os-management-hub managed-instance install-module-profile command and required parameters to install a module profile.

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

    Use the oci os-management-hub managed-instance remove-module-profile command and required parameters to remove a module profile.

    oci os-management-hub managed-instance remove-module-profile --managed-instance-id ocid --module-name name --stream-name name --profile-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 enabled module stream.

    Run the ManageModuleStreamsOnManagedInstance operation to manage module streams on an instance.