SaltStack Config のアップグレード

SaltStack Config を以前のバージョンから最新の安定したバージョンにアップグレードできます。

アップグレードするときのベストプラクティス

アップグレードの計画時には、以下のガイドラインに従ってください。

[インストーラまたは手動のインストール手順を使用してアップグレードしない。]SaltStack Config インストールをアップグレードする場合は、次のアップグレード手順を参照してください。
[最適な結果を得るために、1 つのメジャーリリースから次のメジャーリリースに順番にアップグレードする。]ベストプラクティスとして、必ず SaltStack Config の最新のメジャーバージョンから新しいリリースにアップグレードしてください。古いリリースを使用している場合は、1 つのリリースから次のリリースに順番にアップグレードします。
[データをバックアップする。]データの損失を防ぐために、データをバックアップします。
[ネットワークアクティビティが低い時間帯にアップグレードを実行する。]データベースのアップグレードには、データの再インデックス化が必要です。データの複雑さによっては、データベースのアップグレードに数時間かかる場合があります。サービスの中断を防ぐには、ビジネス活動が低下する時間帯にデータベースをアップグレードするか、アップグレードの前にデータベースをトリミングしてください。
[データベースに古いコマンドが保存されているかどうかを確認する。]PostgreSQL データベースには、実行されていない古いコマンドが保存されている場合があります。これらのコマンドは、アップグレード中に、マスタープラグインを再起動するときに実行される場合があります。この問題を回避するには、データベースに古いコマンドが保存されているかどうかを確認し、定義された時間より古いジョブのスキップを有効にします。
[展開前にアップグレードをテストする。]可能であれば、テスト環境でリハーサルを実行してみることで、アップグレードにかかる時間を把握できます。
[まず、ガイドを通読する。]アップグレードの実装前に、このガイドを 1 度通読することも検討してください。必要なタスクの理解、チームでの計画の必要性、関係者への保留中の変更についての通知の必要性などを判断できます。

古いバージョンからのアップグレード

ベストプラクティスとして、必ず SaltStack Config の最新のメジャーバージョンから新しいリリースにアップグレードしてください。最新リリースよりも前のバージョンからアップグレードする場合は、1 つのメジャーリリースから次のメジャーリリースに順番にアップグレードすることで最適な結果が得られる場合があります。

以前のバージョンの SaltStack Config にアップグレードする手順については、アップグレード元のリリースに固有のアップグレード手順を参照してください。以前のリリースのアップグレード手順は、以降のリリースのインストールガイド PDF に記載されています。たとえば、5.5 から 6.0 にアップグレードする必要がある場合は、6.0 のインストール PDF に記載されているアップグレード手順を参照してください。

SaltStack Config バージョン 8.4 以降の場合は、このページの上部にあるバージョンセレクタを使用して、お使いの製品バージョンに適したアップグレードガイドを選択します。バージョン 8.3 以前の場合は、次の表の PDF ガイドを使用します。


バージョン	インストールおよびアップグレードガイド (PDF)
8.3	8.3 インストールおよびアップグレードガイド
6.4	6.4 インストールおよびアップグレードガイド
6.3	6.3 インストールおよびアップグレードガイド
6.2	6.2 インストールおよびアップグレードガイド
6.1	6.1 インストールおよびアップグレードガイド
6.0.1	6.0.1 インストールおよびアップグレードガイド
6.0	6.0 インストールおよびアップグレードガイド

SaltStack Config のアップグレード方法

SaltStack Config をアップグレードするには、以下のタスクをこの順序で実行します。

SaltStack Config の特定のインストールに不可欠な特定のファイルやディレクトリなどのデータをバックアップする
PostgreSQL をアップグレードする（オプション、推奨）
Salt インフラストラクチャをアップグレードする（オプション、推奨）
アップグレードファイルをダウンロードする
RaaS ノードのアップグレード
マスタープラグインを使用してすべての Salt マスターをアップグレードする

Lifecyle Manager を使用した SSC のアップグレードの詳細については、LCM ドキュメントのvRealize Automation SaltStack Config のアップグレードを参照してください。

SaltStack Config のファイルおよびディレクトリのバックアップ

