RPM ベースの Linux ディストリビューションから RHEL への変換

Red Hat Enterprise Linux 8

CentOS Linux または Oracle Linux から Red Hat Enterprise Linux 7 および Red Hat Enterprise Linux 8 に変換する手順

概要

本書では、オペレーティングシステムを CentOS Linux または Oracle Linux から RHEL 7 および RHEL 8 に変換する方法を説明します。

はじめに

本書では、オペレーティングシステムを別の Linux ディストリビューション (CentOS Linux または Oracle Linux) から、Red Hat Enterprise Linux (RHEL) 7 または RHEL 8 に変換する方法を説明します。変換は Convert2RHEL ユーティリティーにより実行されます。

注記

Scientific Linux、Alma Linux、および Rocky Linux から RHEL への変換は、現在 Red Hat ではサポートされていません。サポートされていない変換の詳細については、How to perform an unsupported conversion from a RHEL-derived Linux distribution to RHEL を参照してください。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、今後の複数のリリースで段階的に用語の置き換えを実施して参ります。詳細は、Red Hat CTO である Chris Wright のメッセージ をご覧ください。

Red Hat ドキュメントへのフィードバック (英語のみ)

当社のドキュメントに関するご意見やご感想をお寄せください。また、改善点があればお知らせください。

特定の文章に関するコメントの送信

  1. Multi-page HTML 形式でドキュメントを表示し、ページが完全にロードされてから右上隅に Feedback ボタンが表示されていることを確認します。
  2. カーソルを使用して、コメントを追加するテキスト部分を強調表示します。
  3. 強調表示されたテキストの近くに表示される Add Feedback ボタンをクリックします。
  4. フィードバックを追加し、Submit をクリックします。

Bugzilla からのフィードバック送信 (アカウントが必要)

  1. Bugzilla の Web サイトにログインします。
  2. Version メニューから正しいバージョンを選択します。
  3. Summary フィールドにわかりやすいタイトルを入力します。
  4. Description フィールドに、ドキュメントの改善に関するご意見を記入してください。ドキュメントの該当部分へのリンクも追加してください。
  5. Submit Bug をクリックします。

主な移行の用語

以下の移行用語はソフトウェア業界で一般的に使用されますが、これらの定義は Red Hat Enterprise Linux (RHEL) に固有のものです。

更新

ソフトウェアパッチと呼ばれることもあります。更新は現行バージョン、オペレーティングシステム、または実行中のソフトウェアに追加されます。ソフトウェア更新は、問題またはバグに対応し、テクノロジーの操作が改善されます。RHEL では、更新は、RHEL 8.1 から 8.2 への更新といったマイナーリリースに関連します。

アップグレード

アップグレードは、現在実行しているアプリケーション、オペレーティングシステム、またはソフトウェアを置き換える場合です。通常、まず Red Hat の指示に従い、データをバックアップします。RHEL をアップグレードすると、以下の 2 つのオプションがあります。

  • In-place upgrade: インプレースアップグレードの場合は、以前のバージョンを削除せずに、以前のバージョンを新しいバージョンに置き換えます。設定や設定と共にインストールされたアプリケーションとユーティリティーは、新規バージョンに組み込まれています。
  • clean install: clean install は、以前にインストールされたオペレーティングシステム、システムデータ、設定、およびアプリケーションのすべてのトレースを削除し、最新バージョンのオペレーティングシステムをインストールします。システムに以前のデータまたはアプリケーションが必要ない場合や、以前のビルドに依存しない新規プロジェクトを開発する場合は、クリーンインストールに適しています。

オペレーティングシステムへの変換

変換は、オペレーティングシステムを別の Linux ディストリビューションから Red Hat Enterprise Linux に変換する際に使用されます。通常、まず Red Hat の指示に従い、データをバックアップします。

マイグレーション

通常、マイグレーションとは、ソフトウェアやハードウェアといったプラットフォームの変更を示しています。Windows から Linux への移行はマイグレーションです。ユーザーがあるラップトップから別のラップトップに移動したり、企業があるサーバーから別のサーバーに移動することもマイグレーションです。ただし、ほとんどのマイグレーションにはアップグレードも含まれており、この2つの用語が同様の意味で使用されることがあります。

  • RHEL へのマイグレーション: 既存のオペレーティングシステムを RHEL に変換すること。
  • RHEL 間での移行: RHEL のあるバージョンから別のバージョンへのアップグレード

