第6章 Satellite Server と Capsule Server のアップグレード

Satellite Server のアップグレード

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

   • 仮想マシンで、スナップショットを取得します。
   • 物理マシンで、バックアップを作成します。

2. アップグレード前スクリプトは競合を検出し、アップグレード後に登録解除および削除できる Satellite Server の重複エントリーがあるホストをリストできます。また、組織に割り当てられていないホストを検出します。Hosts > All hosts を選択して組織の関連付けがないホストがリストされ、同じ名前のコンテンツホストに組織がすでに関連付けられている場合、コンテンツホストは自動的に登録解除されます。これは、アップグレード前にこのようなホストを組織に関連付けることによって回避できます。

   アップグレードの前に、アップグレード前チェックスクリプトを実行して、削除できるホストのリストを取得します。関連付けられていないホストが検出された場合は、アップグレードの前に組織にそれらのホストを関連付けることが推奨されます。

   1. アップグレード前スクリプトを使用するには、ruby193-rubygem-katello-2.2.0.90-1-sat 以降が必要です。

      # yum update ruby193-rubygem-katello

      Copy to Clipboard

   2. アップグレードの前に、アップグレード前チェックスクリプトを実行して、削除できるホストのリストを取得します。関連付けられていないホストが検出された場合は、アップグレードの前に組織にそれらのホストを関連付けることが推奨されます。

      # foreman-rake katello:upgrade_check

      Copy to Clipboard

      アップグレードチェックで、タスクが実行中であることが原因の障害が報告された場合は、タスクが完了するまで待機することが推奨されます。一部のタスクはキャンセルすることができますが、Red Hat ナレッジベースソリューション How to manage paused tasks on Red Hat Satellite 6 のアドバイスに従って、安全にキャンセルできるタスクと安全にキャンセルできなタスクについて理解する必要があります。

3. DNS と DHCP の設定ファイルである /etc/zones.conf と /etc/dhcp/dhcpd.conf をバックアップします。インストーラーでは 1 つのドメインまたはサブネットしかサポートされないため、これらのバックアップから変更を復元する必要がある場合があります。

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

   # katello-installer --capsule-dns-managed=false --capsule-dhcp-managed=false

   Copy to Clipboard

5. Red Hat Satellite 6.1 向けリポジトリーを無効にします。

   • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを実行します。

     # subscription-manager repos --disable rhel-6-server-satellite-6.1-rpms

     Copy to Clipboard

   • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを実行します。

     # subscription-manager repos --disable rhel-7-server-satellite-6.1-rpms

     Copy to Clipboard

6. 必要な場合は、Satellite 6.1 リポジトリーが無効であることを確認するために、以下のようなコマンドを入力します。

   # subscription-manager repos --list-enabled

   Copy to Clipboard

7. Red Hat Satellite 6.2 向けリポジトリーを有効にします。

   • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを実行します。

     # subscription-manager repos --enable=rhel-6-server-rpms \
     --enable=rhel-server-rhscl-6-rpms \
     --enable=rhel-6-server-satellite-6.2-rpms

     Copy to Clipboard

   • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを実行します。

     # subscription-manager repos --enable=rhel-7-server-rpms \
     --enable=rhel-server-rhscl-7-rpms \
     --enable=rhel-7-server-satellite-6.2-rpms

     Copy to Clipboard

8. Red Hat 以外の yum リポジトリーから残されたすべてのメタデータを消去します。

   # yum clean all

   Copy to Clipboard

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

   # yum repolist enabled

   Copy to Clipboard

   以下のような出力が表示されます。

   Loaded plugins: product-id, subscription-manager
   repo id                                        repo name                                                                   status
   !rhel-7-server-rpms/x86_64                     Red Hat Enterprise Linux 7 Server (RPMs)                                    9,889
   !rhel-7-server-satellite-6.2-rpms/x86_64       Red Hat Satellite 6.2 (for RHEL 7 Server) (RPMs)                            545
   !rhel-server-rhscl-7-rpms/x86_64               Red Hat Software Collections RPMs for Red Hat Enterprise Linux 7 Server     4,279
   repolist: 14,713

   Copy to Clipboard
10. Satellite Web UI で、Hosts (ホスト) > Discovered hosts (検出されたホスト) に移動します。検出されたホストが利用可能な場合は、それらを無効にし、Discovered hosts (検出されたホスト) ページ下のすべてのエントリーを削除します。組織設定メニューを使用して他のすべての組織を順番に選択し、必要に応じてこのアクションを繰り返します。アップグレードが完了したら、これらのホストを再起動します。
11. すべての外部 Capsule Server が組織に割り当てられていることを確認します。割り当てられていない場合、これらのサーバーは、ホスト統合の変更により登録解除された可能性があります。

12. Satellite Web UI でリポジトリーを設定します。

    1. Satellite Web UI で、Content > Red Hat Repositories に移動し、RPM タブを選択します。
    2. Red Hat Enterprise Linux Server 製品 を見つけ、展開します。
    3. Red Hat Satellite Tools 6.2 (RHEL X Server 用) (RPM) を見つけ展開します。
    4. RHEL X Server RPMs x86_64 用 Red Hat Satellite Tools 6.2 を選択します。

13. 新しく有効になったリポジトリーを同期します。

    1. Satellite Web UI で、Content (コンテンツ) > Sync Status (同意ステータス) に移動します。
    2. 製品の横にある矢印をクリックして利用可能なリポジトリーを表示します。
    3. 6.2 用リポジトリーを選択します。

    4. Synchronize Now をクリックします。

       Satellite Tools リポジトリーを更新しようとするときにエラーが発生した場合は、カスタマーポータルまたは Satellite Web UI でマニフェストを削除しないでください。削除すると、すべてのコンテンツホストが登録解除されます。詳細については、Red Hat ナレッジベースソリューション「Cannot enable Red Hat Satellite Tools Repo on Satellite 6.2」を参照してください。

14. 6.1 バージョンリポジトリーを使用する既存のコンテンツビューを 6.2 向けの新しいバージョンで更新します。新しい 6.2 バージョンリポジトリーがあるコンテンツビューの更新されたバージョンを公開し、プロモートします。

15. リポジトリーキャッシュを削除します。

    # yum clean all

    Copy to Clipboard

16. アップグレードチェックを再び実行して、すでに行った手順により、アップグレード中にタスクが停止する状況になっていないことを確認します。

    # foreman-rake katello:upgrade_check

    Copy to Clipboard

17. Katello サービスを停止します。

    # katello-service stop

    Copy to Clipboard

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

    # yum update

    Copy to Clipboard

