Skip to content

Commit da2c076

Browse files
committed
REL-1123365: Added TLS security configuration for multi-node
1 parent 78ba565 commit da2c076

1 file changed

Lines changed: 49 additions & 49 deletions

File tree

docs/elastic-stack-setup-01-installation.md

Lines changed: 49 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -223,7 +223,55 @@ If you download a .zip or other file from the internet, Windows may block the fi
223223
> [!NOTE]
224224
> This configuration is NOT recommended for production environments
225225
226-
**Step 7: Configure Transport Layer Security for Multi-Node Clusters (Production)**
226+
**Step 7: Configure Storage Paths**
227+
228+
> [!IMPORTANT]
229+
> **Storage location is critical for Elasticsearch performance**
230+
>
231+
> Elasticsearch requires fast storage with high read/write performance.
232+
>
233+
> **Development:**
234+
> - May use OS disk (C:) temporarily
235+
> - Still not recommended
236+
>
237+
> **Production:**
238+
> - NEVER use the OS drive (C:)
239+
> - Data MUST reside on a dedicated, high-performance disk
240+
> - Fast storage (SSD/NVMe) is required
241+
> - Never share disk with the operating system
242+
>
243+
> **Configuration is simple:** Only two settings are needed to redirect data paths.
244+
245+
**Understanding Elasticsearch directories:**
246+
- **`path.data`**: Stores indices (the actual indexed documents, inverted indices, and metadata)
247+
- **`path.logs`**: Stores Elasticsearch application logs (startup, errors, warnings, query logs)
248+
249+
These are separate directories because data directories require high-performance storage and regular backups, while log directories primarily need adequate space for troubleshooting and monitoring.
250+
251+
1. Configure `path.data` and `path.logs` in `elasticsearch.yml` to point to dedicated high-performance volumes:
252+
253+
```yaml
254+
# Production - use dedicated fast disk (D:, E:, or SAN)
255+
path.data: X:/esdata
256+
path.logs: X:/eslogs
257+
```
258+
259+
2. Save the changes and restart the Elasticsearch service:
260+
261+
262+
```powershell
263+
Restart-Service -Name "elasticsearch-service-x64"
264+
```
265+
266+
> [!NOTE]
267+
> **Development Environment:**
268+
> If you are running a single-node development environment and have changed the data path, you may need to reset the `elastic` user password after restarting the service. Use the following command in the Elasticsearch bin directory:
269+
> ```
270+
> .\elasticsearch-reset-password -u elastic
271+
> ```
272+
> This ensures you can log in to Kibana and perform admin tasks after moving the data directory.
273+
274+
**Step 8: Configure Transport Layer Security for Multi-Node Clusters (Production)**
227275
228276
> [!IMPORTANT]
229277
> **This step is only required for multi-node production clusters.** If you are running a single-node development environment, you can skip this section and proceed to Step 7. Transport layer security ensures secure communication between nodes in a cluster using certificates signed by a Certificate Authority (CA).
@@ -303,54 +351,6 @@ Follow these steps on **all DataGrid servers** and use the **same password** on
303351
> [!IMPORTANT]
304352
> The passwords must be identical on all nodes in the cluster for proper inter-node communication.
305353
306-
**Step 8: Configure Storage Paths**
307-
308-
> [!IMPORTANT]
309-
> **Storage location is critical for Elasticsearch performance**
310-
>
311-
> Elasticsearch requires fast storage with high read/write performance.
312-
>
313-
> **Development:**
314-
> - May use OS disk (C:) temporarily
315-
> - Still not recommended
316-
>
317-
> **Production:**
318-
> - NEVER use the OS drive (C:)
319-
> - Data MUST reside on a dedicated, high-performance disk
320-
> - Fast storage (SSD/NVMe) is required
321-
> - Never share disk with the operating system
322-
>
323-
> **Configuration is simple:** Only two settings are needed to redirect data paths.
324-
325-
**Understanding Elasticsearch directories:**
326-
- **`path.data`**: Stores indices (the actual indexed documents, inverted indices, and metadata)
327-
- **`path.logs`**: Stores Elasticsearch application logs (startup, errors, warnings, query logs)
328-
329-
These are separate directories because data directories require high-performance storage and regular backups, while log directories primarily need adequate space for troubleshooting and monitoring.
330-
331-
1. Configure `path.data` and `path.logs` in `elasticsearch.yml` to point to dedicated high-performance volumes:
332-
333-
```yaml
334-
# Production - use dedicated fast disk (D:, E:, or SAN)
335-
path.data: X:/esdata
336-
path.logs: X:/eslogs
337-
```
338-
339-
2. Save the changes and restart the Elasticsearch service:
340-
341-
342-
```powershell
343-
Restart-Service -Name "elasticsearch-service-x64"
344-
```
345-
346-
> [!NOTE]
347-
> **Development Environment:**
348-
> If you are running a single-node development environment and have changed the data path, you may need to reset the `elastic` user password after restarting the service. Use the following command in the Elasticsearch bin directory:
349-
> ```
350-
> .\elasticsearch-reset-password -u elastic
351-
> ```
352-
> This ensures you can log in to Kibana and perform admin tasks after moving the data directory.
353-
354354
**Step 9: Install the 'mapper-size' plugin**
355355
356356
1. Open an elevated PowerShell, navigate to ElasticSearch's bin folder(C:\elastic\elasticsearch-x.x.x\bin) and run the following command to install the 'mapper-size' plugin:

0 commit comments

Comments
 (0)