1. 既存の Satellite Server をクローンします。詳細は、2章Satellite Server のクローン を参照してください。
2. Satellite Server と全 Capsule Server を Satellite 6.9 にアップグレードします。詳しくは、「Satellite Server のアップグレード」をご覧ください。
3. すべての Satellite クライアントで、Satellite Tools 6.9 にアップグレードします。詳しくは、「Satellite クライアントのアップグレード」をご覧ください。

1. 長期にわたる停止期間ではなく、停止期間を短期で複数回にする場合。
2. 組織内の Capsule が複数のチームで管理されており、別のロケーションに配置されている場合。
3. 負荷分散設定を使用する場合に、負荷分散されている Capsule をアップグレードして、残りの負荷分散型 Capsule を 1 つ前のバージョンにしておくことができます。こうすることで、サービスを停止せずに全 Capsule を順番にアップグレードできます。

1. ソースサーバーをバックアップします。
2. ソースサーバーからターゲットサーバーにクローンを作成します。
3. ソースサーバーの電源を切断します。
4. 新規ホスト名とターゲットサーバーの IP アドレスが一致するように、ターゲットサーバー上のネットワーク設定を更新します。
5. コンテンツホストと Capsule で goferd を再起動して、接続をリフレッシュします。
6. 新規ターゲットサーバーをテストします。

1. MongoDB と PostgreSQL の両データベースをアクティブにし、Pulp データは除外してバックアップを実行します。

   # satellite-maintain backup offline --skip-pulp-content \
   --assumeyes /var/backup

2. satellite-maintain サービスを停止して、無効にします。

   # satellite-maintain service stop
   # satellite-maintain service disable

3. Pulp データをターゲットサーバーにコピーします。

   # rsync --archive --partial --progress --compress \
   /var/lib/pulp target_server.example.com:/var/lib/pulp

手順

1. Satellite Web UI で、コンテンツ > Red Hat リポジトリー に移動します。
2. 推奨のリポジトリー を、オン の位置に切り替えます。

3. 結果の一覧から、以下のリポジトリーを展開して、有効化 アイコンをクリックして、リポジトリーを有効にします。

   • Satellite クライアントをアップグレードするには、クライアントが使用するすべての Red Hat Enterprise Linux バージョンで Red Hat Satellite Tools 6.9 リポジトリーを有効にします。

   • Capsule Server を使用している場合に、Capsule Server をアップグレードするには、以下のリポジトリーも有効にします。

     Red Hat Satellite Capsule 6.9 (RHEL 7 Server 用) (RPM)

     Red Hat Satellite Maintenance 6 (RHEL 7 Server 用) (RPM)

     Red Hat Ansible Engine 2.9 RPMs for Red Hat Enterprise Linux 7 Server

     Red Hat Software Collections RPMs for Red Hat Enterprise Linux 7 Server

   注記

   バージョン 6.9 のリポジトリーが利用できない場合には、サブスクリプションマニフェストをリフレッシュします。コンテンツ > サブスクリプション に移動して マニフェストの管理 をクリックし、リフレッシュ をクリックしてください。

4. コンテンツ > 同期ステータス に移動します。
5. 製品の横にある矢印をクリックして、利用可能なリポジトリーを表示します。
6. 6.9 のリポジトリーを選択します。

7. 今すぐ同期 をクリックします。

   重要

   リポジトリーを同期しようとするとエラーが発生する場合に、マニフェストをリフレッシュしてください。問題が継続する場合には、サポート依頼を起票してください。カスタマーポータルまたは Satellite Web UI からマニフェストを削除しないでください。削除してしまうと、コンテンツホストのエンタイトルメントがすべて削除されてしまいます。

8. コンテンツビューを使用して Capsule Server のベースオペレーティングシステムへの更新を制御する場合、それらのコンテンツビューを新しいリポジトリーで更新し、更新済みのバージョンを公開して、プロモートします。詳しい情報は、コンテンツ管理ガイドの コンテンツビューの管理 を参照してください。

Capsule Server のアップグレード

1. バックアップを作成します。

   • 仮想マシンで、スナップショットを作成します。

   • 物理マシンで、バックアップを作成します。

     バックアップに関する詳細は、Red Hat Satellite 6.9 の管理ガイドの Satellite Server および Capsule Server のバックアップ を参照してください。

2. オプション: /etc/zones.conf または /etc/dhcp/dhcpd.conf ファイルで DNS または DHCP の設定を手動で編集した場合には、設定ファイルをバックアップしてください。インストーラーはドメインまたはサブネット 1 つしかサポートしないので、このバックアップから変更を復元する必要がある場合があります。

