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

このページでは、EUM サーバを最新の実稼働インストールにアップグレードする方法について説明します。このアップグレードは通常、コントローラやイベントサービスなどの他のプラットフォーム コンポーネントのアップグレードとともに行われます。

このドキュメントの対象ユーザー

このドキュメントは、EUMサーバーを利用可能な最新バージョンにアップグレードするユーザーを対象としています。

はじめる前に

EUM サーバーのアップグレードを開始する前に、正しい更新順序に従っていることを確認します。

アップグレードの手順

以下の手順は、EUM サーバーを最新バージョンの実稼働 EUM サーバーにアップグレードする方法を示しています。EUM サーバ 4.4 では、EUM MySQL データベースがコントローラのホストマシンから EUM サーバのホストマシンに移動したため、4.4 よりも前のバージョンから最新バージョンにデータを移行する際は以下の通りさまざまな手順があります。EUM サーバ 4.4 以降から最新バージョンにアップグレードする場合は、データを移行する必要はありませんが、データのバックアップを作成することをお勧めします。

4.4 以降から最新バージョンへのアップグレード

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 を編集し、パスワードプロパティにパスワードを設定します。
    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
  4. EUM ホストマシンで最新の EUM サーバ（20.3 以降）のインストーラを実行し、指示される手順に従います。詳細な手順については、「実稼働 EUM サーバーのインストール」を参照してください。
  5. 古いバージョンの EUM サーバーが HTTPS プロキシではなく HTTPS を使用していた場合は、ファイル <eum_server_home>/eum-processor/bin/eum.properties を編集し、プロパティ processorServer.httpsProduction を true に設定し、プロパティ processorServer.httpsPort に HTTPS ポートを割り当てます。
    注: 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

4.4 より前から最新バージョンへのアップグレード

  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 を編集し、パスワードプロパティにパスワードを設定します。
    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 サーバー 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 サーバー 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 に設定し、プロパティ processorServer.httpsPort に HTTPS ポートを割り当てます。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

EUM サーバーでの SSL の使用

EUM サーバ 4.5.6 以降にアップグレードする場合は、パフォーマンスの問題を回避するために、EUM サーバにバンドルされている JRE のバージョンを 1.8.0_152 にダウングレードすることをお勧めします。