On-Premises Elasticsearch Installation | Communifire Documentation

Installation Process

1. Download Elasticsearch v7.16.2 from https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.16.2-windows-x86_64.zip
2. Unzip the downloaded file. Move the elasticsearch-7.16.2 folder to C:\ and rename it Elasticsearch.
   • Do not install Elasticsearch on the same drive as your site files. For example, if your site is at "D:\websites\yoursite.com", install Elasticsearch on the C drive. Ensure the drive has at least 50% free space.
   • For sites with more than 500 users, install Elasticsearch on a separate server. Only install one instance of Elasticsearch per server.
3. Open Windows Command Prompt using "Run as administrator."
4. Run the following command and press Enter.

   set JAVA_HOME=C:\Elasticsearch\jdk

5. To confirm that the variable is set, run the following command:

   echo %JAVA_HOME%

   The command should return the output in the screenshot below.
   
6. Open C:\Elasticsearch\config\elasticsearch.yml in a text editor. Copy the following content and paste it over the existing text. Save the file.
   

   # ======================== Elasticsearch Configuration =========================
   #
   # NOTE: Elasticsearch comes with reasonable defaults for most settings.
   #       Before you set out to tweak and tune the configuration, make sure you
   #       understand what are you trying to accomplish and the consequences.
   #
   # The primary way of configuring a node is via this file. This template lists
   # the most important settings you may want to configure for a production cluster.
   #
   # Please consult the documentation for further information on configuration options:
   # https://www.elastic.co/guide/en/elasticsearch/reference/index.html
   #
   # ---------------------------------- Cluster -----------------------------------
   #
   # Use a descriptive name for your cluster:
   #
   #cluster.name: my-application
   #
   # ------------------------------------ Node ------------------------------------
   #
   # Use a descriptive name for the node:
   #
   #node.name: node-1
   #
   # Add custom attributes to the node:
   #
   #node.attr.rack: r1
   #
   # ----------------------------------- Paths ------------------------------------
   #
   # Path to directory where to store the data (separate multiple locations by comma):
   #
   #path.data: /path/to/data
   #
   # Path to log files:
   #
   #path.logs: /path/to/logs
   #
   # ----------------------------------- Memory -----------------------------------
   #
   # Lock the memory on startup:
   #
   #bootstrap.memory_lock: true
   #
   # Make sure that the heap size is set to about half the memory available
   # on the system and that the owner of the process is allowed to use this
   # limit.
   #
   # Elasticsearch performs poorly when the system is swapping the memory.
   #
   # ---------------------------------- Network -----------------------------------
   #
   # By default Elasticsearch is only accessible on localhost. Set a different
   # address here to expose this node on the network:
   #
   #network.host: 192.168.0.1
   #
   # By default Elasticsearch listens for HTTP traffic on the first free port it
   # finds starting at 9200. Set a specific HTTP port here:
   #
   #http.port: 9200
   #
   # For more information, consult the network module documentation.
   #
   # --------------------------------- Discovery ----------------------------------
   #
   # Pass an initial list of hosts to perform discovery when this node is started:
   # The default list of hosts is ["127.0.0.1", "[::1]"]
   #
   discovery.seed_hosts: ['127.0.0.1', '[::1]']
   network.host: 0.0.0.0
   discovery.type: single-node
   #
   # Bootstrap the cluster using an initial set of master-eligible nodes:
   #
   #cluster.initial_master_nodes: ["node-1", "node-2"]
   #
   # For more information, consult the discovery and cluster formation module documentation.
   #
   # ---------------------------------- Various -----------------------------------
   #
   # Require explicit names when deleting indices:
   #
   #action.destructive_requires_name: true
   #
   # ---------------------------------- Security ----------------------------------
   #
   #                                 *** WARNING ***
   #
   # Elasticsearch security features are not enabled by default.
   # These features are free, but require configuration changes to enable them.
   # This means that users don’t have to provide credentials and can get full access
   # to the cluster. Network connections are also not encrypted.
   #
   # To protect your data, we strongly encourage you to enable the Elasticsearch security features.
   # Refer to the following documentation for instructions.
   #
   # https://www.elastic.co/guide/en/elasticsearch/reference/7.16/configuring-stack-security.html

7. In the Command Prompt, navigate to C:\Elasticsearch\bin and run the below command:
   

   elasticsearch-service.bat install

8. In the Command Prompt, run the following command to start the service:

   elasticsearch-service.bat start

   Click Yes if you are asked the following question:
   
   
   A message will be displayed in the terminal confirming the start of the service.
   
9. Open Services and find the Elasticsearch service.
   
10. Right-click the service and click Properties.
    
11. For Startup type, select Automatic from the dropdown menu. Click Apply and OK.
    
    The service should now be running at the localhost:9200 endpoint.
    
    To confirm, open a browser and type http://localhost:9200
    
    You should receive a message like the following: