Red Hat Update Infrastructure の設定および管理

手順

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

   [root@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. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@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 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI
     Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (RPMs) from RHUI
   Proceed? (y/n)

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

    Importing Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI...
      Importing product repository Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI (8.4)...
      Importing product repository Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI (8.3)...
      Importing product repository Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI (8.2)...
      Importing product repository Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI (8.1)...
      Importing product repository Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI (8.0)...
      Importing product repository Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI (8)...
    
    Importing Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (RPMs) from RHUI...
      Importing product repository Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (RPMs) from RHUI (8.4)...
      Importing product repository Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (RPMs) from RHUI (8.3)...
      Importing product repository Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (RPMs) from RHUI (8.2)...
      Importing product repository Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (RPMs) from RHUI (8.1)...
      Importing product repository Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (RPMs) from RHUI (8.0)...
      Importing product repository Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (RPMs) from RHUI (8)...
    
    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 ~]# rhui-manager

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

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

   ...
   
   Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8)
   Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.0)
   Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.1)
   Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.2)
   Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.3)
   Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.4)
   Red Hat Enterprise Linux 8 for ARM 64 - AppStream (Source RPMs) from RHUI (8)
   Red Hat Enterprise Linux 8 for ARM 64 - AppStream (Source RPMs) from RHUI (8.0)
   Red Hat Enterprise Linux 8 for ARM 64 - AppStream (Source RPMs) from RHUI (8.1)
   Red Hat Enterprise Linux 8 for ARM 64 - AppStream (Source RPMs) from RHUI (8.2)
   Red Hat Enterprise Linux 8 for ARM 64 - AppStream (Source RPMs) from RHUI (8.3)
   Red Hat Enterprise Linux 8 for ARM 64 - AppStream (Source RPMs) from RHUI (8.4)
   Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI (8)
   Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI (8.0)
   Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI (8.1)
   Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI (8.2)
   Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI (8.3)
   Red Hat Enterprise Linux 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI (8.4)
   
   ...

手順

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

   [root@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 8 for ARM 64 - AppStream (Debug RPMs) from RHUI (8.4)
   ID:                  rhel-8-for-aarch64-appstream-debug-rhui-rpms-8.4
   Type:                Red Hat
   Version:             0
   Relative Path:       content/dist/rhel8/rhui/8.4/aarch64/appstream/debug
   GPG Check:           Yes
   Custom GPG Keys:     (None)
   Red Hat GPG Key:     Yes
   Content Unit Count:
   Last Sync:           2021-11-15 15:56:06
   Next Sync:           2021-11-15 22:00:00
   
   Name:                Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.4)
   ID:                  rhel-8-for-aarch64-appstream-rhui-rpms-8.4
   Type:                Red Hat
   Version:             0
   Relative Path:       content/dist/rhel8/rhui/8.4/aarch64/appstream/os
   GPG Check:           Yes
   Custom GPG Keys:     (None)
   Red Hat GPG Key:     Yes
   Content Unit Count:
   Last Sync:           2021-11-15 19:50:20
   Next Sync:           2021-11-16 01:55:00
   
   Name:                Red Hat Enterprise Linux 8 for ARM 64 - AppStream (Source RPMs) from RHUI (8.4)
   ID:                  rhel-8-for-aarch64-appstream-source-rhui-rpms-8.4
   Type:                Red Hat
   Version:             0
   Relative Path:       content/dist/rhel8/rhui/8.4/aarch64/appstream/source/SRPMS
   GPG Check:           Yes
   Custom GPG Keys:     (None)
   Red Hat GPG Key:     Yes
   Content Unit Count:
   Last Sync:           2021-11-15 15:56:51
   Next Sync:           2021-11-15 22:00:00

検証

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

1. バイナリー RPM リポジトリー
2. ソース RPM リポジトリー
3. デバッグ RPM リポジトリー

1. immediate
2. on_demand

1. rpm_sync_policy
2. source_sync_policy
3. debug_sync_policy

ヒントとコツ

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

手順

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

   # cat /root/example.yaml
   name: Example_YAML_File
   repo_ids:
       - rhel-8-for-x86_64-baseos-eus-rhui-rpms-8.1
       - rhel-8-for-x86_64-baseos-eus-rhui-rpms-8.2
       - rhel-8-for-x86_64-baseos-eus-rhui-rpms-8.4
       - rhel-8-for-x86_64-baseos-eus-rhui-rpms-8.6

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

   # 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 8 for x86_64 - BaseOS - Extended Update Support from RHUI (RPMs) (8.1) (Yum)
   Successfully added Red Hat Enterprise Linux 8 for x86_64 - BaseOS - Extended Update Support from RHUI (RPMs) (8.2) (Yum)
   Successfully added Red Hat Enterprise Linux 8 for x86_64 - BaseOS - Extended Update Support from RHUI (RPMs) (8.4) (Yum)
   Successfully added Red Hat Enterprise Linux 8 for x86_64 - BaseOS - Extended Update Support from RHUI (RPMs) (8.6) (Yum)
   ... successfully scheduled for the next available timeslot.
   ... successfully scheduled for the next available timeslot.
   ... successfully scheduled for the next available timeslot.
   ... successfully scheduled for the next available timeslot.