次のファイルおよびディレクトリには、カスタムの SaltStack Config 構成が含まれているため、アップグレードの前にバックアップする必要があります。

RaaS ノードで、次のディレクトリ全体をバックアップします。
- /etc/raas/raas
- /etc/raas/raas.secconf
- /var/log/raas
- /etc/raas/pki/
注：
pki ディレクトリには隠しファイルが含まれているため、必ずディレクトリ全体をバックアップします。/var/log/raas ディレクトリ内のログファイルをバックアップするかどうかはオプションです。アップグレードプロセスでトラブルシューティングが必要になった場合は、クリーンなログファイルを提供するためにログファイルをクリアします。
各 Salt マスターで、/etc/salt/master.d/raas.conf および /etc/salt/master.d/eAPIMasterPaths.conf ファイルをバックアップします。
注：
SaltStack Config を最初にインストールした方法によっては、eAPI Salt マスターパスが代わりに /etc/salt/master.d/raas.conf ファイル内に記述されている場合があります。

データベーススキーマのバックアップ

RaaS ノードをアップグレードすると、データベーススキーマが更新されます。このため、アップグレードの前には必ずデータベースのバックアップを作成してください。

データベースをバックアップするには、PostgreSQL データベース名を調べてから、その内容をコピーする必要があります。

PostgreSQL サーバで、次のファイルをバックアップします。
- postgres.conf
- pg_hba.conf
次のコマンドを使用して、postgres ユーザーとしてログインします。
```
sudo su - postgres
```
データベース名を確認します。次のコマンドを使用して、PostgreSQL に入り、データベースのリストを取得します。
```
psql
\l
```
PostgreSQL を終了して postgres ユーザーとしてログアウトするために、Ctrl+D キーを押してから次のコマンドを実行します。
```
exit
```
データベースの内容をファイルにコピーします。次のコマンドで例を示します。
```
pg_dump -U salt_eapi raas_db_name > postgres_raas_backup_$(date +%Y-%m-%d).sql
```

PostgreSQL データベースのアップグレード

SaltStack Config では PostgreSQL 9.6 データベースが必須ですが、PostgreSQL 12.4 が推奨されます。推奨されるバージョンの PostgreSQL は、SaltStack Config インストーラに含まれています。

PostgreSQL の最新バージョンへのアップグレードは必須ではありません。ただし、PostgreSQL をアップグレードすると、パフォーマンスが向上する可能性があります。PostgreSQL の最新バージョンへのアップグレードの手順については、PostgreSQL upgradeを参照してください。

Redis データベースのアップグレード

SaltStack Config では Redis 5.x データベースが必須ですが、Redis 5.0.4 が推奨されます。推奨されるバージョンの Redis は、SaltStack Config インストーラに含まれています。

Redis 5.x の最新バージョンへのアップグレードは必須ではありません。ただし、Redis をアップグレードすると、パフォーマンスが向上する可能性があります。Redis のアップグレードの手順については、Redis Administrationを参照してください。

Salt のアップグレード

最適なパフォーマンスを得るために、インフラストラクチャ内の Salt コンポーネントが Salt の最新のメジャーバージョン上で実行されるようにしてください。たとえば、ミニオンが Salt の最新バージョン上にあることを確認します。

Salt マスターおよび他の Salt コンポーネントをアップグレードする手順については、Upgrading Your Salt Infrastructureを参照してください。

Salt Crystal パッケージのアップグレードの手順については、How to Upgrade Salt Crystalを参照してください。

RaaS ノードのアップグレード

PostgreSQL、Redis、および Salt を最新バージョンにアップグレードしたら、RaaS ノードを以前のバージョンから最新バージョンにアップグレードできます。

注：データベースのアップグレードには、データの再インデックス化が必要です。データが複雑な場合、データベースのアップグレードに数時間かかる場合があります。

重要：

RaaS ノードをアップグレードする前に、データの損失を回避するために、[システムデータをバックアップする必要があります]。

RaaS ノードをアップグレードするには、次の手順に従います。

