インストールおよび管理ガイド

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. u を押して、manage RHUI users を選択します。

3. User Manager 画面で、p を押して change admin's password (followed by logout) を選択します。

   -= User Manager =-
   
      p   change admin's password (followed by logout)
   
      rhui (users) => p
   
      Warning: After password change you will be logged out.
      Use ctrl-c to cancel password change.
      New Password:

4. 新しいパスワードを入力し、再度入力すると変更が確定します。

   New Password:
   Re-enter Password:
   
   [localhost] env PULP_SETTINGS=/etc/pulp/settings.py /usr/bin/pulpcore-manager reset-admin-password -p ********

検証

1. 管理者パスワードを変更すると、次のようなメッセージが表示されます。

   Password successfully updated. For security reasons you have been logged out.

手順

1. RHUI を最新バージョンにアップグレードするには、以下のコマンドを使用して RHUI インストーラーを再実行してください。

   $ podman run --pull=always -it --rm -v ~/.ssh/id_rsa:/ssh-keyfile:Z \
       registry.redhat.io/rhui5/installer-rhel9 rhui-installer \
       --target-user <target-user> --target-host <rhua-hostname> --rerun

2. 次に、RHUA 上で以下のコマンドを実行して、CDS および HAProxy イメージをアップグレードする必要があります。

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. r を押して manage repositories を選択します。
3. Repository Management 画面で a を押して、add a new Red Hat content repository を選択します。

4. Red Hat Update Infrastructure Management Tool が、エンタイトルメントが適用されたリポジトリーを特定するのを待ちます。これには数分の時間がかかる場合があります。

   rhui (repo) => a
   
   Loading latest entitled products from Red Hat...
   ... listings loaded
   Determining undeployed products...
   ... product list calculated

5. Red Hat Update Infrastructure Management Tool は、選択方法を選択するよう求めます。

   Import Repositories:
       1 - All in Certificate
       2 - By Product
       3 - By Repository
   Enter value (1-3) or 'b' to abort:

6. 複数のリポジトリーを製品としてまとめて追加するには (通常は製品のすべてのマイナーバージョンをワンステップで追加します)、2 を押して By Product 方式を選択します。または、By Repository 方式を使用して、特定のリポジトリーを追加することもできます。

7. プロンプトでリポジトリーの数を入力して、追加するリポジトリーを選択します。また、リポジトリーの範囲を選択することもできます (例: 1 ~ 5)。

   Enter value (1-620) to toggle selection, 'c' to confirm selections, or '?' for more commands:

8. 追加するリポジトリーがすべて確認されるまで続行します。

9. リポジトリーの選択が完了したら、c キー を押してください。Red Hat Update Infrastructure Management Tool は、デプロイメントのリポジトリーを表示し、確認を求めます。

   The following products will be deployed:
     Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (Debug RPMs) from RHUI
     Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (RPMs) from RHUI
   Proceed? (y/n)

10. y を押して先に進みます。メッセージは、それぞれのデプロイメントの成功を示します。

    Importing Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (Debug RPMs) from RHUI...
      Importing product repository Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (Debug RPMs) from RHUI (10.1)...
      Importing product repository Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (Debug RPMs) from RHUI (10.0)...
      Importing product repository Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (Debug RPMs) from RHUI (10)...
    
    Importing Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (RPMs) from RHUI...
      Importing product repository Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (RPMs) from RHUI (10.1)...
      Importing product repository Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (RPMs) from RHUI (10.0)...
      Importing product repository Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (RPMs) from RHUI (10)...
    
    Content will not be downloaded to the newly imported repositories
    until the next sync is run.

検証

1. Repository Management 画面で l を押し、正しいリポジトリーがインストールされていることを確認します。

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. r を押して manage repositories を選択します。

3. Repository Management 画面で l を押して、list repositories currently managed by the RHUI を選択します。

   ...
   
   Red Hat Enterprise Linux 10 for ARM 64 - AppStream (RPMs) from RHUI (10)
   Red Hat Enterprise Linux 10 for ARM 64 - AppStream (RPMs) from RHUI (10.0)
   Red Hat Enterprise Linux 10 for ARM 64 - AppStream (RPMs) from RHUI (10.1)
   Red Hat Enterprise Linux 10 for ARM 64 - AppStream (Source RPMs) from RHUI (10)
   Red Hat Enterprise Linux 10 for ARM 64 - AppStream (Source RPMs) from RHUI (10.0)
   Red Hat Enterprise Linux 10 for ARM 64 - AppStream (Source RPMs) from RHUI (10.1)
   Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (Debug RPMs) from RHUI (10)
   Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (Debug RPMs) from RHUI (10.0)
   Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (Debug RPMs) from RHUI (10.1)
   
   
   ...

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. r を押して manage repositories を選択します。

3. Repository Management 画面で、i を押します。

   Enter value (1-1631) to toggle selection, 'c' to confirm selections, or '?' for more commands:

4. リポジトリー名の横にある値を入力してリポジトリーを選択します。製品の選択を確認する前に、一度に 1 つのリポジトリー選択を入力します。

5. 確認するには c を押してください。

   Name:                Red Hat Enterprise Linux 10 for ARM 64 - AppStream (Debug RPMs) from RHUI (10.1)
   ID:                  rhel-10-for-aarch64-appstream-debug-rhui-rpms-8.4
   Type:                Red Hat
   Version:             0
   Relative Path:       content/dist/rhel10/rhui/10.1/aarch64/appstream/debug
   GPG Check:           Yes
   Custom GPG Keys:     (None)
   Red Hat GPG Key:     Yes
   Content Unit Count:
   Last Sync:           2026-11-15 15:56:06
   Next Sync:           2026-11-15 22:00:00
   
   Name:                Red Hat Enterprise Linux 10 for ARM 64 - AppStream (RPMs) from RHUI (10.1)
   ID:                  rhel-10-for-aarch64-appstream-rhui-rpms-8.4
   Type:                Red Hat
   Version:             0
   Relative Path:       content/dist/rhel10/rhui/10.1/aarch64/appstream/os
   GPG Check:           Yes
   Custom GPG Keys:     (None)
   Red Hat GPG Key:     Yes
   Content Unit Count:
   Last Sync:           2026-11-15 19:50:20
   Next Sync:           2026-11-16 01:55:00
   
   Name:                Red Hat Enterprise Linux 10 for ARM 64 - AppStream (Source RPMs) from RHUI (10.1)
   ID:                  rhel-10-for-aarch64-appstream-source-rhui-rpms-8.4
   Type:                Red Hat
   Version:             0
   Relative Path:       content/dist/rhel10/rhui/10.1/aarch64/appstream/source/SRPMS
   GPG Check:           Yes
   Custom GPG Keys:     (None)
   Red Hat GPG Key:     Yes
   Content Unit Count:
   Last Sync:           2026-11-15 15:56:51
   Next Sync:           2026-11-15 22:00:00

