Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

Red Hat Update Infrastructure の移行

Red Hat Update Infrastructure 4

Red Hat Update Infrastructure 4 への移行と Red Hat Update Infrastructure の最新バージョンへのアップグレード

Red Hat Customer Content Services

概要

このドキュメントでは、要件をリストにまとめ、クラウドプロバイダーの Red Hat Update Infrastructure 4 (RHUI 4) への移行に役立つ手順を詳説しています。また、Red Hat Update Infrastructure の最新バージョンにアップグレードするための詳細な手順も提供します。

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

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

第1章 Red Hat Update Infrastructure の移行
リンクのコピー

Red Hat Update Infrastructure (RHUI) 4 のインストール後に、既存のリポジトリーを RHUI 3 から RHUI 4 に移行できます。

移行により、RHUI 4 マシンで RHUI 3 リポジトリーが有効になります。ただし、RPM コンテンツまたは RPM データは移行されません。移行の完了後に、これらのリポジトリーを自動または手動で再同期する必要があります。

移行プロセスを開始する前に、次の推奨事項と制限事項に注意してください。

  • RHUI 3 から RHUI 4 に直接アップグレードすることはできません。現在の RHUI 3 インストールと一緒に RHUI 4 をインストールする必要があります。その後、RHUI 3 からの同じ CA 証明書を使用して、RHUI 4 上の RHUI 3 リポジトリーを同期できます。これにより、古いクライアントも RHUI 4 のコンテンツにアクセスできるようになります。最後に、RHUI 4 CDS ノードを指すように RHUI 3 ロードバランサーを変更できます。
  • LEAPP を使用して RHUI 3 から RHUI 4 にアップグレードすることはできません。RHUI 3 と並行して RHUI 4 をセットアップしてから、RHUI データを移行する必要があります。
  • RHUI 4 では、移行の前後に、任意のバージョンのロードバランサーを使用できます。たとえば、RHUI 4 の RHEL 8 バージョンの代わりに、RHUI 3 の HAProxy ノードの RHEL 7 バージョンを RHUI 4 インスタンスで使用できます。

  • 1 つのアドレスまたはロードバランサーから、RHUI の 2 つの異なるインスタンス (RHUI 3 インスタンスと RHUI 4 インスタンスなど) にルーティングするには、古い RHUI 3 インスタンスからすべてのコンテンツを引き継げるように RHUI 4 インスタンスをセットアップする必要があります。

    ただし、単一のアドレスまたはロードバランサーを使用して RHUI3 インスタンスと RHUI4 インスタンスの両方を実行する設定は推奨されません。SSL 証明書の競合からリクエスト間のリポジトリーパスの変更に至るまで、さまざまな問題が発生する可能性があります。

1.1. Red Hat Update Infrastructure の移行の概要
リンクのコピー

移行は、Red Hat Update Infrastructure (RHUI) 4 インストールで利用可能な rhui-manager ユーティリティーを使用して、RHUI 3 から RHUI 4 にリポジトリーを移動します。リポジトリーを移行する前に、RHUI 4 をインストールする必要があります。

rhui-manager ユーティリティーは、サブコマンド migration と以下の必須の引数を使用します。

  1. --hostname: リモート RHUI 3 RHUA ノードのホスト名
  2. --password: リモート RHUI 3 RHUA ノードの rhui-manager パスワード
注記

RHUI 4 マシンの現行ユーザーの SSH キーペアの公開部分を RHUI 3 マシンの .ssh/authorized_keys ファイルに追加する必要があります。

デフォルトのパスが指定されていても、キーファイルへのパスが、指定のデフォルト値と一致しない可能性があります。以下の引数を移行コマンドに追加しなければならない場合があります。

  • --keyfile_path: RHUI 4 マシンの SSH 秘密鍵へのパス。デフォルトのパスは /root/.ssh/id_rsa_rhua です。

1.2. RHUI 3 から RHUI 4 へのリポジトリーの移行
リンクのコピー

以下の手順では、RHUI 3 リポジトリーを RHUI 4 に移行する方法を説明します。

前提条件

  • RHUI 4 が宛先マシンにインストールされているようにする。詳細は、Red Hat Update Infrastructure のインストール を参照してください。
  • RHUI 3 マシンへのアクセスに必要な認証情報がある。

  • RHUI エンタイトルメント証明書が RHUI 4 マシンで利用できるようにする。そうでない場合は、以下のコマンドを実行して証明書を追加します。 

    # rhui-subscription-sync
    Copy to Clipboard Toggle word wrap

  • 任意: 移行を迅速化するために、リポジトリー情報をキャッシュしていることを確認します。これを行うには、次のコマンドを使用します。 

    # rhui-manager repo unused
    Copy to Clipboard Toggle word wrap