第1章 サポート対象の変換パス

重要

Red Hat は、変換プロセスをスムーズに行えるようにするために、Red Hat コンサルティングサービス のサポートを利用することを推奨します。

現在、システムを以下の Linux ディストリビューション、アーキテクチャー、およびバージョンから、表 1.1 に記載されている RHEL の対応するマイナーバージョンに変換できます。

表1.1 サポート対象の変換パス

ソース OSターゲット OSアーキテクチャー製品バリアント

CentOS Linux 8.5

RHEL 8.5

64 ビット Intel

該当なし

CentOS Linux 8.4

RHEL 8.4

64 ビット Intel

該当なし

CentOS Linux 7.9

RHEL 7.9

64 ビット Intel

Server

Oracle Linux 8.7

RHEL 8.7

64 ビット Intel

該当なし

Oracle Linux 7.9

RHEL 7.9

64 ビット Intel

Server

CentOS Linux の最新マイナーバージョンは CentOS Linux 8.5 であるため、CentOS Linux 8 から、RHEL 8 の最新のマイナーバージョン (現在 RHEL 8.7) に直接変換できません。

注記

サポートされているかどうかに関係なく、RHEL 6 への変換を実行することはできなくなりました。CentOS Linux 6 または Oracle Linux 6 システムを RHEL に変換するには、システムを CentOS Linux 7 または Oracle Linux 7 にアップグレードしてから、サポートされている RHEL 7 への変換を実行します。

上記のサポートされている変換パスに加えて、Rocky Linux、Alma Linux、および Scientific Linux から RHEL へのサポートされていない変換を実行することもできます。サポートされていない変換の詳細については、How to perform an unsupported conversion from a RHEL-derived Linux distribution to RHEL を参照してください。

重要

現在、CentOS Stream から RHEL への変換はできません。

Linux ディストリビューション変換に対する Red Hat のサポートポリシーの詳細は Convert2RHEL サポートポリシー を参照してください。

注記

RHEL 8.4 または RHEL 8.5 に変換している場合は、変換後にシステムを RHEL 8.7 に更新することが推奨されます。

第2章 RHEL 変換の計画

実行中のシステムで自動変換プロセスが実行されます。Convert2RHEL ユーティリティーは、元の Linux ディストリビューションのすべての RPM パッケージを RHEL バージョンに置き換えます。プロセスの最後には、RHEL カーネルを起動するためにシステムを再起動する必要があります。

元のディストリビューションでのみ利用でき、RHEL リポジトリーに一致するものがないパッケージと、元の Linux ディストリビューションや RHEL からのサードパーティーパッケージは変換の影響を受けません。Red Hat は、変換プロセス中に変更されないサードパーティーパッケージのサポートはしていません。サードパーティーソフトウェアのサポートに関する Red Hat ポリシー を参照してください。

注記

Convert2RHEL ユーティリティーは、/home および /srv ディレクトリーのローカルユーザーおよびデータに直接影響を与えません。ただし、Convert2RHEL は、変換プロセス中に RPM パッケージスクリプトレットが実行するアクションを制御することはできません。

システムを RHEL に変換する前に、以下を考慮する必要があります。

  • アーキテクチャー - 64 ビット Intel アーキテクチャーを持つシステムにソース OS がインストールされている。他のシステムアーキテクチャーで変換することはできません。
  • セキュリティー - FIPS モードのシステムは、移行に対応していません。
  • カーネル - RHEL カーネルモジュールに存在しないカーネルモジュールを使用するシステムは、現時点では移行に対応していません。Red Hat は、外部カーネルモジュールを無効化またはアンインストールしてから移行し、移行が済んでからこのカーネルモジュールを有効化または再インストールすることを推奨します。対応していないカーネルモジュールには以下が含まれます。

    • 特殊なアプリケーション、GPU、ネットワークドライバー、またはストレージドライバー用のカーネルモジュール
    • DKMS によってビルドされたカスタムコンパイルカーネルモジュール
  • パブリッククラウド - パブリッククラウドの変換は、以下の状況でサポートされます。

    • CentOS Linux: RHSM を以下で使用します。

      • Amazon Web Services (AWS)、Microsoft Azure、および Google Cloud でのサブスクリプションインスタンスの追加
      • すべてのパブリッククラウドでユーザーによって提供されるカスタムイメージ
    • Oracle Linux - すべてのパブリッククラウドでユーザーによって提供されるカスタムイメージに RHSM を使用

      CentOS Linux および Oracle Linux の両方で、パブリッククラウドインスタンスで Red Hat Update Infrastructure (RHUI) を使用するオンデマンドの Pay-As-You-Go (PAYG) インスタンスで RHEL パッケージにアクセスできません。

  • 高可用性 - Red Hat またはサードパーティーによる高可用性クラスターソフトウェアを使用するシステムは、現在 RHEL への変換でテストまたはサポートされていません。Red Hat は、新規インストールした RHEL システムに移行してこのような環境の整合性を確保することを推奨します。
  • ID 管理 - 非 RHEL FreeIPA サーバーから RHEL 8 IdM サーバーへのインプレース変換の実行はサポートされていません。FreeIPA デプロイメントで IdM に移行する方法の詳細については、Migrating to IdM on RHEL 8 from FreeIPA on non-RHEL Linux distributions を 参照してください。

