--- title: "Deploy the EDR Telemetry Store cluster" slug: "deploy-the-edr-telemetry-store-cluster" tags: ["EDR with Forensics (EDRF)", "Endpoint Security"] updated: 2026-09-11T11:37:00Z published: 2026-09-11T11:37:00Z canonical: "docs.trellix.com/deploy-the-edr-telemetry-store-cluster" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Deploy the EDR Telemetry Store cluster After you create a configuration source, you must deploy the EDR Telemetry Store cluster. You can deploy the EDR Telemetry Store cluster using one of the following methods: 1. [Use existing deployed configuration](/v1/docs/deploy-the-edr-telemetry-store-cluster#option-1-use-existing-deployed-configuration) 2. [Generate new configuration artifact](/v1/docs/deploy-the-edr-telemetry-store-cluster#option-2-generate-new-configuration-artifact) 3. [Use latest local artifact](/v1/docs/deploy-the-edr-telemetry-store-cluster#option-3-use-latest-local-artifact) 4. [Browse all local artifacts](/v1/docs/deploy-the-edr-telemetry-store-cluster#option-4-browse-all-local-artifacts) 5. [Download from remote server (SSH/SCP)](/v1/docs/deploy-the-edr-telemetry-store-cluster#option-5-download-from-remote-server-sshscp) 6. [Upload manually](/v1/docs/deploy-the-edr-telemetry-store-cluster#option-6-upload-manually) ### Deployment quick guide In multi-node cluster environments with multiple cluster manager nodes, perform all setup or modification tasks on the single cluster manager node where you set up the cluster. The artifact generated on this node must be replicated across all other nodes to ensure the cluster is synchronized. > [!NOTE] > Note > > Update the default `config` user password on the cluster manager node where you perform the setup. Use this updated password when prompted for credentials on other nodes. | Deployment scenario | Action | | --- | --- | | The cluster manager node where you perform the setup or modification | 1. Run `opensearch cluster deploy`. 2. Select [Option 3: Use latest local artifact](/v1/docs/deploy-the-edr-telemetry-store-cluster#option-3-use-latest-local-artifact). | | For remaining nodes (other cluster manager, data, or ingest nodes) | 1. Run `opensearch cluster deploy`. 2. Select [Option 5: Download from remote server (SSH/SCP)](/v1/docs/deploy-the-edr-telemetry-store-cluster#option-5-download-from-remote-server-sshscp). 3. Enter the IP address and `config` user credentials of the cluster manager node where you perform the setup. 4. Select the generated artifact from that node. 5. Run the deployment. > [!WARNING] > Important > > All nodes must have the same artifact deployed to function as a cluster. Repeat this process for all remaining nodes. | ### Deployment workflow 1. Log on to the EDR Telemetry Store appliance using SSH. ```plaintext ssh admin@ ``` 2. After you create the configuration file, you need to deploy the EDR Telemetry Store cluster. ```plaintext opensearch cluster deploy ``` 3. To proceed with the deployment, type `y` and press **Enter**. 4. From the **Available Configuration Sources**, type the corresponding number (1–6) and press **Enter**. ![1-configsources.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-058a7290-020d-0786-622f-7aab7b270e1f.png?sv=2026-02-06&spr=https&st=2026-11-19T21%3A32%3A08Z&se=2026-11-19T22%3A32%3A08Z&sr=c&sp=r&sig=ZGdp7i7ulldy%2B0s%2FU3QjbFOZxi295KZqA6O2d%2BTVPhc%3D) 5. Once the deployment is done, verify the status. ### Option 1: Use existing deployed configuration Use this method to redeploy the EDR Telemetry Store cluster using the metadata and configuration details (such as index templates and ISM policies) already present on the system. This method is recommended if the EDR Telemetry Store unexpectedly stops or crashes, or if you need to resume a partial deployment without creating a new artifact file. 1. Perform steps 1-4. 2. Type `1` and press **Enter**. This pulls the configuration currently located in `/opt/trellix/config`. 3. To confirm and begin the deployment, type `y` and press **Enter**. ### Option 2: Generate new configuration artifact Use this option if a configuration artifact does not exist or if you need to create a new one from scratch. 1. Perform steps 1-4. 2. Type `2` and press **Enter**. The system exits the deployment menu and displays the command to start the setup wizard. ![2-newartifact.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-5dad41f3-c2ba-8ab1-b48d-2d75eaed4c07.png?sv=2026-02-06&spr=https&st=2026-11-19T21%3A32%3A08Z&se=2026-11-19T22%3A32%3A08Z&sr=c&sp=r&sig=ZGdp7i7ulldy%2B0s%2FU3QjbFOZxi295KZqA6O2d%2BTVPhc%3D) 3. Run the setup wizard to create a new artifact: ```plaintext opensearch cluster setup ``` For more information, see [Configure the EDR Telemetry Store cluster](/v1/docs/configure-the-edr-telemetry-store-cluster). > [!NOTE] > Note > > Once the configuration is complete, run the `opensearch cluster deploy`command again and type `3` to use the artifact you just created. ### Option 3: Use latest local artifact Use this option to deploy the cluster using the most recently created configuration artifact stored on the appliance. This is the standard method to use immediately after you run the setup wizard. 1. Perform steps 1-4. 2. Type `3` and press **Enter**. The system displays the filename, creation date, and size of the artifact being used. For example, `opensearch-cluster-trellix-trace-store-YYYYMMDD_HHMMSS.tar.gz` 3. To confirm and begin the deployment, type `y` and press **Enter**. ### Option 4: Browse all local artifacts Use this option to view a list of all configuration artifacts currently stored in the `/opt/trellix/uploads/config` directory. This allows you to select a specific configuration file. 1. Perform steps 1-4. 2. Type `4` and press **Enter**. The system displays a list of available artifacts. 3. At the **Enter selection** prompt, type the artifact number or the artifact filename, and press **Enter**. ![4-browseallartifacts.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-3403112a-17a1-4488-d64f-2bfd2379eb4f.png?sv=2026-02-06&spr=https&st=2026-11-19T21%3A32%3A08Z&se=2026-11-19T22%3A32%3A08Z&sr=c&sp=r&sig=ZGdp7i7ulldy%2B0s%2FU3QjbFOZxi295KZqA6O2d%2BTVPhc%3D) 4. To confirm and begin the deployment, type `y` and press **Enter**. ### Option 5: Download from remote server (SSH/SCP) Use this method to download a configuration artifact from another machine (such as the primary node in a multi-node deployment) and deploy it on the current appliance. **Prerequisite**: Before you download artifacts from a remote server, you must change the default password for the `config` user on the machine where the artifact was created. - Log on to the EDR Telemetry Store using SSH. ```plaintext ssh config@ ``` - Enter the default password (`config`) and follow the prompts to set a new password. 1. Perform steps 1-4. 2. Type `5` and press **Enter**. 3. Enter the IP address of the remote machine where the artifact is located. 4. Enter the SSH username. Default name: `config` 5. Enter the remote configuration path. Default path: `/opt/trellix/uploads/config` 6. Enter a specific artifact filename, or press **Enter** to browse available artifacts. 7. Enter the password for the `config` user. The system displays a list of artifacts available on the remote server. 8. At the **Select artifact to download** prompt, type the number corresponding to the artifact and press **Enter**. The deployment process automatically begins. ![5-downloadfromserver.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-0c493d17-fd81-b1c1-eb58-58d08aa1f447.png?sv=2026-02-06&spr=https&st=2026-11-19T21%3A32%3A08Z&se=2026-11-19T22%3A32%3A08Z&sr=c&sp=r&sig=ZGdp7i7ulldy%2B0s%2FU3QjbFOZxi295KZqA6O2d%2BTVPhc%3D) ### Option 6: Upload manually Use this option to view the directory structure and permission requirements to create and manually upload a custom artifact. 1. Perform steps 1-4. 2. Type `6` and press **Enter**. The system displays the required folder structure, file location, and permission requirements for a valid artifact. ![6-filestructure.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-e697a248-f4a3-3cad-edd7-274c1b5a1075.png?sv=2026-02-06&spr=https&st=2026-11-19T21%3A32%3A08Z&se=2026-11-19T22%3A32%3A08Z&sr=c&sp=r&sig=ZGdp7i7ulldy%2B0s%2FU3QjbFOZxi295KZqA6O2d%2BTVPhc%3D) 3. Ensure your `tar.gz` file matches the folder structure containing `metadata/`, `nodes/`, `cluster-apis/`, `security/` directories. 4. Ensure that all files within the subdirectories are owned by the `config` user, and that the `.tar.gz` archive is owned by the `config` user and the `sshusers` group. 5. Use a secure transfer tool (like SCP or WinSCP) to upload your artifact to the `/opt/trellix/uploads/config` directory on the appliance. 6. Once the correct file is uploaded, run the `opensearch cluster deploy` command as the `admin` user. 7. Type `4` to deploy using **Browse all local artifacts**, then select your manually uploaded file from the list to begin deployment. ### Verify the deployment The deployment process can take a few minutes. A success message appears after the deployment is completed. 1. To verify the status of the cluster, run the following command: ```plaintext show opensearch status ``` ![1-opensearch_status.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-3d2eb426-89e7-98a9-d7ae-3237756bc6a2.png?sv=2026-02-06&spr=https&st=2026-11-19T21%3A32%3A08Z&se=2026-11-19T22%3A32%3A08Z&sr=c&sp=r&sig=ZGdp7i7ulldy%2B0s%2FU3QjbFOZxi295KZqA6O2d%2BTVPhc%3D) 2. To verify the JVM heap size and node roles, run the following commands: ```plaintext enable [sudo] password for admin: shell curl -k -X GET "https://localhost:9200/_cat/nodes?v&h=name,ip,heap.max,ram.max,node.role" --cert /etc/opensearch/certs/opensearch-admin.pem --key /etc/opensearch/certs/opensearch-admin-key.pem ``` ![2-JVM_memory.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-c9c5478a-f1ed-48de-6c5d-fb926bafa82d.png?sv=2026-02-06&spr=https&st=2026-11-19T21%3A32%3A08Z&se=2026-11-19T22%3A32%3A08Z&sr=c&sp=r&sig=ZGdp7i7ulldy%2B0s%2FU3QjbFOZxi295KZqA6O2d%2BTVPhc%3D)