検証

1. 選択した内容にも同様の出力が表示されます。

ヒントとコツ

1. RHUI をインストールした直後にすべてのリポジトリーを on_demand に設定すると、最初にメタデータを同期するだけで済むため、デプロイが高速化し、エンドユーザーへの提供が迅速化します。
2. 新規インストール環境で、古いバージョンの RHEL クライアントをサポートする必要がない場合は、キャッシュプライミングストラテジーを活用すると効果的です。エンドユーザーの設定をミラーリングするクライアントを使用し、dnf update を実行することで、RHUI のストレージにコンテンツを事前にダウンロードできます。

手順

1. RHUA ノードで、以下の形式で YAML 入力ファイルを作成します。

   # cat /root/example.yaml
   name: Example_YAML_File
   repo_ids:
       - rhel-10-for-x86_64-baseos-eus-rhui-rpms-10.0

2. rhui-manager ユーティリティーを使用して、入力ファイルに一覧表示されているリポジトリーを追加します。

   # rhua rhui-manager repo add_by_file --file /root/example.yaml --sync_now
   The name of the repos being added: Example_YAML_File
   Loading latest entitled products from Red Hat...
   ... listings loaded
   Successfully added Red Hat Enterprise Linux 10 for x86_64 - BaseOS - Extended Update Support from RHUI (RPMs) (10.0) (Yum)
   ... successfully scheduled for the next available timeslot.

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. r を押して manage repositories を選択します。
3. Repository Management 画面で c を押して、create a new custom repository (RPM content only) を選択します。

4. リポジトリーの一意の ID を入力します。英数字、_ (アンダースコア)、および - (ハイフン) のみが許可されます。一意の ID でスペースを使用することはできません。たとえば、repo1、repo_1、repo-1 は有効なエントリーです。

   Unique ID for the custom repository (alphanumerics, _, and - only):

5. リポジトリーの表示名を入力します。この名前には、ID では使用できないスペースやその他の文字を含めることができます。名前にはデフォルトで ID が使用されます。

   Display name for the custom repository [repo_1]:

6. リポジトリーをホストするパスを指定します。このパスは、RHUI がホストする全リポジトリーで一意でなければなりません。たとえば、このステップでパスを internal/rhel/9/repo_1 として指定すると、リポジトリーが https://<yourLB>/pulp/content/protected/internal/rhel/9/repo_1 に配置されます。

   Unique path at which the repository will be served [repo_1]:

7. 新規リポジトリーを保護するかどうかを選択します。この質問に no と回答すると、すべてのクライアントがリポジトリーにアクセスできます。yes と回答すると、適切なエンタイトルメント証明書を持つクライアントのみがリポジトリーにアクセスできます。

   警告

   名前が示すように、保護されていないリポジトリーのコンテンツは、クライアントのエンタイトルメント証明書を必要とせずに要求するシステムで利用できます。保護されていないリポジトリーを使用してコンテンツを配信する場合は、更新されたクライアント設定 RPM などのコンテンツを配布する場合は注意してください。これにより、保護されたリポジトリーへのアクセスが提供されます。

8. 以下のような質問に yes または no と答えます。

   Should the repository require clients to perform a GPG check and verify packages are signed by a GPG key? (y/n)
   
   Will the repository be used to host any Red Hat GPG signed content? (y/n)
   
   Will the repository be used to host any custom GPG signed content? (y/n)
   
   Enter the absolute path to the public key of the GPG key pair:
   
   Would you like to enter another public key? (y/n)
   
   Enter the absolute path to the public key of the GPG key pair:
   
   Would you like to enter another public key? (y/n)

9. 新しいリポジトリーの詳細が表示されます。プロンプトで y を押して情報を確認し、リポジトリーを作成します。

検証

1. Repository Management 画面で l を押し、正しいリポジトリーがインストールされていることを確認します。

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. r を押して manage repositories を選択します。
3. Repository Management 画面で d を押して、Red Hat リポジトリーを削除します。RHUI が現在管理しているリポジトリーのリストが表示されます。
4. プロンプトでリポジトリーの数を入力して、削除するリポジトリーを選択します。リポジトリーの数を入力すると、そのリポジトリー名の横にチェックマークが付けられます。また、リポジトリーの範囲を選択することもできます (例: 1 ~ 5)。
5. 削除するリポジトリーがすべて確認されるまで続行します。

6. プロンプトで c を押して確定します。

   注記

   リポジトリーを削除した後も、リポジトリーの内容 (リポジトリーデータやパッケージなど) はファイルシステム上に残り、クライアントから引き続き利用される可能性があります。リポジトリーの内容は、次の孤立ファイルクリーンアップタスクが実行された後にのみ削除されるため、クライアントは 404 エラーを目にする可能性があります。RHUI5 では、孤立したユニットは毎週水曜日の午前 4 時に削除されます。管理者は、孤立したユニットをいつでも削除できます。404 エラーを回避するには、クライアント設定 RPM を更新する必要があります。

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. r を押して manage repositories を選択します。

3. Repository Management 画面で、u を押します。

   Select the repositories to upload the package into:
     -    1: test

4. 値 (1-1) を入力すると、選択が切り替わります。
5. 選択を確定するには c を押してください。

6. アップロードするパッケージの場所を入力してください。場所が RPM の場合は、ファイルがアップロードされます。場所がディレクトリーの場合は、そのディレクトリー内のすべての RPM がアップロードされます。

   /root/bear-4.1-1.noarch.rpm
   
   The following RPMs will be uploaded:
     bear-4.1-1.noarch.rpm

7. y を押して続行するか、n を押してキャンセルします。

   Copying RPMs to a temporary directory: /tmp/rhui.rpmupload.jsqdub22.tmp
   .. 1 RPMs copied.
   Creating repository metadata for 1 packages ...
   .. repository metadata created for 1 packages.
   The packages upload task for repo: client-config-rhel-10-x86_64 has been queued: /pulp/api/v3/tasks/01937826-8654-77c1-84f7-e9e07c7a7aeb/
   You can inspect its progress via (S)ync screen/(RR) menu option in rhui-manager TUI.

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. r を押して manage repositories を選択します。

3. Repository Management 画面で、ur を押します。

   Select the repositories to upload the package into:
     -    1: test

4. 値 (1-1) を入力すると、選択が切り替わります。

5. c を押して選択を確認します。

   ### WARNING ### WARNING ### WARNING ### WARNING ### WARNING ### WARNING ###
   #                                                                         #
   #   Content retrieved from non-Red Hat arbitrary places can contain       #
   #   unsupported or malicious software.  Proceed at your own risk.         #
   #                                                                         #
   ###########################################################################

6. アップロードするパッケージのリモート URL を入力します。場所が RPM の場合は、ファイルがアップロードされます。場所が Web ページの場合、そのページからリンクされているすべての RPM がアップロードされます。

   https://repos.fedorapeople.org/pulp/pulp/demo_repos/zoo/bear-4.1-1.noarch.rpm
   Retrieving https://repos.fedorapeople.org/pulp/pulp/demo_repos/zoo/bear-4.1-1.noarch.rpm
   
   The following RPMs will be uploaded:
     bear-4.1-1.noarch.rpm

7. y を押して続行するか、n を押してキャンセルします。

   Copying RPMs to a temporary directory: /tmp/rhui.rpmupload.dwux8rq7.tmp
   .. 1 RPMs copied.
   Creating repository metadata for 1 packages ...
   .. repository metadata created for 1 packages.
   The packages upload task for repo: test has been queued: /pulp/api/v3/tasks/0193770c-6523-7363-ae5e-8c6429728b4f/
   You can inspect its progress via (S)ync screen/(RR) menu option in rhui-manager TUI.

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. r を入力して、manage repositories を選択します。

3. Repository Management 画面で r を入力し、リポジトリーから削除するパッケージを選択しま (カスタム RPM コンテンツのみ)。

   -= Repository Management =-
   
      l   list repositories currently managed by RHUI
      i   display detailed information on a repository
      a   add a new Red Hat content repository
      ac  add a new Red Hat container
      c   create a new custom repository (RPM content only)
      d   delete a repository from RHUI
      u   upload content to a custom repository (RPM content only)
      ur  upload content from a remote web site (RPM content only)
      p   list packages in a repository (RPM content only)
      r   select packages to remove from a repository (Custom RPM content only)

4. 値を入力してリポジトリーを選択します。

   Choose a repository to delete packages from:
       1 - Test-RPM-1
       2 - Test-RPM-2

5. 値を入力して削除するパッケージを選択します。

   Select the packages to remove:
     -    1: example-package-1.noarch.rpm
     -    2: example-package-2.noarch.rpm

6. c を入力して選択を確定します。

   The following packages will be removed:
     example-package-1.noarch.rpm

7. y を入力して続行するか、n を入力してキャンセルします。

   Removed example-package-1.noarch.rpm

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. r を押して manage repositories を選択します。
3. Repository Management 画面で、p を押します。

4. 表示するリポジトリーの数を選択します。Red Hat Update Infrastructure Management Tool により、結果をフィルタリングするかどうかを尋ねられます。行を空白のままにして、フィルターなしで結果を確認します。

   Enter value (1-1631) or 'b' to abort: 1
   
   Enter the first few characters (case insensitive) of an RPM to filter the results
   (blank line for no filter):
   
   Only filtered results that contain less than 100 packages will have their
   contents displayed. Results with more than 100 packages will display
   a package count only.
   
   Packages:
     bear-4.1-1.noarch.rpm

検証

1. 3 種類あるメッセージの 1 つが表示されます。

   Packages:
     bear-4.1-1.noarch.rpm

   Package Count: 8001

   No packages in the repository.

手順

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

   # rhua rhui-manager --noninteractive status --repo_json <output_file>*

   すべてのカスタムリポジトリーおよび Red Hat リポジトリーのディクショナリーリストを含む JSON ファイルが生成されます。ファイルの内容を表示するには、次のコマンドを実行してください。

   # rhua cat <output_file>

2. ホスト上で JSON ファイルを表示したい場合は、以下のコマンドを使用して /root ディレクトリーにファイルを作成できます。

   # rhua rhui-manager --noninteractive status --repo_json /root/<output_file>

   これで、ホストマシン上の出力ファイルに /var/lib/rhui/root/<output_file> としてアクセスできるようになります。

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. e を押して create entitlement certificates and client configuration RPMs を選択します。
3. e を押して generate an entitlement certificate を選択します。

4. プロンプトでリポジトリーの番号を入力して、エンタイトルメント証明書に含めるリポジトリーを選択します。リポジトリー数を入力すると、リポジトリー名前の横に x が付けられます。追加するすべてのリポジトリーがチェックされるまで続行します。

   重要

   単一の RHEL バージョンのリポジトリーのみを単一のエンタイトルメントに含めます。複数の RHEL バージョンのリポジトリーを追加すると、dnf 設定ファイルが使用不能になる。

5. プロンプトで c を押して確定します。

6. 証明書の名前を入力します。この名前は、Red Hat Update Infrastructure Management Tool 内で証明書を識別し、証明書ファイルとキーファイルの名前を生成するのに役立ちます。

   Name of the certificate. This will be used as the name of the certificate file
   (name.crt) and its associated private key (name.key). Choose something that will
   help identify the products contained with it.

7. 証明書を保存するパスを入力します。フィールドを空白のままにして、現在の作業ディレクトリーに保存します。

8. 証明書が有効な日数を入力します。365 日の場合はフィールドを空白のままにしておきます。証明書に含まれるリポジトリーの詳細が表示されます。

   Repositories to be included in the entitlement certificate:
   
     Red Hat Repositories
       Red Hat Enterprise Linux 10 for ARM 64 - AppStream (Debug RPMs) from RHUI
       Red Hat Enterprise Linux 10 for ARM 64 - AppStream (RPMs) from RHUI
       Red Hat Enterprise Linux 10 for ARM 64 - AppStream (Source RPMs) from RHUI
   
       Proceed? (y/n)

9. プロンプトで y を押して、情報を確認し、エンタイトルメント証明書を作成します。

検証