3. オプション: DNS または DHCP の設定ファイルを手動で編集し、変更を上書きしない場合は、以下のコマンドを実行します。

   # satellite-installer --foreman-proxy-dns-managed=false \
   --foreman-proxy-dhcp-managed=false

4. Satellite Web UI で、ホスト > 検出されたホスト に移動します。検出されたホストがある場合は、そのホストの電源を切り、検出されたホスト ページに表示されているすべてのエントリーを削除します。必要に応じて、組織設定メニューから、その他の組織を順番に選択し、すべてのエントリーを削除します。アップグレードが完了したら、検出されたホストを再起動します。

5. yum のキャッシュを消去します。

   # yum clean all

6. satellite-maintain が含まれる rubygem-foreman_maintain パッケージがインストールされており、最新の状態になっていることを確認します。

   # yum install rubygem-foreman_maintain

7. gofer パッケージを更新します。

   # satellite-maintain packages update gofer

8. goferd サービスを再起動します。

   # systemctl restart goferd

9. Capsule Server で foreman_url 設定が Satellite FQDN を参照していることを確認します。

   # grep foreman_url /etc/foreman-proxy/settings.yml

10. 利用可能なバージョンを確認して、希望のバージョンが表示されていることを確認します。

    # satellite-maintain upgrade list-versions

11. アップグレード時間は長くなるため、通信セッションの中断と再接続を可能にする screen などのユーティリティーを使用します。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。screen コマンドの使用方法は、Red Hat ナレッジベース の How do I use the screen command? を参照してください。

    アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、/var/log/foreman-installer/satellite.log ファイルのログメッセージで、プロセスが完全に終了したかどうかを確認できます。

12. ヘルスチェックオプションを使用して、システムがアップグレードの準備ができているかどうかを確認します。

    # satellite-maintain upgrade check --target-version 6.9

    結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。

13. アップグレードを実行します。

    # satellite-maintain upgrade run --target-version 6.9

    警告

    config サブディレクトリーを含むディレクトリーからコマンドを実行すると、以下のエラーが発生します。

    ERROR: Scenario (config/capsule.yaml) was not found, can not continue.

    このような場合は、root ユーザーのホームディレクトリーに移動し、コマンドを再実行します。

14. カーネルパッケージが最後に更新された日時を確認します。

    # rpm -qa --last | grep kernel

15. オプション: 最後の再起動以降にカーネルが更新された場合には、satellite-maintain サービスを停止して、システムを再起動します。

    # satellite-maintain service stop
    # reboot

16. 作成しておいたバックアップを使用して、DNS と DHCP の設定ファイルに必要なすべての変更を確認し、復元します。
17. オプション: カスタムリポジトリーを使用する場合は、アップグレードの完了後に、これらのカスタムリポジトリーを有効化することを確認してください。

18. オプション: Capsule Server を検出ホストのプロキシーとして使用する予定の場合には、Discovery プラグインをインストールして、アップロード前にシャットダウンしたホストの電源をオンにします。

    # satellite-maintain packages install tfm-rubygem-smart_proxy_discovery.noarch

Satellite Web UI のリモート実行を使用した Capsule Server のアップグレード

1. バックアップを作成します。

   • 仮想マシンで、スナップショットを作成します。

   • 物理マシンで、バックアップを作成します。

     バックアップに関する詳細は、Red Hat Satellite 6.9 の管理ガイドの Satellite Server および Capsule Server のバックアップ を参照してください。

2. オプション: /etc/zones.conf または /etc/dhcp/dhcpd.conf ファイルで DNS または DHCP の設定を手動で編集した場合には、設定ファイルをバックアップしてください。インストーラーはドメインまたはサブネット 1 つしかサポートしないので、このバックアップから変更を復元する必要がある場合があります。

3. オプション: DNS または DHCP の設定ファイルを手動で編集し、変更を上書きしない場合は、以下のコマンドを実行します。

   # satellite-installer --foreman-proxy-dns-managed=false \
   --foreman-proxy-dhcp-managed=false

4. Satellite Web UI で、Monitor > Jobs に移動します。
5. Run Job をクリックします。
6. Job category リストから Maintenance Operations を選択します。
7. Job template リストから Capsule Upgrade Playbook を選択します。
8. Search Query フィールドに Capsule のホスト名を入力します。
9. Resolves to で 1 host が表示されていることを確認します。
10. target_version フィールドに、Capsule のターゲットバージョンを入力します。
11. whitelist_options フィールドに、許可リストオプションを入力します。
12. Type of query には、クエリーの種類に合わせて Static Query または Dynamic Query をクリックします。
13. Schedule でジョブ実行のスケジュールを選択します。

