Yang, Tong 6182f91ba8 MRS component operation guide_normal 2.0.38.SP20 version
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Yang, Tong <yangtong2@huawei.com>
Co-committed-by: Yang, Tong <yangtong2@huawei.com>
2022-12-09 14:55:21 +00:00

124 lines
32 KiB
HTML

<a name="mrs_01_2127"></a><a name="mrs_01_2127"></a>
<h1 class="topictitle1">Installing a Client (Version 3.x or Later)</h1>
<div id="en-us_topic_0264269828_body1470792934600"><div class="section" id="mrs_01_2127__en-us_topic_0264269828_section65278330165558"><h4 class="sectiontitle">Scenario</h4><p id="mrs_01_2127__en-us_topic_0264269828_p19463153311292">This section describes how to install clients of all services (excluding Flume) in an MRS cluster. For details about how to install the Flume client, see <span id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0264266686_ph63412418173"><a href="https://docs.otc.t-systems.com/cmpntguide/mrs/mrs_01_0392.html" target="_blank" rel="noopener noreferrer">Installing the Flume Client</a><span id="mrs_01_2127__en-us_topic_0264269828_ph63412418173"></span></span>.</p>
<p id="mrs_01_2127__en-us_topic_0264269828_p1779533753119">A client can be installed on a node inside or outside the cluster. This section uses the installation directory <strong id="mrs_01_2127__en-us_topic_0264269828_b321843695712">//opt/client</strong> as an example. Replace it with the actual one.</p>
</div>
<div class="section" id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_section3219221104310"><a name="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_section3219221104310"></a><a name="en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_section3219221104310"></a><h4 class="sectiontitle">Prerequisites</h4><ul id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_ul26645308104434"><li id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_li37425717104434">A Linux ECS has been prepared. For details about the supported OS of the ECS, see <a href="#mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_table40818788104630">Table 1</a>.
<div class="tablenoborder"><a name="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_table40818788104630"></a><a name="en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_table40818788104630"></a><table cellpadding="4" cellspacing="0" summary="" id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_table40818788104630" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Reference list</caption><thead align="left"><tr id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_row38578049104630"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.2.2.1.2.2.4.1.1"><p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_p147543306359">CPU Architecture</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.2.2.1.2.2.4.1.2"><p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_p37814246104630">OS</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="60%" id="mcps1.3.2.2.1.2.2.4.1.3"><p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_p43055100104630">Supported Version</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_row3952911204620"><td class="cellrowborder" rowspan="4" valign="top" width="15%" headers="mcps1.3.2.2.1.2.2.4.1.1 "><p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_p067995812372">x86 computing</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.2.1.2.2.4.1.2 "><p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_p1341716202466">Euler</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.2.2.1.2.2.4.1.3 "><p id="mrs_01_2127__en-us_topic_0264269828_p782123814365">EulerOS 2.5</p>
</td>
</tr>
<tr id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_row64911082104630"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.1.2.2.4.1.1 "><p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_p23306329104630">SUSE</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.2.2.1.2.2.4.1.2 "><p id="mrs_01_2127__en-us_topic_0264269828_p16974173323612">SUSE Linux Enterprise Server 12 SP4 (SUSE 12.4)</p>
</td>
</tr>
<tr id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_row60240262104630"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.1.2.2.4.1.1 "><p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_p47623054104630">RedHat</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.2.2.1.2.2.4.1.2 "><p id="mrs_01_2127__en-us_topic_0264269828_p970920248360">Red Hat-7.5-x86_64 (Red Hat 7.5)</p>
</td>
</tr>
<tr id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_row30103971104630"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.1.2.2.4.1.1 "><p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_p22502558104630">CentOS</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.2.2.1.2.2.4.1.2 "><p id="mrs_01_2127__en-us_topic_0264269828_p12811549123617">CentOS 7.6</p>
</td>
</tr>
<tr id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_row176952056184517"><td class="cellrowborder" rowspan="2" valign="top" width="15%" headers="mcps1.3.2.2.1.2.2.4.1.1 "><p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_p15246194518374">Kunpeng computing (Arm)</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.2.2.1.2.2.4.1.2 "><p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_p126771821194219">Euler</p>
</td>
<td class="cellrowborder" valign="top" width="60%" headers="mcps1.3.2.2.1.2.2.4.1.3 "><p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_p1329205172516">EulerOS 2.8</p>
</td>
</tr>
<tr id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_row7244555103511"><td class="cellrowborder" valign="top" headers="mcps1.3.2.2.1.2.2.4.1.1 "><p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_p11246555203516">CentOS</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.2.2.1.2.2.4.1.2 "><p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_p776320021018">CentOS 7.6</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_p1282531142624">In addition, sufficient disk space is allocated for the ECS, for example, 40 GB.</p>
</li><li id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_li7335267104528">The ECS and the MRS cluster are in the same VPC.</li><li id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_li17980589104436">The security group of the ECS must be the same as that of the master node in the MRS cluster.</li><li id="mrs_01_2127__en-us_topic_0264269828_li9399184211230">The NTP service has been installed on the ECS OS and is running properly.<p id="mrs_01_2127__en-us_topic_0264269828_p163361134122717"><a name="mrs_01_2127__en-us_topic_0264269828_li9399184211230"></a><a name="en-us_topic_0264269828_li9399184211230"></a>If the NTP service is not installed, run the <strong id="mrs_01_2127__en-us_topic_0264269828_b6895923359740">yum install ntp -y</strong> command to install it when the <strong id="mrs_01_2127__en-us_topic_0264269828_b2341459199740">yum</strong> source is configured.</p>
</li><li id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_li55858868171944">A user can log in to the Linux ECS using the password (in SSH mode).</li></ul>
</div>
<div class="section" id="mrs_01_2127__en-us_topic_0264269828_section181806577218"><a name="mrs_01_2127__en-us_topic_0264269828_section181806577218"></a><a name="en-us_topic_0264269828_section181806577218"></a><h4 class="sectiontitle">Installing a Client on a Node Inside a Cluster</h4><ol id="mrs_01_2127__en-us_topic_0264269828_ol9422104205920"><li id="mrs_01_2127__en-us_topic_0264269828_li164221442145916">Obtain the software package.<p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_p15640135222617"><a name="mrs_01_2127__en-us_topic_0264269828_li164221442145916"></a><a name="en-us_topic_0264269828_li164221442145916"></a>Log in to FusionInsight Manager. For details, see <a href="mrs_01_2124.html">Accessing FusionInsight Manager (MRS 3.x or Later)</a>. Click the name of the cluster to be operated in the <strong id="mrs_01_2127__en-us_topic_0264269828_b3328491043">Cluster</strong> drop-down list.</p>
<div class="p" id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_p59080250115641">Choose <strong id="mrs_01_2127__en-us_topic_0264269828_b1280616428515">More &gt; Download Client</strong>. The <strong id="mrs_01_2127__en-us_topic_0264269828_b1380684220511">Download Cluster Client</strong> dialog box is displayed.<div class="note" id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_en-us_topic_0046662333_note57940224"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_en-us_topic_0046662333_p51699968">In the scenario where only one client is to be installed, choose <strong id="mrs_01_2127__en-us_topic_0264269828_b634011211618">Cluster &gt; </strong><strong id="mrs_01_2127__en-us_topic_0264269828_b3340102117619">Service &gt; </strong><em id="mrs_01_2127__en-us_topic_0264269828_i134022114614">Service name</em><strong id="mrs_01_2127__en-us_topic_0264269828_b1334119211265"> &gt; More &gt; Download Client</strong>. The <strong id="mrs_01_2127__en-us_topic_0264269828_b1834132117619">Download Client</strong> dialog box is displayed.</p>
</div></div>
</div>
</li><li id="mrs_01_2127__en-us_topic_0264269828_li1142264215916">Set the client type to <strong id="mrs_01_2127__en-us_topic_0264269828_b46212094101">Complete Client</strong>.<p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_en-us_topic_0046662333_p41204595"><strong id="mrs_01_2127__en-us_topic_0264269828_b10794371996">Configuration Files Only</strong> is to download client configuration files in the following scenario: After a complete client is downloaded and installed and administrators modify server configurations on Manager, developers need to update the configuration files during application development.</p>
<p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_p197866515218">The platform type can be set to <strong id="mrs_01_2127__en-us_topic_0264269828_b206626282495417">x86_64</strong> or <strong id="mrs_01_2127__en-us_topic_0264269828_b95993692895417">aarch64</strong>.</p>
<ul id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_ul1215614381573"><li id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_li1515614383571"><strong id="mrs_01_2127__en-us_topic_0264269828_b16187619131013">x86_64</strong>: indicates the client software package that can be deployed on the x86 servers.</li><li id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_li4130628103215"><strong id="mrs_01_2127__en-us_topic_0264269828_b15342767789740">aarch64</strong>: indicates the client software package that can be deployed on the TaiShan servers.</li></ul>
<div class="note" id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_note147636585111"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="mrs_01_2127__en-us_topic_0264269828_p194192170270">The cluster supports two types of clients: <strong id="mrs_01_2127__en-us_topic_0264269828_b81921218102914">x86_64</strong> and <strong id="mrs_01_2127__en-us_topic_0264269828_b17192181862918">aarch64</strong>. The client type must match the architecture of the node for installing the client. Otherwise, client installation will fail.</p>
</div></div>
</li><li id="mrs_01_2127__en-us_topic_0264269828_li19735161410169">Select <strong id="mrs_01_2127__en-us_topic_0264269828_b801632122316">Save to Path</strong> and click <strong id="mrs_01_2127__en-us_topic_0264269828_b711632152319">OK</strong> to generate the client file.<p id="mrs_01_2127__en-us_topic_0264269828_p94475341617">The generated file is stored in the <strong id="mrs_01_2127__en-us_topic_0264269828_b1380713917236">/tmp/FusionInsight-Client</strong> directory on the active management node by default. You can also store the client file in a directory on which user <strong id="mrs_01_2127__en-us_topic_0264269828_b8307154112314">omm</strong> has the read, write, and execute permissions. Copy the software package to the file directory on the server where the client is to be installed as user <strong id="mrs_01_2127__en-us_topic_0264269828_b1551894332312">omm</strong> or <strong id="mrs_01_2127__en-us_topic_0264269828_b351854392318">root</strong>.</p>
<p id="mrs_01_2127__en-us_topic_0264269828_p12462105132411">The name of the client software package is in the follow format: <strong id="mrs_01_2127__en-us_topic_0264269828_b9310164672314">FusionInsight_Cluster_</strong><strong id="mrs_01_2127__en-us_topic_0264269828_b4311184692313"><em id="mrs_01_2127__en-us_topic_0264269828_i1231174617239">&lt;</em></strong><em id="mrs_01_2127__en-us_topic_0264269828_i9311194672310">Cluster ID</em><strong id="mrs_01_2127__en-us_topic_0264269828_b15311194642315"><em id="mrs_01_2127__en-us_topic_0264269828_i103112046152315">&gt;</em></strong><strong id="mrs_01_2127__en-us_topic_0264269828_b14311146172310">_Services_Client.tar</strong>. In this section, the cluster ID <strong id="mrs_01_2127__en-us_topic_0264269828_b0713350799">1</strong> is used as an example. Replace it with the actual cluster ID.</p>
<div class="p" id="mrs_01_2127__en-us_topic_0264269828_p1546245114246">The following steps and sections use <strong id="mrs_01_2127__en-us_topic_0264269828_b42531848112314">FusionInsight_Cluster_1_Services_Client.tar</strong> as an example.<div class="note" id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_note539514519197"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_p109641130131916">If you cannot obtain the permissions of user <strong id="mrs_01_2127__en-us_topic_0264269828_b214029220795417">root</strong>, use user <strong id="mrs_01_2127__en-us_topic_0264269828_b132821684595417">omm</strong>.</p>
<p id="mrs_01_2127__en-us_topic_0264269828_p393817131820">To install the client on another node in the cluster, run the following command to copy the client to the node where the client is to be installed:</p>
<p id="mrs_01_2127__en-us_topic_0264269828_p122119327172"><strong id="mrs_01_2127__en-us_topic_0264269828_b758811196231">scp -p /</strong><em id="mrs_01_2127__en-us_topic_0264269828_i194552310230">tmp/FusionInsight-Client</em><strong id="mrs_01_2127__en-us_topic_0264269828_b1071462742319">/</strong><strong id="mrs_01_2127__en-us_topic_0264269828_b522163212172">FusionInsight_Cluster_1_Services_Client.tar</strong> <em id="mrs_01_2127__en-us_topic_0264269828_i1222116324172">IP address of the node where the client is to be installed</em><em id="mrs_01_2127__en-us_topic_0264269828_i1233533442218">:</em><em id="mrs_01_2127__en-us_topic_0264269828_i182182519222">/opt/Bigdata/client</em></p>
</div></div>
</div>
</li><li id="mrs_01_2127__en-us_topic_0264269828_li1742384219595">Log in to the server where the client software package is located as user <strong id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_b47429645115832">user_client</strong>.</li><li id="mrs_01_2127__en-us_topic_0264269828_li134231342165916">Decompress the software package.<p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_p64472750115839"><a name="mrs_01_2127__en-us_topic_0264269828_li134231342165916"></a><a name="en-us_topic_0264269828_li134231342165916"></a>Go to the directory where the installation package is stored, such as <strong id="mrs_01_2127__en-us_topic_0264269828_b93645625595417">/tmp/FusionInsight-Client</strong>. Run the following command to decompress the installation package to a local directory:</p>
<p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_en-us_topic_0046662333_p41540743"><strong id="mrs_01_2127__b167745618121">tar -xvf</strong> <strong id="mrs_01_2127__en-us_topic_0193213980_b13193145991418">FusionInsight_Cluster_1_Services_Client.tar</strong></p>
</li><li id="mrs_01_2127__en-us_topic_0264269828_li1442314423596">Verify the software package.<p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_p4558596411591"><a name="mrs_01_2127__en-us_topic_0264269828_li1442314423596"></a><a name="en-us_topic_0264269828_li1442314423596"></a>Run the following command to verify the decompressed file and check whether the command output is consistent with the information in the <strong id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_b4389556111595">sha256</strong> file.</p>
<p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_en-us_topic_0046662333_p17103984"><strong id="mrs_01_2127__b1412211341317">sha256sum -c</strong> <strong id="mrs_01_2127__en-us_topic_0193213980_b7722175017173">FusionInsight_Cluster_1_Services_ClientConfig.tar</strong><strong id="mrs_01_2127__en-us_topic_0193213980_b157602204191">.sha256</strong></p>
<pre class="screen" id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_s34b562fd0e714bc4aa8aba57b503ea70">FusionInsight_Cluster_1_Services_ClientConfig.tar: OK</pre>
</li><li id="mrs_01_2127__en-us_topic_0264269828_li742344275917">Decompress the obtained installation file.<p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_en-us_topic_0046662333_p13221196"><a name="mrs_01_2127__en-us_topic_0264269828_li742344275917"></a><a name="en-us_topic_0264269828_li742344275917"></a><strong id="mrs_01_2127__b265911156138">tar -xvf</strong> <strong id="mrs_01_2127__en-us_topic_0193213980_b18293612014">FusionInsight_Cluster_1_Services_ClientConfig.tar</strong></p>
</li><li id="mrs_01_2127__en-us_topic_0264269828_li44234426592">Go to the directory where the installation package is stored, and run the following command to install the client to a specified directory (an absolute path), for example, <strong id="mrs_01_2127__en-us_topic_0264269828_b842352706185935">/opt/client</strong>:<p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_en-us_topic_0046662333_p41684868"><strong id="mrs_01_2127__en-us_topic_0193213980_b60975609115955">cd /tmp/FusionInsight-Client/FusionInsight</strong><strong id="mrs_01_2127__en-us_topic_0193213980_b11909569115955">_Cluster_1_Services_ClientConfig</strong></p>
<p id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_en-us_topic_0046662333_p20114008">Run the <strong id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_en-us_topic_0046662333_b46808346">./install.sh /opt/client</strong> command to install the client. The client is successfully installed if information similar to the following is displayed:</p>
<pre class="screen" id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_sa1ec942b8a634a789cb524d480c9b987">The component client is installed successfully</pre>
<div class="note" id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_note17447181519244"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_ul17447615152417"><li id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_li1544771552416">If the clients of all or some services use the <strong id="mrs_01_2127__en-us_topic_0264269828_b173227800185652">/opt/client</strong> directory, other directories must be used when you install other service clients.</li><li id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_li164471115192413">You must delete the client installation directory when uninstalling a client.</li><li id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_li244718150244">To ensure that an installed client can only be used by the installation user (for example, <strong id="mrs_01_2127__en-us_topic_0264269828_b178647297495417">user_client</strong>), add parameter <strong id="mrs_01_2127__en-us_topic_0264269828_b96008449095417">-o</strong> during the installation. That is, run the <strong id="mrs_01_2127__en-us_topic_0264269828_b121051227995417">./install.sh /opt/client -o</strong> command to install the client.</li><li id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0193213980_li1618594563813">If an HBase client is installed, it is recommended that the client installation directory contain only uppercase and lowercase letters, digits, and characters (_-?.@+=) due to the limitation of the Ruby syntax used by HBase.</li></ul>
</div></div>
</li></ol>
</div>
<div class="section" id="mrs_01_2127__en-us_topic_0264269828_section8796733802"><h4 class="sectiontitle">Using a Client</h4><ol id="mrs_01_2127__en-us_topic_0264269828_ol406463517727"><li id="mrs_01_2127__en-us_topic_0264269828_li5310293617727">On the node where the client is installed, run the <strong id="mrs_01_2127__en-us_topic_0264269828_b16110326105413">sudo su - omm</strong> command to switch the user. Run the following command to go to the client directory:<p id="mrs_01_2127__en-us_topic_0264269828_p1458176517659"><strong id="mrs_01_2127__b1518921775">cd /opt/client</strong></p>
</li><li id="mrs_01_2127__en-us_topic_0264269828_li6464792217731">Run the following command to configure environment variables:<p id="mrs_01_2127__en-us_topic_0264269828_p4329329317720"><a name="mrs_01_2127__en-us_topic_0264269828_li6464792217731"></a><a name="en-us_topic_0264269828_li6464792217731"></a><strong id="mrs_01_2127__b4463590517724">source bigdata_env</strong></p>
</li><li id="mrs_01_2127__en-us_topic_0264269828_li59218459111521">If Kerberos authentication is enabled for the current cluster, run the following command to authenticate the user. If Kerberos authentication is disabled for the current cluster, skip this step.<p id="mrs_01_2127__en-us_topic_0264269828_p3903911193255"><a name="mrs_01_2127__en-us_topic_0264269828_li59218459111521"></a><a name="en-us_topic_0264269828_li59218459111521"></a><strong id="mrs_01_2127__en-us_topic_0264269828_b63065667193458">kinit</strong> <em id="mrs_01_2127__en-us_topic_0264269828_i6148471145146">MRS cluster user</em></p>
<p id="mrs_01_2127__en-us_topic_0264269828_p23308555145027">Example: <strong id="mrs_01_2127__en-us_topic_0264269828_a1b6c451d34ad45e497b6464bad4e711f">kinit admin</strong></p>
<div class="note" id="mrs_01_2127__en-us_topic_0264269828_note9287432201644"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="mrs_01_2127__en-us_topic_0264269828_p63123885201646">User <span class="parmname" id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0043021163_parmname439877633113147"><b>admin</b></span> is created by default for MRS clusters with Kerberos authentication enabled and is used for administrators to maintain the clusters.</p>
</div></div>
</li><li id="mrs_01_2127__en-us_topic_0264269828_li6700401317745">Run the client command of a component directly.<p id="mrs_01_2127__en-us_topic_0264269828_p71420617745"><a name="mrs_01_2127__en-us_topic_0264269828_li6700401317745"></a><a name="en-us_topic_0264269828_li6700401317745"></a>For example, run the <strong id="mrs_01_2127__en-us_topic_0264269828_b3844345102915">hdfs dfs -ls /</strong> command to view files in the HDFS root directory.</p>
</li></ol>
</div>
<div class="section" id="mrs_01_2127__en-us_topic_0264269828_section49281012266"><h4 class="sectiontitle">Installing a Client on a Node Outside a Cluster</h4><ol id="mrs_01_2127__en-us_topic_0264269828_ol1736616559415"><li id="mrs_01_2127__en-us_topic_0264269828_li18366755642">Create an ECS that meets the requirements in <a href="#mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_section3219221104310">Prerequisites</a>.</li><li id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_li4775145513575">Perform NTP time synchronization to synchronize the time of nodes outside the cluster with that of the MRS cluster.<ol type="a" id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_ol193951422145810"><li id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_li46251218311">Run the <strong id="mrs_01_2127__en-us_topic_0264269828_b6771536259740">vi /etc/ntp.conf</strong> command to edit the NTP client configuration file, add the IP addresses of the master node in the MRS cluster, and comment out the IP address of other servers.<pre class="screen" id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_screen115991769270">server <em id="mrs_01_2127__en-us_topic_0270713152_en-us_topic_0264269418_i1246044402714">master1_ip</em> prefer
server <em id="mrs_01_2127__en-us_topic_0270713152_en-us_topic_0264269418_i194410516271">master2_ip</em> </pre>
<div class="fignone" id="mrs_01_2127__fig86383401545"><span class="figcap"><b>Figure 1 </b>Adding the master node IP addresses</span><br><span><img id="mrs_01_2127__image1377121095319" src="en-us_image_0000001438729629.png"></span></div>
</li><li id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_li03711129101013">Run the <strong id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_b18102121581211">service ntpd stop</strong> command to stop the NTP service.</li><li id="mrs_01_2127__en-us_topic_0264269828_li52801730202416">Run the following command to manually synchronize the time:<p id="mrs_01_2127__en-us_topic_0264269828_p1349612315246"><a name="mrs_01_2127__en-us_topic_0264269828_li52801730202416"></a><a name="en-us_topic_0264269828_li52801730202416"></a><strong id="mrs_01_2127__b5991367279">/usr/sbin/ntpdate </strong><em id="mrs_01_2127__i16679123612279">192.168.10.8</em></p>
<div class="note" id="mrs_01_2127__en-us_topic_0264269828_note733331515278"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="mrs_01_2127__en-us_topic_0264269828_p1333131512276"><strong id="mrs_01_2127__en-us_topic_0264269828_b558716117404">192.168.10.8</strong> indicates the IP address of the active Master node.</p>
</div></div>
</li><li id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_li1626616223117">Run the <strong id="mrs_01_2127__en-us_topic_0264269828_b2386656549740">service ntpd start</strong> or <strong id="mrs_01_2127__en-us_topic_0264269828_b13058506999740">systemctl restart ntpd</strong> command to start the NTP service.</li><li id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_li103951822155811">Run the <strong id="mrs_01_2127__en-us_topic_0264269828_en-us_topic_0270713152_en-us_topic_0264269418_b157561859131116">ntpstat</strong> command to check the time synchronization result.</li></ol>
</li><li id="mrs_01_2127__en-us_topic_0264269828_li1632110101168">Perform the following steps to download the cluster client software package from FusionInsight Manager, copy the package to the ECS node, and install the client:<ol type="a" id="mrs_01_2127__en-us_topic_0264269828_ol1744153134310"><li id="mrs_01_2127__en-us_topic_0264269828_li2047215196234">Log in to FusionInsight Manager and download the cluster client to the specified directory on the active management node by referring to <a href="mrs_01_2124.html">Accessing FusionInsight Manager (MRS 3.x or Later)</a> and <a href="#mrs_01_2127__en-us_topic_0264269828_section181806577218">Installing a Client on a Node Inside a Cluster</a>.</li><li id="mrs_01_2127__en-us_topic_0264269828_li04726194231">Log in to the active management node as user <strong id="mrs_01_2127__en-us_topic_0264269828_b1736225111351">root</strong> and run the following command to copy the client installation package to the target node:<p id="mrs_01_2127__en-us_topic_0264269828_p104721019182319"><strong id="mrs_01_2127__en-us_topic_0264269828_b6236101139740">scp -p /tmp/FusionInsight-Client/FusionInsight_Cluster_1_Services_Client.tar</strong><em id="mrs_01_2127__en-us_topic_0264269828_i12473569079740"> IP address of the node where the client is to be installed</em><strong id="mrs_01_2127__en-us_topic_0264269828_b19770938459740">:/tmp</strong></p>
</li><li id="mrs_01_2127__en-us_topic_0264269828_li247391922314">Log in to the node on which the client is to be installed as the client user.<p id="mrs_01_2127__en-us_topic_0264269828_p1762065714263"><a name="mrs_01_2127__en-us_topic_0264269828_li247391922314"></a><a name="en-us_topic_0264269828_li247391922314"></a>Run the following commands to install the client. If the user does not have operation permissions on the client software package and client installation directory, grant the permissions using the <strong id="mrs_01_2127__en-us_topic_0264269828_b5250445171219">root</strong> user.</p>
<p id="mrs_01_2127__en-us_topic_0264269828_p9473171952319"><strong id="mrs_01_2127__b34731119202310">cd /tmp</strong></p>
<p id="mrs_01_2127__en-us_topic_0264269828_p13761454192720"><strong id="mrs_01_2127__b1445265272714">tar -xvf </strong><strong id="mrs_01_2127__b6452052122710">FusionInsight_Cluster_1_Services_Client.tar</strong></p>
<p id="mrs_01_2127__en-us_topic_0264269828_p63409105285"><strong id="mrs_01_2127__b1719885284">tar -xvf </strong><strong id="mrs_01_2127__b1471917852811">FusionInsight_Cluster_1_Services_ClientConfig.tar</strong></p>
<p id="mrs_01_2127__en-us_topic_0264269828_p1831131182819"><strong id="mrs_01_2127__b174410298289">cd FusionInsight</strong><strong id="mrs_01_2127__b244729172810">_Cluster_1_Services_ClientConfig</strong></p>
<p id="mrs_01_2127__en-us_topic_0264269828_p172671740142820"><strong id="mrs_01_2127__b199816395286">./install.sh /opt/client</strong></p>
</li><li id="mrs_01_2127__en-us_topic_0264269828_li10473191919234">Run the following commands to switch to the client directory and configure environment variables:<p id="mrs_01_2127__en-us_topic_0264269828_p174736199233"><a name="mrs_01_2127__en-us_topic_0264269828_li10473191919234"></a><a name="en-us_topic_0264269828_li10473191919234"></a><strong id="mrs_01_2127__b1747361952311">cd /opt/client</strong></p>
<p id="mrs_01_2127__en-us_topic_0264269828_p1547391911235"><strong id="mrs_01_2127__b10473111902312">source bigdata_env</strong></p>
</li><li id="mrs_01_2127__en-us_topic_0264269828_li547351914231">If Kerberos authentication is enabled for the current cluster, run the following command to authenticate the user. If Kerberos authentication is disabled for the current cluster, skip this step.<p id="mrs_01_2127__en-us_topic_0264269828_p147318190238"><a name="mrs_01_2127__en-us_topic_0264269828_li547351914231"></a><a name="en-us_topic_0264269828_li547351914231"></a><strong id="mrs_01_2127__en-us_topic_0264269828_b14311128977">kinit</strong> <em id="mrs_01_2127__en-us_topic_0264269828_i1231182818710">MRS cluster user</em></p>
<p id="mrs_01_2127__en-us_topic_0264269828_p847391917238">Example: <strong id="mrs_01_2127__b1437200555">kinit admin</strong></p>
</li><li id="mrs_01_2127__en-us_topic_0264269828_li247381916232">Run the client command of a component directly.<p id="mrs_01_2127__en-us_topic_0264269828_p1247431910238"><a name="mrs_01_2127__en-us_topic_0264269828_li247381916232"></a><a name="en-us_topic_0264269828_li247381916232"></a>For example, run the <strong id="mrs_01_2127__en-us_topic_0264269828_b1947411922316">hdfs dfs -ls /</strong> command to view files in the HDFS root directory.</p>
</li></ol>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="mrs_01_2126.html">Using an MRS Client</a></div>
</div>
</div>