1. エンタイトルメント証明書が作成されると、同様のメッセージが表示されます。

   ..........................+++++
   ....+++++
   Entitlement certificate created at ./rhel10-for-rhui5.crt
   
   ------------------------------------------------------------------------------

手順

1. 以下のコマンドを使用して、CLI からエンタイトルメント証明書を作成します。

   # rhua rhui-manager client cert --repo_label rhel-10-for-x86_64-appstream-eus-rhui-source-rpms --name rhuiclientexample --days 365 --dir /root/clientcert
   .............................................+++++
   ...............................................................................+++++
   Entitlement certificate created at /root/clientcert/rhuiclientexample.crt

   注記

   ID ではなく、Red Hat リポジトリーラベルを使用します。すべてのラベルのリストを取得するには、rhui-manager client labels コマンドを実行します。保護されたカスタムリポジトリーを証明書に含める場合は、代わりにリポジトリーの ID を使用します。

検証

1. エンタイトルメント証明書の作成に成功した場合も同様のメッセージが表示されます。

   Entitlement certificate created at /root/clientcert/rhuiclientexample.crt

手順

1. 以下のコマンドを使用して、RHUI CLI で RPM を作成します。

   # rhua rhui-manager client rpm --entitlement_cert /root/clientcert/rhuiclientexample.crt --private_key /root/clientcert/rhuiclientexample.key --rpm_name clientrpmtest --dir /root --unprotected_repos unprotected_repo1
   Successfully created client configuration RPM.
   Location: /root/clientrpmtest-2.0/build/RPMS/noarch/clientrpmtest-2.0-1.noarch.rpm

   注記

   CLI を使用する場合、RHUI リポジトリーで使用するプロキシーサーバーの URL を指定することもできます。また、_none_ (アンダースコアを含む) を使用して、クライアントマシン上のグローバルな dnf 設定を上書きすることもできます。プロキシーを指定するには、--proxy パラメーターを使用します。

検証

1. クライアント設定 RPM の作成に成功した場合も同様のメッセージが表示されます。

   Successfully created client configuration RPM.
   Location: /root/clientrpmtest-2.0/build/RPMS/noarch/clientrpmtest-2.0-1.noarch.rpm

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. e を押して create entitlement certificates and client configuration RPMs を選択します。
3. Client Entitlement Management 画面で c を押し、create a client configuration RPM from an entitlement certificate を選択します。

4. ローカルディレクトリーの完全なパスを入力し、設定ファイルを保存します。

   Full path to local directory in which the client configuration files generated by this tool
   should be stored (if this directory does not exist, it will be created):

5. RPM の名前を入力します。
6. 設定 RPM のバージョンを入力します。デフォルトのバージョンは 2.0 です。
7. 設定 RPM のリリースを入力します。デフォルトのリリースは 1 です。
8. 特定のリポジトリーへのアクセスをクライアントに許可するエンタイトルメント証明書への完全なパスを入力します。
9. エンタイトルメント証明書の秘密鍵への完全パスを入力します。
10. クライアント設定に含める保護されていないカスタムリポジトリーを選択します。
11. 選択を確認する場合は c を押すか、他のコマンドの場合は ? を押します。

検証

1. RPM が正常に作成されても、同様のメッセージが表示されます。

   Successfully created client configuration RPM.
   Location: /root/clientrpmtest-2.0/build/RPMS/noarch/clientrpmtest-2.0-1.noarch.rpm

手順

1. 次の例では、x86_64 アーキテクチャー上のベース RHEL 10 用のクライアント設定 RPM のカスタムリポジトリーを作成します。

   # rhua rhui-manager repo create_custom --protected --repo_id client-config-rhel-10-x86_64 --display_name "RHUI Client Configuration for RHEL 9 on x86_64" --gpg_public_keys /root/RPM-GPG-KEY-my-cloud

   必要に応じて別のリポジトリー ID と表示名を使用することもできます。また、実際の GPG 鍵ファイルを指定してください。

2. 関連する Red Hat リポジトリーを追加します。以下の YAML ファイルには、バージョン管理されていないリポジトリーを使用した、x86_64 アーキテクチャー上のベース RHEL 10 の典型的なリポジトリーセットが含まれています。

   # cat rhel-10-x86_64.yaml
   name: Red Hat Enterprise Linux 10 on x86_64
   repo_ids:
     - codeready-builder-for-rhel-10-x86_64-rhui-debug-rpms-8
     - codeready-builder-for-rhel-10-x86_64-rhui-rpms-8
     - codeready-builder-for-rhel-10-x86_64-rhui-source-rpms-8
     - rhel-10-for-x86_64-appstream-rhui-debug-rpms-8
     - rhel-10-for-x86_64-appstream-rhui-rpms-8
     - rhel-10-for-x86_64-appstream-rhui-source-rpms-8
     - rhel-10-for-x86_64-baseos-rhui-debug-rpms-8
     - rhel-10-for-x86_64-baseos-rhui-rpms-8
     - rhel-10-for-x86_64-baseos-rhui-source-rpms-8
     - rhel-10-for-x86_64-supplementary-rhui-debug-rpms-8
     - rhel-10-for-x86_64-supplementary-rhui-rpms-8
     - rhel-10-for-x86_64-supplementary-rhui-source-rpms-8

   上記の YAML ファイルを使用してこれらすべてのリポジトリーを追加および同期するには、次のコマンドを実行します。

   # rhua rhui-manager repo add_by_file --file rhel-10-x86_64.yaml --sync_now

3. エンタイトルメント証明書を作成します。証明書で許可されるリポジトリーラベルのリストが必要です。リポジトリーのラベルは、リポジトリー ID と同一であることが多いですが、リポジトリー ID に特定の RHEL マイナーバージョンが含まれている場合は例外で、その場合はラベルにはマイナーバージョンは含まれず、メジャーバージョンのみが含まれます。ベースとなる RHEL リポジトリーの場合、ID は同一であるため、上記の YAML ファイルから次の Python コードを使用して抽出できます。

   import yaml
   with open("rhel-10-x86_64.yaml") as repoyaml:
       repodata = yaml.safe_load(repoyaml)
       print(",".join(repodata["repo_ids"]))

   出力をクリップボードにコピーし、環境変数 ($labels など) として保存します。

   # labels=<paste the contents of the clipboard here>

   エンタイトルメント証明書を作成する際には、RHEL リポジトリーのラベルに加えて、カスタムリポジトリーもコンマ区切りのラベルリストに追加する必要があります。以下のコマンドを実行して、RHEL リポジトリーとカスタムリポジトリーの両方へのアクセスを許可するエンタイトルメント証明書を作成します。

   # rhua rhui-manager client cert --name rhel-10-x86_64 --dir /root --days 3650 --repo_label $labels,client-config-rhel-10-x86_64

   会社のポリシーで証明書の有効期間が 1 年、2 年などに制限されている場合は、それに応じて --days 引数の値を変更します。

   このコマンドは 、/root/rhel- 10-x86_64.crt と /root/rhel-10-x86_64.key というファイルを作成します。これらのファイルは次のステップで必要になります。