一括リポジトリー設定 UI を使用した Satellite クライアントのアップグレード

1. Satellite Web UI で、ホスト > コンテンツホスト に移動し、アップグレードするコンテンツホストを選択します。
2. アクションの選択 一覧から リポジトリーセットの管理 を選択します。
3. リポジトリーセットの管理 の一覧から、Red Hat Satellite Tools 6.8 のチェックボックスを選択します。
4. アクションの選択 一覧から Override to Disabled (無効に上書き) を選択し、Done (完了) をクリックします。
5. プロセスが完了したら、以前の手順で使用した同じホストセットの アクションの選択 一覧から、リポジトリーセットの管理 を選択します。
6. リポジトリーセットの管理 一覧から、Red Hat Satellite Tools 6.9 のチェックボックスを選択します。
7. アクションの選択 一覧から Override to Enabled (有効に上書き) を選択し、Done (完了) をクリックします。
8. プロセスが完了したら、以前の手順で使用した同じホストセットの アクションの選択 リストから、パッケージの管理 を選択します。

9. パッケージ 検索フィールドに、設定に応じて以下のいずれかのオプションを入力します。

   • お使いのデプロイメントで katello-agent および goferd を使用する場合は、katello-agent と入力します。
   • お使いのデプロイメントで katello-agent および goferd を使用しない場合は、katello-host-tools と入力します。
10. 更新 一覧 から リモート実行経由 を選択します。Katello エージェントを使用してパッケージを更新すると、これによりクライアントと Satellite または Capsule Server 間の通信が中断され、更新が失敗することから、リモート実行経由の選択が必要です。詳細は、ホストの管理ガイドの ホストでのリモートジョブの実行 を参照してください。

Satellite クライアントの手動アップグレード

1. クライアントシステムにログインします。

2. 以前のバージョンの Satellite のリポジトリーを無効にします。

   # subscription-manager repos \
   --disable rhel-7-server-satellite-tools-6.8-rpms

3. このバージョンの Satellite 向け Satellite Tools 6.9 リポジトリーを有効にします。

   # subscription-manager repos \
   --enable=rhel-7-server-satellite-tools-6.9-rpms

4. お使いの設定に応じて、以下のいずれかの手順を実行します。

   • お使いのデプロイメントで katello-agent および goferd を使用する場合は、以下のコマンドを入力して katello-agent をインストールまたはアップグレードします。

     # yum install katello-agent

   • お使いのデプロイメントで katello-agent および goferd を使用しない場合は、以下のコマンドを入力して katello-host-tools をインストールまたはアップグレードします。

     # yum install katello-host-tools

virt-who の手動アップグレード

1. virt-who をアップグレードします。

   # yum upgrade virt-who

2. virt-who サービスを再起動して、新しいバージョンを有効にします。

   # systemctl restart virt-who.service

1. Satellite Web UI で、コンテンツ > Red Hat サブスクリプション に移動します。
2. 有効されたリポジトリー エリアで、Red Hat Satellite Tools 6.8 for RHEL 7 Server RPMs x86_64 を探し出します。
3. 右側の 無効化 アイコンをクリックします。

手順

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

   # satellite-maintain service stop --only \
   pulp_celerybeat.service,pulp_resource_manager.service,pulp_streamer.service,pulp_workers.service,httpd

2. MongoDB シェルにアクセスします。

   # mongo pulp_database

3. 修復前の MongoDB のディスク領域の使用量を確認します。

   > db.stats()

4. 現在の MongoDB データベースに 2 GB を足したサイズに相当する空のディスク領域があることを確認します。MongoDB データベースを含むボリュームに十分な領域がない場合、別のボリュームをマウントし、これを修復に使用することができます。

5. 修復コマンドを入力します。データベースのサイズによっては、修復コマンドは、その他すべての操作をブロックし、完了までに時間がかかる場合があることに注意してください。

   > db.repairDatabase()

6. 修復後の MongoDB のディスク領域の使用量を確認します。

   > db.stats()

7. MongoDB シェルを終了します。

   > exit

8. Pulp サービスを開始します。

   # satellite-maintain service start

手順

1. postgresql サービス以外の全サービスを停止します。

   # satellite-maintain service stop --exclude postgresql