第3章 RHEL 変換の準備

この手順では、CentOS Linux または Oracle Linux から Red Hat Enterprise Linux (RHEL) への変換を実行する前に必要な手順を説明します。

前提条件

  • RHEL への変換でシステムが対応していることを確認している。詳細は、サポート対象の変換パス を参照してください。
  • 重要なアプリケーション、データベースサービスおよびデータを格納するその他のサービスを停止し、データの整合性の問題を軽減している。
  • 変換が失敗するのを防ぐために一時的にコンピューターソフトウェアを無効にしている。
  • 元のシステムを復元しないように、設定管理システム (Salt、Chef、Puppet、Ansible など) を無効にしたり、適切に再設定したりしている。
  • sos パッケージがインストールされている。このパッケージを使用して、Red Hat サポートチームのサポートケースを開くときに必要な sosreport を生成する必要があります。

手順

  1. システムをバックアップし、システムを復元できることを確認します。
  2. 既知の問題および制限 を確認し、システムが変換に対応していることを確認します。必要に応じて回避策を適用します。
  3. 標準カーネルが起動したカーネルであることを確認します。

    • CentOS Linux: 標準の CentOS Linux カーネル
    • Oracle Linux: Red Hat Compatible Kernel (RHCK)

      システムを起動するカーネルが標準カーネルではない場合 (CentOS リアルタイムカーネルまたは Oracle Linux Unbreakable Enterprise Kernel (UEK) など)、デフォルトカーネルを標準カーネルに変更してシステムを再起動します。

  4. CentOS Linux 8 から変換する場合は、システムから CentOS Stream パッケージを削除します。現在、Cent OS Stream は変換をサポートしておらず、システムにパッケージが存在する場合、変換が失敗する可能性があります。
  5. ファイアウォール、Red Hat Satellite、またはプロキシーサーバーを使用して変換する場合は、次の接続にアクセスできることを確認してください。

  6. CentOS Linux 8 から変換する場合は、CentOS リポジトリーの URL を更新します。

    # sed -i 's/^mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-*
    # sed -i 's|#baseurl=http://mirror.centos.org|baseurl=https://vault.centos.org|g' /etc/yum.repos.d/CentOS-*
    重要

    CentOS Linux 8 のライフサイクルは終了しました。詳細は、CentOS Linux EOL を参照してください。

  7. Convert2RHEL をインストールします。

    1. Red Hat GPG キーをダウンロードします。

      # curl -o /etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release https://www.redhat.com/security/data/fd431d51.txt
    2. Convert2RHEL リポジトリーを含む https://cdn.redhat.com サーバーの SSL 証明書をダウンロードします。

      # curl --create-dirs -o /etc/rhsm/ca/redhat-uep.pem https://ftp.redhat.com/redhat/convert2rhel/redhat-uep.pem
    3. Convert2RHEL リポジトリーファイルをインストールします。

      # curl -o /etc/yum.repos.d/convert2rhel.repo https://ftp.redhat.com/redhat/convert2rhel/<version_number>/convert2rhel.repo

      version_number は、OS の適切なメジャーバージョンに置き換えます (例: 7 または 8)。

      注記

      最新バージョンの Convert2RHEL リポジトリーファイルで変換を実行する必要があります。以前のバージョンのリポジトリーファイルをインストールしている場合は、以前のバージョンを削除して、現在のバージョンをインストールします。

    4. Convert2RHEL ユーティリティーをインストールします。

      # yum -y install convert2rhel
  8. 以下のいずれかの方法で RHEL パッケージにアクセスできることを確認します。

    1. Red Hat Subscription Manager (RHSM) を介した Red Hat コンテンツ配信ネットワーク (CDN)。RHSM にアクセスするには、Red Hat アカウントと適切な RHEL サブスクリプションが必要です。テーブル 1.1 に従って、OS が RHEL の対応するマイナーバージョンに変換されることに注意してください。
    2. フルサポートまたはメンテナーンスサポートがあるバージョンの Red Hat Satellite。詳細は、Red Hat Satellite の製品ライフサイクル を参照してください。

      注記

      Satellite サーバーが以下の条件を満たすことを確認します。

      • Satellite には、RHEL リポジトリーをインポートしたサブスクリプションマニフェストがあります。詳細は、Red Hat Satellite の特定のバージョン (version 6.10 など) の Content Management Guide の Managing Subscriptions を参照してください。
      • 以下のリポジトリーが有効になり、最新のターゲットの OS の更新と同期され、Satellite で公開されています。OS の適切なメジャーバージョンに対して、少なくとも以下のリポジトリーを有効にします。

        • Red Hat Enterprise Linux 7 Server RPMs x86_64 7Server
        • Red Hat Enterprise Linux 8 for x86_64 - AppStream RPMs <target_os>
        • Red Hat Enterprise Linux 8 for x86_64 - BaseOS RPMs <target_os>

      target_os は、CentOS Linux 変換の場合は 8.4 または 8.5、Oracle Linux 変換の場合は 8.7 に置き換えます。

    3. /etc/yum.repos.d/ ディレクトリーで設定され、ターゲット OS リポジトリーのミラーを参照しているカスタムリポジトリー。ローカルネットワークまたはポータブルメディアにしかアクセスできないため、RHSM を介して Red Hat CDN にアクセスできないシステムには、カスタムリポジトリーを使用します。ダウングレードと変換の失敗を防ぐために、リポジトリーに RHEL マイナーバージョンで利用可能な最新のコンテンツが含まれていることを確認してください。詳細は、Creating a Local Repository and Sharing With Disconnected/Offline/Air-gapped Systems を参照してください。

      注記

      RHEL 8 コンテンツは、BaseOS と AppStream の 2 つのデフォルトリポジトリーで配布されます。カスタムリポジトリーを使用して RHEL パッケージにアクセスする場合は、変換を成功させるために両方のデフォルトリポジトリーを設定する必要があります。Convert2RHEL ユーティリティーを実行する場合は、--enablerepo オプションを使用して両方のリポジトリーを有効にする必要があります。RHEL 8 リポジトリーの詳細は、RHEL 8 の導入における検討事項 を参照してください。

  9. Red Hat Satellite サーバーで RHEL パッケージにアクセスする場合は、コンシューマー RPM を /usr/share/convert2rhel/subscription-manager/ ディレクトリーにダウンロードします。

    # curl --insecure --output /usr/share/convert2rhel/subscription-manager/katello-ca-consumer-latest.noarch.rpm https://<satellite.example.com>/pub/katello-ca-consumer-latest.noarch.rpm

    satellite.example.com を Satellite サーバーのホスト名に置き換えます。

  10. ウイルス対策ソフトウェアを一時的に無効にして、変換が失敗しないようにします。
  11. 表 1.1 で指定されている変換でサポートされるマイナーバージョンに元の OS を更新し、システムを再起動します。

    変換に失敗した場合に、ロールバック機能を使用するためにサポートされる OS のマイナーバージョンの最新パッケージで変換を実行する必要があります。詳細は、Conversion rollback を参照してください。

第4章 RHEL システムへの変換

この手順では、システムを CentOS Linux または Oracle Linux (RHEL) に移行するのに必要な手順を説明します。

注記

デフォルトでは、Red Hat はユーティリティーの使用状況を分析するために、変換の開始時刻と終了時刻、変換が成功したかどうかなど、変換関連のデータを収集します。データ収集を無効にするには、CONVERT2RHEL_DISABLE_TELEMETRY 環境変数を 1 に設定します。

Red Hat CDN、または RHSM 経由で Satellite を使用して RHEL パッケージにアクセスする場合に、移行時のシステムの登録、サブスクライブ方法には 2 種類あります。

  • 組織 ID とアクティベーションキーを指定する方法。この方法は、多くのシステムを移行する場合や、スクリプトを使用して移行プロセスを自動化する場合に推奨されます。アクティベーションキーを作成するには、組織の管理者である必要があります。RHSM で Satellite を使用して RHEL パッケージにアクセスする場合は、この方法を使用する必要があります。
  • ユーザー名、パスワード、およびプール ID を指定する方法。RHSM から Red Hat CDN を使用して RHEL パッケージにアクセスする場合は、この方法を使用できます。

前提条件

手順

  1. Convert2RHEL ユーティリティーを起動します。

    Convert2RHEL は RHSM またはカスタムリポジトリーのいずれかで使用できます。利用可能なオプションをすべて表示するには、-h-help オプションを使用します。

    # convert2rhel -h
    • 組織 ID とアクティベーションキーで RHSM を使用して変換するには、次の手順を実行します。Satellite を使用して RHEL パッケージにアクセスする場合は、この方法を使用する必要があります。

      • アクティベーションキーを /etc/convert2rhel.ini ファイルに追加します。

        [subscription_manager]
        activation_key = <activation_key>

        Red Hat CDN を使用している場合、または Red Hat Satellite を使用している場合、Satellite Web UI を使用している場合は、activation_key を Red Hat Customer Portal からの アクティベーションキー に置き換えます。

      • Convert2RHEL ユーティリティーを起動します。

        # convert2rhel --org <organization_ID>

        Red Hat CDN を使用している場合は、organization_ID を Red Hat Customer Portal組織 ID に置き換えます。Red Hat Satellite を使用している場合は、Satellite Web UI を使用します。

        注記

        Satellite を使用して RHEL パッケージにアクセスしていて、システムにインターネットアクセスがない場合は、--keep-rhsm オプションを追加します。subscription-manager および katello-ca-consumer パッケージがすでにインストールされている必要があり、convert2rhel コマンドを実行するときに、組織 ID とアクティベーションキーを含む設定ファイルの両方を提供する必要があることに注意してください。

    • ユーザー名、パスワード、およびプール ID で RHSM を使用して変換するには、次の手順を実行します。

      • Red Hat アカウントのパスワードを /etc/convert2rhel.ini ファイルに追加します。

        [subscription_manager]
        password = <password>

        password を Red Hat アカウントのパスワード資格情報に置き換えます。

      • Convert2RHEL ユーティリティーを起動します。

        # convert2rhel --username <username> --pool <pool_ID>

        username を Red Hat アカウントのユーザー名資格情報に置き換えます。pool_ID は、システムに割り当てるサブスクリプションのプール ID に置き換えます。プール ID が分からない場合は、--pool オプションを省略して、アカウントで利用できるサブスクリプションの一覧を生成します。

    • カスタムリポジトリーを使用して変換するには、Convert2RHEL ユーティリティーを起動します。

      # convert2rhel --no-rhsm --enablerepo <RHEL_RepoID1> --enablerepo <RHEL_RepoID2>

      RHEL_RepoID を、/etc/yum.repos.d/ ディレクトリーで設定したカスタムリポジトリーに置き換えます (例: rhel-7-server-rpms または rhel-8-baseos および rhel-8-appstream)。

      注記

      RHSM またはカスタムリポジトリーで変換する場合は、--enablerepo オプションを使用して追加のパッケージを RHEL の対応パッケージに置き換えて、RHEL 7 Extras リポジトリーまたは Optional リポジトリーを手動で有効にできます。Optional リポジトリーのパッケージはサポートされないことに注意してください。詳細は Red Hat Enterprise Linux における Optional および Supplementary チャンネルのサポートポリシー を参照してください。

  2. Convert2RHEL が元のディストリビューションのパッケージを RHEL パッケージに置き換える前に、以下の警告メッセージが表示されます。

    The tool allows rollback of any action until this point.
    By continuing, all further changes on the system will need to be reverted manually by the user, if necessary.

    この時点で Convert2RHEL による変更は自動的に元に戻されます。変換プロセスを続行することを確認します。

  3. Convert2RHEL が RHEL パッケージをインストールし、正常に終了するまで待ちます。
  4. 推奨手順: 変換にカスタムリポジトリーを使用している場合は、RHEL システムを登録してサブスクライブします。詳細は、How to register and subscribe a system offline to the Red Hat Customer Portal? を参照してください。
  5. この時点で、システムは RAM に読み込まれている元のディストリビューションカーネルで稼働します。システムを再起動して、新たにインストールした RHEL カーネルを起動します。

    # reboot
  6. 変更されていない元の OS からサードパーティーパッケージを削除します (通常は、RHEL 対応がないパッケージ)。これらのパッケージの一覧を表示するには、以下を使用します。

    # yum list extras --disablerepo="*" --enablerepo=<RHEL_RepoID>

    RHEL_RepoID は、お使いのリポジトリーに置き換えます。

  7. 必要に応じて、RHEL 8.4 または RHEL 8.5 に変換した場合は、システムを最新のマイナーバージョンに更新します。

    # yum update -y
  8. オプション: RHEL 9 へのインプレースアップグレードを実行して、システムが最新の拡張機能、セキュリティー機能、およびバグ修正で更新されていることを確認します。詳細については、RHEL 7 から RHEL 8 へのアップグレード および RHEL 8 から RHEL 9 へのアップグレード ガイドを参照してください。RHEL 7 に変換した場合は、最初に RHEL 7 から RHEL 8 へのインプレースアップグレードを実行し、次に RHEL 8 から RHEL 9 へのインプレースアップグレードを実行する必要があることに注意してください。

検証

  • システムが期待どおりに動作することを確認します。必要な場合は、変換後にシステムサービスを再設定し、依存関係エラーを修正します。詳細は、依存関係エラーの修正 を参照してください。

第5章 変換ロールバック

Convert2RHEL ユーティリティーは、制限されたロールバック機能を提供します。ユーザーが変換をキャンセルした場合や、変換が失敗した場合、ユーティリティーは、以下の条件下で変換プロセス中に加えられた変更のロールバックを実行します。

  • 元に戻すことができるのは、Convert2RHEL が元のディストリビューションのパッケージを RHEL パッケージに置き換えるまで実行された変更のみです。この瞬間は警告メッセージで表示されます。

    The tool allows rollback of any action until this point.
    By continuing all further changes on the system will need to be reverted manually by the user, if necessary.

    これには、プロセスを続行するかどうかの質問が続きます。

    注記

    convert2rhel コマンドとともに -y オプションを指定すると、自動ロールバック可能ではなくなったときを示す質問がスキップされます。

  • ロールバックを実行するには、元のディストリビューションのパッケージを提供するリポジトリー (特にベースリポジトリー) が必要です。Convert2RHEL はこれらのレポジトリーへのアクセスなしでは、ツールの実行が初期段階で停止しても、システムを元の状態に戻すことができません。これは、Convert2RHEL が変換プロセス時に特定のパッケージを削除し、ロールバックのために元のリポジトリーからこれらのパッケージを先制的にダウンロードする必要があるためです。
  • ロールバックは、元の OS のすべてのパッケージが、システムからアクセス可能なリポジトリーで取得できる最新バージョンに更新されているシステムでのみ実行可能です。したがって、変換プロセスを開始する前に yum update コマンドを使用します。
警告

Convert2RHEL がパッケージ置き換えフェーズを開始した後に変換プロセスがキャンセルまたは失敗すると、システムが機能しなくなる可能性があります。そのような場合は、手動の修正が必要になります。サポートが必要な場合は Red Hat Consulting services までお問い合わせください。

第6章 変換のトラブルシューティング

本章では、トラブルシューティングに使用するリソースおよびヒントを紹介します。

6.1. トラブルシューティングのリソース

変換プロセス中に発生する可能性のある問題のトラブルシューティングを容易にするため、コンソールおよびログファイルに出力されるログメッセージを確認してください。

コンソールの出力

デフォルトでは、Convert2RHEL ユーティリティーにより、情報、警告、エラー、重要なログレベルのメッセージのみがコンソールに出力されます。デバッグメッセージも出力するには、convert2rhel コマンドで --debug オプションを使用します。

ログ

  • /var/log/convert2rhel/convert2rhel.log ファイルには、デバッグ、情報、警告、エラー、重要なメッセージの一覧が表示されます。
  • /var/log/convert2rhel/rpm_va.log ファイルには、ユーザーが修正した変換されていないシステムのパッケージファイルがすべて表示されます。この出力は、rpm -Va コマンドで生成されます。これは --no-rpm-va オプションを convert2rhel コマンドで指定しない限り、自動的に実行されます。

