Updating the MRS Cluster Client After the Server Configuration Expires

An MRS cluster provides a client for you to connect to a server, view task results, or manage data. If you modify service configuration parameters on Manager and restart the service, you need to download and install the client again or use the configuration file to update the client.

For clusters of MRS 2.x or earlier, the original client is stored in the /opt/client directory of all nodes in the cluster by default when you create a cluster. After the cluster is created, only the client of a Master node can be directly used. To use the client of a Core node, you need to update the client configuration file first.

Updating Client Configurations (Version 3.x or Later)

Method 1

Log in to MRS Manager by referring to Accessing MRS Manager. Choose Cluster > Overview > More > Download Client.
Choose More > Download Client > Configuration Files Only.

The generated compressed file contains the configuration files of all services.

Figure 1 Downloading the client configuration file
Determine whether to generate a configuration file on the cluster node.
- If yes, select Save to Path, and click OK to generate the client file. By default, the client file is generated in /tmp/FusionInsight-Client on the active management node. You can also store the client file in other directories, and user omm has the read, write, and execute permissions on the directories. Then go to 4.
- If no, click OK, specify a local save path, and download the complete client. Wait until the download is complete and go to 4.
Use WinSCP to save the compressed file to the client installation directory, for example, /opt/hadoopclient, as the client installation user.
Decompress the software package.

Run the following commands to go to the directory where the client is installed, and decompress the file to a local directory. For example, the downloaded client file is FusionInsight_Cluster_1_Services_Client.tar.

cd /opt/hadoopclient

tar -xvf FusionInsight_Cluster_1_Services_Client.tar
Verify the software package.

Run the following command to verify the decompressed file and check whether the command output is consistent with the information in the sha256 file.

sha256sum -c FusionInsight_Cluster_1_Services_ClientConfig_ConfigFiles.tar.sha256
```
FusionInsight_Cluster_1_Services_ClientConfig_ConfigFiles.tar: OK     
```
Decompress the package to obtain the configuration file.

tar -xvf FusionInsight_Cluster_1_Services_ClientConfig_ConfigFiles.tar
Run the following command in the client installation directory to update the client using the configuration file:

sh refreshConfig.sh Client installation directory Directory where the configuration file is located

For example, run the following command:

sh refreshConfig.sh /opt/hadoopclient /opt/hadoopclient/FusionInsight_Cluster_1_Services_ClientConfig_ConfigFiles

If the following information is displayed, the configurations have been updated successfully.
```
Succeed to refresh components client config.
```

Method 2:

Log in to the client installation node as user root.
Go to the client installation directory, for example, /opt/hadoopclient and run the following commands to update the configuration file:

cd /opt/hadoopclient

sh autoRefreshConfig.sh
Enter the username and password of the FusionInsight Manager administrator and the floating IP address of OMS.

To obtain the floating IP address of OMS, log in to the Master2 node remotely, and run the ifconfig command. In the command output, eth0:wsom indicates the floating IP address of OMS. Record the value of inet. If the floating IP address of OMS cannot be queried on the Master2 node, switch to the Master1 node to query and record the floating IP address. If there is only one Master node, query and record the IP address on the Master node.
Enter the names of the components whose configuration needs to be updated. Use commas (,) to separate the component names. Press Enter to update the configurations of all components if necessary.

If the following information is displayed, the configurations have been updated successfully.
```
Succeed to refresh components client config.
```

Updating Client Configurations (Version 2.x or Earlier)

Method 1 (applicable to all versions)

Log in to MRS Manager and choose Services.
Click Download Client.

Set Client Type to Only configuration files, Download To to Server, and click OK to generate the client configuration file. The generated file is saved in the /tmp/MRS-client directory on the active management node by default. You can customize the file path.

Figure 2 Downloading the client configuration file
Query and log in to the active Master node.
If you use the client in the cluster, run the following command to switch to user omm. If you use the client outside the cluster, switch to user root.

sudo su - omm
Go to the client directory.

cd Client installation directory
Update client configurations.

sh refreshConfig.sh Client installation directoryFull path of the client configuration file package

Example:

sh refreshConfig.sh /opt/Bigdata/client /tmp/MRS-client/MRS_Services_Client.tar

If the following information is displayed, the configurations have been updated successfully.
```
ReFresh components client config is complete.
Succeed to refresh components client config.
```

Method 2:

After the cluster is installed, run the following command to switch to user omm. If you use the client outside the cluster, switch to user root.

sudo su - omm
Go to the client directory.

cd Client installation directory
Run the following command and enter the name of an MRS Manager user with the download permission and its password (for example, the username is admin and the password is the one set during cluster creation) as prompted to update client configurations.

sh autoRefreshConfig.sh
After the command is executed, the following information is displayed, where XXX indicates the name of the component installed in the cluster. To update client configurations of all components, press Enter. To update client configurations of some components, enter the component names and separate them with commas (,).
```
Components "xxx" have been installed in the cluster. Please input the comma-separated names of the components for which you want to update client configurations. If you press Enter without inputting any component name, the client configurations of all components will be updated:
```
If the following information is displayed, the configurations have been updated:
```
Succeed to refresh components client config.
```
If the following information is displayed, the username or password is incorrect.
```
login manager failed,Incorrect username or password.
```
- This script automatically connects to the cluster and invokes the refreshConfig.sh script to download and update the client configuration file.
- By default, the client uses the floating IP address specified by wsom=xxx in the Version file in the installation directory to update the client configurations. To update the configuration file of another cluster, modify the value of wsom=xxx in the Version file to the floating IP address of the corresponding cluster before performing this step.