2. postgres ユーザーに切り替えてデータベースの領域を確保します。

   # su - postgres -c 'vacuumdb --full --dbname=foreman'

3. Vacuum が完了したら、他のサービスを開始します。

   # satellite-maintain service start

1. /usr/share/foreman-installer/config/foreman.hiera/tuning/common.yaml ファイルで定義したデフォルトの tuning プロファイル
2. /usr/share/foreman-installer/config/foreman.hiera/tuning/sizes/ ディレクトリーで定義され、デプロイメントに適用する tuning プロファイル
3. オプション: /etc/foreman-installer/custom-hiera.yaml ファイルを設定した場合、Satellite はこれらの設定を適用します。

1. オプション: Satellite Server で、custom-hiera.yaml ファイルを設定した場合、/etc/foreman-installer/custom-hiera.yaml ファイルを custom-hiera.original にバックアップします。/etc/foreman-installer/custom-hiera.yaml ファイルが破損した場合には、バックアップファイルを使用して、ファイルを元の状態に戻します。

   # cp /etc/foreman-installer/custom-hiera.yaml \
   /etc/foreman-installer/custom-hiera.original

2. オプション: Satellite Server で custom-hiera.yaml ファイルを設定した場合、/usr/share/foreman-installer/config/foreman.hiera/tuning/common.yaml のデフォルト tuning プロファイルの定義と、/usr/share/foreman-installer/config/foreman.hiera/tuning/sizes/ に適用する tuning プロファイルを確認します。/etc/foreman-installer/custom-hiera.yaml ファイルの設定内容と比較して、/etc/foreman-installer/custom-hiera.yaml ファイルで重複設定を削除します。

3. 適用するプロファイルに対して、--tuning オプションを指定して satellite-installer コマンドを入力します。たとえば、medium tuning プロファイル設定を適用するには、以下のコマンドを入力します。

   # satellite-installer --tuning medium

前提条件

1. Satellite を Red Hat カスタマーポータルに登録している。

手順

1. オプション: Satellite Server から Red Hat Insights の登録を解除するには、以下のコマンドを入力します。

   # insights-client --unregister

2. オプション: Satellite Server を Red Hat Insights に登録するには、以下のコマンドを入力します。

   # satellite-installer --register-with-insights

Satellite Server の更新手順:

1. Satellite Maintenance リポジトリーが有効になっているのを確認します。

   # subscription-manager repos --enable \
   rhel-7-server-satellite-maintenance-6-rpms

2. 利用可能なバージョンを確認して、次のマイナーバージョンが一覧に追加されているのを確認します。

   # satellite-maintain upgrade list-versions

3. ヘルスチェックオプションを使用して、システムをアップグレードする準備が完了しているかどうかを確認します。このコマンドを最初に使用したときに、satellite-maintain により hammer 管理者ユーザー認証情報を入力して、/etc/foreman-maintain/foreman-maintain-hammer.yml ファイルに保存します。

   # satellite-maintain upgrade check --target-version 6.9.z

   結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。

4. 更新時間は長くなるため、通信セッションの中断と再接続を可能にする screen などのユーティリティーを使用します。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。screen コマンドの使用方法は、Red Hat ナレッジベース の How do I use the screen command? を参照してください。

   アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、/var/log/foreman-installer/satellite.log ファイルのログメッセージで、プロセスが完全に終了したかどうかを確認できます。

5. アップグレードを実行します。

   # satellite-maintain upgrade run --target-version 6.9.z

6. カーネルパッケージが最後に更新された日時を確認します。

   # rpm -qa --last | grep kernel

7. オプション: 最後の再起動以降にカーネルが更新された場合には、satellite-maintain サービスを停止して、システムを再起動します。

   # satellite-maintain service stop
   # reboot

切断された Satellite Server の次のマイナーバージョンへの更新

