Skip to content

Commit 4ce459d

Browse files
Merge pull request #609 from redis/DOC-4131-rdi-localhost-ip-change-fail
DOC-4131 added note about localhost IP change
2 parents e8b6f8b + 63d70b2 commit 4ce459d

File tree

2 files changed

+26
-5
lines changed

2 files changed

+26
-5
lines changed

content/integrate/redis-data-integration/ingest/data-pipelines/data-pipelines.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -172,8 +172,6 @@ configuration contains the following data:
172172
Quarkus [Configuration options](https://quarkus.io/guides/all-config)
173173
docs for the full set of available properties.
174174

175-
176-
177175
### Targets
178176

179177
Use this section to provide the connection details for the target Redis
@@ -184,6 +182,18 @@ with a unique name that you are free to choose (here, we have used
184182
`host` and `port` of the server. You can also supply connection credentials
185183
and TLS/mTLS secrets here if you use them.
186184

185+
{{< note >}}If you specify `localhost` as the address of either the source or target server during
186+
installation then the connection will fail if the actual IP address changes for the local
187+
VM. For this reason, we recommend that you don't use `localhost` for the address. However,
188+
if you do encounter this problem, you can fix it using the following commands on the VM
189+
that is running RDI itself:
190+
191+
```bash
192+
sudo k3s kubectl delete nodes --all
193+
sudo service k3s restart
194+
```
195+
{{< /note >}}
196+
187197
## Job files
188198

189199
You can optionally supply one or more job files that specify how you want to

content/integrate/redis-data-integration/ingest/installation/_index.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -147,7 +147,8 @@ Follow the steps below for each of your VMs:
147147
RDI uses a database on your Redis Enterprise cluster to store its state
148148
information. *This requires Redis Enterprise v6.4 or greater*.
149149

150-
The installer will ask you for cluster admin credentials. You should supply
150+
The installer gives you instructions to help you create secrets and create your pipeline.
151+
It will ask you for cluster admin credentials during installation. You should supply
151152
these if you want the installer to create the RDI database for you.
152153

153154
{{<note>}}The installer does not create the RDI Redis database with
@@ -163,9 +164,19 @@ If you don’t want the installation to create the RDI database for you:
163164
and TLS.
164165
- Provide the installation with the required RDI database details.
165166

166-
Once the installation is finished, RDI is ready for use.
167+
{{< note >}}If you specify `localhost` as the address of the RDI database server during
168+
installation then the connection will fail if the actual IP address changes for the local
169+
VM. For this reason, we recommend that you don't use `localhost` for the address. However,
170+
if you do encounter this problem, you can fix it using the following commands on the VM
171+
that is running RDI itself:
167172
168-
{{<note>}}RDI gives you instructions to help you create secrets and create your pipeline.{{</note>}}
173+
```bash
174+
sudo k3s kubectl delete nodes --all
175+
sudo service k3s restart
176+
```
177+
{{< /note >}}
178+
179+
After the installation is finished, RDI is ready for use.
169180
170181
## "Silent" installation
171182

0 commit comments

Comments
 (0)