6.2. 依存関係エラーの修正

異なる Linux ディストリビューションから RHEL への移行時に、特定のパッケージが、一部の依存関係がない状態でインストールされることがあります。

前提条件

手順

  1. 依存関係エラーを特定します。

    # yum check dependencies

    コマンドが出力を表示しない場合、それ以上のアクションは必要ありません。

  2. 依存関係エラーを修正するには、影響を受けるパッケージを再インストールします。この操作中に、yum ユーティリティーは不足している依存関係を自動的にインストールします。必要な依存関係がシステムで利用可能なリポジトリーにより提供されていない場合は、それらのパッケージを手動でインストールします。

6.3. 既知の問題および制限

変換中に以下の問題と制限が発生することが知られています。

  • ファイルが /mnt/ ディレクトリーに直接マウントされている、または /sys/ ディレクトリーが読み取り専用としてマウントされている場合は、変換が停止します。
  • HTTP プロキシーサーバーを使用してインターネットに接続するシステムは、RHSM を介して Red Hat CDN または Satellite を使用して変換できません。この問題を回避するには、yum の HTTP プロキシーを有効にし、RHSM の HTTP プロキシーを設定します。

    1. How to enable proxy settings for yum command on RHEL? の説明に従って、HTTP プロキシーを使用するように yum を設定します。
    2. Yum および Yum リポジトリーの設定 で説明されているように、以下の URL のいずれかを参照するリポジトリーを設定します。

    3. 設定したリポジトリーから subscription-manager パッケージをインストールします。
    4. How to configure HTTP Proxy for Red Hat Subscription Management の説明に従い、RHSM の HTTP プロキシーを設定します。
    5. --keep-rhsm オプションを使用して RHEL への変換を実行します。

      (BZ#1965487)

  • セキュアブートが有効になっている UEFI システムは、変換がサポートされていません。この問題を回避するには、変換前にセキュアブートを無効にし、変換の完了後に再度有効にします。(BZ#2057229)
  • Convert2RHEL ユーティリティーは、変換の一部としてシステムに RHEL カーネルをインストールします。すでにカーネル制限に達している場合、変換は失敗します。この問題を回避するには、既存のカーネルを削除して、新しい RHEL カーネル用のスペースを確保します。詳細については、convert2rhel が Problem 2: package kernel requires kernel-core-uname-r but none of the providers can be installed で失敗するを参照してください。
  • RHSM にサブスクライブしていて、--keep-rhsm オプションを使用して変換を実行する場合、変換中にロールバックを実行すると、RHSM サブスクリプションは復元されません。この問題を回避するには、ロールバック後にシステムを RHSM に再登録します。(RHELC-898)

6.4. サポートの利用

変換中に問題が発生した場合は Red Hat にお知らせください。問題に対応させていただきます。

重要

変換中に問題が発生した場合は、重大度 3 または重大度 4 レベルのみのサポートケースを作成してください。詳細は、製品サポートのサービスレベルアグリーメント を参照してください。

前提条件

  • sos パッケージがインストールされている。このパッケージを使用して、Red Hat サポートチームのサポートケースを開くときに必要な sosreport を生成する必要があります。

手順

  • サポートを受けるには、次のいずれかの手順を実行します。

    • サポートケースを作成します。

      • 製品に RHEL 7 または RHEL 8 を選択し、システムから sosreport を添付します。
      • システムで sosreport を生成します。

        # sosreport

        ケース ID は空のままにできます。

    • バグ報告 を送信します。

      • バグを開き、製品で RHEL 7 または RHEL 8 を選択し、コンポーネントに convert2rhel を選択します。

sosreport を生成する方法は、ナレッジベースのソリューション Red Hat Enterprise Linux 上での sosreport のロールと取得方法 を参照してください。

カスタマーポータルでサポートケースを作成し、管理する方法は、ナレッジベースのアーティクル カスタマーポータルでサポートケースを作成および管理する を参照してください。

Linux ディストリビューション変換に対する Red Hat のサポートポリシーの詳細は Convert2RHEL サポートポリシー を参照してください。

第7章 関連情報