手順

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

   [root@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 ~]# rhui-manager

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

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

   注記

   リポジトリーの削除後、削除されたリポジトリーを参照するクライアント設定 RPM は yum では使用できません。

手順

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

   [root@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-8-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 ~]# 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 ~]# rhui-manager

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

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

   -= Repository Management =-
   
      l   list repositories currently managed by the 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 the 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 ~]# 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. Red Hat Update Infrastructure Management Tool のホーム画面に移動します。

   [root@rhua ~]# rhui-manager

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

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

   重要

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

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 8 for ARM 64 - AppStream (Debug RPMs) from RHUI
       Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI
       Red Hat Enterprise Linux 8 for ARM 64 - AppStream (Source RPMs) from RHUI
   
       Proceed? (y/n)

9. プロンプトが表示されたら y を押して、情報を確認し、エンタイトルメント証明書を作成します。

検証

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

   ..........................+++++
   ....+++++
   Entitlement certificate created at ./rhel8-for-rhui4.crt
   
   ------------------------------------------------------------------------------

手順

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

   # rhui-manager client cert --repo_label rhel-8-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. クライアント RPM、または RPM がインストールされているマシンで、クライアントエンタイトルメント証明書が保存されるパスを指定して以下のコマンドを実行します。

   # openssl x509 -noout -text -in /etc/pki/rhui/product/content.crt | grep bit

2. RSA 鍵の長さを確認します。

   • 長さが 2048 ビットの場合には、クライアントエンタイトルメント証明書は FUTURE ポリシーに準拠していません。
   • 長さが 4096 ビットの場合には、クライアントエンタイトルメント証明書は FUTURE ポリシーに準拠しています。

手順

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

   [root@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: /tmp/clientrpmtest-2.0/build/RPMS/noarch/clientrpmtest-2.0-1.noarch.rpm

手順

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

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

   注記

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

検証

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

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

手順

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   /tmp/rhui-client-rhel-8-x86_64-1.0/build/RPMS/noarch/rhui-client-rhel-8-x86_64-1.0-1.noarch.rpm

5. この RPM を RHUA からシステムに転送し、適切な GPG 鍵 (カスタムリポジトリーの作成時に --gpg_public_keys パラメーターとして使用した公開鍵に対応する秘密鍵) を使用して RPM に署名します。その後、たとえば、クラウド環境内の Red Hat Enterprise Linux 8 x86_64 イメージに、署名済み RPM をプリインストールすることができます。また、署名済み RPM を RHUA に転送し、x86_64 上の Red Hat Enterprise Linux 8 のカスタムリポジトリーにアップロードする必要があります。

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

検証

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

   # rhui-manager packages list --repo_id client-config-rhel-8-x86_64

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

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

   # yum -v repolist

   このコマンドは、設定された Red Hat Enterprise Linux 8 リポジトリーとクライアント設定 RPM 用のカスタムリポジトリーを出力するためのものです。

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

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

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

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

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

手順

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

   [root@rhua ~]# rhui-manager

2. s を押して、synchronization status and scheduling を選択します。

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 8 for ARM 64 - BaseOS (Debug RPMs) from RHUI (8)
     Never                        None
   ....
   ....
   Red Hat Enterprise Linux 8 for x86_64 - AppStream from RHUI (Debug RPMs) (8.2)
     2021-07-29 17:45:41          Running
   Associating Content: 11001 (97%)
   Downloading Artifacts: 7376

手順

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

   [root@rhua ~]# rhui-manager

2. s を押して、synchronization status and scheduling を選択します。

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

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

手順

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

   [root@rhua ~]# rhui-manager

2. s を押して、synchronization status and scheduling を選択します。
3. Synchronization Status 画面から vr を押します。

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

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

検証

1. 選択したリポジトリーが同期されていない場合も同様のメッセージが表示されます。

   Repo: Red Hat Enterprise Linux 8 for x86_64 - AppStream from RHUI (Debug RPMs) (8.2)
   No syncs have been completed for this repository.

手順

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

   [root@rhua ~]# rhui-manager

2. s を押して、synchronization status and scheduling を選択します。

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        2021-11-17 20:30:00    Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.4)

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

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

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

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

   注記

   このメッセージは、選択したリポジトリーのタスクが実行中であるかどうかを示します。Ignoring sync request for Red Hat Enterprise Linux 8 for x86_64 - AppStream from RHUI (Debug RPMs) (8.2) as the repo is currently reserved by a running task.

