diff --git a/content/operate/rs/installing-upgrading/configuring/change-location-socket-files.md b/content/operate/rs/installing-upgrading/configuring/change-location-socket-files.md index a765fed9c9..286b052925 100644 --- a/content/operate/rs/installing-upgrading/configuring/change-location-socket-files.md +++ b/content/operate/rs/installing-upgrading/configuring/change-location-socket-files.md @@ -21,44 +21,48 @@ There are two default locations for the socket files in Redis Enterprise Softwar The default location was changed in case you run any maintenance procedures that delete the `/tmp` directory. {{}} -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 either specify a custom location -for the socket files during [installation]({{< relref "/operate/rs/installing-upgrading" >}}) or use the [following procedure](#change-socket-file-locations) after installation. +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). -## Change socket file locations +## Specify socket file location during install {#during-install} -To change the location of the socket files: +To specify the socket file location during a new installation, follow the [Install Redis Enterprise Software on Linux]({{}}) instructions, but use the `-s` [installation script option]({{}}): -1. On each node in the cluster, run: +```sh +sudo ./install.sh -s +``` - ```sh - sudo rlutil create_socket_path socket_path=/var/opt/redislabs/run - ``` +## Change socket file location for an existing cluster {#after-cluster-setup} -1. Identify the node with the `master` role by running the following command on any node in the cluster: +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: - ```sh - rladmin status nodes - ``` +- [Replace nodes](#replace-nodes) -1. On the master node, change the socket file location: +- [Migrate the cluster using Replica Of](#migrate-replica-of) - ```sh - sudo rlutil set_socket_path socket_path=/var/opt/redislabs/run - ``` +### Replace nodes {#replace-nodes} + +To change the socket file location for all nodes in a cluster, follow these steps: -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: +1. Install Redis Enterprise Software on a new node with the new socket file location. Follow the [Install Redis Enterprise Software on Linux]({{}}) instructions, but use the -s [installation script option]({{}}): ```sh - sudo service rlec_supervisor restart + sudo ./install.sh -s ``` -1. Restart each database in the cluster to update the socket file location: +1. [Add the new node]({{}}) to the existing cluster. - ```sh - rladmin restart db +1. [Remove a node]({{}}) with the old socket file location. + +1. Repeat the previous steps until all nodes with the old socket file location have been replaced. + +### Migrate cluster using Replica Of {#migrate-replica-of} + +To migrate an existing cluster to a new cluster with a different socket file location: + +1. Create a new cluster with the new socket file location. To do so, follow the [Install Redis Enterprise Software on Linux]({{}}) instructions, but use the `-s` [installation script option]({{}}): + + ``` + sudo ./install.sh -s ``` - {{< warning >}} -Restarting databases can cause interruptions in data traffic. - {{< /warning >}} +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]({{}}).