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.6

    ...

    sv-

    ...

    On this page:

    Table of Contents
    maxLevel2

    translation
    languageen

    You can run the installer in one of three modes. The GUI and silent installation methods are described below. To start the installer in interactive console mode, start the installer with the -c switch. The console mode prompts you for the equivalent information that appears in the GUI installer screens, as described below.

    In addition, you can run the installer using a Response file (for unattended installations). See Installing with the Silent Installer.

    About the Demo Installation

    This mode is for demonstration and light testing only. If you are using the Events Service, it must be on a separate host.

    If you do not already have an existing on-premises Controller, install it as described in Custom Install

    Installation Requirements

    To install the Demo Installation, you are required to do the following:

    • Install and run a Controller instance on the same host machine before starting the EUM Server installation.
    • Install the EUM Server with the same user account used to install the Controller, or use an account that has read, write, and execute permissions to the Controller home directory.

    Installing with the GUI Installer

    1. Start the installer: 
      • On Linux: 

        1. From a command prompt, navigate to the directory to which you downloaded the EUM Server installer. 

        2. Change permissions on the downloaded installer script to make it executable, as follows:

          No Format
          chmod 775 euem-64bit-linux-4.

    ...

        1. 5.x.x.sh
        2. Run the script as follows:

          No Format
          ./euem-64bit-linux-4.

    ...

        1. 5.x.x.sh
      • On Windows: 

        1. Open an elevated command prompt (run as administrator) and navigate to the directory to which you downloaded the EUM Server installer. 
        2. Run the installer:

          No Format
          euem-64bit-windows-4.

    ...

        1. 5.x.x.exe
    1. In the Welcome screen, click Next.
      The License Agreement page appears.  
    2. Scroll to the end of the license agreement, accept the license agreement

    ...

    1. and click Next to continue. 
    2. Select the directory in which you want to install the server and click Next.  
    3. Choose Demo for the installation mode. In this mode, the installer looks for a Controller on the current host and an Events Service on a separate host. It then installs the EUM Server on the same host as the Controller. Click Next.
      EUM Demo SetupImage Modified
    4. In the Database Setup dialog box:
      1. Enter a password in the Root User Password field.
      2. Enter and confirm a password for the eum_user database user account.
    5. In the End User Monitoring Server Setup screen:
      1. Enter the HTTP or HTTPs listening ports on the EUM Server at which the Controller will connect to the EUM Server (the default HTTP port is 7001 and HTTPS is 7002).
      2. Enter a new

    ...

      1. password in the Key Store Password and confirm it.

      EUM Server SetupImage Modified

      Warning

      Usernames and passwords can only consist of ASCII characters. In addition, passwords cannot include the characters '^', '/', or '$'.


      Note that ports shown here are the location both to which the EUM Agents send their beacons and from which the Controller fetches the processed beacon data. Click Next and click Finish.

    Post-installation Tasks

    After installing the EUM server, you must perform three additional post-installation tasks:

    • Provision the EUM license
    • Configure the Events Services properties in the eum.properties file (optional)

    • Connect the EUM server with the AppDynamics Controller

    Provision the EUM License

    To provision the EUM license:

    Tabs Container
    Width800px
    directionhorizontal
    Tabs Page
    tabNameLinux
    titleLinux
    1. Log in to your EUM Server. 
    2. Change to the directory with the script for provisioning licenses: $> cd $EUM_HOME/eum-

    ...

    1. processor
    2. Provision each license, one at a time, on the EUM Server by running the following command: $> ./bin/provision-license

    ...

    1. <PATH_TO_EUM_LICENSE>



    Note
    iconfalse

    The command needs to be run from the $EUM_HOME/eum-processor directory or it will fail.

    Tabs Page
    tabNameWindows
    titleWindows
    1. Log in to your EUM Server. 
    2. Change to the directory with the script for provisioning licenses: $> cd $EUM_HOME\eum-processor
    3. Provision each license, one at a time, on the EUM Server by running the following command: $> .\bin\provision-license.bat <PATH_TO_EUM_LICENSE>


    Note
    iconfalse

    The command needs to be run from the $EUM_HOME\eum-processor directory or it will fail.

    Configure the Events Service Properties

    For the demo installation, Events Services configuration is not required for the EUM Server to start.

    To configure the Events Service properties in the eum.properties file:

    1. Navigate to and start your Controller.
    2. Using the CLI, navigate to the bin directory.
    3. Open the eum.properties file for editing.
    4. In the eum.properties file, enter the following values:
      1. analytics.enabled=true
      2. analytics.serverHost=<hostname>, where

    ...

      1. <hostname> is the host where the event service is running
      2. analytics.accountAccessKey=<eum_key>, where <eum_key> is the Events Service key that appears as the appdynamics.es.eum.key value in the Administration Console:
        Events Service KeyImage Modified
        The configuration should appear similar to the following example:
        Example configurationImage Modified
    1. After updating the eum.properties file, restart the EUM Server.

    Connect the EUM Server with the AppDynamics Controller

    To connect the EUM server with the AppDynamics Controller:

    1. Log in to the Administration Console.
    2. Set the following Controller properties:
      1. eum.cloud.host: http://localhost:7001 – This tells you where the Controller will poll for EUM metrics
      2. eum.beacon.host: eum-host-name:7001

    ...

      1.  –  This tells you where

    ...

      1. beacons are sent for page requests made with the HTTP protocol
      2. eum.beacon.https.host:

    ...

      1. https://eum-host-name:7002 – This tells you

    ...

      1. where the beacons are sent for page requests made with the HTTPS protocol
      2. eum.mobile.screenshot.host: eum-host-name:7001 – This tells you where the Controller will look for mobile screenshots

    Anchor
    response
    response
    Installing with the Silent Installer

    Instead of using the installer in GUI mode, you can use the silent installer to perform an unattended installation. The silent installer takes a response file as a source for the initial configuration settings. It's useful for scripting installation or performing large scale deployments. 

    To use a response file for a Demo installation:

    1. Create a file named response.varfile on the machine on which you will run EUM installer with the following:

      No Format
      sys.adminRights$Boolean=false
      sys.languageId=en
      sys.installationDir=/AppDynamics/EUM
      euem.InstallationMode=demo
      euem.Host=

    ...

    1. controller
      euem.initialHeapXms=1024
      euem.maximumHeapXmx=4096
      euem.httpPort=7001
      euem.httpsPort=7002
      mysql.databasePort=3388
      mysql.databaseRootUser=root
      mysql.dbHostName=localhost
      mysql.dataDir=/usr/local/AppDynamics/EUM/data
      mysql.rootUserPassword=singcontroller
      mysql.rootUserPasswordReEnter=singcontroller
      eumDatabasePassword=secret
      eumDatabaseReEnterPassword=secret
      keyStorePassword=secret
      keyStorePasswordReEnter=secret
      eventsService.isEnabled$Boolean=true
      eventsService.serverScheme=http
      eventsService.host=eventsservice_host
      eventsService.port=9080
      eventsService.APIKey=1a234567-1234-1234-4567-ab123456
    2. Modify values of the installation parameters based on your own environment and requirements. Particularly ensure that the directory paths and passwords match your environment.  

    3. Run the installer with the following command: 

      No Format
      ./euem-64bit-linux-4.

    ...

    1. 5.x.x.sh -q -varfile response.varfile

      On Windows, use: 

      No Format
      euem-64bit-windows-4.5.x.x.exe -q -varfile response.varfile
    Sv translation
    languageja


    インストーラは3つのモードのいずれかで実行できます。GUIおよびサイレントインストールの方法を以下で説明します。インストーラをインタラクティブなコンソールモードで始めるには、-c スイッチを使用してインストーラを起動します。コンソールモードは、後述するGUIインストーラ画面に表示されるのと同等の情報を入力するよう求めます。

    また、応答ファイルを使ってインストーラを起動(無人インストール)することもできます。詳細については、「サイレントインストーラを使用したインストール作業」を参照してください。

    デモインストールについて

    このモードはデモンストレーションおよびライトテストのみを目的としています。イベントサービスを使用している場合は、別のホスト上に存在する必要があります。

    既存のオンプレミスコントローラがない場合は、「Custom Install」の説明に従ってインストールします。 

    インストール要件

    Demo環境をインストールするには、以下の作業を行う必要があります。

    • コントローラインスタンスを同じホストマシンでインストールし実行した後で、EUMサーバーのインストールを開始します。
    • コントローラをインストールした際と同じユーザーアカウントを使用するか、またはコントローラのhomeディレクトリに対して読み取り、書き取りおよび実行権限を持つアカウントを使用して、EUMサーバーをインストールします。

    GUIインストーラでのインストール

    1. 以下のようにして、インストーラを起動します。
      • Linuxの場合:

        1. コマンドプロンプトから EUM サーバインストーラをダウンロードしたディレクトリに移動します。 

        2. 以下のように、ダウンロードしたインストーラスクリプトの権限を実行可能に変更します。

          No Format
          chmod 775 euem-64bit-linux-4.5.x.x.sh
        3. 以下のようにスクリプトを実行します。

          No Format
          ./euem-64bit-linux-4.5.x.x.sh
      • Windowsの場合:

        1. 管理者特権でコマンドプロンプトを開き(管理者として実行)、EUM サーバインストーラをダウンロードしたディレクトリに移動します。 
        2. インストーラを実行。

          No Format
          euem-64bit-windows-4.5.x.x.exe
    2. ウェルカム画面で [Next] をクリックします。
      [License Agreement] ページが表示されます。  
    3. 使用許諾契約を最後までスクロールし、これに同意します。次に [Next] をクリックして先に進みます。 
    4. サーバをインストールするディレクトリを選択し、[Next] をクリックします。  
    5. インストールモードとして [Demo] を選択します。このモードでは、インストーラは現在のホストのコントローラおよび異なるホストのイベントサービスを検索します。その後、コントローラと同じホストに EUM サーバをインストールします。Next をクリックします。
      Image Added
    6. データベースのセットアップダイアログボックスで、以下のようにします。
      1. パスワードを [Root User Password] フィールドに入力します。
      2. eum_user用データベースユーザーアカウントのパスワードを入力し、確認のためもう一度入力します。
    7. End User Monitoringサーバーのセットアップ画面で以下のようにします。
      1. コントローラがEUMサーバーとの接続に使用する、EUMサーバーのHTTP用またはHTTPS用のリスニングポート(デフォルトのHTTP用ポートは7001、HTTPS用ポートは7002)を入力します。
      2. キーストア用の新しいパスワードを入力し、確認のためもう一度入力します。

      Image Added

      Warning

      ユーザー名とパスワードにはASCII文字を使用します。また、パスワードには「^」、「/」、「$」を使用できません。


      ここに示したポートは、EUM エージェントがビーコンを送信する場所であり、コントローラがビーコンの処理済みデータを取得する場所でもあります。[Next ] をクリックし、[ Finish.] をクリックします。

    インストール後のタスク

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

    • EUMライセンスの設定
    • eum.propertiesファイルのイベントサービスプロパティを構成する(オプション)

    • EUMサーバーとAppDynamicsコントローラとの接続

    EUMライセンスの設定

    EUMライセンスを設定するには、以下のようにします。

    Appd tabs container
    Width800px
    Appd tab item
    tabNameLinux
    1. EUM サーバにログインします。 
    2. ライセンスを設定するスクリプトが保存されているディレクトリに変更します。$> cd $EUM_HOME/eum-processor
    3. EUM サーバで次のコマンドを実行して、各ライセンスを設定します。コマンド 1 回につき、1 つのライセンスが設定されます。$> ./bin/provision-license <PATH_TO_EUM_LICENSE>



    Note
    iconfalse

    このコマンドは $EUM_HOME/eum-processor ディレクトリで実行する必要があります。それ以外のディレクトリで実行した場合、コマンドは失敗します。

    Appd tab item
    tabNameWindows
    1. EUM サーバにログインします。 
    2. ライセンスを設定するスクリプトが保存されているディレクトリに変更します。$> cd $EUM_HOME\eum-processor
    3. EUM サーバで次のコマンドを実行して、各ライセンスを設定します。コマンド 1 回につき、1 つのライセンスが設定されます。$> .\bin\provision-license.bat <PATH_TO_EUM_LICENSE>


    Note
    iconfalse

    このコマンドは $EUM_HOME\eum-processor ディレクトリで実行する必要があります。それ以外のディレクトリで実行した場合、コマンドは失敗します。

    イベントサービスプロパティの構成

    デモインストールの場合、EUMサーバーを起動するのにイベントサービス構成は必要ありません。

    eum.properties ファイル内のイベントサービスプロパティを構成するには、以下のようにします。

    1. コントローラに移動し、コントローラを起動します。
    2. CLI を使用して bin ディレクトリに移動します。
    3. eum.properties ファイルを開いて編集します。
    4. eum.properties ファイルに以下の値を入力します。
      1. analytics.enabled=true
      2. analytics.serverHost=<hostname>。<hostname> はイベントサービスが実行されているホストです。
      3. analytics.accountAccessKey=<eum_key>。<eum_key> はイベントサービスキーです。[Administration Console] では、appdynamics.es.eum.key の値で確認できます。
        Image Added
        この構成は、以下の例のような状態になります。
        Image Added
    5. eum.properties ファイルの更新が終わったら EUM サーバを再起動します。

    EUMサーバーとAppDynamicsコントローラとの接続

    EUMサーバーをAppDynamicsコントローラに接続するには、次のようにします。

    1. 管理コンソールにログインします。
    2. コントローラの以下のプロパティを設定します。
      1. eum.cloud.host: http://localhost:7001– コントローラが EUM のメトリックをポーリングする場所を示します。
      2. eum.beacon.host: eum-host-name:7001 – HTTP プロトコルを介したページリクエストに対してどこにビーコンが送信されるかを示します。
      3. eum.beacon.https.host: https://eum-host-name:7002– HTTPS プロトコルを介したページリクエストに対してどこにビーコンが送信されるかを示します。
      4. eum.mobile.screenshot.host: eum-host-name:7001– コントローラがモバイルスクリーンショットを検索する場所を示します。

    Anchor
    response
    response
    サイレントインストーラを使用したインストール作業

    GUIモードでインストーラを使用する代わりに、サイレントインストーラを使用して無人インストールを実行することができます。サイレントインストーラは応答ファイルを初期構成設定用のソースとして使用します。これはインストール作業のスクリプト化や大規模なデプロイを実行する際に有用です。 

    Demoのインストール作業で応答ファイルを使用する場合は、以下のようにします。

    1. EUM インストーラを実行するマシン上に response.varfile という名前のファイルを作成します。使用する情報は 以下のとおりです。

      No Format
      sys.adminRights$Boolean=false
      sys.languageId=en
      sys.installationDir=/AppDynamics/EUM
      euem.InstallationMode=demo
      euem.Host=controller
      euem.initialHeapXms=1024
      euem.maximumHeapXmx=4096
      euem.httpPort=7001
      euem.httpsPort=7002
      mysql.databasePort=3388
      mysql.databaseRootUser=root
      mysql.dbHostName=localhost
      mysql.dataDir=/usr/local/AppDynamics/EUM/data
      mysql.rootUserPassword=singcontroller
      mysql.rootUserPasswordReEnter=singcontroller
      eumDatabasePassword=secret
      eumDatabaseReEnterPassword=secret
      keyStorePassword=secret
      keyStorePasswordReEnter=secret
      eventsService.isEnabled$Boolean=true
      eventsService.serverScheme=http
      eventsService.host=eventsservice_host
      eventsService.port=9080
      eventsService.APIKey=1a234567-1234-1234-4567-ab123456
    2. インストールパラメータの値をご使用の環境および要件に応じて変更します。特に、ディレクトリパスとパスワードがご使用の環境と一致することを確認します。  

    3. 次のコマンドを使用してインストーラを実行します。

      No Format
      ./euem-64bit-linux-4.5.x.x.sh -q -varfile response.varfile

      Windowsの場合、以下を使用します。

      No Format
      euem-64bit-windows-4.5.x.x.exe -q -varfile response.varfile