実稼働EUMサーバーのアップグレード

EUM サーバ 4.4 以降を最新の実稼働インストールにアップグレードするには、使用している EUM サーバのバージョンに該当する以下の手順に従います。

1. MySQL を使用しているプロセスがないことを確認します。 

   • 端末と IDE を使用してログインした場合は、MySQL データベースからログアウトします。
   • MySQL ディレクトリを終了します。
2. EUM サーバを停止します。EUM MySQLデータベースは停止しません。
3. 予防措置として古いEUMデータをバックアップします。
   1. サーバホストで、<eum_server_home>（つまり <installDir>/AppDynamics/EUM）ディレクトリを安全な場所にコピーすることによって、古いバージョンをバックアップします。
   2. <eum_server_home>/eum-processor/bin/liquibase.properties ファイルを編集して、password プロパティのパスワードを設定します。

   3. ターミナルで、<eum_server_home>/mysql/bin に移動して、データベース eum_db をファイルにダンプします。

      ./mysqldump -u root -p --databases eum_db -h <eum_server_host> -P <eum_mysql_port>  -S </path/to/socket> --add-drop-database >eum_db1.mysql

      BASH

4. EUM ホストマシンで最新の EUM サーバ（20.3 以降）のインストーラを実行し、指示される手順に従います。詳細な手順については、「実稼働EUMサーバーのインストール」を参照してください。

5. 古いバージョンの EUM サーバで HTTPS プロキシを使用せずに HTTPS を使用していた場合は、<eum_server_home>/eum-processor/bin/eum.properties ファイルを編集して、プロパティprocessorServer.httpsProduction を true に設定し、使用する HTTPS ポートをプロパティ processorServer.httpsPort に割り当てます。

   HTTPS リクエストを受け入れるように EUM サーバを構成するのではなく、EUM サーバに対して HTTPS リバースプロキシを使用することを強くお勧めします。

6. eum.properties で設定をカスタマイズしていた場合は、以下の操作を行う必要があります。

   1. それらのカスタムプロパティを使用して、EUM の新しいインストールの eum.properties を更新します。

   2. 新しいバージョンのEUMサーバーを停止してから起動します。

7. EUMサーバーに対してcURLリクエストを実行することで、EUMサーバーが実行中であることを確認します。以下に示すように、サーバは ping で応答します。

   curl http(s)://<eum_server_host>:<port>/eumcollector/ping
   ping

   BASH

1. MySQL を使用しているプロセスがないことを確認します。 

   • 端末と IDE を使用してログインした場合は、MySQL データベースからログアウトします。
   • MySQL ディレクトリを終了します。
2. EUM サーバを停止します。
3. 新しくインストールしたEUMサーバーに後で移植するために、古いEUMデータをバックアップします。
   1. 古い EUM サーバのホストマシンから、<eum_server_home>（つまり <installDir>/AppDynamics/EUM）ディレクトリを安全な場所にコピーして、データをバックアップします。

   2. コントローラのホストマシンから、<controller_home>/mysql/bin に変更し、データベース eum_db を次のファイルにダンプします。

      ./mysqldump -u root --password --protocol=TCP -P [Controller-MySQL-Port] --databases eum_db --add-drop-database --socket=<controller_home>/mysql/mysql.sock > eum_db.sql

4. EUM サーバのホストマシンで最新の EUM サーバインストーラを実行し、指示される手順に従います。詳細な手順については、「実稼働EUMサーバーのインストール」を参照してください。

5. インストールした EUM サーバを停止します（EUM MySQL データベースは停止しないでください。EUM サーバの処理のみを停止します）。

6. 古い EUM データ（ファイルベースおよび MySQL データ）を新しい実稼働 EUM サーバにインポートします。
   

   1. ファイルベースのデータを、EUM サーバの古いバージョンから（ステップ 2a を参照）最新 EUM サーバのホストマシンの <eum_server_home>/store/ ディレクトリにコピーします。

      cp -r <old_eum_server_home>/store/* <new_eum_server_home>/store/

   2. <eum_server_home>/eum-processor/bin/liquibase.properties ファイルを編集して、password プロパティのパスワードを設定します。
   3. <eum_server_home>/mysql/bin に移動します。
   4. 新しい EUM MySQL インスタンスでデータベース eum_db にあるテーブルをすべてドロップします。
      

      1. ドロップする必要があるテーブルのリストを取得します。

         ./mysql -u eum_user --password eum_db --protocol=TCP -P [EUM-MySQL-Port] --socket=<eum_server_home>/mysql/mysql.sock -e "show tables"

      2. 表示されているテーブルのリストで、ドロップする各テーブルに対して次のコマンドを実行します。[tableName] は、ドロップするテーブルの名前に置き換えます。

         ./mysql -u eum_user --password eum_db --protocol=TCP -P [EUM-MySQL-Port] --socket=<eum_server_home>/mysql/mysql.sock -e "drop table [tableName]"

   5. コントローラのホストマシン（ステップ 2b を参照）から新しいデータベースとなる EUM データベースへ、バックアップした MySQL テーブルをインポートします。
      EUM Server 4.3

      ./mysql -u root --password --protocol=TCP -P [EUM-MySQL-Port] --socket=<eum_server_home>/mysql/mysql.sock < <controller_home>/db/bin/eum_db.sql

      EUM Server 4.0+
      4.0.7.0、4.0.8、4.0.9、4.0.10、または4.1.xからアップグレードする場合は、以下のコマンドを実行します。

      ./mysql -u root --password --protocol=TCP -P [EUM-MySQL-Port] --socket=<eum_server_home>/mysql/mysql.sock < <controller_home>/db/bin/eum_db.sql ./mysql -u root -p eum_db --protocol=TCP -P [EUM-MySQL-Por] --socket=<eum_server_home>/mysql/mysql.sock < <eum_server_home>/eum-processor/bin/407to410.sql

   6. スキーマを最新バージョンへアップグレードします。

      cd <eum_server_home>/eum-processor/bin/ bash ./eum-schema update

   7. データベースが設定されたら、<eum_server_home>/eum-processor/bin/liquibase.properties ファイル内でプロパティのパスワードを削除するか、または置き換えます。

7. 古いバージョンの EUM サーバで HTTPS プロキシを使用せずに HTTPS を使用していた場合は、<eum_server_home>/eum-processor/bin/eum.properties ファイルを編集して、processorServer.httpsProduction  プロパティを true に設定し、HTTPS ポートをプロパティ processorServer.httpsPort に割り当てます。

   HTTPS リクエストを受け入れるように EUM サーバを構成するのではなく、EUM サーバに対して HTTPS リバースプロキシを使用することを強くお勧めします。

8. eum.properties で設定をカスタマイズしていた場合は、以下の操作を行う必要があります。

   1. それらのカスタムプロパティを使用して、EUM の新しいインストールの eum.properties を更新します。

9. EUMサーバーを再起動します。

10. EUMサーバーに対してcURLリクエストを実行することで、EUMサーバーが実行中であることを確認します。以下に示すように、サーバは ping で応答します。

    curl http(s)://<eum_server_host>:<port>/eumcollector/ping ping