Install Elastic Stack using Relativity Server CLI

https://artifacts.elastic.co/downloads

Installation Steps

.\relsvr.exe install --elastic-stack-version "9.3.0" --elasticsearch-data-path "D:\elastic-data" --elasticsearch-logs-path "D:\elastic-logs"

Or follow the interactive prompts:

1. Open an elevated PowerShell window and run the following command:

   Copy

   .\relsvr.exe install
   

2. When prompted, select Elastic Stack and confirm the Elastic Stack installation.

3. Select the Elastic Stack version from the list of supported versions.

4. When prompted with Use a custom Elastic package source?, enter n to download packages from the internet.

5. When prompted with Use custom storage paths for Elasticsearch data and logs?, enter y and provide the path, or n to use the defaults.

   The installer creates the specified directories automatically if they do not already exist.

6. The installation proceeds automatically.

PS C:\elastic\Relativity.Server.Cli.102.0.3\tools> .\relsvr.exe install

Relativity Server CLI - 102.0.3
Copyright (c) 2025, Relativity ODA LLC

Install the Elastic Stack? [y/n] (y): y

The "Open and Free" Elasticsearch product can be installed to support features like
Datagrid/Audit and Environment Watch that search billions of unstructured JSON documents in seconds.

Selected Elastic Stack version: 8.19.8
Recommended distribution source path: \\{server}\BCPPath\EnvironmentWatch\ElasticPackages
Use a custom Elastic package source? [y/n] (n): n
Selected Elastic Stack components to install: Elasticsearch,Kibana,APM Server
Use custom storage paths for Elasticsearch data and logs? [y/n] (n): y
Enter the Elasticsearch data storage path (e.g. D:\elastic-data): (D:\elastic-data): D:\elastic-data
Enter the Elasticsearch logs storage path (e.g. D:\elastic-logs): (D:\elastic-logs): D:\elastic-logs

Prerequisites

On a machine with internet access, download the required packages and organize them in the following directory structure before transferring to the target environment.

Download locations:

https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-9.3.0-windows-x86_64.zip
https://artifacts.elastic.co/downloads/kibana/kibana-9.3.0-windows-x86_64.zip
https://artifacts.elastic.co/downloads/apm-server/apm-server-9.3.0-windows-x86_64.zip
https://artifacts.elastic.co/downloads/elasticsearch-plugins/mapper-size/mapper-size-9.3.0.zip

Required directory structure (example for Elastic Stack 8.19.8 and RWSM 2.24.0):

The folder names shown below are required, as the installation process relies on this structure.

C:\elastic-packages\
─ elasticsearch\
│   ─ elasticsearch-8.19.8-windows-x86_64.zip
│   └── plugins\
│       └── mapper-size-8.19.8.zip
─ kibana\
│   └── kibana-8.19.8-windows-x86_64.zip
─ apm-server\
│   └── apm-server-8.19.8-windows-x86_64.zip
└── tools\
    └── relativity.windows.servicemanager.2.24.0.nupkg

Transfer the entire directory structure to the offline machine or a BCP network share accessible from the target machine.

Installation Steps

# Using a local path
.\relsvr.exe install --elastic-stack-version "9.3.0" --distribution-source "C:\elastic-packages" --elasticsearch-data-path "D:\elastic-data" --elasticsearch-logs-path "D:\elastic-logs"

# Using a BCP network path
.\relsvr.exe install --elastic-stack-version "9.3.0" --distribution-source "\\fileserver\elastic-packages" --elasticsearch-data-path "D:\elastic-data" --elasticsearch-logs-path "D:\elastic-logs"

Or follow the interactive prompts:

1. Open an elevated PowerShell window and run the following command:

   Copy

   .\relsvr.exe install
   

2. When prompted, select Elastic Stack for setup and confirm the Elastic Stack installation.

3. Select the Elastic Stack version from the list of supported versions. Verify that the selected version matches the version of the packages you downloaded.

4. When prompted with Use a custom Elastic package source?, enter y.

5. Provide the local path or BCP path to the folder containing the pre-downloaded packages.

6. When prompted with Use custom storage paths for Elasticsearch data and logs?, enter y and provide the path, or n to use the defaults.

7. The installation proceeds automatically.

PS C:\elastic\publish-cli> .\relsvr.exe install

Relativity Server CLI - 100.0.28
Copyright (c) 2025, Relativity ODA LLC

Install the Elastic Stack? [y/n] (y): y

The "Open and Free" Elasticsearch product can be installed to support features like
Datagrid/Audit and Environment Watch that search billions of unstructured JSON documents in seconds.

Selected Elastic Stack version: 8.19.8
Recommended distribution source path: \\{server}\BCPPath\EnvironmentWatch\ElasticPackages
Use a custom Elastic package source? [y/n] (n): y
Enter the distribution source path (e.g. \\{server}\BCPPath\EnvironmentWatch\ElasticPackages): (\\{server}\BCPPath\EnvironmentWatch\ElasticPackages): C:\elastic\packages
Distribution source: C:\elastic\packages
Selected Elastic Stack components to install: Elasticsearch,Kibana,APM Server
Use custom storage paths for Elasticsearch data and logs? [y/n] (n): y
Enter the Elasticsearch data storage path (e.g. D:\elastic-data): (D:\elastic-data): D:\elastic-data
Enter the Elasticsearch logs storage path (e.g. D:\elastic-logs): (D:\elastic-logs): D:\elastic-logs

After installation completes:

1. The auto-generated elastic superuser password is saved to:

   Copy

   C:\elastic\secrets\elastic-user.txt
   

   Record and securely store it immediately according to your organization's credential management policy.

2. Verify Elasticsearch is running by opening a browser and navigating to:

   Copy

   https://host-name:9200
   

   Log in with username elastic and the password from C:\elastic\secrets\elastic-user.txt. A successful response shows basic cluster information in JSON format.

3. Verify Kibana is running by opening a browser and navigating to:

   Copy

   https://host-name:5601
   

   Log in with username elastic and the password from C:\elastic\secrets\elastic-user.txt. A successful response loads the Kibana home dashboard.

4. Verify APM Server is running by opening a browser and navigating to:

   Copy

   https://host-name:8200
   

   A successful response returns a JSON object containing APM Server build information.

5. Once all services are verified and the password is securely stored, delete the password file from disk:

   Copy

   Remove-Item -Path "C:\elastic\secrets\elastic-user.txt"