手順

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

   [root@rhua ~]# rhui-manager

2. s を押して、synchronization status and scheduling を選択します。
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 8 for x86_64 - AppStream from RHUI (Debug RPMs) (8.2)
   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) (8.2)
   Proceed? (y/n)

検証

1. アクティブな同期タスクをキャンセルすると、この例と同様のメッセージが表示されます。

   Canceling active task for repo Red Hat Enterprise Linux 8 for x86_64 - AppStream from RHUI (Debug RPMs) (8.2) ...
   ... done

手順

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

   [root@rhua ~]# rhui-manager

2. s を押して、synchronization status and scheduling を選択します。
3. Synchronization Status 画面で cw を押し、cancel waiting sync tasks を選択します。

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

   Select one or more repositories for which you want to cancel their pending tasks.
     -    1: Single Sign-On 7.4 for RHEL 8 x86_64 (Source RPMs) from RHUI
   Enter value (1-1) to toggle selection, 'c' to confirm selections, or '?' for more commands: 1

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

   Select one or more repositories for which you want to cancel their pending tasks.
     x    1: Single Sign-On 7.4 for RHEL 8 x86_64 (Source RPMs) from RHUI
   Enter value (1-1) to toggle selection, 'c' to confirm selections, or '?' for more commands: c

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

   The pending tasks will be canceled for the following repositories:
     Single Sign-On 7.4 for RHEL 8 x86_64 (Source RPMs) from RHUI
   Proceed? (y/n) y

検証

1. キャンセルに成功した場合も同様のメッセージが表示されます。

   Canceling pending task for repo Single Sign-On 7.4 for RHEL 8 x86_64 (Source RPMs) from RHUI ...
   ... done

2. 保留中の同期タスクがない場合は、以下のメッセージが表示されます。

   There are no repositories with pending sync related tasks.

手順

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

   [root@rhua ~]# rhui-manager

2. s を押して、synchronization status and scheduling を選択します。

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: yum
   
        -  713:       AUTO Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.3)
        -  714:       AUTO Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.4)
        -  719:       AUTO Red Hat Enterprise Linux 8 for ARM 64 - AppStream (Source RPMs) from RHUI (8.3)
        -  720:       AUTO Red Hat Enterprise Linux 8 for ARM 64 - AppStream (Source RPMs) from RHUI (8.4)

4. 値 (1-1631) を入力すると選択が切り替わり、c 選択が確定し、さらにコマンドを入力する場合は ? を選択します。

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

5. c を押して選択を確認します。
6. y を押して続行します。

検証

1. 選択して確定したときにも同様のメッセージが表示されます。

   Scheduling a task to turn off auto-publish status of repository Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8)

手順

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

   [root@rhua ~]# rhui-manager

2. s を押して、synchronization status and scheduling を選択します。
3. Synchronization Status 画面から wf を押します。

4. 値 (1-1631) を入力すると選択が切り替わり、c 選択が確定し、さらにコマンドを入力する場合は ? を選択します。

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

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

検証

1. スケジューリングに成功した場合も同様のメッセージが表示されます。

   Scheduling a task for generating metadata version 0 for repo Red Hat Enterprise Linux 8 for ARM 64 - AppStream (RPMs) from RHUI (8.4) ...
     ... task scheduled.

手順

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

   [root@rhua ~]# rhui-manager

2. s を押して、synchronization status and scheduling を選択します。
3. Synchronization Status 画面から、ex を押します。
4. 値を入力すると、選択が切り替わります。

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

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

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

検証

1. リポジトリーがファイルシステムにエクスポートされている場合も、同様のメッセージが表示されます。

   [1/1] Exporting version 1 of the repo Red Hat Enterprise Linux 8 for ARM 64 - AppStream (Source RPMs) from RHUI (8).

手順

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

   [root@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 ~]# rhui-manager

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

3. Content Delivery Server (CDS) Management 画面で l を押して、Red Hat Update Infrastructure 4 が管理する既知の 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 ~]# 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. Enter a value or b to abort: 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. コードの出力を表示して、CDS が正常に再インストールおよび再設定されたことを確認します。

   Ensuring that instance ports are reachable ...
   Done.

手順

