Skip to content

Commit 11d46c7

Browse files
authored
RS: New procedure for change socket file location without rlutil (#963)
* DOC-4192 RS: New procedure for change socket file location without rlutil * DOC-4192 Edits to address feedback * Revert Redis Software back to Redis Enterprise Software * DOC-4192 Added replace node method to change socket file location * Revert changes to Redis Enterprise name in Create Replica Of doc
1 parent 581f7b0 commit 11d46c7

File tree

1 file changed

+29
-25
lines changed

1 file changed

+29
-25
lines changed

content/operate/rs/installing-upgrading/configuring/change-location-socket-files.md

Lines changed: 29 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -21,44 +21,48 @@ There are two default locations for the socket files in Redis Enterprise Softwar
2121
The default location was changed in case you run any maintenance procedures that delete the `/tmp` directory.
2222
{{</note>}}
2323

24-
When you upgrade Redis Enterprise Software from an earlier version to 5.2.2 or later, the socket files
25-
are not moved to the new location by default. You need to either specify a custom location
26-
for the socket files during [installation]({{< relref "/operate/rs/installing-upgrading" >}}) or use the [following procedure](#change-socket-file-locations) after installation.
24+
When you upgrade Redis Enterprise Software from an earlier version to 5.2.2 or later, the socket files are not moved to the new location by default. You need to specify the socket file location [during installation](#during-install).
2725

28-
## Change socket file locations
26+
## Specify socket file location during install {#during-install}
2927

30-
To change the location of the socket files:
28+
To specify the socket file location during a new installation, follow the [Install Redis Enterprise Software on Linux]({{<relref "/operate/rs/installing-upgrading/install/install-on-linux">}}) instructions, but use the `-s` [installation script option]({{<relref "/operate/rs/installing-upgrading/install/install-script">}}):
3129

32-
1. On each node in the cluster, run:
30+
```sh
31+
sudo ./install.sh -s </path/to/socket/files>
32+
```
3333

34-
```sh
35-
sudo rlutil create_socket_path socket_path=/var/opt/redislabs/run
36-
```
34+
## Change socket file location for an existing cluster {#after-cluster-setup}
3735

38-
1. Identify the node with the `master` role by running the following command on any node in the cluster:
36+
Directly changing the socket file location directly is not supported for bootstrapped nodes. If you need to change the socket file location for an existing cluster, use one of the following methods instead:
3937

40-
```sh
41-
rladmin status nodes
42-
```
38+
- [Replace nodes](#replace-nodes)
4339

44-
1. On the master node, change the socket file location:
40+
- [Migrate the cluster using Replica Of](#migrate-replica-of)
4541

46-
```sh
47-
sudo rlutil set_socket_path socket_path=/var/opt/redislabs/run
48-
```
42+
### Replace nodes {#replace-nodes}
43+
44+
To change the socket file location for all nodes in a cluster, follow these steps:
4945

50-
1. To update the socket file location for all other nodes, restart Redis Enterprise Software on each node in the cluster, one at a time:
46+
1. Install Redis Enterprise Software on a new node with the new socket file location. Follow the [Install Redis Enterprise Software on Linux]({{<relref "/operate/rs/installing-upgrading/install/install-on-linux">}}) instructions, but use the -s [installation script option]({{<relref "/operate/rs/installing-upgrading/install/install-script">}}):
5147

5248
```sh
53-
sudo service rlec_supervisor restart
49+
sudo ./install.sh -s </path/to/socket/files>
5450
```
5551

56-
1. Restart each database in the cluster to update the socket file location:
52+
1. [Add the new node]({{<relref "/operate/rs/clusters/add-node">}}) to the existing cluster.
5753

58-
```sh
59-
rladmin restart db <db name>
54+
1. [Remove a node]({{<relref "/operate/rs/clusters/remove-node#remove-a-node">}}) with the old socket file location.
55+
56+
1. Repeat the previous steps until all nodes with the old socket file location have been replaced.
57+
58+
### Migrate cluster using Replica Of {#migrate-replica-of}
59+
60+
To migrate an existing cluster to a new cluster with a different socket file location:
61+
62+
1. Create a new cluster with the new socket file location. To do so, follow the [Install Redis Enterprise Software on Linux]({{<relref "/operate/rs/installing-upgrading/install/install-on-linux">}}) instructions, but use the `-s` [installation script option]({{<relref "/operate/rs/installing-upgrading/install/install-script">}}):
63+
64+
```
65+
sudo ./install.sh -s </path/to/socket/files>
6066
```
6167

62-
{{< warning >}}
63-
Restarting databases can cause interruptions in data traffic.
64-
{{< /warning >}}
68+
1. Use Replica Of to migrate your databases from the original cluster to the new cluster. For detailed steps, see the procedure to [configure Replica Of with different Redis Enterprise clusters]({{<relref "/operate/rs/databases/import-export/replica-of/create#different-cluster">}}).

0 commit comments

Comments
 (0)