Install Elasticsearch on a Dedicated Server

Install Elasticsearch on a Dedicated Server

Procedure

  1. On the server on which you want to install Elasticsearch, download and install OpenJDK V1.8.0_111 or Oracle JDK V1.8.0_73.
    Important: Java versions higher than V1.8.0_XX are currently not supported. You may need to disable automatic updates for Java. For more information, refer to the Java Update Options topic in the https://www.java.com/en/download/help/java_update.xml.
  2. 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

  3. 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.
  4. Download the zip file for Windows, elasticsearch-6.7.0.zip, from the official Elasticsearch 6.7.0 https://www.elastic.co/downloads/past-releases/elasticsearch-6-7-0 page.
  5. Extract the contents of the zip file to C:\ElasticSearch.
  6. Go to C:\ElasticSearch\elasticsearch-6.7.0\elasticsearch-6.7.0\config, and then access the elasticsearch.yml file.
  7. 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
  8. Save and close the .yml file.
  9. Select the Start button on Windows, right-click Command Prompt, and then select Run as administrator.
    The Command Prompt window appears.
  10. At the command prompt, enter cd C:\ElasticSearch\elasticsearch-6.7.0\bin, and then press Enter.
  11. At the command prompt, enter elasticsearch-service install, and then press Enter.
    Elasticsearch is installed.
  12. 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.
  13. 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" : "6.7.0",
"build_hash" : "3adb13b",
"build_date" : "2017-03-23T03:31:50.652Z",
"build_snapshot" : false,
"lucene_version" : "6.4.1"
},
  14. 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.
  15. On the GE Digital APM server, go to C:\ProgramData\Meridium\MeridiumAppSettings.xml.
  16. 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" />
  17. After all third-party services are configured, reset IIS and services on all GE Digital APM App Servers.