4. クライアント設定 RPM を作成します。

   # rhua rhui-manager client rpm --dir /tmp --rpm_name rhui-client-rhel-10-x86_64 --rpm_version 1.0 --entitlement_cert /root/rhel-10-x86_64.crt --private_key /root/rhel-10-x86_64.key

   任意の RPM 名またはバージョンを使用してください。上記の値を指定すると、コマンドによって RPM が作成され、その場所が出力されます。場所は次のとおりです。

    `/tmp/rhui-client-rhel-10-x86_64-1.0/build/RPMS/noarch/rhui-client-rhel-10-x86_64-1.0-1.noarch.rpm`
   . Transfer this RPM from the RHUA to your system and sign it with the appropriate GPG key—the
   private key that corresponds to the public key that you used as the `--gpg_public_keys` parameter
   when you created the custom repository. You can then, for example, have the signed RPM
   preinstalled on RHEL 8 x86_64 images in your cloud environment. You also need to transfer the
   signed RPM back to the RHUA and upload it to the custom repository for RHEL 8 on x86_64:

   # rhua rhui-manager packages upload --repo_id client-config-rhel-10-x86_64 --packages /root/signed/rhui-client-rhel-10-x86_64-1.0-1.noarch.rpm

検証

1. カスタムリポジトリーの内容を確認します。

   # rhua rhui-manager packages list --repo_id client-config-rhel-10-x86_64

   このコマンドは、アップロードした RPM ファイルを出力するためのものです。

2. CDS ノードと HAProxy ノードを設定 (このガイドで後ほど説明) してから、テスト仮想マシンにクライアント設定 RPM をインストールし、テスト仮想マシンで次のコマンドを実行して、関連するすべてのリポジトリーへのアクセスを確認することもできます。

   # dnf -v repolist

   このコマンドは、設定済みの RHEL 8 リポジトリーと、クライアント設定 RPM 用のカスタムリポジトリーを表示することを目的としています。

1. 前回の呼び出しで 1.0 を使用した場合は、2.0 などを使用します。他のパラメーターはそのままにします。

   # rhua rhui-manager client rpm --dir /tmp --rpm_name rhui-client-rhel-10-x86_64 --rpm_version 2.0 ...

2. 再度、新しい RPM に署名し、RHUA に転送して、カスタムリポジトリーにアップロードします。

   # rhua rhui-manager packages upload --repo_id client-config-rhel-10-x86_64 --packages /root/signed/rhui-client-rhel-10-x86_64-2.0-1.noarch.rpm

3. これで、以前のバージョンの RPM がインストールされているクライアント仮想マシンを新しいバージョンに更新できます。新しい RPM をアップロードしたときに、更新されたリポジトリーデータを dnf で再ロードするには、クライアント仮想マシン上の dnf キャッシュを消去する必要がある場合があります。

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. n を押して manage Red Hat entitlement certificates を選択します。

3. Entitlements Manager 画面で l を押して、現在のコンテンツ証明書に関するデータをリスト表示します。

   rhui (entitlements) => l
   
   Red Hat Enterprise Linux 10 for ARM 64 - AppStream (Debug RPMs) from RHUI
      Expiration: 02-27-2027     Certificate: c885597492374720bb5d398c3f65d1ed.pem
   
      Red Hat Enterprise Linux 10 for ARM 64 - AppStream (RPMs) from RHUI
      Expiration: 02-27-2027     Certificate: c885597492374720bb5d398c3f65d1ed.pem
   
      Red Hat Enterprise Linux 10 for ARM 64 - AppStream (Source RPMs) from RHUI
      Expiration: 02-27-2027     Certificate: c885597492374720bb5d398c3f65d1ed.pem
   
      Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (Debug RPMs) from RHUI
      Expiration: 02-27-2027     Certificate: c885597492374720bb5d398c3f65d1ed.pem
   
      Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (RPMs) from RHUI
      Expiration: 02-27-2027     Certificate: c885597492374720bb5d398c3f65d1ed.pem
   
      Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (Source RPMs) from RHUI
      Expiration: 02-27-2027     Certificate: c885597492374720bb5d398c3f65d1ed.pem

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. c を押して manage content delivery servers (CDS) を選択します。
3. Content Delivery Server (CDS) Management 画面で a を押して、新しい CDS インスタンスを追加します。

4. 追加する CDS のホスト名を入力します。

   Hostname of the CDS instance to register:
   cds1.example.com

5. CDS への SSH アクセスがあり、sudo 権限を持つユーザー名を入力します。

   Username with SSH access to <cds1.example.com> and sudo privileges:
   <cloud-user>

6. CDS にログインするために SSH 秘密鍵への絶対パスを入力し、Enter を押します。

   Absolute path to an SSH private key to log into <cds1.example.com> as <cloud-user>:
   /home/<cloud-user>/.ssh/id_rsa_rhua

7. 利用可能なパッケージの最新バージョンでインスタンスを更新します。

   Update instance after registering? (y/n): y

8. オプション カスタム SSL 証明書を使用する場合は、カスタム SSL 証明書、SSL キー、および SSL crt ファイルへの絶対パスを入力します。

   注記

   SSL 証明書を指定しない場合は、自動的に生成されます。

   Optional absolute path to user supplied SSL key file:
   /home/<cloud-user>/custom_ssl.key
   
   Optional absolute path to user supplied SSL crt file:
   /home/<cloud-user>/custom_ssl.crt
   
   .........................................................................
   The following CDS has been successfully added:
   
     Hostname:             <cds1.example.com>
     SSH Username:         <cloud-user>
     SSH Private Key:      /home/<cloud-user>/.ssh/id_rsa_rhua
   
   The CDS will now be configured:
   ....................................................................
   The CDS was successfully configured.

