Skip to content

Commit b70c04a

Browse files
committed
DOC-4192 Added replace node method to change socket file location
1 parent 477c0c9 commit b70c04a

File tree

1 file changed

+26
-4
lines changed

1 file changed

+26
-4
lines changed

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

Lines changed: 26 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -33,14 +33,36 @@ sudo ./install.sh -s </path/to/socket/files>
3333

3434
## Change socket file location for an existing cluster {#after-cluster-setup}
3535

36-
Changing the socket file location is not supported for bootstrapped nodes.
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:
3737

38-
To change the socket file location for an existing cluster:
38+
- [Replace nodes](#replace-nodes)
3939

40-
1. Create a new cluster with the new socket file path. 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">}}):
40+
- [Migrate the cluster using Replica Of](#migrate-replica-of)
41+
42+
### Replace nodes {#replace-nodes}
43+
44+
To change the socket file location for all nodes in a cluster, follow these steps:
45+
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">}}):
47+
48+
```sh
49+
sudo ./install.sh -s </path/to/socket/files>
50+
```
51+
52+
1. [Add the new node]({{<relref "/operate/rs/clusters/add-node">}}) to the existing cluster.
53+
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">}}):
4163

4264
```
4365
sudo ./install.sh -s </path/to/socket/files>
4466
```
4567

46-
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 Software clusters]({{<relref "/operate/rs/databases/import-export/replica-of/create#different-cluster">}}).
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 Software clusters]({{<relref "/operate/rs/databases/import-export/replica-of/create#different-cluster">}}).

0 commit comments

Comments
 (0)