6.6. Ubuntu20.04(Rel-22.08～Rel-23.05)⇒Ubuntu20.04(Rel-23.13)¶

Ubuntu20.04LTS(Rel-22.08～Rel-23.05)からUbuntu20.04LTS(Rel-23.13)にバージョンアップする手順を記載します。

バージョンアップ手順の流れとしては、以下の通りとなります。

1：Shield初期インストール設定を確認
2：ポリシー設定をエクスポートして保管
3：最新のJson設定ファイルを取得
4：Ericom Shieldのアンインストールを実施
5：Ericom Shield 23.13を新規でインストールを実施
6：手順3で事前に取得したJson設定ファイルをリストアすることで設定を復元
7：設定リストア後、Shield管理コンソール上で設定状態を調整
8：Ericom Shieldが正常に動作することを確認

6.6.1. Shield初期インストール設定を確認¶

バージョンアップ作業前に、以下のShield初期インストール設定の状態を確認します。

Kubernetesクラスタでのネットワーク通信方式の設定
Ericom Shieldが利用するDockerのネットワークアドレス範囲の設定

こちらで確認した設定状態で、Ericom Shield 23.13を新規インストールする際に同設定を行いインストールする必要がありますので、必ず事前に設定状態を確認してメモしてください。

Kubernetesクラスタでのネットワーク通信方式の設定¶

デフォルトでは「Flannel方式」となります。「Calico方式」に変更している場合がありますので以下のコマンドをセットアップスクリプト(shield-setup.sh)を実行したサーバで実行してすることで確認します。

$ kubectl get pods -A -o wide | grep kube-system | grep -e flannel -e calico

Flannel方式の実行結果例

kkauser@sh01:~$ kubectl get pods -A -o wide | grep kube-system | grep -e flannel -e calico
kube-system     kube-flannel-2bk8d                                  2/2     Running     5          2y40d   192.168.100.1   sh01   <none>           <none>

Calico方式の実行結果例

kkauser@sh01:~$ kubectl get pods -A -o wide | grep kube-system | grep -e flannel -e calico
kube-system     calico-node-5l5b9                          1/1     Running     0          47m   192.168.100. 1   sh01   <none>           <none>

Ericom Shieldが利用するDockerのネットワークアドレス範囲の設定¶

デフォルトと異なるDockerのネットワークアドレス範囲を利用されている環境の場合、セットアップスクリプト(shield-setup.sh)を実行したサーバに設定変更を行う「.es_custom_env」ファイルを設置してネットワークアドレス範囲を変更してShieldをインストールしています。

以下のコマンド実行することで「.es_custom_env」ファイルが存在する場合には、ネットワークアドレス範囲の設定値が出力されますので確認します。

$ cat ~/.es_custom_env | grep -e service_cluster_ip_range -e docker0 -e cluster_cidr -e cluster_dns_server

6.6.2. ポリシー設定をエクスポートして保管¶

Shield管理コンソールにログインを行い、ポリシー設定画面にて設定のエクスポートを行い出力されたファイルを保管します。

※ こちらで出力したエクスポートファイルは、Ver23.13へバージョンアップ後にShield管理コンソール上で設定状態の調整を行う際に、ポリシー設定を比較確認して設定値を変更（調整）して保存する際に利用します。

6.6.3. 最新のJson設定ファイルを取得¶

バージョンアップ作業前に、最新のJson設定ファイルを取得します。

Json設定ファイルの保存場所は、セットアップスクリプト（shield-setup.sh）を実行したサーバにて以下のコマンドを実行することで確認できます。

cat ~/ericomshield/custom-management.yaml | grep localPath

実行例：

非冗長構成の場合（ローカルPath）

kkauser@sh01:~$ cat ~/ericomshield/custom-management.yaml | grep localPath
    localPath: /home/ericom/ericomshield/config-backup/

冗長構成の場合（NFSマウント先Path）

