Install Elastic Search on a Dedicated Server

Procedure

On the server machine on which you want to install Elastic Search, access the GE Digital APM distribution package, and then navigate to the folder 3rd_Party_Software\ElasticSearch.
Extract the contents of the file elasticsearch-5.3.0.zip to the folder C:\ElasticSearch.
In the extracted files, navigate to the folder C:\ElasticSearch\elasticsearch-5.3.0\elasticsearch-5.3.0\config, and then access the file elasticsearch.yml.

In the elasticsearch.yml file, uncomment the following properties and 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

Save and close the elasticsearch.yml file.
Select the Windows Start button, then navigate to and right-click Command Prompt, and then select Run as administrator.
A command prompt window appears.
In the command prompt window, enter cd C:\ElasticSearch\elasticsearch-5.3.0\bin
In the command prompt window, enter elasticsearch-service install
Elastic Search is installed.
Access the Services console (services.msc), and then test and modify the following Elastic Search properties:
- Verify that the service runs as Local System.
- Modify the startup to be Automatic.
- Start the service to verify installation and configuration.

On the Elastic Server machine, ensure that Elastic Search is running by navigating to http://localhost:9200/ in your preferred web browser.

You should receive a response similar to the following:

{
"name" : "apm-node",
"cluster_name" : "apm-cluster",
"cluster_uuid" : "58cS6NyzQJOLZ8Xr1e3vkg",
"version" : {
"number" : "5.3.0",
"build_hash" : "3adb13b",
"build_date" : "2017-03-23T03:31:50.652Z",
"build_snapshot" : false,
"lucene_version" : "6.4.1"
},

On the GE Digital APM Server machine, ensure that Elastic Search is running by navigating to http://[elastic-search-server]:9200/ in your preferred web browser.
You should receive a response similar to that seen in the previous step.
On the GE Digital APM Server machine, navigate to C:\ProgramData\Meridium, and then edit the file MeridiumAppSettings.xml

In the file MeridiumAppSettings.xml, modify the following values as needed:

<!-- Search and Elastic Services -->
<add key="searchServiceUrl" value="http://localhost:9199" />
<add key="elasticServiceUrl" value="http://<name of Elastic Search server>:9200" />

On the GE Digital APM Server, restart the following services:
- Meridium Search Service
- Redis service
- Reset IIS (optional)

Enable Elastic Search

Before you begin

Deploying translations is part of both the GE Digital APM first time deployment workflow and the GE Digital APM upgrade workflow. Ensure that you have completed the preceding steps in the appropriate workflow before attempting to deploy translations.

Procedure

If you used the Meridium APM Server and Add-ons installer to install elastic search on a GE Digital APM Server, proceed to step 2.

-or-

If you will follow the recommended deployment and install elastic search on its own, dedicated server, then, via the official Elastic Search website, download and install ElasticSearch.
After installing ElasticSearch, you must modify the file elasticsearch.yml to configure the cluster.name and node.name values. Open that file in a text editor, then uncomment the following lines by removing the # symbols, and replace the cluster.name and node.name values with the appropriate values for your deployment.
```
#cluster.name: apm-foundation (dev/qa/prod/etc.)
```
```
#node.name: apm-foundation-vm2 (dev/qa/prod/etc.)-(servername/etc.)
```

In the file elasticsearch.yml, uncomment the following lines by removing the # symbols, and, if needed, replace the values with the appropriate values for your deployment.

#path.data: /ProgramData/Meridium/ElasticSearch

#path.logs: /ProgramData/Meridium/Logs

#bootstrap.memory_lock: true

#network.host: 127.0.0.1

#http.port: 9200

#action.destructive_requires_name: true

To install the Meridium.Service.Search service:
1. Open a Visual Studio Command window.
2. Execute the following command: cd C:\Program Files\Meridium\Services
3. Execute the following command: installutil Meridium.Service.Search.exe
Access Computer Management, and then navigate to Services and Applications > Services and locate Meridium Search Service in the list. Then, complete the following actions:
1. Verify that the service runs as Local System.
2. Change the startup to be Automatic.
3. Start the service to verify installation and configuration.

Navigate to c:\ProgramData\Meridium\MeridiumAppSettings.xml, and then add the following lines:

<!-- Search and Elastic Services -->

<add key="searchServiceUrl" value="http://localhost:9199" />

<add key="elasticServiceUrl" value="http://localhost:9200" />

Elastic Search is enabled.