Deploy GE Digital APM for the First Time

The following table outlines the steps that you must complete to deploy and configure GE Digital APM for the first time. After you have completed these steps, you will need to perform additional steps to configure the modules that you have purchased.

These tasks may be completed by multiple people in your organization. We recommend, however, that the tasks be completed in the order in which they are listed. All steps are required unless otherwise noted.

Step

Task

Notes

1

Ensure that your system meets the hardware and software requirements for the basic GE Digital APM system architecture.

This step is required.
2

Review how the operating systems are configured in the GE Digital APM testing environment. To configure your system to match the GE Digital APM testing environment, you need to:

This step is required. It is recommended that you configure your system to match the configuration used in the GE Digital APM testing environment.
3

On the server on which you will install Elasticsearch, download and install OpenJDK V1.8.0_111 or Oracle JDK V1.8.0_73.

Important: The versions higher than V1.8.0_XX are not currently supported. You may need to disable automatic updates for Java. For more information, refer to the topic Java Update Options found in the official https://www.java.com/en/download/help/java_update.xml.

After the installation is complete, create a JAVA HOME system environment variable for the installed version as shown in the following examples:

  • Example of system environment variable for OpenJDK V1.8.0_181-b13

    JAVA_HOME=C:\Program Files\Java\java-1.8.0-openjdk-1.8.0.181-1.b13.redhat.windows.x86_64

  • Example of system environment variable for Oracle JDK V1.8.0_73

    JAVA_HOME=C:\Program Files\Java\jdk1.8.0_73

Enter the following command to verify the environment variable.
echo %JAVA_HOME%
Note:
  • The JAVA HOME variable should match the full version string of OpenJDK or Oracle JDK that you installed, and its installation location.
  • For additional information regarding Java support for Elasticsearch, consult https://www.elastic.co/guide/index.html.

This step is required. Ensure that you complete this step on the server on which you will install Elasticsearch.

Note:

For optimum system performance, GE Digital APM recommends that you install Elasticsearch on its own, dedicated server that contains no GE Digital APM components.

Important: Any time you update OpenJDK or Oracle JDK, you will need to re-enter this environment variable.
4 Install the GE Digital APM Server and add-ons software on each computer that will serve as a GE Digital APM Server.This step is required.
5Install Redis on the GE Digital Redis server (Linux server).This step is required.
Note: The last supported Redis version for Windows contains Common Vulnerabilities and Exposures (CVE). Therefore, we recommend that you install Redis on a Linux server. However, if you want to install Redis on a Windows server, refer to the Install Redis on the GE Digital APM and Redis servers (Windows server) topic.
6Install Elasticsearch on a dedicated server.This step is required. You must install Elasticsearch on a server in your environment.
7

Deploy the GE Digital APM Database Server, which includes creating and configuring your GE Digital APM database.

This step is required.
8

Deploy the GE Digital APM SQL Server Report Server.

This step is required.
9

Create security user records for the individuals who will need to log in to GE Digital APM applications.

This step is required.
10

Activate licensed modules and products .

This step is required.
11

If you want to use non-English translations in GE Digital APM, deploy translations.

This step is required only if you want to deploy translations.
12If required, configure one of the virtual machine to execute all the scheduled jobs. This step is required only if you have deployed the GE Digital APM in a clustered environment and you want to dedicate a virtual machine to run all the scheduled jobs.
13If required, deploy the GE Digital APM mobile application on mobile devices.This step is required only if you are deploying the GE Digital APM mobile application on mobile devices.
14If required, enable single sign-on for on-site or off-site authentication.This step is required only if you are enabling single sign-on.