9. コンテンツ配信サーバーを追加できない場合は、ファイアウォールルールが RHUA と CDS 間のアクセスを許可していることを確認します。

10. mount コマンドを実行して、共有ストレージが読み取り/書き込みとしてマウントされているかどうかを確認します。

    [root@rhua ~]# mount | grep rhui
    
    nfs.example.com:/export on /var/lib/rhui/remote_share type nfs4 (rw,relatime,vers=4.2,rsize=1048576,wsize=1048576,namlen=255,hard,proto=tcp,timeo=600,retrans=2,sec=sys,clientaddr=10.8.41.163,local_lock=none,addr=10.8.41.163)

11. 設定に成功すると、残りのすべての CDS ノードでこの手順を繰り返します。

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. c を押して、manage content delivery servers (CDS) を選択します。

3. コンテンツ配信サーバー (CDS) 管理 画面で、l を押すと、RHUI 5} が管理する既知のすべての CDS ノードが表示されます。

   Hostname:             <cds1.example.com>
   SSH Username:     <cloud-user>
   SSH Private Key:     /<cloud-user>/.ssh/id_rsa_rhua

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. c を押して manage content delivery servers (CDS) を選択します。
3. Content Delivery Server (CDS) Management 画面で、r を押して、reinstall and reapply configuration to an existing CDS instance を選択します。Red Hat Update Infrastructure Management Tool は、すべての再インストールおよび再設定タスクを自動的に実行します。

4. 再インストールする CDS を選択します。

       1 -
       Hostname:             <cds1.example.com>
       SSH Username:     <cloud-user>
       SSH Private Key:     /<cloud-user>/.ssh/id_rsa_rhua

5. 値を入力するか、b を入力して中止してください: 1: 1

6. Update instance (s) after reinstall? (y/n) で y を入力します。

   Checking that the RHUA services are reachable from the instance...
   Done.
   
   
   Installing and configuring the CDS...
   
   PLAY [Registering a CDS instance] **********************************************
   
   ...
   
   TASK [Update CDS instance] *****************************************************
   ok: [cds1.example.com]
   
   PLAY RECAP *********************************************************************
   cloud-user@cds1.example.com : ok=24   changed=10   unreachable=0    failed=0    skipped=2    rescued=0    ignored=0
   
   Done.

手順

1. 既存の CA 証明書を CDS ノードに転送し、/etc/pki/rhui/legacy-ca/ ディレクトリーに保存してください。

2. 証明書からサブジェクトのハッシュ値を取得し、シェル変数に保持します。

   #hash=`openssl x509 -hash -noout -in /etc/pki/rhui/legacy-ca/YOUR_CERT.crt`

3. /etc/pki/tls/certs/ ディレクトリーにある証明書ファイルへのシンボリックリンクを作成します。リンク名は、ハッシュ値と、0 から始まる未使用の番号を使用します。

   #ln -s /etc/pki/rhui/legacy-ca/YOUR_CERT.crt /etc/pki/tls/certs/$hash.0

   このアクションはすぐに有効になります。

手順

1. CDS ノードで、/etc/pki/rhui/legacy/ ディレクトリーに移動します。

   # cd /etc/pki/rhui/legacy/

2. オプション: 既存の CA 証明書をバックアップします。

3. 制限する CA に対応する CA 証明書を削除します。

   # rm example-legacy.crt

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. c を押して manage content delivery servers (CDS) を選択します。
3. Content Delivery Server (CDS) Management 画面で d を押して CDS インスタンスを削除します。

4. 削除する CDS のホスト名を入力します。

   Hostname of the CDS instance to unregister:
   cds1.example.com

前提条件

1. HAProxy ロードバランサーノードで sshd が稼働しており、port 443 が開いていることを確認する。

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. l を押して、manage HAProxy load-balancer instances を選択します。
3. Load-balancer (HAProxy) Management 画面で a を押して、新しいロードバランサーインスタンスを追加します。

4. 新しいロードバランサーのホスト名を入力します。

   Hostname of the HAProxy Load-balancer instance to register:
   <haproxy1.example.com>

5. ロードバランサーへの SSH アクセスがあり、sudo 権限を持つユーザー名を入力します。

   Username with SSH access to cds.example.com and sudo privileges:
   <cloud-user>

6. ロードバランサーインスタンスにログインするために SSH 秘密鍵に絶対的な部分を入力し、Enter を押します。

   Absolute path to an SSH private key to log into cds.example.com as <cloud-user>:
   /<cloud-user>/.ssh/id_rsa_rhua

7. 利用可能なパッケージの最新バージョンでインスタンスを更新します。

   Update instance after registering? (y/n): y

8. オプション: ユーザーが指定した HAProxy 設定ファイルへのオプションの絶対パスを入力し、Enter キー を押します。

   カスタム設定ファイルへのパスを指定しない場合は、代わりにデフォルトのファイル /usr/share/rhui-tools/templates/haproxy.cfg が使用されます。

   Optional absolute path to user supplied HAProxy config file:
   
   .........................................................................
   The following load-balancer has been successfully added:
   
   Hostname:         <haproxy1.example.com>
   SSH Username:     <cloud-user>
   SSH Private Key:  /<cloud-user>/.ssh/id_rsa_rhua
   
   The load-balancer will now be configured:

9. ロードバランサーの追加に失敗した場合、ファイアウォールのルールで RHUA とロードバランサー間のアクセスが許可されているか確認してください。
10. 設定に成功すると、残りのロードバランサーインスタンスにこの手順を繰り返します。

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. l を押して、manage HAProxy load-balancer instances を選択します。

3. Load-balancer (HAProxy) Management 画面で l を押すと、RHUI が管理するロードバランサーインスタンスがリスト表示されます。

   Hostname:             <haproxy1.example.com>
   SSH Username:     <cloud-user>
   SSH Private Key:     /<cloud-user>/.ssh/id_rsa_rhua

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. l を押して、manage HAProxy load-balancer instances を選択します。

3. Load-balancer (HAProxy) Management 画面で r を押すと、ロードバランサーのインスタンスに設定を再インストールして再適用します。

   Red Hat Update Infrastructure Management Tool は、すべての再インストールおよび再設定タスクを自動的に実行します。

