Versions Compared

    Key

    • This line was added.
    • This line was removed.
    • Formatting was changed.
    Comment: Published by Scroll Versions from this space and version 20.8
    Sv translation
    languageen

    You run the Synthetic Server installer from the command line. The installer relies on theinputs.groovy file to configure the network connections to the on-premises EUM Server, and if you are using Synthetic Hosted Agents, to the SaaS EUM Server and SaaS Synthetic Server as well.

    To install the Synthetic Server, follow the steps below:

    Table of Contents
    outlinetrue
    stylenone

    Prepare for the Installation

    Before starting the installation, verify that you have:

    • Successfully deployed the Controller, EUM Server, and the Events Service.
    • Downloaded the Synthetic Server installer package from the AppDynamics Download Center. The installer package will be listed on the Downloads site as "Synthetic Server (zip)".

    Grant Access to the EUM Server MySQL Database 
    Anchor
    grant-privileges
    grant-privileges

    The Synthetic Server installer modifies the EUM MySQL database schema and the Synthetic Server stores data in the EUM MySQL database. Thus, you will need to grant MySQL users from the machine hosting the Synthetic Server privilege to the EUM Server's MySQL database.

    1. Log on to the machine where the EUM MySQL database is located.
    2. Connect to the MySQL Server with the EUM Server database. For example, if you are using the default EUM MySQL database, do the following:
      1. Change to <installDir>/AppDynamics/EUM.
      2. Connect to the EUM MySQL database:

        Code Block
        languagebash
        mysql/bin/mysql -u root -h <eum_server_hostname> -P <eum_server_mysql_port> -p 
    3. From the MySQL monitor, grant privileges to the MySQL user root of the Synthetic Server machine. The installer will use the MySQL user root to update the EUM database schema. Be sure to replace <on-prem-synthetic_server_hostname> with the URL to your Synthetic Server.

      Code Block
      languagesql
      mysql> GRANT ALL PRIVILEGES ON eum_db.* TO 'root'@'<on-prem_synthetic_server_hostname>' IDENTIFIED BY <db-root-password>;;
      Info

      The MySQL root user from the Synthetic Server is not related to the Linux user account that is installing the Synthetic Server. For example, the Linux user account ubuntu can run the installer, but the installer will use the MySQL user root when connecting to the EUM Server MySQL database to update the database schema.

    4. You will also need to grant access to the MySQL user eum_user to write data to the EUM database (eum_db). Be sure to replace <on-prem-synthetic_server_hostname> with the URL to your Synthetic Server.

      Code Block
      languagesql
      mysql> GRANT ALL PRIVILEGES ON eum_db.* TO 'eum_user'@'<on-prem_synthetic_server_hostname>' IDENTIFIED BY <db_eum_user_password>;
    5. Set the password for the MySQL user root. The password should be the same as the one specified by the db_root_pwd in the inputs.groovy file.

      Code Block
      languagesql
      mysql> SET PASSWORD FOR 'root'@'<on-prem-synthetic_server_hostname>' = PASSWORD('<root_password>');
    6. Confirm that you have granted permission for eum_user and root:

      Code Block
      languagesql
      show grants for eum_user@<on-prem_synthetic_server_hostname>;
      show grants for root@<on-prem_synthetic_server_hostname>;

    Unzip the Synthetic Server Installer Package

    1. Copy the Synthetic Server installer package (appdynamics-synthetic-server-<version>.zip) to the machine that will be hosting the Synthetic Server.
    2. Create a directory for storing the Synthetic Server installer, such as synthetic-server.
    3. Move the Synthetic Server installer package to the directory you created.
    4. Change to the directory you created for storing the Synthetic Server installer.
    5. Unzip the Synthetic Server installer package.

    Configure the Installation

    1. From a command prompt, navigate to the directory where you unzipped the Synthetic Server installer package.

    2. Copy the sample configuration file: cp inputs.groovy.sample inputs.groovy
    3. Edit the file inputs.groovy and make changes to the properties listed below:

      PropertyChange to MakeDescription
      db_hostAssign the URL to the machine hosting your on-premises EUM Server to the db_host property. The public DNS to the machine hosting the EUM Server.
      db_portChange the value to "3388". This is the default port for the EUM Server's MySQL database.The port that the EUM Server's MySQL database is listening on.
      db_usernameChange the value to eum_user. This is the default user for the EUM Server.The MySQL user that accesses the EUM Server's MySQL database.
      db_passwordAssign the password for the MySQL user eum_user to remotely access the EUM Server's MySQL database. The password that you set for the user that is specified by db_username. The value of db_username should be eum_user.
      collector_hostAssign the public DNS to the machine hosting your on-premises EUM Server to the collector_host property.The public DNS to the machine hosting the EUM Server.
      collector_portConfirm that the value is "7001". This is the default port of the EUM Server.The port that the EUM API Server and EUM Collector are listening on. The default is '7001'.
      key_store_passwordAssign the key store password you set when installing your on-premises EUM Server to the key_store_password property.The key store password you set during the installation of the EUM Server.

      localFileStoreRootPath

      Assign a file path where you want the Synthetic Server to store data to the localFileStoreRootPath property. The Synthetic Server must be able to read and write to the path and the files in the path.The path where the Synthetic Server stores data such as the measurement results and the screenshots.

    Run the Installer

    From the root directory of the installer, run the following command as the root user.

    Code Block
    languagebash
     unix/deploy.sh install

    In the output from the install command, you should see the log of completed tasks similar to the following:

    Code Block
    languagebash
    Task [facts for localhost] completed executing in [274] ms.
    Task [Create the encryption directory] completed executing in [78] ms.
    Task [Create keystore for encryption] completed executing in [796] ms.
    Task [Create the encrypted password] completed executing in [566] ms.
    Task [Obfuscate the key store password] completed executing in [397] ms.
    Task [Read created password] completed executing in [46] ms.
    Task [Read the obfuscated key store password] completed executing in [43] ms.
    Task [Change configurations for the shepherd and scheduler conf] completed executing in [81] ms.
    Task [Read created password] completed executing in [24] ms.
    Task [Read the obfuscated key store password] completed executing in [26] ms.
    Task [Change configurations for the shepherd and scheduler conf] completed executing in [76] ms.
    Task [Read created password] completed executing in [29] ms.
    Task [Read the obfuscated key store password] completed executing in [20] ms.
    Task [Change configurations for the shepherd and scheduler conf] completed executing in [31] ms.
    Task [Delete the encryption directory] completed executing in [47] ms.
    Task [Change configurations for the liquibase properties file] completed executing in [26] ms.
    Task [Update schema of SQL DB to include synthetic schema] completed executing in [2412] ms.
    Task [Install flake8 for script linting] completed executing in [1671] ms.
    Task [Start the synthetic services] completed executing in [67] ms.

    Verify the Installation Was Successful

    1. Confirm that the Synthetic Server is running:

      Code Block
      languagebash
      ps aux | grep synthetic-processor
      Info

      If you have jps installed, you can also just run it to verify the Synthetic Server are running.

    2. Verify that the Synthetic Scheduler and Synthetic Shepherd are listening on the default ports:

      Code Block
      languagebash
       netstat -lan | grep "1[0,2,6]10[1,2]"
    3. With mysql installed on the Synthetic Server machine, you can verify that the Synthetic Server machine can connect to the EUM Server MySQL eum_db database:

      Code Block
      languagebash
      mysql -h <eum_server_instance> -P 3338 -D eum_db -u eum_user -p
    4. If you cannot connect to the EUM Server MySQL database, return to Grant Privileges to the EUM Server MySQL Database and complete the steps again. 

    Perform Post-installation Tasks

    After installing the Synthetic Server, perform the following additional post-installation tasks:

    1. Configure the Controller for the Synthetic Server
    2. Install Synthetic Private Agents (Optional)
    3. Make configurations to use one or both of the Synthetic Agents:
      1. Synthetic Private Agent
      2. Synthetic Hosted Agent
    4. Secure the Synthetic Server (Recommended)
    5. Monitor the Synthetic Server (Recommended)
    Sv translation
    languageja

    Appd tocbox

    On this page:

    Table of Contents
    maxLevel2

    コマンドラインから合成サーバーインストーラを実行します。インストーラは、inputs.groovy ファイルに依存し、オンプレミス EUM サーバへのネットワーク接続を設定します。また、合成ホステッドエージェントを使用している場合は、SaaS EUM サーバと SaaS 合成サーバにもネットワーク接続を設定します。

    合成サーバーをインストールするには、以下の手順に従います。

    Table of Contents
    outlinetrue
    stylenone

    インストールの準備

    インストールを開始する前に、以下が完了していることを確認してください。

    • コントローラ、EUM サーバ、イベントサービスが正常に展開されている。
    • AppDynamics ダウンロードセンターから合成サーバ インストーラ パッケージがダウンロードされている。インストーラパッケージは、「合成サーバ(zip)」としてダウンロードサイトに表示されます。

    EUMサーバーのMySQLデータベースへのアクセス権の付与
    Anchor
    grant-privileges
    grant-privileges

    合成サーバインストーラが EUM MySQL データベーススキーマを変更し、合成サーバが EUM MySQL データベースにデータを保存します。そのため、合成サーバをホストするマシンから MySQL ユーザに EUM サーバの MySQL データベースへの権限を付与する必要があります。

    1. EUM MySQLデータベースが配置されているマシンにログオンします。
    2. EUMサーバーデータベースを搭載したMySQLサーバーに接続します。たとえば、デフォルトのEUM MySQLデータベースを使用している場合、以下を行います。
      1. <installDir>/AppDynamics/EUM に変更します。
      2. EUM MySQLデータベースに接続します。

        Code Block
        languagebash
        mysql/bin/mysql -u root -p --socket <installDir>/AppDynamics/EUM/mysql/mysql.sock
    3. MySQL モニタから、合成サーバマシンの MySQL ユーザ root に権限を付与します。インストーラは MySQL ユーザ root を使用して EUM データベーススキーマを更新します。<on-prem-synthetic_server_hostname> を合成サーバの URL に必ず置き換えてください。

      Code Block
      languagesql
      mysql> GRANT ALL PRIVILEGES ON eum_db.* TO 'root'@'<on-prem-synthetic_server_hostname>';
      Info

      合成サーバの MySQL root ユーザは、合成サーバをインストールしている Linux ユーザアカウントとは関係ありません。たとえば、Linux ユーザアカウント ubuntu はインストーラを実行できますが、インストーラは EUM サーバ MySQL データベースに接続してデータベーススキーマを更新するときに MySQL ユーザ root を使用します。

    4. また、データを EUM データベース(eum_db)に書き込むために MySQL ユーザ eum_user へのアクセス権を付与する必要があります。<on-prem-synthetic_server_hostname> を合成サーバの URL に必ず置き換えてください。

      Code Block
      languagesql
      mysql> GRANT ALL PRIVILEGES ON eum_db.* TO 'eum_user'@'<on-prem-synthetic_server_hostname>';
    5. MySQL ユーザ root. のパスワードを設定します。パスワードは、inputs.groovy ファイル内の db_root_pwd で指定されたパスワードと同じである必要があります。

      Code Block
      languagesql
      mysql> SET PASSWORD FOR 'root'@'<on-prem-synthetic_server_hostname>' = PASSWORD('<root_password>');
    6. eum_user と root に権限が付与されていることを確認します。

      Code Block
      languagesql
      show grants for eum_user@<on-prem-synthetic_server_hostname>;
      show grants for root@<on-prem-synthetic_server_hostname>;

    合成サーバーインストーラパッケージを解凍します

    1. 合成サーバ インストーラ パッケージ(appdynamics-synthetic-server-<version>.zip)を、合成サーバをホストするマシンにコピーします。
    2. 合成サーバインストーラを保存するディレクトリ(synthetic-server など)を作成します。
    3. 合成サーバーインストーラパッケージを、作成したディレクトリに移動します。
    4. 合成サーバーインストーラの保存用に作成したディレクトリに変更します。
    5. 合成サーバーインストーラパッケージを解凍します。

    インストールの構成

    1. コマンドプロンプトから、合成サーバーインストーラパッケージを解凍したディレクトリに移動します。

    2. サンプル構成ファイルをコピーします。cp inputs.groovy.sample inputs.groovy
    3. ファイル inputs.groovy を編集して、プロパティを以下のように変更します。

      プロパティ必要な変更説明
      db_hostオンプレミス EUM サーバをホストするマシンの URL を db_host プロパティに割り当てます。 EUMサーバーをホストするマシンの公開DNS。
      db_port値を「3388」に変更します。これは、EUMサーバーのMySQLデータベースのデフォルトポートです。EUM サーバの MySQL データベースがリスンしているポート。
      db_username値を "eum_user" に変更します。これはEUMサーバーのデフォルトユーザーです。EUM サーバの MySQL データベースにアクセスする MySQL ユーザ。
      db_passwordEUM サーバの MySQL データベースにリモートアクセスするための MySQL ユーザ eum_user のパスワードを割り当てます。 db_username で指定されたユーザに対して設定したパスワード。db_username の値は eum_user である必要があります。
      collector_hostオンプレミス EUM サーバをホストするマシンの公開 DNS を collector_host プロパティに割り当てます。EUMサーバーをホストするマシンの公開DNS。
      collector_port値が「7001」であることを確認します。これは、EUMサーバーのデフォルトポートです。EUM API サーバとの EUM コレクタがリスンしているポート。デフォルトは「7001」です。
      key_store_passwordオンプレミス EUM サーバのインストール時に設定したキーストアパスワードを key_store_password プロパティに割り当てます。EUMサーバーのインストール中に設定したキーストアパスワード。

      localFileStoreRootPath

      合成サーバでデータを保存するファイルパスを localFileStoreRootPath プロパティに割り当てます。合成サーバーはそのパスとパス内のファイルに対し、読み取りおよび書き込みできる必要があります。合成サーバーが測定結果やスクリーンショットなどのデータを保存するパス。

    インストーラの実行

    インストーラの root ディレクトリから、root ユーザとして次のコマンドを実行します。

    Code Block
    languagebash
     unix/deploy.sh install

    install コマンドの出力には、以下のような完了したタスクのログが表示されます。

    Code Block
    languagebash
    Task [facts for localhost] completed executing in [274] ms.
    Task [Create the encryption directory] completed executing in [78] ms.
    Task [Create keystore for encryption] completed executing in [796] ms.
    Task [Create the encrypted password] completed executing in [566] ms.
    Task [Obfuscate the key store password] completed executing in [397] ms.
    Task [Read created password] completed executing in [46] ms.
    Task [Read the obfuscated key store password] completed executing in [43] ms.
    Task [Change configurations for the shepherd and scheduler conf] completed executing in [81] ms.
    Task [Read created password] completed executing in [24] ms.
    Task [Read the obfuscated key store password] completed executing in [26] ms.
    Task [Change configurations for the shepherd and scheduler conf] completed executing in [76] ms.
    Task [Read created password] completed executing in [29] ms.
    Task [Read the obfuscated key store password] completed executing in [20] ms.
    Task [Change configurations for the shepherd and scheduler conf] completed executing in [31] ms.
    Task [Delete the encryption directory] completed executing in [47] ms.
    Task [Change configurations for the liquibase properties file] completed executing in [26] ms.
    Task [Update schema of SQL DB to include synthetic schema] completed executing in [2412] ms.
    Task [Install flake8 for script linting] completed executing in [1671] ms.
    Task [Start the synthetic services] completed executing in [67] ms.

    インストールの成功の確認

    1. 合成サーバが実行されていることを確認します。

      Code Block
      languagebash
      ps aux | grep synthetic-processor
      Info

      jps がインストールされている場合、これを実行して、合成サーバが実行されていることを確認することもできます。

    2. 合成スケジューラと合成シェパードがデフォルトポートをリスンしていることを確認します。

      Code Block
      languagebash
       netstat -lan | grep "1[0,2,6]10[1,2]"
    3. 合成サーバマシンにmysqlがインストールされている場合、合成サーバマシンが EUM サーバの MySQL eum_db データベースに接続できることを確認できます。

      Code Block
      languagebash
      mysql -h <eum_server_instance> -P 3338 -D eum_db -u eum_user -p
    4. EUM サーバの MySQL データベースに接続できない場合には、EUM サーバの MySQL データベースへの権限の付与に戻って手順を再実行してください。 

    インストール後タスクの実行

    合成サーバをインストールした後、さらに以下のインストール後タスクを実行する必要があります。

    1. Configure the Controller for the Synthetic Server
    2. 合成プライベートエージェントのインストール(オプション)
    3. 次のいずれかまたは両方の合成エージェントを使用するように設定します。
      1. 合成プライベートエージェント
      2. 合成ホステッドエージェント
    4. 合成サーバのセキュリティ保護(推奨)
    5. Monitor the Synthetic Server (推奨)