Contrast EOPをアップグレードする(Linux)

EOP サーバのアップデート手順を説明します。

新しいバージョンのインストーラを実行することで、インストール済みの EOP バージョンをアップデート可能です。

前提条件

l ユーザがEOPにアクセスしていないこと
l ディスクに十分な空き容量を確保した上で実施
l ワーキングディレクトリはCONTRASTのインストールディレクトリ
l EOPサーバが稼働している
l お客様の運用に合わせて作業前にEOPのフルバックアップ、スナップショットを取得
l LinuxのCLIでのインストール手順です。GUIモードご利用の場合、本手順通り進める為にはCLIに切り替えて実施ください。

1. インストーラの準備

最初に、Contrast Hub(ハブ)で最新のバージョンのインストーラをダウンロードします。Contrast Hub の URL は以下となります。

https://hub.contrastsecurity.com/  

2. mysqldb事前バックアップ

   2.1 データベースのバックアップ先のディレクトリを確認します。お客様のEOPをインストールしたディレクトリ配下に移動し、下記のコマンドを実行します。バックアップ先を指定するプロパティは"database.bk.dir"です。(管理者権限のあるユーザとして実行する必要がございます。お客様によってEOPをインストールしたディレクトリは異なります。例：/usr/local/contrastや/opt/contrastなど)

/usr/local/contrast$ sudo bin/edit-properties -e data/esapi/ -f data/conf/database.properties

   2.2  Contrast 準備済みのスクリプトを使用し、DB のバックアップを取得します。コマンド実行ユーザがバックアップ先のディレクトリの書き込み許可を持っている必要があります。

/usr/local/contrast$ sudo bin/backup-db.sh          

　Reading Database Configuration
　Ensuring Database Connectivity: Up
　Backing up Schema: contrast to 　/usr/local/contrast/data/backups/db/contrast.backup.20211011051923.sql

　2.3  正常にバックアップが取得出来たことを確認します。

/usr/local/contrast$ ls -lh /usr/local/contrast/data/backups/db/contrast.backup.20211011051923.sql
-rw-r--r-- 1 root root 8.4G Oct 11 05:22 contrast.backup.20211011051923.sql

3.  アップグレード

ダウンロードしたインストーラを任意のディレクトリへscpなどで移動し、インストーラの存在するディレクトリへ移動します。新しいEOP バージョンのインストーラを起動し、アップデートとして実行します。コマンド例を下記に示します。案内に従い、Enterをクリックするとアップデートが始まります。
※1 Contrast EOP のインストーラは管理者権限のあるユーザとして実行する必要があります。以下のように、 sudo コマンドを使用して、インストーラ(sh ファイル)を実行します。 

sudo sh Contrast-x.x.x.xxxx.sh 

　Unpacking JRE ...
　Starting Installer ...
　This will install Contrast Enterprise On-Premises on your computer.
　OK [o, Enter], Cancel [c]
　A previous installation has been detected. Do you wish to update that installation?
　Yes, update the existing installation [1, Enter]
　No, install into a different directory [2]
　Click Next to continue, or Cancel to exit Setup. 

　~以下省略~

　Installing Service
　contrast-server.service
　Starting Service
　Connecting to the configured MySQL Database
　Starting up Contrast on the embedded Tomcat server
　To track the progress of Contrast startup, run
　tail -f /usr/local/contrast/data/logs/contrast.log -f /usr/local/contrast/logs/server.log
　Setup has finished installing Contrast Enterprise On-Premises on your
　computer.

　Thank you for installing Contrast Enterprise on Premise. Your server should
　now be running.

　Finishing installation ...

3.  Contrast UIにログイン

アップデート後、Contrast UIにログインし右上のユーザネームをクリックし、リリースニュースの右に表示されるバージョンが更新されたことを確認ください。Contrast UIが正常に正しく表示されない場合は、ウェブブラウザのキャッシュをクリアし再度アクセスしてください。それでも正常に表示されない場合は、サポートデスクへお問い合わせください。