kkauser@sh01:~$ cat ~/ericomshield/custom-management.yaml | grep localPath
    localPath: /mnt/nfs_shield/ericomshield/config-backup/

対象Pathをｌｓコマンドで実行した場合の例

kkauser@sh01:~$ ls -l /home/ericom/ericomshield/config-backup/backup/
-rw-r--r-- 1 root root 1513669 Nov  1 22:34 backup2024-11-01-13-34-36.json
-rw-r--r-- 1 root root 1513825 Nov  1 22:34 backup2024-11-01-13-34-48.json
-rw-r--r-- 1 root root 1514281 Nov  1 22:40 backup2024-11-01-13-40-26.json

6.6.4. Ericom Shieldのアンインストールを実施¶

Ericom Shieldのアンインストールを実施します。

以下のコマンドを全てのノードで実施してアンインストールを行ってください。

$ curl -s -OL https://ericom-tec.ashisuto.co.jp/shield/delete-all.sh
$ chmod +x delete-all.sh
$ sudo -E ./delete-all.sh

6.6.5. Ericom Shield 23.13を新規でインストールを実施¶

OSバージョンアップが完了した各サーバに対して、Ericom Shield 23.13を新規でインストールを実施します。

こちらの新規インストールで実施する手順は、以下となります。

「 5.2. UbuntuOSマシン準備後の事前準備」
「 5.3. 最小構成での導入手順」or「 5.4. 冗長構成での導入手順」

⇒「ライセンスのアクティベーション」手順の前まで実施します。

6.6.6. 手順3で事前に取得したJson設定ファイルをリストアすることで設定を復元¶

ブラウザを起動し、Shieldの管理コンソールにアクセスします。( https://***.***.***.***:30181/ )

デフォルトのIDとパスワードを入力し、ログインします。（ID：admin / パスワード：ericomshield）

手順3で事前に取得したJson設定ファイルをリストアすることで設定を復元します。

リストア設定箇所：「設定＞リストア＞復元ファイルのアップロード」

リストアを実施後、設定を反映させるために、セットアップスクリプト（shield-setup.sh）を実行したサーバにて以下コマンドを実行してShieldを再起動します。

$ ~/ericomshield/shield-stop.sh
$ ~/ericomshield/shield-start.sh

6.6.7. 設定リストア後、Shield管理コンソール上で設定状態を調整¶

設定リストア後、Shield管理コンソール上で設定状態について、以下の各設定について、確認を行い必要に応じて調整を行ってください。

言語の設定¶

以下の設定を変更することで、管理コンソール上の表示言語が日本語に一時的に変更されます。

↓↓↓

以下の設定を変更して保存することで、管理コンソール上のデフォルト表示言語が日本語に変更されます。「設定＞国際化＞管理コンソールの言語を設定」：[English] ⇒ [日本語]

以下の設定を変更して保存することで、分離ブラウザのコンテキストメニュー表示言語が日本語に変更されます。

「設定＞エンドユーザオプション＞エンドユーザ言語の選択」：[なし] ⇒ [日本語]

ポリシーの設定¶

ポリシー設定の各ポリシーについて以下の２点について確認を行い、必要に応じて変更して保存してください。

以下の設定値を保管していたポリシー設定のエクスポートファイルの設置値と比較確認して設定値がリセットされている場合には、正しい値に再設定を行い保存します。
- 「ファイル操作＞ファイルアップロードの検査」
- 「ファイル操作＞ファイルダウンロードの検査」
Ver23.05以降から検査モードが実装されたことに伴い、「アクセス：許可」が「アクセス：検査」に表記が変更されました。こちらの変更に伴い、ファイルダウンロード時の挙動が変化しますので、必要に応じて、「検査」から「SSLインスペクション無しで許可」に変更して保存します。

※「アクセス：検査」についての説明は、「 8.5. アクセス「検査」ポリシーについて」を参照ください。