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
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
Copy file name to clipboardExpand all lines: content/operate/rs/installing-upgrading/configuring/change-location-socket-files.md
+29-25Lines changed: 29 additions & 25 deletions
Original file line number
Diff line number
Diff line change
@@ -21,44 +21,48 @@ There are two default locations for the socket files in Redis Enterprise Softwar
21
21
The default location was changed in case you run any maintenance procedures that delete the `/tmp` directory.
22
22
{{</note>}}
23
23
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).
27
25
28
-
## Change socket file locations
26
+
## Specify socket file location during install {#during-install}
29
27
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">}}):
## Change socket file location for an existing cluster {#after-cluster-setup}
37
35
38
-
1. Identify the node with the `master` role by running the following command on any node inthe 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:
39
37
40
-
```sh
41
-
rladmin status nodes
42
-
```
38
+
-[Replace nodes](#replace-nodes)
43
39
44
-
1. On the master node, change the socket file location:
40
+
-[Migrate the cluster using Replica Of](#migrate-replica-of)
To change the socket file location for all nodes in a cluster, follow these steps:
49
45
50
-
1. To update the socket file locationforall other nodes, restart Redis Enterprise Software on each nodeinthe 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">}}):
51
47
52
48
```sh
53
-
sudo service rlec_supervisor restart
49
+
sudo ./install.sh -s </path/to/socket/files>
54
50
```
55
51
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.
57
53
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>
60
66
```
61
67
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