スタンドアロンAutonomous LinuxインスタンスのOS管理サービスへの移行

alx-migrateスクリプトは、スタンドアロンのAutonomous LinuxインスタンスをOS管理サービスに移行するために使用できます。

スタンドアロンAutonomous Linuxインスタンスは、古いOracle Autonomous Linuxイメージに基づくインスタンスです。これらのインスタンスはOS管理サービスと統合されていないため、スタンドアロンAutonomous Linuxインスタンスと呼ばれます。

移行後、インスタンスはOS管理サービスを使用して管理され、クリティカル・イベントのモニタリングなど、Oracle Cloud Infrastructureのサービスによって提供される追加の自律機能を利用できます。

サポートされているイメージ

  • 2021年7月のOracle Autonomous Linuxプラットフォーム・イメージ(Oracle-Autonomous-Linux-7.9-2021.07-0)以前を使用して作成されたAutonomous Linuxインスタンス。
  • 次のOracle Cloud Marketplaceイメージを使用して作成されたAutonomous Linuxインスタンス:
    • Unbreakable Enterprise Kernelを使用したOracle Linux KVMイメージ(Autonomous Linux)。
    重要

    • alx-migrateスクリプトは、Oracle Linux Storage Appliance (Autonomous Linux)イメージではサポートされていません。
    • Autonomous Linuxは、Red Hat Compatible Kernelではサポートされていません。

前提条件

重要

  • OS管理サービスと統合されているAutonomous Linuxインスタンスは、Oracle Cloud Free Tierではサポートされていません。既知の問題を参照してください。
  • カスタム・イメージに基づくAutonomous Linuxインスタンスは、サポートされていません。

alx-migrateのインストール

  1. alx-migrateパッケージをインストールします:

    sudo yum install alx-migrate

alx-migrateの使用

alx-migrateユーティリティを使用して、スタンドアロンのAutonomous LinuxインスタンスをOS管理サービスに移行します。

alx-migrateユーティリティを実行すると、OS管理サービスの使用条件に同意するように求められます。条件に自動的に同意するには、--accept-terms(または-a)オプションを指定してalx-migrateスクリプトを実行します。

sudo alx-migrate --accept-terms

移行が成功すると、al-config RPMパッケージはもう必要ないため、alx-migrateユーティリティによって削除されます。移行後、al-configユーティリティのかわりにAutonomous Linuxサービスを使用して自律型設定が管理されます。詳細は、Autonomous Linux設定の管理を参照してください。

ノート

このユーティリティは、移行プロセス中に一連のチェックを実行します。いずれかのチェックが失敗した場合、スクリプトは失敗した内容と解決方法を示すエラー・メッセージを表示し、インスタンスをスタンドアロンのAutonomous Linuxインスタンスとして以前の状態に自動的にロールバックします。詳細は、移行エラーおよび推奨アクションを参照してください。

重要

OS管理サービスはプライベートyumリポジトリを管理またはモニターせず、Autonomous Linuxサービスは毎日の自律型更新の一部としてプライベートyumリポジトリからの更新を適用しません。

プライベートyumリポジトリがある場合、alx-migrateユーティリティによって、Private Yum repositories are not monitored or managed by the OS Management serviceという注意が表示されます。ユーティリティを実行すると、プライベートyumリポジトリが/etc/oracle-cloud-agent/plugins/osms/ignored_repos.confファイルに自動的に追加されます。これによって、OS管理サービス・エージェント・プラグインがそれらのリポジトリの設定を上書きするのを防ぎます。ignore_repos.confファイルの詳細は、プライベート・リポジトリの無視を参照してください。

次の例は、--accept-terms (-a)オプションを指定してalx-migrateユーティリティを実行する方法を示しています。

$ 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
移行エラーおよび推奨アクション

次の表に、alx-migrateユーティリティによって生成される可能性のあるエラー・メッセージと、エラーを解決するための推奨アクションを示します。

エラー・メッセージ

推奨アクション

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

alx-migrateユーティリティを再度実行し、プロンプトに対してyesと応答するか、 --accept-termsオプションを指定してユーティリティを実行します。

Error: The OS Management Service Agent plugin is disabled.

OS管理サービス・エージェント・プラグインを有効にして、alx-migrateスクリプトを再実行します。

詳細は、Oracle Cloud Agentを使用したプラグインの管理を参照してください。

Error: The Oracle Autonomous Linux plugin is disabled.

Oracle Autonomous Linuxプラグインを有効にして、alx-migrateスクリプトを再度実行します。

詳細は、Oracle Cloud Agentを使用したプラグインの管理を参照してください。

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

Oracle Autonomous Linuxサービスに必要なIAMポリシーが移行用に正しく構成されていることを確認します。

詳細は、必須IAMポリシーを参照してください。

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

既知の問題を参照してください。

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

OS管理サービス・エージェント・プラグインを有効にして、alx-migrateスクリプトを再実行します。

詳細は、Oracle Cloud Agentを使用したプラグインの管理を参照してください。

Error: The Oracle Autonomous Linux plugin could not start.

Oracle Autonomous Linuxプラグインを有効にして、alx-migrateスクリプトを再度実行します。

詳細は、Oracle Cloud Agentを使用したプラグインの管理を参照してください。

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

Oracle Autonomous Linuxサービスに必要なIAMポリシーが移行用に正しく構成されていることを確認します。

詳細は、必須IAMポリシーを参照してください。

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

Oracle Autonomous Linuxサービスに必要なIAMポリシーが移行用に正しく構成されていることを確認します。

詳細は、必須IAMポリシーを参照してください。

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

Oracle Autonomous Linuxサービスに必要なIAMポリシーが移行用に正しく構成されていることを確認します。

詳細は、必須IAMポリシーを参照してください。

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

Oracle Autonomous Linuxサービスに必要なIAMポリシーが移行用に正しく構成されていることを確認します。

詳細は、必要なIAMポリシーを参照してください。

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.

Oracle Autonomous Linuxサービスに必要なIAMポリシーが移行用に正しく構成されていることを確認します。

詳細は、必須IAMポリシーを参照してください。

次の作業

管理対象インスタンスを設定した後、OS管理サービスでAutonomous Linuxの使用を開始して、それらのインスタンスを最新のパッチおよび更新で最新の状態に保つことができます。

Oracle Autonomous Linuxの使用