Migrating a Standalone Autonomous Linux Instance to the OS Management Service

The alx-migrate script is available to migrate standalone Autonomous Linux instances to the OS Management service.

Standalone Autonomous Linux instances are instances that are based on older Oracle Autonomous Linux images. These instances are referred to as standalone Autonomous Linux instances because they are not integrated with the OS Management service.

After migration, the instances are managed using the OS Management service and take advantage of the additional autonomous capabilities provided by the service in Oracle Cloud Infrastructure, such as monitoring for critical events.

Supported Images

  • Autonomous Linux instances that were created using the July 2021 Oracle Autonomous Linux platform image (Oracle-Autonomous-Linux-7.9-2021.07-0) or earlier.
  • Autonomous Linux instances that were created using the following Oracle Cloud Marketplace images:
    • Oracle Linux KVM Image (Autonomous Linux) with Unbreakable Enterprise Kernel.
    Important

    • The alx-migrate script is not supported with the Oracle Linux Storage Appliance (Autonomous Linux) image.
    • Autonomous Linux is not supported with Red Hat Compatible Kernel.

Installing alx-migrate

  1. Install the alx-migrate package:

    sudo yum install alx-migrate

Using alx-migrate

Use the alx-migrate utility to migrate standalone Autonomous Linux instances to the OS Management service.

When running the alx-migrate utility, you are prompted to accept the terms of use for the OS Management service. To automatically accept the terms, run the alx-migrate script with the --accept-terms (or -a) option.

sudo alx-migrate --accept-terms

During a successful migration, the alx-migrate utility removes the al-config RPM package, as this package is no longer needed. After migration, the Autonomous Linux service is used to manage autonomous settings instead of the al-config utility. For more information, see Managing Autonomous Linux Settings.

Note

The utility runs a series of checks during the migration process. If any check fails, the script displays an error message, indicating what failed and how to resolve, and automatically rolls the instance back to its previous state as a standalone Autonomous Linux instance. For more information, see Migration Errors and Recommendation Actions.

Important

The OS Management service does not manage or monitor private yum repositories and the Autonomous Linux service does not apply updates from private yum repositories as part of the daily autonomous updates.

If you have private yum repositories, the alx-migrate utility displays a note indicating that Private Yum repositories are not monitored or managed by the OS Management service. When running the utility, private yum repositories are automatically added to the /etc/oracle-cloud-agent/plugins/osms/ignored_repos.conf file, which prevents the OS Management Service Agent plugin from overwriting the settings for those repositories. For more information about the ignore_repos.conf file, see Ignoring Private Repositories.

The following example shows how to run the alx-migrate utility with the --accept-terms (-a) option.

$ sudo alx-migrate --accept-terms
TERMS OF USE FOR THE OS MANAGEMENT SERVICE
--------------------------------------------------------------------------------
Your use of the OS Management service is governed by the terms of Your agreement
with Oracle applicable to the services (the "Terms").  As part of the OS
Management service, Oracle may collect data including, but not limited to,
kernel configurations, log files and security settings.  You may access more
information about the data that Oracle may collect at

https://docs.oracle.com/iaas/os-management/osms/alx-events.htm#alx-about-collected-information

Collection of such data will be handled in accordance with the Terms and the
Oracle General Privacy Policy.

By answering "yes", you acknowledge the Terms and Your agreement, as an
authorized representative of Your company or organization (if being acquired for
use by an entity) or as an individual, to comply with the Terms.  If You are not
willing to be bound by the Terms with respect to the OS Management service,
answer "no" and do not access the OS Management service.
--------------------------------------------------------------------------------

You accepted the Terms of Use for the OS Management service with '--accept-terms'.

Checking for Oracle Cloud Agent plugins.
Checking for required IAM policies.
Checking for Always Free instance.

Starting migration.
The next Daily Autonomous Updates start time: Wed, Mar 30, 2022, 20:04:22 UTC
Generating custom config file for migration.
Migration data has been added to '/etc/oracle-cloud-agent/plugins/oci-alx/custom-config.yml'.
Private Yum repository configuration files found:
  - al-infra.appad1iad.osdevelopmeniad.oraclevcn.com_alx-repo_.repo