手順

  1. RHUI 4 マシンで、rhui-manager ユーティリティーを使用して移行を開始します。 

    # rhui-manager migrate --hostname my-rhui3-rhua.example.com --password <your_password> --keyfile_path ~/.ssh/id_rsa_rhua
    Copy to Clipboard Toggle word wrap

  2. 以下のようなエラーで移行に失敗すると、移行を試みているリポジトリーと RHUI 4 マシンにすでに存在しているリポジトリー間で競合が発生しています。 

    ERROR: Configured repos detected. Use --force to ignore. Exiting
    Copy to Clipboard Toggle word wrap

    これを修正するには、--force 引数を使用して移行を実行します。

    注記

    --force 引数を使用すると、ID が RHUI 3 リポジトリー ID に一致するリポジトリーが削除され、再作成されます。 

    # rhui-manager migrate --hostname my-rhui3-rhua.example.com --password <your_password> --keyfile_path ~/.ssh/id_rsa_rhua --force
    Copy to Clipboard Toggle word wrap

  3. オプション: カスタムリポジトリーを移行した場合は、RPM コンテンツを手動でアップロードする必要があります。

    これを実行する詳細な手順は、/root/.rhui/migration/ ディレクトリーにある upload_rpms_document.txt ファイルを参照してください。

検証

  • 以下のコマンドを実行し、RHUI 4 マシンで RHUI 3 リポジトリーが利用可能かどうかを確認します。 

    # rhui-manager repo list
    Copy to Clipboard Toggle word wrap

1.3. クライアント RPM の RHUI 3 から RHUI 4 への移行
リンクのコピー

RHUI 4 にアップグレードした後に、RHUI 3 クライアント RPM をそのまま使用する必要がある場合があります。その場合には、RHUI 3 認証局 (CA) を RHUI 4 システムに移行して、RHUI 4 でその CA を使用するように設定できます。

前提条件

  • RHUI 3 マシンへのアクセスに必要な認証情報がある。

手順

  1. CA 証明書と CA 鍵を RHUI 3 から RHUI 4 にコピーします。

    • 証明書 rhui-default-ca.crt は /etc/pki/rhui/certs/ ディレクトリーにあります。
    • キー rhui-default-ca.key は /etc/pki/rhui/private/ ディレクトリーにあります。

  2. RHUA ノードで rhui-installer を再実行し、RHUI 3 インストールからコピーした CA を指定します。 

    # rhui-installer --rerun --remote-fs-server <address> --rhua-hostname <RHUA hostname> --cds-lb-hostname <HAProxy hostname> --user-supplied-rhui-ca-crt rhui-default-ca.crt --user-supplied-rhui-ca-key rhui-default-ca.key
    Copy to Clipboard Toggle word wrap
    • --remote-fs-server: 共有ファイルシステムのリモートマウントポイント。
    • --rhua-hostname: RHUA ノードのホスト名。名前は完全修飾ドメイン名 (FQDN) として指定する必要があります。
    • --cds-lb-hostname: CDS にアクセスするためにクライアントが使用するロードバランサーの名前。名前は完全修飾ドメイン名 (FQDN) として指定する必要があります。
    • --user-supplied-rhui-ca-crt rhui-default-ca.crt: RHUI 3 インストールからコピーした CA 証明書。

    • --user-supplied—rhui-ca-key rhui-default-ca.key: RHUI 3 インストールからコピーした CA 鍵。

      注記

      新しい RHUI 4 CDS ノードを使用するように設定されている場合は、RHUI 3 HAProxy を使用できます。または、RHUI 3 HAProxy ホスト名が新規 HAProxy を参照するように DNS を更新して、新しい RHUI 4 HAProxy を使用できます。

第2章 Red Hat Update Infrastructure のアップグレード
リンクのコピー

Red Hat Update Infrastructure (RHUI) は定期的にアップグレードされ、バグ修正、機能拡張を導入して、一般的な脆弱性および露出を修正します。

重要

Red Hat は、最新の RHUI 更新をリリース時に適用し、インストールを最新の状態に保つことを推奨します。

2.1. Red Hat Update Infrastructure の更新
リンクのコピー

Red Hat Update Infrastructure (RHUI) のインスタンスを最新バージョンに更新するには、次の手順を実行する必要があります。

前提条件

  • RHUA ノードへの root アクセス。
  • Red Hat Update Infrastructure のインストール で説明されているとおりに、すべての RHUI ノードがサブスクライブされており、正しいリポジトリーを使用している。
  • リポジトリー同期タスクが、更新の完了後に実行されるようにスケジュールされている。更新中に実行されるタスクは中止される可能性があります。詳細は、既知の問題 を参照してください。
重要

rhui-installer は、PostgreSQL のバージョンのアップグレードをサポートします。アップグレードを実行する前に、PostgreSQL データベースをバックアップすることが重要です。

PostgreSQL データベースをバックアップする方法は、第 12 章 Red Hat Update Infrastructure のバックアップと復元 (Red Hat Update Infrastructure の設定および管理 ドキュメント) で説明されています。

重要

利用可能なすべてのパッケージ更新を単に適用するだけで、RHUA ノードを最新の状態に維持しようと試みることは避けてください。そうすると、RHUA が破損する可能性があります。RHUA の更新は、必ず以下の手順に従って実行する必要があります。

OS の更新のみを適用し、RHUI パッケージの更新を除外する場合は、更新トランザクションで RHUI リポジトリーを除外します。たとえば、コマンドラインで次のコマンドを実行します。 

# dnf --disablerepo=rhui-4-for-rhel-8-x86_64-rpms update
Copy to Clipboard Toggle word wrap

このトランザクションの後、システムを再起動するか、RHUI サービスを再起動する必要がある場合があります。

注記

CDS ノードを最新の状態に保つには、利用可能なパッケージ更新を適用するだけでは不十分です。多くの RHUI バージョンでさまざまな設定が変更されているため、以下の手順に従って設定を再適用する必要があります。

手順

  1. RHUA ノードで、RHUI インストーラーを更新します。 

    # dnf update rhui-installer
    Copy to Clipboard Toggle word wrap

  2. RHUI インストーラーを実行します。

    • RHUI 4.10 から更新する場合に、すでに on_demand 同期ポリシーの使用を開始している場合は、RHUI アップグレード後のカスタム設定の保持 の説明に従って、設定の関連部分をカスタム設定ファイルにコピーします。

    • 次のように rhui-installer コマンドを実行します。

      • RHUI 4.1.0 以前から更新する場合は、rerun オプションとともにカスタム RHUI CA を指定する必要があります。 

        # rhui-installer --rerun --user-supplied-rhui-ca-crt <custom_RHUI_CA.crt> --user-supplied-rhui-ca-key <custom_RHUI_CA_key>
        Copy to Clipboard Toggle word wrap

      • RHUI 4.1.1 以降から更新する場合は、rerun オプションのみを指定して RHUI Installer を実行します。 

        # rhui-installer --rerun
        Copy to Clipboard Toggle word wrap

      • PostgreSQL のバージョンを 12 から 15 に更新する場合は、--postgresql-version オプションと rerun オプションを使用してこれを指定する必要があります。 

        # rhui-installer --postgresql-version 15 --rerun
        Copy to Clipboard Toggle word wrap

  3. オプション: 環境によっては、rhui-installer が再実行に失敗し、代わりに次のエラーが表示されます。 

    There have been identified artifacts with forbidden checksum md5. Run pulpcore-manager handle-artifact-checksums first to unset forbidden checksums.
    Copy to Clipboard Toggle word wrap

    このエラーを修正するには、以下を実行します。

    1. RHUA ノードで以下のコマンドを実行します。 

      # env PULP_SETTINGS=/etc/pulp/settings.py pulpcore-manager handle-artifact-checksums
      Copy to Clipboard Toggle word wrap
    2. rerun オプションを指定して rhui-installer を実行します。

  4. rhui-installer によって更新されたパッケージがインストールされているかどうかを確認します。

    デフォルトでは、rhui-installer は利用可能な RHEL パッケージの更新をインストールします。再起動が必要なパッケージが更新された場合は、RHUA を再起動する必要があります。これをチェックするコマンドは次のとおりです。 

    # needs-restarting -r
    Copy to Clipboard Toggle word wrap
    注記

    このコマンドは yum-utils パッケージの一部であり、コマンドを使用するには、このパッケージが RHUA にインストールされている必要があります。

  5. 更新されたテンプレートおよび Playbook を適用するには、CDS ノードをすべて再インストールします。

    これにより、利用可能な RHEL パッケージの更新もインストールされます。これを回避するには、--no_update フラグを指定して以下のコマンドを実行します。 

    # rhui-manager --noninteractive cds reinstall --all
    Copy to Clipboard Toggle word wrap

  6. 更新されたパッケージが CDS ノードにインストールされているかどうかを確認します。

    パッケージの更新がインストールされた場合は、CDS ノードを再起動する必要がある場合があります。CDS ノードを再起動する必要があるかどうかを確認するには、ノードにログオンして次のコマンドを実行します。 

    # needs-restarting -r
    Copy to Clipboard Toggle word wrap
    注記

    このコマンドは yum-utils パッケージの一部であり、コマンドを使用するには、このパッケージが RHUA にインストールされている必要があります。

  7. RHUI Manager にログインします。 

    # rhui-manager
    Copy to Clipboard Toggle word wrap

検証

  • RHUA ノードで以下のコマンドを実行し、最新バージョンの RHUI がインストールされているかどうかを確認します。 

    # rpm -q rhui-tools
    Copy to Clipboard Toggle word wrap

法律上の通知
リンクのコピー

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

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

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat