第4章 アップグレード後のタスク

このセクションでは、PXE ブートを使用して Satellite Server に登録するホストに渡した PXELinux テンプレートとブートイメージをアップデートする方法を説明します。

Satellite 6.4 以降、プロビジョニングテンプレートには別途サブネットが関連付けられるので、対象のサブネットに対して TFTP Capsule を使用するように初期設定しないようにしてください。アップグレード後にサブネットを作成する場合には、特に Satellite また Capsule が Discovery テンプレートにプロキシーサービスを提供できるようにしてから、テンプレート Capsule を使用するように、検出されたホストで全ホストを設定する必要があります。

アップグレード中は、TFTP プロキシーが設定された各サブネットが有効化されている場合には、テンプレート Capsule を TFTP Capsule と同じに設定してください。アップグレード後には、すべてのサブネットでこれが正しく設定されていることを確認してください。

ホストで PXE ブートを使用しない場合には、Satellite に新規ホストを検出させるために、これらの手順は、必要ありません。

Satellite の以前のバージョンでは、Ansible Playbook はハッシュ foreman_params を使用して、パラメーターを取得しました。以下に例を示します。

- hosts: all
  tasks:
    - name: Print Remote Execution SSH keys
      debug:
        var: foreman_params['remote_execution_ssh_keys']

これは、ユーザーが foreman_params ハッシュを使用するために、すべての Ansible Playbook をアップデートする必要があったため、Ansible Playbook をインポートした時に問題を引き起こしました。Satellite 6.6 では、Ansible 変数の機能が強化され、foreman_params ハッシュが削除されました。

Satellite 6.6 にアップグレードしたら、Ansible Playbook をアップデートして foreman_params ハッシュを削除する必要があります。

Ansible Playbook が、以下の方法で変数を参照していることを確認します。

- hosts: all
  tasks:
    - name: Print Remote Execution SSH keys
      debug:
        var: remote_execution_ssh_keys

Satellite Server または Capsule Server に virt-who がインストールされている場合は、Satellite Server または Capsule Server のアップグレード時に一緒にアップグレードされるため、追加の作業は必要ありません。virt-who を他の場所にインストールしている場合は、手動でアップグレードする必要があります。

Satellite 6.6 へのアップグレードが完了したら、コンテンツビューから Red Hat Satellite Tools 6.5 リポジトリーを削除して、無効にすることができます。

バージョン 6.5 の Satellite Tools リポジトリーを無効にします。

リポジトリーがまだコンテンツビューに含まれている場合には、無効にできません。スケジュールされているタスクにより、無効にされたリポジトリーからパッケージが自動的に削除されます。

アップグレードを完了したら、オプションで MongoDB ストレージエンジンを WiredTiger にアップグレードできます。すでに WiredTiger を使用する場合は、アップグレード後にこの手順を実行する必要はありません。WiredTiger の使用を希望する場合は、Satellite Server と全 Capsule Server で、以下の手順を繰り返し実行する必要があります。WiredTiger ストレージエンジンに関する詳細は、MongoDB マニュアル の WiredTiger Storage Engine を参照してください。

# satellite-installer --upgrade-mongo-storage-engine

アップグレードが完了したら、Satellite Server で PostgreSQL の完全なデータベース Vacuum を実行して、移行先のデータベースの領域を確保できます。

アップグレードプロセスで、Satellite は Satellite 6.6 で非推奨となったマクロの場所を特定し、全テンプレート、パラメーター、ルックアップキーおよび値の以前の構文を新しい構文に変換します。このプロセスでは、以下のような単純なテキスト置換を使用します。

@host.params['parameter1'] -> host_param('parameter1')
@host.param_true?('parameter1') -> host_param_true?('parameter1')
@host.param_false?('parameter1') -> host_param_false?('parameter1')
@host.info['parameters'] -> host_enc['parameters']

このテキスト置換で、ファイルの変数を破損したり、省略したりしないように、以前の構文の全テンプレート、パラメーター、ルックアップキーおよび値すべてを確認して、手動で置き換えます。

以下のエラーは、アップグレード後にファイル内に以前の構文が残っていることが原因で発生します。

 undefined method '#params' for Host::Managed::Jail