GE Digital Solutions
APM Classic
Copyright © 2023 General Electric Company. All rights reserved. | Privacy | Terms | Cookies
  • Installation
    • The Basic GE Digital APM System Architecture
    • First Time Installation
      • GE Digital APM First-time Deployment
      • Operating System Configuration in GE Digital APM Testing Environment
      • GE Digital APM Server Roles and Features
      • GE Digital APM Server First-time Installation
      • Redis on Linux Installation
      • Elasticsearch Installation
      • ActiveMQ Installation
      • Database Server Installation
      • Initial Data Source Creation
      • SQL Server Report Server First-Time Installation
      • Reporting Server Configuration
      • Security User Creation
      • Activate License
      • Translations Deployment
      • Server Configuration for Scheduled Jobs
      • Mobile Application
      • Single Sign On
      • IIS Configuration
      • Module Deployment
    • GE Digital APM Upgrade
    • Manage the GE Digital APM Database Comparison Tool
  1. Home
  2. Installation
  3. First Time Installation
  4. Elasticsearch Installation
Expand display

Elasticsearch Installation

Install Elasticsearch on a Dedicated Server

Procedure

  1. On the server on which you want to install Elasticsearch, install one of the following:
    • OpenJDK V11
      1. Download OpenJDK 11 (LTS) from the AdoptOpenJDK website.

        The OpenJDK 11 installer is downloaded to your local drive.

      2. Run the OpenJDK 11 installer and follow the instructions in the wizard.
      3. In the Custom Setup page, select the Set JAVA_HOME variable menu, and then select Will be installed on local hard drive.
      4. When the installation is complete, close the OpenJDK 11 installer.
    • Oracle JDK V11
      1. Download and install Oracle JDK V11.
      2. Configure the JAVA_HOME environment variable to point Elasticsearch to the Java installation directory, and then add Java to the Path system variable.
        Note: For more information on how to configure the JAVA_HOME environment variable, refer to the Oracle documentation.
  2. Download the ZIP file for Windows, elasticsearch-7.9.3.zip, from the official Elasticsearch 7.9.3 Downloads page.
  3. Extract the contents of the zip file to C:\ElasticSearch.
  4. Go to C:\ElasticSearch\elasticsearch-7.9.3\config, and then access the elasticsearch.yml file.
  5. In the .yml file, uncomment the following properties, and then modify the values to match those shown here:
    cluster.name: apm-cluster
    node.name: ${COMPUTERNAME}
    path.data: /ProgramData/Meridium/ElasticSearch
    path.logs: /ProgramData/Meridium/Logs
    bootstrap.memory_lock: true
    network.host: 0.0.0.0
    http.port: 9200
    action.destructive_requires_name: true
  6. Save and close the .yml file.
  7. Select the Start button on Windows, right-click Command Prompt, and then select Run as administrator.
    The Command Prompt window appears.
  8. At the command prompt, enter cd C:\ElasticSearch\elasticsearch-7.9.3\bin, and then press Enter.
  9. At the command prompt, enter elasticsearch-service install, and then press Enter.
    Elasticsearch is installed.
  10. Access the Microsoft Management Console (services.msc) and perform the following operations for the Elasticsearch service:
    • Verify that the service runs as Local System.
    • Modify the startup to be Automatic.
    • Start the service to verify installation and configuration.
  11. On the server on which Elasticsearch is installed, go to http://localhost:9200/ in a web browser, and ensure that Elasticsearch runs successfully.
    A response that is similar to the following sample appears.
    {
    "name" : "apm-node",
    "cluster_name" : "apm-cluster",
    "cluster_uuid" : "58cS6NyzQJOLZ8Xr1e3vkg",
    "version" : {
    "number" : "7.9.3",
    "build_hash" : "3adb13b",
    "build_date" : "2017-03-23T03:31:50.652Z",
    "build_snapshot" : false,
    "lucene_version" : "6.4.1"
    },
  12. On the server on which Elasticsearch is installed, go to http://[elastic-search-server]:9200/ in a web browser, and ensure that Elasticsearch runs successfully.
    A response that is similar to the sample provided in the previous step appears.
  13. On the GE Digital APM server, go to C:\ProgramData\Meridium\MeridiumAppSettings.xml.
  14. As needed, modify the following values.
    <!-- Search and Elastic Services -->
    <add key="searchServiceUrl" value="http://localhost:9199" />
    <add key="elasticServiceUrl" value="http://<name of Elastic Search server>:9200" />
  15. After all third-party services are configured, reset IIS and services on all GE Digital APM App Servers.

What To Do Next

  • Add User Authentication for Elasticsearch

Add User Authentication for Elasticsearch

To improve security, you can implement user authentication for Elasticsearch using the X-Pack security.

Procedure

  1. From the Elasticsearch installation folder, navigate to the config folder (For example, <Elasticsearch_installation_folder>\config), and then access the file elasticsearch.yml.
  2. In the .yml file, add the following line of code:
    xpack.security.enabled: true
  3. Based on your Elasticsearch cluster type, complete one of the following steps:
    • Single node Elasticsearch cluster: Add the following line of code in the elasticsearch.yml file:

      discovery.type: single-node

      Save and close the .yml file.

    • Multi-node Elasticsearch cluster: The Elasticsearch requires TLS communication between nodes. To enable TLS communication, see https://www.elastic.co/guide/en/elasticsearch/reference/7.9/configuring-tls.html#node-certificates. 
  4. From the Elasticsearch install folder, set bootstrap password. Perform the following steps
    1. Select the Start button on Windows, right-click Command Prompt, and then select Run as administrator.

      The Command Prompt window appears.

    2. At the command prompt, enter cd <Elasticsearch_installation_folder>, and then press Enter.
    3. At the command prompt, enter bin/elasticsearch-keystore add "bootstrap.password".
    4. Enter the password and then press Enter. Note that the password is not displayed while you enter the password, and you will not be prompted for password verification.
  5. On the GE Digital APM server, navigate to C:\ProgramData\Meridium, and then modify the MeridiumAppSettings.xml file to add the following line of code:
    <add key="elasticServicePassword" value="password entered in step 4.d" />
  6. Restart Elasticsearch, Search, and IIS.

What To Do Next

  • Install ActiveMQ on a Dedicated Server
On this page
  • Install Elasticsearch on a Dedicated Server
  • Add User Authentication for Elasticsearch