1. 次のように新しい設定ファイルを作成します。

   # vi /etc/yum.repos.d/redhat-local.repo
   
   [rhel-7-server-ansible-2.9-rpms]
   name=Ansible 2.9 RPMs for Red Hat Enterprise Linux 7 Server x86_64
   baseurl=file:///var/lib/pulp/published/yum/https/repos/Default_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/ansible/2.9/os/
   enabled=1
   
   [rhel-7-server-rpms]
   name=Red Hat Enterprise Linux 7 Server RPMs x86_64
   baseurl=file:///var/lib/pulp/published/yum/https/repos/Default_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/os/
   enabled=1
   
   [rhel-7-server-satellite-6.9-rpms]
   name=Red Hat Satellite 6 for RHEL 7 Server RPMs x86_64
   baseurl=file:///var/lib/pulp/published/yum/https/repos/Default_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/satellite/6.9/os/
   enabled=1
   
   [rhel-7-server-satellite-maintenance-6-rpms]
   name=Red Hat Satellite Maintenance 6 for RHEL 7 Server RPMs x86_64
   baseurl=file:///var/lib/pulp/published/yum/https/repos/Default_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/sat-maintenance/6/os/
   enabled=1
   
   [rhel-server-rhscl-7-rpms]
   name=Red Hat Software Collections RPMs for Red Hat Enterprise Linux 7 Server x86_64
   baseurl=file:///var/lib/pulp/published/yum/https/repos/Default_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/rhscl/1/os/
   enabled=1

2. 設定ファイルで baseurl の Default_Organization は適切あ組織ラベルに置き換えます。組織ラベルを取得するにはコマンドを入力します。

   # ls /var/lib/pulp/published/yum/https/repos/

3. satellite-maintain が含まれる rubygem-foreman_maintain パッケージがインストールされており、最新の状態になっていることを確認します。

   # yum install rubygem-foreman_maintain

4. 利用可能なバージョンを確認して、次のマイナーバージョンが一覧に追加されているのを確認します。

   # satellite-maintain upgrade list-versions

5. ヘルスチェックオプションを使用して、システムをアップグレードする準備が完了しているかどうかを確認します。このコマンドを最初に使用したときに、satellite-maintain により hammer 管理者ユーザー認証情報を入力して、/etc/foreman-maintain/foreman-maintain-hammer.yml ファイルに保存します。

   # satellite-maintain upgrade check --target-version 6.9.z

   結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。

6. 更新時間は長くなるため、通信セッションの中断と再接続を可能にする screen などのユーティリティーを使用します。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。screen コマンドの使用方法は、Red Hat ナレッジベース の How do I use the screen command? を参照してください。

   アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、/var/log/foreman-installer/satellite.log ファイルのログメッセージで、プロセスが完全に終了したかどうかを確認できます。

7. アップグレードを実行します。

   # satellite-maintain upgrade run --target-version 6.9.z

8. カーネルパッケージが最後に更新された日時を確認します。

   # rpm -qa --last | grep kernel

9. オプション: 最後の再起動以降にカーネルが更新された場合には、satellite-maintain サービスを停止して、システムを再起動します。

   # satellite-maintain service stop
   # reboot

手順

1. gofer パッケージを更新します。

   # satellite-maintain packages install gofer

2. goferd サービスを再起動します。

   # systemctl restart goferd

3. Satellite Maintenance リポジトリーが有効になっていることを確認します。

   # subscription-manager repos --enable \
   rhel-7-server-satellite-maintenance-6-rpms

4. 利用可能なバージョンを確認して、次のマイナーバージョンが一覧に追加されているのを確認します。

   # satellite-maintain upgrade list-versions

5. ヘルスチェックオプションを使用して、システムがアップグレードの準備ができているかどうかを確認します。

   # satellite-maintain upgrade check --target-version 6.9.z

   結果を確認し、アップグレードを実行する前に、強調表示されているエラー状態に対応します。

6. 更新時間は長くなるため、通信セッションの中断と再接続を可能にする screen などのユーティリティーを使用します。これにより、コマンドシェルに接続し続けなくてもアップグレードの進捗が確認できるようになります。screen コマンドの使用方法は、Red Hat ナレッジベース の How do I use the screen command? を参照してください。

   アップグレードコマンドを実行しているコマンドシェルへの接続がなくなった場合は、/var/log/foreman-installer/satellite.log ファイルのログメッセージで、プロセスが完全に終了したかどうかを確認できます。

7. アップグレードを実行します。

   # satellite-maintain upgrade run --target-version 6.9.z

8. カーネルパッケージが最後に更新された日時を確認します。

   # rpm -qa --last | grep kernel

9. オプション: 最後の再起動以降にカーネルが更新された場合には、satellite-maintain サービスを停止して、システムを再起動します。

   # satellite-maintain service stop
   # reboot

コンテンツホストを更新するには、以下コマンドを入力します。

1. gofer パッケージを更新します。

   # yum update gofer

2. goferd を再起動します。

   # systemctl restart goferd

3. すべてのパッケージを更新します。

   # yum update

4. オプション: カーネルを更新してから再起動していない場合には、システムを再起動します。

   # reboot