Install Elasticsearch

Version 5.x and higher of Identity Panel uses Elasticsearch version 7.x as a full-text indexing service. The following guide may be used to prepare for a clean installation of Identity Panel or as part of upgrading to 5.x

Elasticsearch requires Java, and supports Oracle Java and OpenJDK. Elasticsearch is bundled with OpenJDK, but it is also possible to run against a separate JDK installation.

Elasticsearch 7.16 or higher (within the 7.x major version) is strongly recommended as this includes the remediation for the log4j vulnerability.

Install and configure OpenJDK (optional)

1. Download OpenJDK from https://jdk.java.net/.
2. Unblock (if necessary) and extract the zip file
   
3. Open System Environment Variables and add (or update) the JAVA_HOME variable pointing to the extracted jdk-13* folder

Install Elasticsearch

1. Download a 7.x release of Elasticsearch. Choose the Windows download
   
   
2. Right click on the downloaded zip, choose properties, and unblock it if necessary.
   
3. Create a folder in a suitable location (e.g. C:\Program Files\SoftwareIDM\Elastic), and extract the downloaded zip archive:
   
4. Optional: edit configuration to provide custom data and log paths
   1. Edit \elasticsearch-8.x\config\elasticsearch.yml
   2. Un-comment path.data and path.logs and revise as needed
5. Validate the java runtime accessibility and configuration by running bin\elasticsearch.bat
6. Install Service
   1. Open an administrative command prompt in the extracted location's bin folder, e.g. C:\Program Files\SoftwareIDM\Elastic\elasticsearch-8.x.x\bin\
   2. Run: elasticsearch-service.bat install <custom service name e.g. SoftwareIDM.ElasticSearch>

   3. Optional: You may  change the service display name so that it sorts close to the Identity Panel web maintenance service:
      sc config <custom service name> displayName= "SoftwareIDM Elastic"
   4. Change the service to autostart: sc config <custom service name> start= auto
   5. Start the service: net start <custom service name>

7. Validate the Elastic search configuration by browsing to http://localhost:9200/
   

Troubleshooting

If the service fails to start and writes "Missing service ImageFile" in the Elastic.yyyy-mm-dd.txt log, the Java environment may be missing or incorrectly configured. Ensure Java is installed and the JAVA_HOME variable is present as per the Install and configure OpenJDK section above.

Further reading

• Setup Overview: https://www.elastic.co/guide/en/elasticsearch/reference/current/setup.html
• Installing on Windows: https://www.elastic.co/guide/en/elasticsearch/reference/current/zip-windows.html
• Downloads (Past Releases: choose a 8.x version): https://www.elastic.co/downloads/past-releases#elasticsearch