4. 再インストールするロードバランサーを選択します。

       1 -
       Hostname:             <haproxy1.example.com>
       SSH Username:     <cloud-user>
       SSH Private Key:     /<cloud-user>/.ssh/id_rsa_rhua

5. 値を入力するか、b を入力して中止してください: 1: 1

6. Update instance (s) after reinstall? (y/n) で y を入力します。

   Installing and configuring the HAProxy Load-balancer...
   
   PLAY [Registering a load balancer instance] ************************************
   
   ...
   
   TASK [Update load balancer instance] *******************************************
   ok: [haproxy1.example.com]
   
   PLAY RECAP *********************************************************************
   cloud-user@haproxy1.example.com : ok=8    changed=3    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
   
   Done.

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. l を押して、manage HAProxy load-balancer instances を選択します。
3. Load-balancer (HAProxy) Management 画面で d を押してロードバランサーインスタンスを削除します。

4. 削除するロードバランサーのホスト名を入力してください。

   Hostname of the load-balancer instance to unregister:
   <haproxy1.example.com>

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. s を押して、同期のステータスとスケジューリング を選択します。

3. Synchronization Status 画面から、dr を押します。

   -= Repository Summary Synchronization Status =-
   
   Last Refreshed: 02:01:22
   (updated every 5 seconds, ctrl+c to exit)
   
   Last Sync                    Last Result
   -------------------------------------------------
   Red Hat Enterprise Linux 10 for ARM 64 - BaseOS (Debug RPMs) from RHUI (10)
     Never                        None
   ....
   ....
   Red Hat Enterprise Linux 10 for x86_64 - AppStream from RHUI (Debug RPMs) (10.1)
     2026-07-29 17:45:41          Running
   Associating Content: 11001 (97%)
   Downloading Artifacts: 7376

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. s を押して、同期のステータスとスケジューリング を選択します。

3. Synchronization Status 画面から rr を押します。

   Last Refreshed: 02:06:46
   (updated every 5 seconds, ctrl+c to exit)
   
   Current Sync                 Result
   -------------------------------------------------
   Red Hat Enterprise Linux 10 for x86_64 - AppStream from RHUI (Debug RPMs) (10.0)
     2026-07-29 17:45:41          Running
   Associating Content: 11001 (97%)
   Downloading Artifacts: 7376

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. s を押して、同期のステータスとスケジューリング を選択します。
3. Synchronization Status 画面から vr を押します。

4. 詳細を確認するリポジトリーの番号を入力します。

   Enter value (1-66) or 'b' to abort:

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. s を押して、同期のステータスとスケジューリング を選択します。

3. Synchronization Status 画面から sr を押します。

   Select one or more repositories to schedule to be synchronized before its scheduled time.
   The sync will happen as soon as possible depending on other tasks that may be executing
   in the RHUI.  Sync requests for repositories with tasks in running
   or pending state will be ignored.
   
            Last Result  Next Sync              Repository
            -------------------------------------------------

4. リポジトリー名の横にある値を入力してリポジトリーを選択します。製品の選択を確認する前に、一度に 1 つのリポジトリー選択を入力します。

   x  714: Error        2026-11-17 20:30:00    Red Hat Enterprise Linux 10 for ARM 64 - AppStream (RPMs) from RHUI (10.0)

5. 確認するには c を押してください。

   The following repositories will be scheduled for synchronization:
     Red Hat Enterprise Linux 10 for ARM 64 - AppStream (RPMs) from RHUI (10.0)
   Proceed? (y/n) y

6. y を押して続行します。

   Scheduling sync for Red Hat Enterprise Linux 10 for ARM 64 - AppStream (RPMs) from RHUI (10.0)...
   ... successfully scheduled for the next available timeslot.

   注記

   このメッセージは、選択したリポジトリーのタスクが実行中であるかどうかを示します。現在実行中のタスクによってリポジトリーが予約されているため、Red Hat Enterprise Linux 10 for x86_64 - AppStream from RHUI (Debug RPMs) (10.0) の同期要求を無視します。

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. s を押して、同期のステータスとスケジューリング を選択します。
3. Synchronization Status 画面から ca を押して、cancel active sync tasks を選択します。

4. 取り消すタスクまたはタスクの値を入力します。

   Select one or more repositories for which you want to cancel their active tasks.
     -    1: Red Hat Enterprise Linux 10 for x86_64 - AppStream from RHUI (Debug RPMs) (10.0)
   Enter value (1-1) to toggle selection, 'c' to confirm selections, or '?' for more commands:

5. 選択を確定するには c を押してください。

6. y を押して、1 つまたは複数の同期タスクをキャンセルします。

   The active tasks will be canceled for the following repositories:
     Red Hat Enterprise Linux 8 for x86_64 - AppStream from RHUI (Debug RPMs) (10.0)
   Proceed? (y/n)

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. s を押して、同期のステータスとスケジューリング を選択します。

3. Synchronization Status 画面から、ap を押します。

   rhui (sync) => ap
   
   Select one or more repositories to toggle the auto-publish status.
   The operation will be executed as soon as possible depending on other tasks
   that may be executing in the RHUI.
   
                   Status | Repository
              --------------------------------------------------------------------------
   Select one or more repositories:
   
     Custom Repositories
   
     Red Hat Repositories: dnf
   
        -  713:       AUTO Red Hat Enterprise Linux 10 for ARM 64 - AppStream (RPMs) from RHUI (10)
        -  714:       AUTO Red Hat Enterprise Linux 10 for ARM 64 - AppStream (RPMs) from RHUI (10.1)

4. 選択を切り替えるには値 (1 - 1631) を入力し、選択を確定するには c を入力し、その他のコマンドを表示するには ? を入力してください。

   The following repositories will have their auto-publish status changed:
     Red Hat Repositories
       dnf
          Red Hat Enterprise Linux 10 for ARM 64 - AppStream (RPMs) from RHUI (10.0)

5. 選択を確定するには c を押してください。
6. y を押して先に進みます。

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. s を押して、同期のステータスとスケジューリング を選択します。
3. Synchronization Status 画面から wf を押します。

4. 選択を切り替えるには値 (1 - 1631) を入力し、選択を確定するには c を入力し、その他のコマンドを表示するには ? を入力してください。

   The following repositories will be scheduled for workflow push:
     Red Hat Repositories
       dnf
          Red Hat Enterprise Linux 10 for ARM 64 - AppStream (RPMs) from RHUI (10)

5. y を押して続行します。

手順

1. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhua rhui-manager

2. s を押して、同期のステータスとスケジューリング を選択します。
3. Synchronization Status 画面から、ex を押します。
4. 値を入力すると、選択が切り替わります。

5. c を押して選択を確認します。

   The following repositories will be exported:
     Red Hat Repositories
       dnf
          Red Hat Enterprise Linux 10 for ARM 64 - AppStream (Source RPMs) from RHUI (10)

6. y を押して先に進みます。

手順

1. RHUA サービスを停止する:

   # systemctl stop rhui_rhua

2. サービスが停止したかどうかを確認します。

   # systemctl status rhui_rhua

3. 以下のファイルをバックアップします。

   # rsync -av --exclude .local --exclude remote_share /var/lib/rhui/ /BACKUP/DIRECTORY/

   重要

   ファイルをバックアップするときに、ファイルが現在の属性を保持していることを確認してください。

4. 生成されたクライアントエンタイトルメント証明書とクライアント設定 RPM をバックアップします。

   • オプション: ファイルサーバーに別のバックアップソリューションを使用せずに、RHUA からリモート共有をバックアップする場合は、次のコマンドを使用します。

     # rsync -av /var/lib/rhui/remote_share/ /ANOTHER/BACKUP/DIRECTORY/

5. RHUI サービスを再起動します。

   # systemctl start rhui_rhua

手順

1. nginx サービスを停止します。

   # systemctl stop nginx

2. nginx サービスが停止していることを確認します。

   # systemctl status nginx

3. 以下のファイルをバックアップします。

   # cp -a <source_files_path> <destination_files_path>

   重要

   ファイルをバックアップするときに、ファイルが現在の属性を保持していることを確認してください。

   ファイルのリスト:

   • /etc/nginx/*
   • /var/log/nginx/*
   • /etc/pki/rhui/*

4. RHUI サービスを再起動します。

   # rhui-services-restart

手順

1. プロキシーサーバーの設定を設定 (または設定解除) するには、ローカルオーバーライドファイル /etc/rhui/rhui-tools.conf を作成 (または編集) して、以下の内容を記述します。

   [proxy]
   proxy_protocol: <PROTOCOL>
   proxy_host: <HOSTNAME>
   proxy_port: <PORT>
   proxy_user: <USERNAME>
   proxy_pass: <PASSWORD>

   すると、パラメーターは以下のようになります。

   • PROTOCOL は プロキシーサーバーを設定する場合は http または https の いずれかです。設定を解除する場合、ローカルファイルを使用する場合は、値を空のままにします。
   • HOSTNAME は新しいプロキシーサーバーのホスト名です。ローカルファイルを使用する際に設定をクリアする場合は、この値を空のままにしてください。
   • PORT はプロキシーサーバーがリッスンしている TCP ポート番号で、通常は 3128 です。ローカルファイルを使用する際に設定をクリアする場合は、この値を空のままにしてください。
   • USERNAME はオプションのパラメーターです。プロキシーサーバーに認証情報が必要な場合にのみ使用してください。そうでない場合、またはローカルファイルを使用する際に設定をクリアする場合は、値を空のままにするか、proxy_user: オプションをまったく使用しないでください。
   • PASSWORD はオプションのパラメーターです。プロキシーサーバーに認証情報が必要な場合にのみ使用してください。そうでない場合、またはローカルファイルを使用する際に設定をクリアする場合は、値を空のままにするか、proxy_user: オプションをまったく使用しないでください。

   • すべてのコマンドは RHUA コンテナー内で実行する必要があります。

     重要

     この新しい設定は、設定が更新された後に追加された Red Hat リポジトリーにのみ適用されます。この新しい設定を既存のリポジトリーに適用するには、リポジトリーを削除、追加、および再同期する必要があります。

     これにより、削除した瞬間から再同期するまで停止状態が続きます。ただし、すでに同期されたパッケージは Red Hat CDN から再度ダウンロードする必要はありません。RHUI は主に、すべての repodata ファイルを解析し、どのパッケージがどこに属しているかを判断する必要があります。これには数時間かかる場合があります。

     rhui-manager の外部には、技術的に、既存のリポジトリー (つまり、いわゆる remotes) のプロキシーフィールドを変更できる手段がありますが、そのような手段の使用はサポートされていません。

2. リポジトリーを再度追加できるように、リポジトリーのリスト (複数可) があることを確認してください。そのようなリストがない場合は、rhui-manager を使用して、現在追加されているすべての Red Hat リポジトリーを含むファイルを生成できます。

3. Red Hat リポジトリーのリストを生成するには、まず 1 行に 1 つの ID を含む生のリストを作成します。

   rhui-manager --noninteractive repo list --redhat_only --ids_only > /root/rawlist

4. 次に、リポジトリーを含む YAML ファイルを作成します。まずスタブを作成します。

   echo -e "name: all Red Hat repositories\nrepo_ids:" > /root/repo_list.yml

5. 次に、生のリストからリポジトリーを YAML リスト項目として追加します。

   sed "s/^/  - /" /root/rawlist >> /root/repo_list.yml

6. RHUI からすべての Red Hat リポジトリーを削除します。

   テキストユーザーインターフェイスを使用するか、コマンドラインで 1 つずつ削除します。後者の場合、先ほど作成した生のリストを使用できます。

   while read repo; do rhui-manager --noninteractive repo delete --repo_id $repo; done < /root/rawlist

   注記

   リポジトリーは、非同期のバックグラウンドタスクで削除されます。つまり、利用可能な Pulp ワーカーによってキューに入れられ、実行されます。実際にすべてのリポジトリーを削除するには、数十分または数時間かかる場合があります。完了までしばらくお待ちください。

7. リポジトリーが削除されたら、再度追加します。今回は新しいプロキシー設定 (またはプロキシー URL なし) で追加されます。リポジトリーを再同期する必要もあります。コマンドラインで 1 つの手順で追加および再同期できます。

   rhui-manager --noninteractive repo add_by_file --file /root/repo_list.yml --sync_now

   または、独自の方法 (例: 特定の順序) を使用して、リポジトリーを同期します。最後に、同期が自動的に開始されるまで待機することも可能です。開始時間は 6 時間後、または /etc/rhui/rhui-tools.conf の repo_sync_frequency で定義されている任意の時間です。

   重要

   その間リポジトリーは利用できません。