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

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

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

はじめる前に

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

アップグレードの手順

以下の手順は、EUM サーバを最新バージョンの実稼働 EUM サーバにアップグレードする方法を示しています。EUM サーバ 4.4 では、EUM MySQL データベースがコントローラのホストマシンから EUM サーバのホストマシンに移動したため、4.4 よりも前のバージョンから最新バージョンにデータを移行する際は以下の通りさまざまな手順があります。EUM サーバ 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 ファイルを編集して、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.httpsProductiontrue に設定し、使用する 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

EUM サーバでの SSL の使用

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