How to Install Elasticsearch | Axero Documentation

Important Notes

• Install only one Elasticsearch instance per server.
• Do not install Elasticsearch on the same drive as your site files.
• Ensure the drive has at least 50% free space.
• If you have over 500 users, install Elasticsearch on a separate server.

How to Install

1. Uninstall Previous Version
   • Remove any existing Elasticsearch installation to avoid conflicts (see instructions).
2. Download Elasticsearch
   1. Download the Elasticsearch installation file from the official Elastic website.
   2. Extract the contents to a directory on your server (e.g., C:\Elasticsearch).
3. Enable Security
   1. Open the C:\Elasticsearch\config\elasticsearch.yml file in a text editor.
   2. Add the following line to enable security:
      

      xpack.security.enabled: true

   3. By default, Elasticsearch is only accessible on localhost. To make Elasticsearch accessible on a server IP, uncomment and update network.host: 192.168.0.1 to your desired IP address.
   4. Save and close the file.
4. Adjust JVM Heap Size
   1. Go to C:\Elasticsearch\config\jvm.options.d and create a new file named heap.options in a text editor.
   2. In the new file, add the following lines to set the minimum and maximum heap size:
      

      -Xms2g
      -Xmx2g

   3. Save and close the file.
5. Install Elasticsearch Service
   1. Open Command Prompt as an administrator.
   2. Go to the Elasticsearch bin directory (e.g., cd c:\elasticsearch\bin) and run:
      

      elasticsearch-service.bat install

6. Configure the Elasticsearch Service
   1. Press Windows Key + R, type services.msc, and press Enter.
   2. Locate the Elasticsearch service.
   3. Right-click the service and select Properties.
   4. Set Startup type to Automatic and click OK.
   5. Right-click the service again and select Start.
7. Set Elasticsearch Password
   1. Wait a few minutes for the service to start.
   2. Open Command Prompt as an administrator.
   3. Go to the Elasticsearch bin directory (e.g., cd c:\elasticsearch\bin) and reset the password by running:
      

      elasticsearch-reset-password.bat -u elastic

   4. Record the displayed password for the next step.
8. Connect Elasticsearch to Axero
   1. In Axero, go to Control Panel > System > System Properties.
   2. Edit ElasticsearchUsername, enter elastic, and save.
   3. Edit ElasticsearchPassword, paste the password from the previous step, and save.
   4. If you set a server IP address in step 3, edit ElasticsearchServer, enter the IP address, and save.
9. Finalize Installation
   1. Go to System > Advanced System Utilities and click Restart Site. The restart may take a few minutes.
   2. After the restart, click Rebuild Index. You'll see a success message when the indexing is complete:
      
   3. If you are upgrading Elasticsearch, also click Rebuild Activity Log Index.