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

Satellite Server のアップグレード

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

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

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

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

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

      Copy to Clipboard Toggle word wrap

      # yum update ruby193-rubygem-katello

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

      Copy to Clipboard Toggle word wrap

      # foreman-rake katello:upgrade_check

      アップグレードチェックで、タスクが実行中であることが原因の障害が報告された場合は、タスクが完了するまで待機することが推奨されます。一部のタスクはキャンセルすることができますが、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 の設定ファイルを手動で編集し、変更を上書きしたくない場合は、以下のコマンドを実行します。

   Copy to Clipboard Toggle word wrap

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

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

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

     Copy to Clipboard Toggle word wrap

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

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

     Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   # subscription-manager repos --list-enabled

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

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

     Copy to Clipboard Toggle word wrap

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

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

     Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   # yum clean all

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

   Copy to Clipboard Toggle word wrap

   # yum repolist enabled

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

   Copy to Clipboard Toggle word wrap

   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

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. リポジトリーキャッシュを削除します。

    Copy to Clipboard Toggle word wrap

    # yum clean all

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

    Copy to Clipboard Toggle word wrap

    # foreman-rake katello:upgrade_check

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

    Copy to Clipboard Toggle word wrap

    # katello-service stop

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

    Copy to Clipboard Toggle word wrap

    # yum update

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

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

       Copy to Clipboard Toggle word wrap

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

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

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

         Copy to Clipboard Toggle word wrap

         # service httpd restart

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

         Copy to Clipboard Toggle word wrap

         # systemctl restart httpd

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

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

         Copy to Clipboard Toggle word wrap

         # service postgresql start
         # service mongod start

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

         Copy to Clipboard Toggle word wrap

         # systemctl start postgresql
         # systemctl start mongod

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

       Copy to Clipboard Toggle word wrap

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

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

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

       Copy to Clipboard Toggle word wrap

       # katello-service stop

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

    Copy to Clipboard Toggle word wrap

    # satellite-installer --scenario satellite --upgrade

    警告

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

    Copy to Clipboard Toggle word wrap

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

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

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

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

    Copy to Clipboard Toggle word wrap

    # katello-service restart

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

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

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

       Copy to Clipboard Toggle word wrap

       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

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

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

    Copy to Clipboard Toggle word wrap

    # foreman-rake foreman_openscap:bulk_upload:default

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 以降が必要です。

      Copy to Clipboard Toggle word wrap

      # yum update ruby193-rubygem-katello

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

      Copy to Clipboard Toggle word wrap

      # foreman-rake katello:upgrade_check

      アップグレードチェックで、タスクが実行中であることが原因の障害が報告された場合は、タスクが完了するまで待機することが推奨されます。一部のタスクはキャンセルすることができますが、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 の設定ファイルを手動で編集し、変更を上書きしたくない場合は、以下のコマンドを実行します。

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

   # katello-service stop

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

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

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

      Copy to Clipboard Toggle word wrap

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

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

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

        Copy to Clipboard Toggle word wrap

        # service httpd restart

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

        Copy to Clipboard Toggle word wrap

        # systemctl restart httpd

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

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

        Copy to Clipboard Toggle word wrap

        # service postgresql start
        # service mongod start

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

        Copy to Clipboard Toggle word wrap

        # systemctl start postgresql
        # systemctl start mongod

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

      Copy to Clipboard Toggle word wrap

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

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

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

      Copy to Clipboard Toggle word wrap

      # katello-service stop

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

    Copy to Clipboard Toggle word wrap

    # satellite-installer --scenario satellite --upgrade

    警告

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

    Copy to Clipboard Toggle word wrap

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

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

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

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

    Copy to Clipboard Toggle word wrap

    # katello-service restart

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

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

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

       Copy to Clipboard Toggle word wrap

       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

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

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

    Copy to Clipboard Toggle word wrap

    # foreman-rake foreman_openscap:bulk_upload:default

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

