You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Both must return `TcpTestSucceeded : True` before proceeding. If either fails, resolve the network or firewall issue before continuing.
30
53
31
-
5.**SSL/TLS certificate trust** — The SSL certificates for both Relativity (Kepler) and Elasticsearch must be trusted on the SQL Primary server. This is one of the most common causes of CLI setup failure, particularly when certificates are self-signed, issued by a private CA, or issued to a hostname that differs from the one provided as the URL input.
54
+
5.**SSL/TLS certificate trust** — The SSL certificates for both Relativity (Kepler) and Elasticsearch must be trusted on the SQL Primary server.
32
55
33
56
**Relativity (Kepler) SSL certificate:**
34
57
- The Kepler SSL certificate must be trusted on the SQL Primary server, and must be issued to the same hostname you provide as the Relativity instance URL. A mismatch between the certificate hostname and the URL will cause SSL validation to fail even if the certificate itself is valid.
@@ -41,7 +64,7 @@ After installing the required Elastic components for Data Grid Audit, the integr
41
64
- The Elasticsearch cluster certificate must be trusted on the SQL Primary server.
42
65
- To verify from the SQL Primary server:
43
66
```powershell
44
-
curl.exe -u <username>:<password> -X GET "https://<elasticsearch-hostname>:9200/"
67
+
curl.exe -u <username>:<password> -X GET "https://<elasticsearch-masternode-hostname>:9200/"
45
68
```
46
69
47
70
A successful response (without `-k`) for each confirms the certificate is trusted. If a command only succeeds with `-k` (skip verification), import the relevant CA certificate into the Windows **Trusted Root Certification Authorities** store on the SQL Primary before proceeding. See [SSL/TLS Certificate Issues](./troubleshooting/pre-requisite-troubleshooting.md#ssltls-certificate-issues) for import instructions.
@@ -59,16 +82,16 @@ After installing the required Elastic components for Data Grid Audit, the integr
59
82
> Providing the wrong Relativity or Elasticsearch URL is one of the most common causes of setup failure. Review these requirements before running the CLI.
60
83
61
84
**Relativity instance URL:**
62
-
- Use the **load balancer or primary web server hostname** that is reachable from the SQL Primary server, in the format `https://<hostname>/Relativity`.
85
+
- Use the **load balancer or primary web server hostname** that is reachable from the SQL Primary server, in the format `https://<domainurl>/Relativity`.
63
86
- Do **not** use a private or internal hostname that resolves differently from the SQL server than from workstations. The CLI makes REST API calls from the SQL Primary server, so the URL must resolve and be routable from that machine.
64
87
- The URL must use HTTPS and the certificate at that hostname must be trusted on the SQL Primary server (see prerequisite 5).
- Use the **master node hostname** — do not use a data node URL. The CLI communicates with the cluster through the master/coordinating node, which handles cluster-level operations such as API key creation and index management.
69
92
- The default port is `9200`. The URL must use HTTPS if TLS is enabled on the cluster.
70
93
- Use a hostname that matches the **Subject Alternative Name (SAN) or Common Name (CN)** on the Elasticsearch TLS certificate. Using an IP address or alternate hostname not covered by the certificate will cause a certificate mismatch (SSL error) even if the certificate is otherwise trusted.
> If your environment uses a load balancer in front of Elasticsearch, confirm that the load balancer certificate covers the hostname you are providing, and that the backend nodes are also individually accessible for certificate validation. When in doubt, use the individual node hostname that matches the certificate CN/SAN.
@@ -99,22 +122,22 @@ Follow these steps to set up Data Grid Audit using the Relativity Server CLI. Al
99
122
Existing settings do not exist
100
123
Enter the Relativity admin username (<relativity-admin-username>): <relativity-admin-username>
101
124
Enter the Relativity admin password: *********
102
-
Enter the Relativity instance url (https://relativity.example.com/Relativity): https://relativity.example.com/Relativity
125
+
Enter the Relativity instance url (https://<domainurl>/Relativity): https://<domainurl>/Relativity
103
126
Relativity instance is verified
104
127
Enter the Elasticsearch admin username (elastic): elastic
105
128
Enter the Elasticsearch admin password: *********
106
-
Enter the Elasticsearch cluster endpoint URL (https://<elasticsearch-hostname>:9200): https://<elasticsearch-hostname>:9200
129
+
Enter the Elasticsearch cluster endpoint URL (https://<elasticsearch-masternode-hostname>:9200): https://<elasticsearch-masternode-hostname>:9200
107
130
108
131
```
109
132
110
133
| Parameter | Description | Example |
111
134
| :--- | :--- | :--- |
112
135
| Relativity admin username | The username of a Relativity System Administrator account. Must use Forms Authentication with two-factor authentication disabled. | `<relativity-admin-username>` |
113
136
| Relativity admin password | The password for the Relativity admin account. | |
114
-
| Relativity instance URL | The HTTPS URL of the Relativity web server or load balancer, reachable from the SQL Primary server. Must end with `/Relativity`. | `https://relativity.example.com/Relativity` |
137
+
| Relativity instance URL | The HTTPS URL of the Relativity web server or load balancer, reachable from the SQL Primary server. Must end with `/Relativity`. | `https://<domainurl>/Relativity` |
115
138
| Elasticsearch admin username | The username of an Elasticsearch account with superuser privileges. | `elastic` |
116
139
| Elasticsearch admin password | The password for the Elasticsearch admin account. | |
117
-
| Elasticsearch cluster endpoint URL | The HTTPS URL of the Elasticsearch **master**. Do not use a data node URL. The hostname must match the CN/SAN on the Elasticsearch TLS certificate. Default port is `9200`. | `https://<elasticsearch-hostname>:9200` |
140
+
| Elasticsearch cluster endpoint URL | The HTTPS URL of the Elasticsearch **master**. Do not use a data node URL. The hostname must match the CN/SAN on the Elasticsearch TLS certificate. Default port is `9200`. | `https://<elasticsearch-masternode-hostname>:9200` |
0 commit comments