1. CDS ノードで、/etc/pki/rhui/legacy ディレクトリーがない場合は作成します。

   # mkdir /etc/pki/rhui/legacy

2. レガシー CA 証明書をディレクトリーに保存します。

手順

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 ~]# 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 ~]# 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 ~]# 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 ~]# 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. Enter a value or b to abort: 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. コードの出力を表示して、ロードバランサーが正常に再インストールおよび再設定されたことを確認します。

   Ensuring that HAProxy is available...
   Done.

手順

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

   [root@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. RHUI をインストールしたときにコンテナーサポートを有効にしなかった場合は、RHUA で次のコマンドを実行します。

   # rhui-installer --rerun --container-support-enabled True
   # rhui-manager --noninteractive cds reinstall --all

2. オプション: /etc/rhui/rhui-tools.conf ファイルを編集し、[container] セクションの次の行を削除して、RHUI 設定でコンテナーレジストリーの認証情報を設定します。

   RHUI 4.1.1 以降をクリーンインストールしている場合、最後の数行には、podman 固有のオプションと便利なコメントが含まれる [container] セクションが含まれます。以前のバージョンの RHUI から更新した場合、このセクションは etc/rhui/rhui-tools.conf.rpmnew ファイルの最後にあり、rhui-tools.conf ファイルにコピーできます。

   [container]
   …
   registry_username: your_RH_login
   registry_password: your_RH_password

   注記

   通常、registry.redhat.io とは異なるレジストリーから同期する場合は、それに応じて registry_url オプションと registry_auth オプションの値も変更します。

3. RHUA ノードで、rhui-manager を実行します。

   # rhui-manager

4. r を押して、Repository Management 画面にアクセスします。

   -= Red Hat Update Infrastructure Management Tool =-
   
   
   -= Repository Management =-
   
     l list repositories currently managed by the 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 the 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)
   
   Connected: rhua.example.com