Customer Connect からアップグレードファイルをダウンロードします。
デフォルトのファイルシステム、ピラーデータ、およびジョブに加えた変更を、新しいファイルまたはジョブとして保存します。
デフォルトのターゲットに対して行われたすべてのピラーの割り当てをメモします。これらはアップグレード後に再割り当てする必要があります。
次のコマンドを使用して、RaaS サービスを停止します。
```
sudo systemctl stop raas
```
/var/log/raas ディレクトリのログファイルを削除します。ログファイルをクリアしておくと、トラブルシューティングが必要になった場合に、クリーンなログファイルを取得できます。
次のコマンドを使用して、現在インストールされているバージョンの API (RaaS) を削除します。
```
sudo yum remove raas
```
最新の RPM をインストールして、RaaS ノードをアップグレードします。次のコマンド例を、RPM の実際のファイル名に置き換えて使用します。
```
sudo yum install raas-rpm-file-name.rpm
```
[重要：]次のファイルのバックアップを復旧します。
- /etc/raas/raas
- /etc/raas/raas.secconf
- /etc/raas/pki/
次のコマンドを使用して、raas ユーザーの権限を更新します。
```
sudo chown -R raas:raas /etc/pki/raas/certs
```
オプション：SaltStack SecOps ライセンスを持っていて、コンプライアンスライブラリを追加する場合は、/etc/raas/raas ファイルに次の新しいセクションを追加します。
```
sec:
  ingest_override: true
  locke_dir: locke
  post_ingest_cleanup: true
  username: 'secops'
  content_url: 'https://enterprise.saltstack.com/secops_downloads'
  download_enabled: true
  download_frequency: 86400
  stats_snapshot_interval: 3600
  compile_stats_interval: 10
  ingest_on_boot: True
  content_lock_timeout: 60
  content_lock_block_timeout: 120
```
注：
この手順はオプションであり、有効な SaltStack SecOps ライセンスを持つ組織にのみ適用されます。このアドオンモジュールは、SaltStack Config バージョン 6.0 以降で使用できます。/etc/raas/raas 構成ファイル内の以前の構成オプションは、これらのアドオンモジュールに固有です。

オプション：SaltStack SecOps ライセンスを持っていて、脆弱性ライブラリを追加する場合は、/etc/raas/raas ファイルに次の新しいセクションを追加します。

vman:
  vman_dir: vman
  download_enabled: true
  download_frequency: 86400
  username: vman
  content_url: 'https://enterprise.saltstack.com/vman_downloads'
  ingest_on_boot: true
  compile_stats_interval: 60
  stats_snapshot_interval: 3600
  old_policy_file_lifespan: 2
  delete_old_policy_files_interval: 86400
  tenable_asset_import_enabled: True
  tenable_asset_import_grains: ['fqdn', 'ipv4', 'ipv6', 'hostname', 'mac_address', 'netbios_name',
                                'bios_uuid', 'manufacturer_tpm_id', 'ssh_fingerprint',
                                'mcafee_epo_guid', 'mcafee_epo_agent_guid', 'symantec_ep_hardware_key',
                                'qualys_asset_id', 'qualys_host_id', 'servicenow_sys_id', 'gcp_project_id',
                                'gcp_zone', 'gcp_instance_id', 'azure_vm_id', 'azure_resource_id',
                                'aws_availability_zone', 'aws_ec2_instance_ami_id',
                                'aws_ec2_instance_group_name', 'aws_ec2_instance_state_name',
                                'aws_ec2_instance_type', 'aws_ec2_name', 'aws_ec2_product_code',
                                'aws_owner_id', 'aws_region', 'aws_subnet_id', 'aws_vpc_id',
                                'installed_software', 'bigfix_asset_id'
                                ]

注：

この手順はオプションであり、有効な SaltStack SecOps ライセンスを持つ組織にのみ適用されます。このアドオンモジュールは、SaltStack Config バージョン 6.0 以降で使用できます。/etc/raas/raas 構成ファイル内の以前の構成オプションは、これらのアドオンモジュールに固有です。