Note: Private Yum repositories are not monitored or managed by the OS Management service.
Removing al-config package.
warning: /etc/al-config/al.conf saved as /etc/al-config/al.conf.rpmsave
Installing alx-utils package.
Initializing Oracle Autonomous Linux.
Restarted abrtd systemd service.
Initialized Oracle Autonomous Linux.
Starting alx service.
Restarting the Oracle Cloud Agent.
Waiting for the OS Management Service Agent plugin to start.
OS Management Service Agent plugin is running.
Waiting for Oracle Autonomous Linux plugin to start.
Oracle Autonomous Linux plugin is running.
Waiting for the instance to be registered with the OS Management service.
The instance has been registered with the OS Management service.
Waiting for the instance to check in with the Oracle Autonomous Linux service.
The instance has checked in with the Oracle Autonomous Linux service.
Validating scheduled job.
Validated scheduled job.
Waiting for standard Yum channels to be enabled with the OS Management service.
Standard Yum channels have been enabled:
  - Latest Unbreakable Enterprise Kernel Release 6 for Oracle Linux 7Server (x86_64)
  - Oracle Linux 7Server Add ons (x86_64)
  - Ksplice for Oracle Linux 7 (x86_64)
  - Oracle Linux 7Server Latest (x86_64)
  - Oracle Software for OCI users on Oracle Linux 7 (x86_64)
  - Oracle Linux 7Server Optional Latest (x86_64)
  - Software Collection Library release 3.0 packages for Oracle Linux 7 (x86_64)
  - Ksplice aware userspace packages for Oracle Linux 7Server (x86_64)

Migration to the Oracle Autonomous Linux service is completed!

For more information, please visit the following links:
  - https://docs.oracle.com/iaas/oracle-linux/autonomous-linux/index.htm
  - https://docs.oracle.com/iaas/os-management/osms/alx-index.htm
  - https://docs.oracle.com/iaas/os-management/osms/alx-migrate.htm
Migration Errors and Recommendation Actions

The following table lists the possible error messages generated by the alx-migrate utility and recommended actions to resolve the errors.

Error Message

Recommended Action

Error: You did not accept the Terms of Use for the OS Management service.

Run the alx-migrate utility again and answer yes to the prompt or run the utility with the --accept-terms option.

Error: The OS Management Service Agent plugin is disabled.

Enable the OS Management Service Agent plugin and rerun the alx-migrate script.

For more information, see Managing Plugins with Oracle Cloud Agent.

Error: The Oracle Autonomous Linux plugin is disabled.

Enable the Oracle Autonomous Linux plugin and rerun the alx-migrate script.

For more information, see Managing Plugins with Oracle Cloud Agent.

Error: Missing required IAM policies for the Oracle Autonomous Linux service.

Confirm that the required IAM policies for the Oracle Autonomous Linux service are configured correctly for migration.

For more information, see Required IAM Policies.

Error: Migration for an Always Free Oracle Autonomous Linux instance to the Oracle Autonomous Linux service is not supported.

See Known Issues.

Error: The OS Management Service Agent plugin could not start.

Enable the OS Management Service Agent plugin and rerun the alx-migrate script.

For more information, see Managing Plugins with Oracle Cloud Agent.

Error: The Oracle Autonomous Linux plugin could not start.

Enable the Oracle Autonomous Linux plugin and rerun the alx-migrate script.

For more information, see Managing Plugins with Oracle Cloud Agent.

Error: The OS Management Service Agent plugin could not register with the OS Management service.

Confirm that the required IAM policies for the Oracle Autonomous Linux service are configured correctly for migration.

For more information, see Required IAM Policies.

Error: The Oracle Autonomous Linux plugin could not check in with Oracle Autonomous Linux service.

Confirm that the required IAM policies for the Oracle Autonomous Linux service are configured correctly for migration.

For more information, see Required IAM Policies.

Error: Could not validate the scheduled job for Daily Autonomous Updates.

Confirm that the required IAM policies for the Oracle Autonomous Linux service arefor configured correctly for migration.

For more information, see Required IAM Policies.

Error: Could not validate the notification topic '<topic ocid>'.

Confirm that the required IAM policies for the Oracle Autonomous Linux service are configured correctly for migration.

For more inmation, see Required IAM Policies.

Error: Could not enable standard Yum channels with the OS Management service.

Possible causes:

- The Yum channel is not supported by the OS Management service.

- Required Oracle Autonomous Linux service IAM policies are not configured correctly.

Confirm that the required IAM policies for the Oracle Autonomous Linux service are configured correctly for migration.

For more information, see Required IAM Policies.