5. ac を押して、新しい Red Hat コンテナーを追加します。

   rhui (repo) => ac Specify URL of registry [https://registry.redhat.io]:

6. 追加するコンテナーがデフォルト以外のレジストリーに存在する場合は、レジストリーの URL を入力します。デフォルトのレジストリーを使用するには、何も入力せずに Enter キーを押します。

7. レジストリーにコンテナーの名前を入力します。

   jboss-eap-6/eap64-openshift

8. コンテナーの一意の ID を入力します。

   rhui-manager は、スラッシュとドットをアンダースコアに置き換えることにより、コンテナーの名前をレジストリーから Pulp で使用できる形式に変換します。Enter キーを押すか、任意の名前を入力することで、このように変換された名前を使用できます。

9. コンテナーの表示名を入力します。

   jboss-eap-6_eap64-openshift

10. オプション: プロンプトが表示されたら、RHUI 設定でログインとパスワードを設定します。

11. 表示された概要を確認します。

    The following container will be added:
      Registry URL: http://registry.redhat.io
      Container Id: jboss-eap-6_eap64-openshift
      Display Name: jboss-eap-6_eap64-openshift
      Upstream Container Name: jboss-eap-6/eap64-openshift
    Proceed? (y/n)

12. y を押して続行し、コンテナーを追加します。

    y
    Successfully added container jboss-eap-6_eap64-openshift

手順

1. RHUA ノードで、rhui-manager を実行します。

   # rhui-manager

2. s を押して、synchronization status and scheduling 画面にアクセスします。
3. sr を押して、個々のリポジトリーを即時に同期します。
4. 同期するリポジトリーの数を入力します。
5. c を押して選択を確認します。

6. リポジトリーを確認し、y を押して同期するか、n を押してキャンセルします。

   The following repositories will be scheduled for synchronization: jboss-eap-6_eap64-openshift
   Proceed? (y/n) y
   Scheduling sync for jboss-eap-6_eap64-openshift...
   ... successfully scheduled for the next available timeslot.

手順

1. RHUA ノードで、rhui-manager を実行します。

   # rhui-manager

2. e を押して、entitlement certificates and client configuration RPMs 画面にアクセスします。
3. d を押して、create a container client configuration RPM (コンテナークライアント設定 RPM の作成) を実行します。

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

   /root/

5. RPM の名前を入力します。

   containertest

6. 設定 RPM のバージョン番号を入力します。デフォルトは 2.0 です。
7. 設定 RPM のリリース番号を入力します。デフォルトは 1 です。

8. 証明書が有効な日数を入力します。デフォルトは 365 です。

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

手順

1. RPM を RHUA ノードからローカルマシンに取得します。

   # scp root@rhua.example.com:/root/containertest-2.0/build/RPMS/noarch/containertest-2.0-1.noarch.rpm .

2. RPM をローカルマシンからクライアントに転送します。

   # scp containertest-2.0-1.noarch.rpm root@cli01.example.com:.

3. クライアントに切り替え、RPM をインストールします。

   [root@cli01 ~]# yum install containertest-2.0-1.noarch.rpm

手順

1. podman pull コマンドを実行します。

   [root@cli01 ~]# podman pull jboss-eap-6_eap64-openshift
   
   Resolving "jboss-eap-6_eap64-openshift" using unqualified-search registries (/etc/containers/registries.conf)
   Trying to pull cds.example.com/jboss-eap-6_eap64-openshift:latest...
   Getting image source signatures
   Copying blob b0e0b761a531 done
   Copying blob aa23ac04e287 done
   Copying blob 0d30ea1353f9 done
   Copying config 3d0728c907 done
   Writing manifest to image destination
   Storing signatures
   3d0728c907d55d9faedc4d19de003f21e2a1ebdf3533b3d670a4e2f77c6b35d2

2. podman pull コマンドが失敗した場合は、rhui-manager のステータスを確認します。同期がまだ実行されていない可能性があり、同期するまで待機する必要があります。

   Resolving "jboss-eap-6_eap64-openshift" using unqualified-search registries (/etc/containers/registries.conf)
   Trying to pull cds.example.com/jboss-eap-6_eap64-openshift:latest...
   Error: initializing source docker://cds.example.com/jboss-eap-6_eap64-openshift:latest: reading manifest latest in cds.example.com/jboss-eap-6_eap64-openshift: manifest unknown: Manifest not found.

手順

1. pulp-server サービスを停止します。

   # systemctl stop pulpcore-api pulpcore-content pulpcore-worker\*

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

   # systemctl status pulpcore-api pulpcore-content pulpcore-worker\*

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

   # cp -a <source_files_path> <destination_files_path>

   重要

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

   ファイルのリスト:

   • /etc/pki/rhui/*
   • /etc/pulp/*
   • /etc/rhui/*
   • /etc/rhui/rhui-tools.conf
   • /etc/nginx/*
   • /root/.rhui/*
   • /var/log/rhui/*
   • /var/log/rhui-subscription-sync.log*

   • オプション: /var/lib/rhui/*

     注記

     このディレクトリーをバックアップすると、ダウンロードされたすべてのコンテンツがバックアップされるため、データ量が多くなる可能性があります。

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

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

   # rhui-services-restart

手順

1. postgres ユーザーに変更します。

   # su - postgres

2. PostgreSQL データベースをダンプします。

   # pg_dump -j 4 -F d -f <pg_dump_directory> pulp

手順

1. 新しい RHUA ノードを作成します。詳細は、RHUA ノードの設定 を参照してください。

2. pulp-server サービスを停止します。

   # systemctl stop pulpcore-api pulpcore-content pulpcore-worker\*

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

   # systemctl status pulpcore-api pulpcore-content pulpcore-worker\*

4. 以下のファイルを復元します。

   # cp -a <source_files_path> <destination_files_path>

   重要

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

   ファイルのリスト:

   • /etc/pki/rhui/*
   • /etc/pulp/*
   • /etc/rhui/*
   • /etc/rhui/rhui-tools.conf
   • /etc/nginx/*
   • /root/.rhui/*
   • /var/log/rhui/*
   • /var/log/rhui-subscription-sync.log*

   • オプション: /var/lib/rhui/*

     注記

     このディレクトリーを復元すると、ダウンロードされたすべてのコンテンツが復元されるため、データ量が多くなる可能性があります。

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

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

   # rhui-services-restart

手順

1. postgres ユーザーに変更します。

   # su - postgres

2. PostgreSQL データベースを復元します。

   # pg_restore -j 4 -F d -d pulp <pg_dump_directory>

手順

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. 新しい CDS ノードを作成します。詳細は、CDS ノードの設定 を参照してください。

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

   # systemctl stop nginx

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

   # systemctl status nginx

4. 以下のファイルを復元します。

   # cp -a <source_files_path> <destination_files_path>

   重要

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

   ファイルのリスト:

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

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

   # rhui-services-restart

手順

1. /etc/haproxy/haproxy.cfg ファイルをバックアップします。

   # cp -a <source_files_path> <destination_files_path>

   重要

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

手順

1. 新しい HAProxy ノードを作成します。詳細は、HAProxy ノードの設定 を参照してください。

2. /etc/haproxy/haproxy.cfg ファイルを復元します。

   # cp -a <source_files_path> <destination_files_path>

   重要

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