現在、RaaS には、古いジョブに関連する既知の問題があります。アップグレード時に、一部のユーザーが、保留中の状態でスタックされている古いジョブのキューに気づく場合があります。これらのジョブを先に消去しておかないと、RaaS ノードをアップグレードしたときに、これらのジョブが実行される可能性があります。
そうなることを回避するには、まず、古いコマンドがデータベースに格納されているかどうかを確認します。PostgreSQL ノードで、次のコマンドを使用して、保留中のジョブを調べます。
```
select count(1) from commands where state='new';
```
結果として、保留中のジョブの数が表示されます。ジョブの数が 0 である場合は、残りのアップグレードプロセスを続行します。
次のコマンドを使用して、RaaS サービスデータベースをアップグレードします。
```
sudo su - raas
raas upgrade
```
注：
データベースのサイズによっては、アップグレードに数分から 1 時間以上かかる場合があります。エラーが発生する場合は、/var/log/raas/raas ログファイルで詳細情報を確認してください。
アップグレード後、次のコマンドを使用して、raas ユーザーのセッションを終了します。
```
exit
```
次のコマンドを使用して、RaaS サービスを開始します。
```
sudo systemctl enable raas
sudo systemctl start raas
```

マスタープラグインのアップグレード

RaaS ノードが正常にアップグレードされたら、SaltStack Config への接続にマスタープラグインを使用する Salt マスターをアップグレードできます。

注：

Salt マスターをアップグレードする前に、Salt マスターに pip3 アプリケーションがインストールされていることを確認してください。マスタープラグインの最新バージョンからアップグレードした場合、このアプリケーションはすでにインストールされています。

Salt マスターでマスタープラグインをアップグレードするには、次の手順に従います。

次のコマンドを使用して、salt-master サービスを停止します。
```
sudo systemctl stop salt-master
```
Salt マスターで実行されている Python のバージョンを確認します。Python 3.6 以降が実行されている場合は、変更の必要はありません。そうでない場合は、SSEAPE モジュールの以前のバージョンを削除します。（SSEAPE は、Salt マスターの SaltStack Config プラグインです。）例：
RHEL/CentOS
```
sudo rm -rf /usr/lib/python3.6/site-packages/SSEAPE*
```
Ubuntu
```
sudo rm /usr/lib/python3.6/dist-packages/SSEAPE*
```
更新された Python wheel を手動でインストールして、マスタープラグインをアップグレードします。次のコマンド例を、wheel ファイルの実際の名前に置き換えて使用してください。
RHEL/CentOS
```
sudo pip3 install SSEAPE-file-name.whl --prefix /usr
```
Ubuntu
```
sudo pip3 install SSEAPE-file-name.whl
```
注：
一部のユーザーは、オペレーティングシステムに合わせて、構文を pip3.6 または pip36 に変更する必要があります。
さまざまなモジュールへのパスを参照するように、/etc/salt/master.d/eAPIMasterPaths.conf ファイルを編集して API (RaaS) モジュールのパスを更新します。たとえば、このファイル内のすべての python2.7 の参照を python3.6 に変更します。
注：
SaltStack Config を最初にインストールした方法によっては、eAPI Salt マスターパスが代わりに /etc/salt/master.d/raas.conf ファイル内に記述されている場合があります。
/etc/salt/master.d/raas.conf の engines セクションを調べて、以下と一致することを確認します。
```
engines:
  - sseapi: {}
  - eventqueue: {}
  - rpcqueue: {}
  - jobcompletion: {}
  - keyauth: {}
```
注：
問題が発生した場合は、/etc/salt/master.d/raas.conf ファイルおよび /etc/salt/master.d/eAPIMasterPaths.conf ファイルのバックアップの復旧が必要になることがあります。
Salt マスターキー認証（推奨）を使用している場合は、sseapi_pubkey_path が構成されていること、および sseapi_username と sseapi_password が /etc/salt/master.d/raas.conf でコメントアウトされていることを確認してください。
```
sseapi_pubkey_path: /etc/salt/pki/master/sseapi_key.pub

#sseapi_username:
#sseapi_password:
```
master_job_cache および event_return のエントリが sseapi に設定されていることを確認します。pgjsonb リターナは、使用できません。
次のコマンドを使用して、salt-master サービスを開始します。
```
sudo systemctl start salt-master
```

これで、アップグレードプロセスが完了しました。その他のエラーが発生した場合は、トラブルシューティングを参照してください。

アップグレードするときのベスト プラクティス