19. カスタム Apache サーバー設定がある場合は、次の手順でインストールデフォルト値に戻ります。アップグレードの実行時に変更される内容を確認する場合は、--noop (no operation) オプションとともにアップグレードコマンドを入力し、次の手順でアップグレードコマンドを入力するときに適用される変更内容を確認できます。このテストを行わない場合は、次の手順に進みます。または、以下のように手順を続行します。

    1. 次の行を /etc/httpd/conf/httpd.conf 設定ファイルに追加します。

       Include /etc/httpd/conf.modules.d/*.conf

       Copy to Clipboard

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

       • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを入力します。

         # service httpd restart

         Copy to Clipboard

       • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。

         # systemctl restart httpd

         Copy to Clipboard

    3. postgresql データベースサービスおよび mongod データベースサービスを起動します。

       • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを入力します。

         # service postgresql start
         # service mongod start

         Copy to Clipboard

       • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。

         # systemctl start postgresql
         # systemctl start mongod

         Copy to Clipboard

    4. 以下のように --noop オプションとともにコマンドを入力します。

       # satellite-installer --scenario satellite --upgrade --verbose --noop

       Copy to Clipboard

       /var/log/foreman-installer/satellite.log を参照して、--noop オプションが省略された場合に適用される変更を確認します。設定ファイルの変更を示す +++ と --- の記号を探します。上記の "no operation" コマンドにより実際にはファイルは作成されず、モジュール内の一部の Puppet リソースではファイルがそこに存在することが期待されるため、いくつかのエラーメッセージが表示されるはずです。

    5. Katello サービスを停止します。

       # katello-service stop

       Copy to Clipboard

20. --upgrade オプションを使用してインストーラースクリプトを実行することによりアップグレードを実行します。

    # satellite-installer --scenario satellite --upgrade

    Copy to Clipboard
    警告

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

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

    Copy to Clipboard

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

21. これまでに行ったバックアップを使用して DNS と DHCP の設定ファイルに必要なすべての変更を確認し、復元します。

22. 前の手順で変更を行った場合は、Katello サービスを再起動します。

    # katello-service restart

    Copy to Clipboard

23. Satellite Web UI で Discovery テンプレートを更新します。

    1. Hosts (ホスト) > Provisioning templates (テンプレートのプロビジョニング) に移動します。
    2. PXELinux global default (PXELinux グローバルデフォルト) を選択します。

    3. Template editor (テンプレートエディター) ダイアログボックスで、以下のテキストに一致するよう LABEL discovery で始まるスタンザを更新することにより PXELinux global default (PXELinux グローバルデフォルト) テンプレート検出メニューエントリーを編集します。

       LABEL discovery
       MENU LABEL Satellite 6 Discovery
       MENU DEFAULT
       KERNEL boot/fdi-image-rhel_7-vmlinuz
       APPEND initrd=boot/fdi-image-rhel_7-img rootflags=loop root=live:/fdi.iso rootfstype=auto ro rd.live.image acpi=force rd.luks=0 rd.md=0 rd.dm=0 rd.lvm=0 rd.bootif=0 rd.neednet=0 nomodeset proxy.url=https://SATELLITE_CAPSULE_URL:9090 proxy.type=proxy
       IPAPPEND 2

       Copy to Clipboard
       • proxy.type オプションは proxy または foreman のいずれかになります。proxy の場合は、すべての通信が Capsule 経由で行われます。foreman の場合は、通信が直接 Satellite Server に行われます。
       • proxy.url には、Satellite Capsule または Server の URL を指定します。HTTP と HTTPS の両方のプロトコルがサポートされます。

24. OpenSCAP プラグインがインストールされており、デフォルトの OpenSCAP コンテンツが利用可能でない場合は、以下のコマンドを実行します。

    # foreman-rake foreman_openscap:bulk_upload:default

    Copy to Clipboard
25. Satellite Web UI で Configure (設定) > Discovery Rules (検出ルール) に移動し、選択された組織および場所を検出ルールに関連付けます。

切断された Satellite Server のアップグレード

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

   • 仮想マシンで、スナップショットを取得します。
   • 物理マシンで、バックアップを作成します。

2. アップグレード前スクリプトは競合を検出し、アップグレード後に登録解除および削除できる Satellite Server の重複エントリーがあるホストをリストできます。また、組織に割り当てられていないホストを検出します。Hosts > All hosts を選択して組織の関連付けがないホストがリストされ、同じ名前のコンテンツホストに組織がすでに関連付けられている場合、コンテンツホストは自動的に登録解除されます。これは、アップグレード前にこのようなホストを組織に関連付けることによって回避できます。

   アップグレードの前に、アップグレード前チェックスクリプトを実行して、削除できるホストのリストを取得します。関連付けられていないホストが検出された場合は、アップグレードの前に組織にそれらのホストを関連付けることが推奨されます。

   1. アップグレード前スクリプトを使用するには、ruby193-rubygem-katello-2.2.0.90-1-sat 以降が必要です。

      # yum update ruby193-rubygem-katello

      Copy to Clipboard

   2. アップグレードの前に、アップグレード前チェックスクリプトを実行して、削除できるホストのリストを取得します。関連付けられていないホストが検出された場合は、アップグレードの前に組織にそれらのホストを関連付けることが推奨されます。

      # foreman-rake katello:upgrade_check

      Copy to Clipboard

      アップグレードチェックで、タスクが実行中であることが原因の障害が報告された場合は、タスクが完了するまで待機することが推奨されます。一部のタスクはキャンセルすることができますが、Red Hat ナレッジベースソリューション How to manage paused tasks on Red Hat Satellite 6 のアドバイスに従って、安全にキャンセルできるタスクと安全にキャンセルできなタスクについて理解する必要があります。

3. DNS と DHCP の設定ファイルである /etc/zones.conf と /etc/dhcp/dhcpd.conf をバックアップします。インストーラーでは 1 つのドメインまたはサブネットしかサポートされないため、これらのバックアップから変更を復元する必要がある場合があります。

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

   # katello-installer --capsule-dns-managed=false --capsule-dhcp-managed=false

   Copy to Clipboard
5. Satellite Web UI で、Hosts (ホスト) > Discovered hosts (検出されたホスト) に移動します。検出されたホストが利用可能な場合は、それらを無効にし、Discovered hosts (検出されたホスト) ページ下のすべてのエントリーを削除します。組織設定メニューを使用して他のすべての組織を順番に選択し、必要に応じてこのアクションを繰り返します。アップグレードが完了したら、これらのホストを再起動します。
6. すべての外部 Capsule Server が組織に割り当てられていることを確認します。割り当てられていない場合、これらのサーバーは、ホスト統合の変更により登録解除された可能性があります。

7. Katello サービスを停止します。

   # katello-service stop

   Copy to Clipboard
8. ISO ファイルを取得してマウントし、パッケージをインストールします。詳細については、「切断されたネットワークからのダウンロードおよびインストール」を参照してください。

9. カスタム Apache サーバー設定がある場合は、次の手順でインストールデフォルト値に戻ります。アップグレードの実行時に変更される内容を確認する場合は、--noop (no operation) オプションとともにアップグレードコマンドを入力し、次の手順でアップグレードコマンドを入力するときに適用される変更内容を確認できます。このテストを行わない場合は、次の手順に進みます。または、以下のように手順を続行します。

   1. 次の行を /etc/httpd/conf/httpd.conf 設定ファイルに追加します。

      Include /etc/httpd/conf.modules.d/*.conf

      Copy to Clipboard

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

      • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを入力します。

        # service httpd restart

        Copy to Clipboard

      • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。

        # systemctl restart httpd

        Copy to Clipboard

   3. postgresql データベースサービスおよび mongod データベースサービスを起動します。

      • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを入力します。

        # service postgresql start
        # service mongod start

        Copy to Clipboard

      • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。

        # systemctl start postgresql
        # systemctl start mongod

        Copy to Clipboard

   4. 以下のように --noop オプションとともにコマンドを入力します。

      # satellite-installer --scenario satellite --upgrade --verbose --noop

      Copy to Clipboard

      /var/log/foreman-installer/satellite.log を参照して、--noop オプションが省略された場合に適用される変更を確認します。設定ファイルの変更を示す +++ と --- の記号を探します。上記の "no operation" コマンドにより実際にはファイルは作成されず、モジュール内の一部の Puppet リソースではファイルがそこに存在することが期待されるため、いくつかのエラーメッセージが表示されるはずです。

   5. Katello サービスを停止します。

      # katello-service stop

      Copy to Clipboard

10. --upgrade オプションを使用してインストーラースクリプトを実行することによりアップグレードを実行します。

    # satellite-installer --scenario satellite --upgrade

    Copy to Clipboard
    警告

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

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

    Copy to Clipboard

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

11. これまでに行ったバックアップを使用して DNS と DHCP の設定ファイルに必要なすべての変更を確認し、復元します。

12. 前の手順で変更を行った場合は、Katello サービスを再起動します。

    # katello-service restart

    Copy to Clipboard

13. Satellite Web UI で Discovery テンプレートを更新します。

    1. Hosts (ホスト) > Provisioning templates (テンプレートのプロビジョニング) に移動します。
    2. PXELinux global default (PXELinux グローバルデフォルト) を選択します。

    3. Template editor (テンプレートエディター) ダイアログボックスで、以下のテキストに一致するよう LABEL discovery で始まるスタンザを更新することにより PXELinux global default (PXELinux グローバルデフォルト) テンプレート検出メニューエントリーを編集します。

       LABEL discovery
       MENU LABEL Satellite 6 Discovery
       MENU DEFAULT
       KERNEL boot/fdi-image-rhel_7-vmlinuz
       APPEND initrd=boot/fdi-image-rhel_7-img rootflags=loop root=live:/fdi.iso rootfstype=auto ro rd.live.image acpi=force rd.luks=0 rd.md=0 rd.dm=0 rd.lvm=0 rd.bootif=0 rd.neednet=0 nomodeset proxy.url=https://SATELLITE_CAPSULE_URL:9090 proxy.type=proxy
       IPAPPEND 2

       Copy to Clipboard
       • proxy.type オプションは proxy または foreman のいずれかになります。proxy の場合は、すべての通信が Capsule 経由で行われます。foreman の場合は、通信が直接 Satellite Server に行われます。
       • proxy.url には、Satellite Capsule または Server の URL を指定します。HTTP と HTTPS の両方のプロトコルがサポートされます。

14. OpenSCAP プラグインがインストールされており、デフォルトの OpenSCAP コンテンツが利用可能でない場合は、以下のコマンドを実行します。

    # foreman-rake foreman_openscap:bulk_upload:default

    Copy to Clipboard
15. Satellite Web UI で Configure (設定) > Discovery Rules (検出ルール) に移動し、選択された組織および場所を検出ルールに関連付けます。

Capsule Server のアップグレード

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

   • 仮想マシンで、スナップショットを取得します。
   • 物理マシンで、バックアップを作成します。
2. DNS と DHCP の設定ファイルである /etc/zones.conf と /etc/dhcp/dhcpd.conf をバックアップします。インストーラーでは 1 つのドメインまたはサブネットしかサポートされないため、これらのバックアップから変更を復元する必要がある場合があります。

3. DNS または DHCP の設定ファイルを手動で編集し、変更を上書きしたくない場合は、以下のコマンドを入力します。

   # capsule-installer --foreman-proxy-dns-managed=false --foreman-proxy-dhcp-managed=false

   Copy to Clipboard

4. Red Hat Satellite 6.1 向けリポジトリーを無効にします。

   • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを実行します。

     # subscription-manager repos --disable rhel-6-server-satellite-capsule-6.1-rpms

     Copy to Clipboard

   • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを実行します。

     # subscription-manager repos --disable rhel-7-server-satellite-capsule-6.1-rpms

     Copy to Clipboard

5. 新しいリポジトリーを有効にします。

   Red Hat Software Collections リポジトリーは、リモート実行機能を含む一部の Red Hat Satellite 機能で必要な新しいバージョンの Ruby を提供します。

   • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを実行します。

     # subscription-manager repos --enable rhel-7-server-satellite-capsule-6.2-rpms --enable rhel-server-rhscl-7-rpms

     Copy to Clipboard

   • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを実行します。

     # subscription-manager repos --enable rhel-6-server-satellite-capsule-6.2-rpms --enable rhel-server-rhscl-6-rpms

     Copy to Clipboard
6. Satellite Web UI で、Hosts (ホスト) > Discovered hosts (検出されたホスト) に移動します。検出されたホストが利用可能な場合は、それらを無効にし、Discovered hosts (検出されたホスト) ページ下のすべてのエントリーを削除します。組織設定メニューを使用して他のすべての組織を順番に選択し、必要に応じてこのアクションを繰り返します。アップグレードが完了したら、これらのホストを再起動します。

7. リポジトリーキャッシュを削除します。

   # yum clean all

   Copy to Clipboard

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

   # yum update

   Copy to Clipboard

9. Satellite Server で、新しい証明書を使用してアーカイブを生成します。

   # capsule-certs-generate --capsule-fqdn "mycapsule.example.com" --certs-tar "mycapsule.example.com-certs.tar"

   Copy to Clipboard

   mycapsule.example.com を Capsule Server の完全修飾ドメイン名に置き換える必要があります。

10. アーカイブファイルを Capsule Server にコピーします。

    # scp mycapsule.example.com-certs.tar mycapsule.example.com

    Copy to Clipboard

11. Capsule Server を検出済みホストのプロキシーとして使用する場合は、検出プラグインをインストールします。

    # yum install rubygem-smart_proxy_discovery.noarch

    Copy to Clipboard

12. Capsule Server で foreman_url 設定が正しいことを確認します。

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

    Copy to Clipboard

    Satellite Server の完全修飾ドメイン名が表示されます。

13. カスタム Apache サーバー設定がある場合は、次の手順でインストールデフォルト値に戻ります。アップグレードの実行時に変更される内容を確認する場合は、--noop (no operation) オプションとともにアップグレードコマンドを入力し、次の手順でアップグレードコマンドを入力するときに適用される変更内容を確認できます。このテストを行わない場合は、次の手順に進みます。または、以下のように手順を続行します。

    1. 次の行を /etc/httpd/conf/httpd.conf 設定ファイルに追加します。

       Include /etc/httpd/conf.modules.d/*.conf

       Copy to Clipboard

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

       • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを入力します。

         # service httpd restart

         Copy to Clipboard

       • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。

         # systemctl restart httpd

         Copy to Clipboard

    3. mongod データベースサービスを起動します。

       • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを入力します。

         # service mongod start

         Copy to Clipboard

       • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。

         # systemctl start mongod

         Copy to Clipboard

    4. 以下のように --noop オプションとともにコマンドを入力します。

       # satellite-installer --scenario capsule --upgrade --verbose --noop

       Copy to Clipboard

       /var/log/foreman-installer/capsule.log を参照して、--noop オプションが省略された場合に適用される変更を確認します。設定ファイルの変更を示す +++ と --- の記号を探します。上記の "no operation" コマンドにより実際にはファイルは作成されず、モジュール内の一部の Puppet リソースではファイルがそこに存在することが期待されるため、いくつかのエラーメッセージが表示されるはずです。

    5. Katello サービスを停止します。

       # katello-service stop

       Copy to Clipboard

14. --upgrade オプションを使用してインストーラースクリプトを実行してアップグレードを行い、Satellite Server で以前に作成された証明書アーカイブへのパスを指定します。

    # satellite-installer --scenario capsule --upgrade \
      --certs-tar mycapsule.example.com-certs.tar

    Copy to Clipboard
    警告

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

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

    Copy to Clipboard

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

15. これまでに行ったバックアップを使用して DNS と DHCP の設定ファイルに必要なすべての変更を確認し、復元します。
16. Satellite Server で foreman-discovery パッケージをアップグレードし、アップグレード前にシャットダウンされたホストを有効にします。

1. 関連するすべてのパッケージが Satellite Server で最新であることを確認します。

   # yum upgrade tfm-rubygem-foreman_discovery

   Copy to Clipboard

2. 必要な場合は、Katello サービスを再起動します。

   # katello-service restart

   Copy to Clipboard

3. 検出されたホストとのプロビジョニングネットワークに接続された、または検出されたホストに TFTP サービスを提供するSatellite Capsule 上の Discovery イメージをアップグレードします。

   # yum upgrade foreman-discovery-image

   Copy to Clipboard

4. 同じインスタンスで、プロキシーサービスを提供するパッケージをインストールし、foreman-proxy サービスを再起動します。

   # yum install rubygem-smart_proxy_discovery
   # service foreman-proxy restart

   Copy to Clipboard
5. Satellite Web UI で、Infrastructure (インフラストラクチャー) > Capsules に移動し、関連するプロキシーにより Discovery 機能がリストされていることを確認します。必要な場合は、Refresh features (機能の更新) をクリックします。
6. Infrastructure (インフラストラクチャー) > Subnets (サブネット) に移動し、検出を使用する各サブネットに必要なスマートプロキシーを選択して、検出プロキシーに接続されていることを確認します。

1. Hosts (ホスト) > Provisioning Templates (テンプレートのプロビジョニング) に移動します。
2. PXELinux global default (PXELinux グローバルデフォルト) を選択します。

3. Template editor (テンプレートエディター) ダイアログボックスで、以下のテキストに一致するよう LABEL discovery で始まるスタンザを更新することにより PXELinux global default (PXELinux グローバルデフォルト) テンプレート検出メニューエントリーを編集します。

   LABEL discovery
   MENU LABEL Satellite 6 Discovery
   MENU DEFAULT
   KERNEL boot/fdi-image-rhel_7-vmlinuz
   APPEND initrd=boot/fdi-image-rhel_7-img rootflags=loop root=live:/fdi.iso rootfstype=auto ro rd.live.image acpi=force rd.luks=0 rd.md=0 rd.dm=0 rd.lvm=0 rd.bootif=0 rd.neednet=0 nomodeset proxy.url=https://SATELLITE_CAPSULE_URL:9090 proxy.type=proxy
   IPAPPEND 2

   Copy to Clipboard
   • proxy.type オプションは proxy または foreman のいずれかになります。proxy の場合は、すべての通信が Capsule 経由で行われます。foreman の場合は、通信が直接 Satellite Server に行われます。
   • proxy.url には、Satellite Capsule または Server の URL を指定します。HTTP と HTTPS の両方のプロトコルがサポートされます。
   • proxy.url オプションを省略し、SRV レコードから Capsule DNS 名を決定することができます。これは、複数の検出サブネットが存在する場合に役に立ちます。詳細については、『Red Hat Satellite 6.2 Host Configuration Guide』を参照してください。

satellite-tools-upgrade パッケージを使用した Satellite クライアントのアップグレード

1. Satellite Web UI で Hosts (ホスト) > Content Hosts (コンテンツホスト) または Host Collections (ホストコレクション) に移動し、アップグレードするコンテンツホストを選択します。

2. Packages (パッケージ) タブで、検索フィールドにパッケージ名 satellite-tools-upgrade を入力します。

   1. Content Host (コンテンツホスト) ビューを使用して単一のホストをアップグレードする場合は、Perform (実行) を選択してパッケージをインストールします。
   2. Bulk Actions (一括処理) ビューを使用してホストのコレクションをアップグレードする場合は、Install (インストール) を選択してパッケージをインストールします。

3. Packages (パッケージ) タブで、検索フィールドにパッケージ名 katello-agent を入力します。

   1. Content Host (コンテンツホスト) ビューを使用して単一のホストをアップグレードする場合は、Package Update (パッケージの更新) を選択し、Perform (実行) を使用してパッケージを更新します。
   2. Bulk Actions (一括処理) ビューを使用してホストのコレクションをアップグレードする場合は、Update (更新) を選択してパッケージを更新します。

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

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

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

   • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを実行します。

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

     Copy to Clipboard

   • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを実行します。

     # subscription-manager repos --disable rhel-6-server-satellite-tools-6.1-rpms

     Copy to Clipboard

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

   • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを実行します。

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

     Copy to Clipboard

   • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを実行します。

     # subscription-manager repos --enable=rhel-6-server-satellite-tools-6.2-rpms

     Copy to Clipboard

4. Katello エージェントパッケージをアップグレードします。

   # yum upgrade katello-agent

   Copy to Clipboard

自己登録 Satellite Server のアップグレード

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

   • 仮想マシンで、スナップショットを取得します。
   • 物理マシンで、バックアップを作成します。

2. アップグレード前スクリプトは競合を検出し、アップグレード後に登録解除および削除できる Satellite Server の重複エントリーがあるホストをリストできます。また、組織に割り当てられていないホストを検出します。Hosts > All hosts を選択して組織の関連付けがないホストがリストされ、同じ名前のコンテンツホストに組織がすでに関連付けられている場合、コンテンツホストは自動的に登録解除されます。これは、アップグレード前にこのようなホストを組織に関連付けることによって回避できます。

   アップグレードの前に、アップグレード前チェックスクリプトを実行して、削除できるホストのリストを取得します。関連付けられていないホストが検出された場合は、アップグレードの前に組織にそれらのホストを関連付けることが推奨されます。

   1. アップグレード前スクリプトを使用するには、ruby193-rubygem-katello-2.2.0.90-1-sat 以降が必要です。

      # yum update ruby193-rubygem-katello

      Copy to Clipboard

   2. アップグレードの前に、アップグレード前チェックスクリプトを実行して、削除できるホストのリストを取得します。関連付けられていないホストが検出された場合は、アップグレードの前に組織にそれらのホストを関連付けることが推奨されます。

      # foreman-rake katello:upgrade_check

      Copy to Clipboard

      アップグレードチェックで、タスクが実行中であることが原因の障害が報告された場合は、タスクが完了するまで待機することが推奨されます。一部のタスクはキャンセルすることができますが、Red Hat ナレッジベースソリューション How to manage paused tasks on Red Hat Satellite 6 のアドバイスに従って、安全にキャンセルできるタスクと安全にキャンセルできなタスクについて理解する必要があります。

3. DNS と DHCP の設定ファイルである /etc/zones.conf と /etc/dhcp/dhcpd.conf をバックアップします。インストーラーでは 1 つのドメインまたはサブネットしかサポートされないため、これらのバックアップから変更を復元する必要がある場合があります。

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

   # katello-installer --capsule-dns-managed=false --capsule-dhcp-managed=false

   Copy to Clipboard

5. 有効なリポジトリーをリストします。

   # subscription-manager repos --list-enabled

   Copy to Clipboard

6. 以下のリポジトリーのみが有効であることを確認します。

   rhel-X-server-satellite-tools-6.1-rpms
   rhel-server-rhscl-X-rpms
   rhel-X-server-satellite-6.1-rpms
   rhel-X-server-rpms

   Copy to Clipboard

   ここで、X はベースシステムのメジャーバージョンです。他のリポジトリーが検出された場合は、リポジトリーの設定の手順に従ってそれらのリポジトリーを削除します。

7. ベースシステムで Satellite の以前のバージョン向けリポジトリーを無効にします。

   • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを入力します。

     # subscription-manager repos --disable rhel-6-server-satellite-6.1-rpms
     # subscription-manager repos --disable rhel-6-server-satellite-tools-6.1-rpms

     Copy to Clipboard

   • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。

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

     Copy to Clipboard

8. 必要な場合は、Satellite 6.1 リポジトリーが無効であることを確認するために、以下のようなコマンドを入力します。

   # subscription-manager repos --list-enabled

   Copy to Clipboard

9. Satellite Web UI でリポジトリーを設定します。

   1. Satellite Web UI で、Content > Red Hat Repositories に移動し、RPM タブを選択します。
   2. Red Hat Satellite 製品 を見つけ、展開します。
   3. Repository Set Red Hat Satellite 6.1 (RHEL X Server 用) (RPM) を見つけ展開します。
   4. RHEL X Server RPM x86_64 用 Red Hat Satellite 6.1 を選択解除します。
   5. Repository Set Red Hat Satellite 6.2 (RHEL X Server 用) (RPM) を見つけ展開します。
   6. RHEL X Server RPM x86_64 用 Red Hat Satellite 6.2 を選択します。
   7. Red Hat Enterprise Linux Server 製品 を見つけ、展開します。
   8. Red Hat Satellite Tools 6.2 (RHEL X Server 用) (RPM) を見つけ展開します。
   9. RHEL X Server RPMs x86_64 用 Red Hat Satellite Tools 6.2 を選択します。

10. 新しく有効になったリポジトリーを同期します。

    1. Satellite Web UI で、Content (コンテンツ) > Sync Status (同意ステータス) に移動します。
    2. 製品の横にある矢印をクリックして利用可能なリポジトリーを表示します。
    3. 6.2 用リポジトリーを選択します。

    4. Synchronize Now をクリックします。

       Satellite Tools リポジトリーを更新しようとするときにエラーが発生した場合は、カスタマーポータルまたは Satellite Web UI でマニフェストを削除しないでください。削除すると、すべてのコンテンツホストが登録解除されます。詳細については、Red Hat ナレッジベースソリューション「Cannot enable Red Hat Satellite Tools Repo on Satellite 6.2」を参照してください。

11. 6.1 バージョンリポジトリーを使用する既存のコンテンツビューを 6.2 向けの新しいバージョンで更新します。新しい 6.2 バージョンリポジトリーがあるコンテンツビューの更新されたバージョンを公開し、プロモートします。

12. リポジトリーの同期が完了したら、ベースシステムで新しいリポジトリーを有効にします。

    • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを入力します。

      # subscription-manager repos --enable rhel-6-server-satellite-6.2-rpms
      # subscription-manager repos --enable rhel-6-server-satellite-tools-6.2-rpms

      Copy to Clipboard

    • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。

      # subscription-manager repos --enable rhel-7-server-satellite-6.2-rpms
      # subscription-manager repos --enable rhel-7-server-satellite-tools-6.2-rpms

      Copy to Clipboard
13. Satellite Web UI で、Hosts (ホスト) > Discovered hosts (検出されたホスト) に移動します。検出されたホストが利用可能な場合は、それらを無効にし、Discovered hosts (検出されたホスト) ページ下のすべてのエントリーを削除します。組織設定メニューを使用して他のすべての組織を順番に選択し、必要に応じてこのアクションを繰り返します。アップグレードが完了したら、これらのホストを再起動します。
14. すべての外部 Capsule Server が組織に割り当てられていることを確認します。割り当てられていない場合、これらのサーバーは、ホスト統合の変更により登録解除された可能性があります。

15. リポジトリーキャッシュを削除します。

    # yum clean all

    Copy to Clipboard

16. 以下のパッケージをダウンロードします。

    # yum install --downloadonly rubygem-smart_proxy_remote_execution_ssh rubygem-smart_proxy_openscap rubygem-smart_proxy_dynflow tfm-rubygem-smart_proxy_dynflow_core tfm-rubygem-foreman_remote_execution katello-client-bootstrap

    Copy to Clipboard

17. 更新されたすべてのパッケージをダウンロードします。

    # yum update --downloadonly

    Copy to Clipboard

18. Katello サービスを停止します。

    # katello-service stop

    Copy to Clipboard

19. 以前にダウンロードされたパッケージをインストールします。

    # yum install rubygem-smart_proxy_remote_execution_ssh rubygem-smart_proxy_openscap rubygem-smart_proxy_dynflow tfm-rubygem-smart_proxy_dynflow_core tfm-rubygem-foreman_remote_execution katello-client-bootstrap

    Copy to Clipboard

20. 更新されたすべてのパッケージをインストールします。

    # yum update

    Copy to Clipboard

21. カスタム Apache サーバー設定がある場合は、次の手順でインストールデフォルト値に戻ります。アップグレードの実行時に変更される内容を確認する場合は、--noop (no operation) オプションとともにアップグレードコマンドを入力し、次の手順でアップグレードコマンドを入力するときに適用される変更内容を確認できます。このテストを行わない場合は、次の手順に進みます。または、以下のように手順を続行します。

    1. 次の行を /etc/httpd/conf/httpd.conf 設定ファイルに追加します。

       Include /etc/httpd/conf.modules.d/*.conf

       Copy to Clipboard

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

       • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを入力します。

         # service httpd restart

         Copy to Clipboard

       • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。

         # systemctl restart httpd

         Copy to Clipboard

    3. postgresql データベースサービスおよび mongod データベースサービスを起動します。

       • Red Hat Enterprise Linux 6 の場合は、以下のコマンドを入力します。

         # service postgresql start
         # service mongod start

         Copy to Clipboard

       • Red Hat Enterprise Linux 7 の場合は、以下のコマンドを入力します。

         # systemctl start postgresql
         # systemctl start mongod

         Copy to Clipboard

    4. 以下のように --noop オプションとともにコマンドを入力します。

       # satellite-installer --scenario satellite --upgrade --verbose --noop

       Copy to Clipboard

       /var/log/foreman-installer/satellite.log を参照して、--noop オプションが省略された場合に適用される変更を確認します。設定ファイルの変更を示す +++ と --- の記号を探します。上記の "no operation" コマンドにより実際にはファイルは作成されず、モジュール内の一部の Puppet リソースではファイルがそこに存在することが期待されるため、いくつかのエラーメッセージが表示されるはずです。

    5. Katello サービスを停止します。

       # katello-service stop

       Copy to Clipboard

22. --upgrade オプションを使用してインストーラースクリプトを実行することによりアップグレードを実行します。

    # satellite-installer --scenario satellite --upgrade

    Copy to Clipboard
    警告

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

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

    Copy to Clipboard

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

23. これまでに行ったバックアップを使用して DNS と DHCP の設定ファイルに必要なすべての変更を確認し、復元します。

24. 前の手順で変更を行った場合は、Katello サービスを再起動します。

    # katello-service restart

    Copy to Clipboard

25. Satellite Web UI で Discovery テンプレートを更新します。

    1. Hosts (ホスト) > Provisioning templates (テンプレートのプロビジョニング) に移動します。
    2. PXELinux global default (PXELinux グローバルデフォルト) を選択します。

    3. Template editor (テンプレートエディター) ダイアログボックスで、以下のテキストに一致するよう LABEL discovery で始まるスタンザを更新することにより PXELinux global default (PXELinux グローバルデフォルト) テンプレート検出メニューエントリーを編集します。

       LABEL discovery
       MENU LABEL Satellite 6 Discovery
       MENU DEFAULT
       KERNEL boot/fdi-image-rhel_7-vmlinuz
       APPEND initrd=boot/fdi-image-rhel_7-img rootflags=loop root=live:/fdi.iso rootfstype=auto ro rd.live.image acpi=force rd.luks=0 rd.md=0 rd.dm=0 rd.lvm=0 rd.bootif=0 rd.neednet=0 nomodeset proxy.url=https://SATELLITE_CAPSULE_URL:9090 proxy.type=proxy
       IPAPPEND 2

       Copy to Clipboard
       • proxy.type オプションは proxy または foreman のいずれかになります。proxy の場合は、すべての通信が Capsule 経由で行われます。foreman の場合は、通信が直接 Satellite Server に行われます。
       • proxy.url には、Satellite Capsule または Server の URL を指定します。HTTP と HTTPS の両方のプロトコルがサポートされます。

26. OpenSCAP プラグインがインストールされており、デフォルトの OpenSCAP コンテンツが利用可能でない場合は、以下のコマンドを実行します。

    # foreman-rake foreman_openscap:bulk_upload:default

    Copy to Clipboard
27. Satellite Web UI で Configure (設定) > Discovery Rules (検出ルール) に移動し、選択された組織および場所を検出ルールに関連付けます。

28. Red Hat カスタマーポータルで Satellite Server を同期します。

    1. Content (コンテンツ) > Sync Status (同期ステータス) に移動します。

       同期可能な製品リポジトリーのリストが表示されます。

    2. 製品コンテンツの横にある矢印をクリックして利用可能なコンテンツを表示します。
    3. 同期するコンテンツを選択します。

    4. Synchronize Now をクリックします。

       コンテンツの同期には時間がかかることがあります。同期に要する時間は、ディスクドライブの速度やネットワーク接続の速度、同期対象として選択されたコンテンツの量によって異なります。

29. (オプション) 必要なコンテンツビューを公開します。

    コンテンツビューを公開して、ホストが参照および使用できるようにする必要があります。公開する前に、コンテンツビュー定義に必要な製品、リポジトリー、およびフィルターが含まれることを確認する必要があります。

    1. メインメニューから、Content (コンテンツ) > Content Views (コンテンツビュー) を選択します。
    2. Name (名前) 列から、Satellite Server コンテンツビューを選択します。
    3. Publish New Version (新規バージョンの公開) をクリックします。
    4. コメントを入力し、Save (保存) をクリックします。

30. (オプション) コンテンツビューをプロモートします。

    1. メインメニューから、Content (コンテンツ) > Content Views (コンテンツビュー) を選択します。
    2. Name (名前) 列で、Satellite Server コンテンツビューを選択します。
    3. Versions (バージョン) タブで、最新バージョンを選択し、Promote (プロモート) をクリックします。

    4. プロモーションパスを特定し、適切なライフサイクル環境を選択して、Promote Version (バージョンのプロモート) をクリックします。

       処理が完了したら、更新されたコンテンツビューステータスが Versions (バージョン) タブに表示されます。