Capsule Server のアップグレード

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

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

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

   Copy to Clipboard Toggle word wrap

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

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

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

     Copy to Clipboard Toggle word wrap

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

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

     Copy to Clipboard Toggle word wrap

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

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

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

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

     Copy to Clipboard Toggle word wrap

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

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

     Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

   # yum clean all

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

   Copy to Clipboard Toggle word wrap

   # yum update

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

   Copy to Clipboard Toggle word wrap

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

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

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

    Copy to Clipboard Toggle word wrap

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

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

    Copy to Clipboard Toggle word wrap

    # yum install rubygem-smart_proxy_discovery.noarch

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

    Copy to Clipboard Toggle word wrap

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

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

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

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

       Copy to Clipboard Toggle word wrap

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

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

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

         Copy to Clipboard Toggle word wrap

         # service httpd restart

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

         Copy to Clipboard Toggle word wrap

         # systemctl restart httpd

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

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

         Copy to Clipboard Toggle word wrap

         # service mongod start

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

         Copy to Clipboard Toggle word wrap

         # systemctl start mongod

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

       Copy to Clipboard Toggle word wrap

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

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

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

       Copy to Clipboard Toggle word wrap

       # katello-service stop

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

    Copy to Clipboard Toggle word wrap

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

    警告

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

    Copy to Clipboard Toggle word wrap

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

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

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

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

   Copy to Clipboard Toggle word wrap

   # yum upgrade tfm-rubygem-foreman_discovery

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

   Copy to Clipboard Toggle word wrap

   # katello-service restart

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

   Copy to Clipboard Toggle word wrap

   # yum upgrade foreman-discovery-image

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

   Copy to Clipboard Toggle word wrap

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

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 グローバルデフォルト) テンプレート検出メニューエントリーを編集します。

   Copy to Clipboard Toggle word wrap

   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

   • 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 の場合は、以下のコマンドを実行します。

     Copy to Clipboard Toggle word wrap

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

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

     Copy to Clipboard Toggle word wrap

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

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

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

     Copy to Clipboard Toggle word wrap

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

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

     Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   # yum upgrade katello-agent

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

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

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

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

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

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

      Copy to Clipboard Toggle word wrap

      # yum update ruby193-rubygem-katello

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

      Copy to Clipboard Toggle word wrap

      # foreman-rake katello:upgrade_check

      アップグレードチェックで、タスクが実行中であることが原因の障害が報告された場合は、タスクが完了するまで待機することが推奨されます。一部のタスクはキャンセルすることができますが、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 の設定ファイルを手動で編集し、変更を上書きしたくない場合は、以下のコマンドを実行します。

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   # subscription-manager repos --list-enabled

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

   Copy to Clipboard Toggle word wrap

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

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

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

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

     Copy to Clipboard Toggle word wrap

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

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

     Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   # subscription-manager repos --list-enabled

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 の場合は、以下のコマンドを入力します。

      Copy to Clipboard Toggle word wrap

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

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

      Copy to Clipboard Toggle word wrap

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

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

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

    Copy to Clipboard Toggle word wrap

    # yum clean all

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

    Copy to Clipboard Toggle word wrap

    # 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

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

    Copy to Clipboard Toggle word wrap

    # yum update --downloadonly

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

    Copy to Clipboard Toggle word wrap

    # katello-service stop

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

    Copy to Clipboard Toggle word wrap

    # 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

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

    Copy to Clipboard Toggle word wrap

    # yum update

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

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

       Copy to Clipboard Toggle word wrap

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

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

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

         Copy to Clipboard Toggle word wrap

         # service httpd restart

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

         Copy to Clipboard Toggle word wrap

         # systemctl restart httpd

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

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

         Copy to Clipboard Toggle word wrap

         # service postgresql start
         # service mongod start

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

         Copy to Clipboard Toggle word wrap

         # systemctl start postgresql
         # systemctl start mongod

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

       Copy to Clipboard Toggle word wrap

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

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

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

       Copy to Clipboard Toggle word wrap

       # katello-service stop

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

    Copy to Clipboard Toggle word wrap

    # satellite-installer --scenario satellite --upgrade

    警告

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

    Copy to Clipboard Toggle word wrap

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

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

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

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

    Copy to Clipboard Toggle word wrap

    # katello-service restart

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

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

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

       Copy to Clipboard Toggle word wrap

       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

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

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

    Copy to Clipboard Toggle word wrap

    # foreman-rake foreman_openscap:bulk_upload:default

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 (バージョン) タブに表示されます。