forked from docs/doc-exports
yangtong
c285e88a17
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com> Co-authored-by: yangtong <yangtong2@huawei.com> Co-committed-by: yangtong <yangtong2@huawei.com>
176 lines
44 KiB
HTML
176 lines
44 KiB
HTML
<a name="admin_guide_000171"></a><a name="admin_guide_000171"></a>
|
|
|
|
<h1 class="topictitle1">Installing a Client</h1>
|
|
<div id="body8662426"><div class="section" id="admin_guide_000171__en-us_topic_0193213980_s1a1a66848fb546e98ca950c8283b62d9"><h4 class="sectiontitle">Scenario</h4><p id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_p18875499">This section describes how to install the clients of all services, except Flume, in the <span id="admin_guide_000171__text660675792417">MRS</span> cluster. <span id="admin_guide_000171__text62601919182510">MRS</span> provides shell scripts for different services so that maintenance personnel can log in to related maintenance clients and implement maintenance operations.</p>
|
|
<div class="note" id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_note35661763"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="admin_guide_000171__ul6106125612102"><li id="admin_guide_000171__li4106195619101">Reinstall the client after server configuration is modified on <span id="admin_guide_000171__text15946118176">MRS</span> Manager or after the system is upgraded. Otherwise, the versions of the client and server will be inconsistent.</li></ul>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="admin_guide_000171__en-us_topic_0193213980_s1afb479ab58e4b0387e014dabf861bb0"><h4 class="sectiontitle">Prerequisites</h4><ul id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_ul206293"><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li1856645">An installation directory will be automatically created if it does not exist. If the directory exists, it must be empty. The directory cannot contain any space.</li><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li16709807">If a server outside the cluster is used as the client node, the node can communicate with the cluster service plane. Otherwise, client installation will fail.</li><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li16170542">The client must have the NTP service enabled and synchronized time with the NTP server. Otherwise, client installation will fail.</li><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li11317154">If clients of all components are downloaded, HDFS and MapReduce are installed in the same directory (<em id="admin_guide_000171__i387700288114618">Client directory</em><strong id="admin_guide_000171__b1876619256114618">/HDFS/</strong>).</li><li id="admin_guide_000171__en-us_topic_0193213980_li89648583314">You can install and use the client as any user whose username and password have been obtained from the system administrator. This section uses <strong id="admin_guide_000171__b92306201562">user_client</strong> as an example. Ensure that user <strong id="admin_guide_000171__b2537117172412">user_client</strong> is the owner of the server file directory (for example, <strong id="admin_guide_000171__b113013238285">/opt</strong><strong id="admin_guide_000171__b830113237284">/Bigdata</strong><strong id="admin_guide_000171__b18301162372814">/hadoopclient</strong>) and client installation directory (for example, <strong id="admin_guide_000171__b1811415426285"><span id="admin_guide_000171__ph381512063917">/opt/client</span></strong>). The permission for the two directories is <strong id="admin_guide_000171__b2032113176251">755</strong>.</li><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li44274261">You have obtained the component service username (a default user or new user) and password from the system administrator.</li><li id="admin_guide_000171__en-us_topic_0193213980_li1366734117407">When you install the client as a user other than <strong id="admin_guide_000171__en-us_topic_0193213980_b1270103162413">omm</strong> or <strong id="admin_guide_000171__en-us_topic_0193213980_b4725175172420">root</strong>, and the <strong id="admin_guide_000171__b0328164232512">/var/tmp/patch</strong> directory already exists, you have changed the permission for the directory to <strong id="admin_guide_000171__b49291518182618">777</strong> and changed the permission for the logs in the directory to <strong id="admin_guide_000171__b1720123782617">666</strong>.</li></ul>
|
|
</div>
|
|
<div class="section" id="admin_guide_000171__en-us_topic_0193213980_s6870771d9133462aa75d095bd7e63aa9"><h4 class="sectiontitle">Procedure</h4><ol id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_ol63681652"><li id="admin_guide_000171__en-us_topic_0193213980_li36272065115639"><span>Obtain the required software packages.</span><p><p id="admin_guide_000171__en-us_topic_0193213980_p15640135222617">Log in to <span id="admin_guide_000171__text155101019165619">MRS</span> Manager. <span id="admin_guide_000171__text68461439112613">Click the wanted cluster from the <strong>Cluster</strong> drop-down list.</span></p>
|
|
<p id="admin_guide_000171__en-us_topic_0193213980_p59080250115641">Click <strong id="admin_guide_000171__b187332743019">More</strong> and select <strong id="admin_guide_000171__b1567591063017">Download Client</strong>. The <strong id="admin_guide_000171__b345983177114618">Download Cluster Client</strong> page is displayed.</p>
|
|
<div class="note" id="admin_guide_000171__note1255111169211"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="admin_guide_000171__p15523164211">If only one component client is to be installed, choose <strong id="admin_guide_000171__b1516658718114618">Cluster</strong>, click the name of the target cluster, choose <strong id="admin_guide_000171__b1058539810114618">Services</strong>, click a service name, click <strong id="admin_guide_000171__b643141219344">More</strong>, and select <strong id="admin_guide_000171__b377211192347">Download Client</strong>. The <strong id="admin_guide_000171__b1853158268114618">Download Client</strong> page is displayed.</p>
|
|
</div></div>
|
|
</p></li><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li26947909"><span>Set <strong id="admin_guide_000171__b58491113163510">Select Client Type</strong> to <strong id="admin_guide_000171__b20849141312352">Complete Client</strong>.</span><p><p id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_p41204595"><strong id="admin_guide_000171__b11641125655613">Configuration Files Only</strong> is to download client configuration files in the following scenario: After a complete client is downloaded and installed and the system administrator modifies server configurations on Manager, developers need to update the configuration files during application development.</p>
|
|
<p id="admin_guide_000171__en-us_topic_0193213980_p197866515218">The platform type can be set to <strong id="admin_guide_000171__b2002663297114618">x86_64</strong> or <strong id="admin_guide_000171__b536254817114618">aarch64</strong>.</p>
|
|
<ul id="admin_guide_000171__en-us_topic_0193213980_ul1215614381573"><li id="admin_guide_000171__en-us_topic_0193213980_li1515614383571"><strong id="admin_guide_000171__b1340358918114618">x86_64</strong>: indicates the client software package that can be deployed on the x86 servers. </li><li id="admin_guide_000171__en-us_topic_0193213980_li4130628103215"><strong id="admin_guide_000171__b961285958114618">aarch64</strong>: indicates the client software package that can be deployed on the TaiShan servers. </li></ul>
|
|
<div class="note" id="admin_guide_000171__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="admin_guide_000171__p194192170270">The cluster supports two types of clients: <strong id="admin_guide_000171__b317810283441">x86_64</strong> and <strong id="admin_guide_000171__b9179192874416">aarch64</strong>. The client type must match the architecture of the node for installing the client. Otherwise, client installation will fail.</p>
|
|
</div></div>
|
|
</p></li><li id="admin_guide_000171__en-us_topic_0193213980_li4528442311580"><span><span id="admin_guide_000171__ph38852178262">Select the path for saving the downloaded client file.</span></span><p><p id="admin_guide_000171__p696412583577">You can directly download the client file to the node where the client is to be installed, or download the file to the active OMS node or local computer and copy it to the node where the client is to be installed.</p>
|
|
<ul id="admin_guide_000171__ul183523102616"><li id="admin_guide_000171__admin_guide_000014_li176630261458"><strong id="admin_guide_000171__admin_guide_000014_b44941250112116">Server</strong>: Download the file to the active OMS node of the cluster.<p id="admin_guide_000171__admin_guide_000014_p1611414513480">The generated file is stored in the <strong id="admin_guide_000171__admin_guide_000014_b147373825210042">/tmp/FusionInsight-Client</strong> directory on the active OMS node by default. You can also store the client file in other directories, and user <strong id="admin_guide_000171__admin_guide_000014_b130311484910042">omm</strong> has the read, write, and execute permissions on the directory. If the client file already exists in the path, the existing client file will be replaced.</p>
|
|
<div class="note" id="admin_guide_000171__admin_guide_000014_note109824615541"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="admin_guide_000171__admin_guide_000014_p19179123013011">When a cluster has many services installed, the cluster client file becomes quite large. Additionally, decompressing this file during installation can consume significant disk space. It's recommended to download the client files to a different directory that has ample space, or to promptly remove unnecessary files from the client download directory after installation. Doing so helps avoid exhausting the <strong id="admin_guide_000171__admin_guide_000014_b1213815612218">/tmp directory</strong>'s disk space, which could interrupt the normal operation of the cluster nodes.</p>
|
|
</div></div>
|
|
<p id="admin_guide_000171__admin_guide_000014_p811434513484">After the file is generated, copy the obtained package to another directory, for example, <strong id="admin_guide_000171__admin_guide_000014_b122700608010042">/opt</strong><strong id="admin_guide_000171__admin_guide_000014_b58281351510042">/Bigdata</strong><strong id="admin_guide_000171__admin_guide_000014_b78698261410042">/hadoopclient</strong>, as user <strong id="admin_guide_000171__admin_guide_000014_b192222954710042">omm</strong> or client installation user.</p>
|
|
</li><li id="admin_guide_000171__admin_guide_000014_li1549643524512"><strong id="admin_guide_000171__admin_guide_000014_b1255945612217">Browser</strong>: Download the file to the local computer.</li><li id="admin_guide_000171__admin_guide_000014_li340233817458"><strong id="admin_guide_000171__admin_guide_000014_b195283711817">Remote node:</strong> Download the file to a node other than the active OMS node. If you select this option, you need to set the following parameters:
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="admin_guide_000171__admin_guide_000014_table17680191211536" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters</caption><thead align="left"><tr id="admin_guide_000171__admin_guide_000014_row86811112135316"><th align="left" class="cellrowborder" valign="top" width="23.762376237623766%" id="mcps1.3.3.2.3.2.2.3.2.2.4.1.1"><p id="admin_guide_000171__admin_guide_000014_p4681141216539"><strong id="admin_guide_000171__admin_guide_000014_b45901795135">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="42.9042904290429%" id="mcps1.3.3.2.3.2.2.3.2.2.4.1.2"><p id="admin_guide_000171__admin_guide_000014_p14681191219536"><strong id="admin_guide_000171__admin_guide_000014_b21537134137">Description</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.2.3.2.2.3.2.2.4.1.3"><p id="admin_guide_000171__admin_guide_000014_p14681201225319"><strong id="admin_guide_000171__admin_guide_000014_b497319121313">Example Value</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="admin_guide_000171__admin_guide_000014_row1368141265311"><td class="cellrowborder" valign="top" width="23.762376237623766%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.1 "><p id="admin_guide_000171__admin_guide_000014_p1668131215532">Save to Path</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="42.9042904290429%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.2 "><p id="admin_guide_000171__admin_guide_000014_p59501421105518">Path for storing client files.</p>
|
|
<p id="admin_guide_000171__admin_guide_000014_p368110123531">If there is already a client file in the path, it will be overwritten. For a remote node, write permission for the path is required.</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.3 "><p id="admin_guide_000171__admin_guide_000014_p2068131217535">/tmp/FusionInsight-Client-Remote/</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000171__admin_guide_000014_row1168119124534"><td class="cellrowborder" valign="top" width="23.762376237623766%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.1 "><p id="admin_guide_000171__admin_guide_000014_p1168181214537">Host IP Address</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="42.9042904290429%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.2 "><p id="admin_guide_000171__admin_guide_000014_p13682151225318">IP address of the remote node.</p>
|
|
<div class="note" id="admin_guide_000171__admin_guide_000014_note15281145510416"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="admin_guide_000171__admin_guide_000014_p828219552418">The platform type of the remote node must be the same as that of the downloaded client. Otherwise, the client may fail to be installed.</p>
|
|
</div></div>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.3 "><p id="admin_guide_000171__admin_guide_000014_p468231220535">x.x.x.x</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000171__admin_guide_000014_row13682312155313"><td class="cellrowborder" valign="top" width="23.762376237623766%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.1 "><p id="admin_guide_000171__admin_guide_000014_p968261210532">Host Port</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="42.9042904290429%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.2 "><p id="admin_guide_000171__admin_guide_000014_p126824126535">Host port of the remote node.</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.3 "><p id="admin_guide_000171__admin_guide_000014_p15682312155314">22</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000171__admin_guide_000014_row168251265316"><td class="cellrowborder" valign="top" width="23.762376237623766%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.1 "><p id="admin_guide_000171__admin_guide_000014_p19682191217536">Username</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="42.9042904290429%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.2 "><p id="admin_guide_000171__admin_guide_000014_p2068216124536">Username for logging in to the remote node.</p>
|
|
<p id="admin_guide_000171__admin_guide_000014_p1586652317584">For a remote node, write permission for the path is required.</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.3 "><p id="admin_guide_000171__admin_guide_000014_p13682111215313">xxx</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000171__admin_guide_000014_row068261213537"><td class="cellrowborder" valign="top" width="23.762376237623766%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.1 "><p id="admin_guide_000171__admin_guide_000014_p106827128532">Authentication Method</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="42.9042904290429%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.2 "><p id="admin_guide_000171__admin_guide_000014_p10682121220531">You can choose one of the following methods:</p>
|
|
<ul id="admin_guide_000171__admin_guide_000014_ul78031653175818"><li id="admin_guide_000171__admin_guide_000014_li1803175345813"><strong id="admin_guide_000171__admin_guide_000014_b6851101519511">Password</strong>: Use the password for login.</li><li id="admin_guide_000171__admin_guide_000014_li1480320532586"><strong id="admin_guide_000171__admin_guide_000014_b552872319516">SSH private keys</strong>: Use SSH private keys for login.</li><li id="admin_guide_000171__admin_guide_000014_li16803135315582"><strong id="admin_guide_000171__admin_guide_000014_b7240142115112">None</strong>: To use this method, passwordless login needs to be enabled for the node.</li></ul>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.3 "><p id="admin_guide_000171__admin_guide_000014_p206822127538">Password</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000171__admin_guide_000014_row768291235319"><td class="cellrowborder" valign="top" width="23.762376237623766%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.1 "><p id="admin_guide_000171__admin_guide_000014_p15682912125312">Password</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="42.9042904290429%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.2 "><p id="admin_guide_000171__admin_guide_000014_p3969550803">This parameter is mandatory when <strong id="admin_guide_000171__admin_guide_000014_b376815338575">Authentication Method</strong> is set to <strong id="admin_guide_000171__admin_guide_000014_b745733965713">Password</strong>.</p>
|
|
<p id="admin_guide_000171__admin_guide_000014_p156826127536">This parameter indicates the password used for login.</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.3 "><p id="admin_guide_000171__admin_guide_000014_p7682312175310">xxx</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000171__admin_guide_000014_row174354576597"><td class="cellrowborder" valign="top" width="23.762376237623766%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.1 "><p id="admin_guide_000171__admin_guide_000014_p34351557195910">SSH Private Keys</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="42.9042904290429%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.2 "><p id="admin_guide_000171__admin_guide_000014_p5700449902">This parameter is mandatory when <strong id="admin_guide_000171__admin_guide_000014_b176914583316">Authentication Method</strong> is set to <strong id="admin_guide_000171__admin_guide_000014_b277019581731">SSH private keys</strong>.</p>
|
|
<p id="admin_guide_000171__admin_guide_000014_p3435175765917">Click <strong id="admin_guide_000171__admin_guide_000014_b36852357610042">Select File</strong> and select a local file to upload.</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.3 "><p id="admin_guide_000171__admin_guide_000014_p14366571598">-</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000171__admin_guide_000014_row1642037165414"><td class="cellrowborder" valign="top" width="23.762376237623766%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.1 "><p id="admin_guide_000171__admin_guide_000014_p1944113716544">Auto Deployment</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="42.9042904290429%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.2 "><p id="admin_guide_000171__admin_guide_000014_p944183705412">Whether to enable auto deployment. This parameter is mandatory when <strong id="admin_guide_000171__admin_guide_000014_b746924260">Select Client Type</strong> is set to <strong id="admin_guide_000171__admin_guide_000014_b1457274111610">Complete Client</strong>.</p>
|
|
<ul id="admin_guide_000171__admin_guide_000014_ul79311736079"><li id="admin_guide_000171__admin_guide_000014_li179310362711">If you set this parameter to <strong id="admin_guide_000171__admin_guide_000014_b126451845875">yes</strong>, the client is automatically installed and deployed on the current node.</li><li id="admin_guide_000171__admin_guide_000014_li1786338177">If you set this parameter to <strong id="admin_guide_000171__admin_guide_000014_b1248319551477">no</strong>, the client will not be automatically installed and deployed. You need to manually install the client after it is downloaded.</li></ul>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.3 "><p id="admin_guide_000171__admin_guide_000014_p1844837165416">Yes</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000171__admin_guide_000014_row92281016214"><td class="cellrowborder" valign="top" width="23.762376237623766%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.1 "><p id="admin_guide_000171__admin_guide_000014_p322820161313">Deployment Path</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="42.9042904290429%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.2 "><p id="admin_guide_000171__admin_guide_000014_p1322821615117">This parameter is mandatory when <strong id="admin_guide_000171__admin_guide_000014_b1468154012811">Auto Deployment</strong> is set to <strong id="admin_guide_000171__admin_guide_000014_b20388948384">Yes</strong>. If only the configuration file is downloaded, this parameter will not be displayed.</p>
|
|
<p id="admin_guide_000171__admin_guide_000014_p1271624413146">The deployment path must be empty if it already exists on the remote node. Otherwise, it will be created automatically. The path also requires operate and write permissions.</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.3.2.2.3.2.2.4.1.3 "><p id="admin_guide_000171__admin_guide_000014_p6228151612115">/opt/testclient</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<p id="admin_guide_000171__p1696719272296">Copy the obtained software package to the file directory (for example, <strong id="admin_guide_000171__b17176142192615">/tmp/FusionInsight-Client</strong>) of the server where the client is to be installed as the user (for example, <strong id="admin_guide_000171__b175551032614">user_client</strong>) who is preparing to install the client.</p>
|
|
<p id="admin_guide_000171__en-us_topic_0193213980_p15291226254">The name of the client software package is in the follow format: <strong id="admin_guide_000171__b1390070003114618">FusionInsight_Cluster_</strong><strong id="admin_guide_000171__b207859828114618"><em id="admin_guide_000171__i754241331114618"><</em></strong><em id="admin_guide_000171__i174626328114618">Cluster ID</em><strong id="admin_guide_000171__b242309878114618"><em id="admin_guide_000171__i528530268114618">></em></strong><strong id="admin_guide_000171__b352809672114618">_Services_Client.tar</strong>.</p>
|
|
<div class="p" id="admin_guide_000171__en-us_topic_0193213980_p39101414513">The following steps and sections use <strong id="admin_guide_000171__b949698372114618">FusionInsight_Cluster_1_Services_Client.tar</strong> as an example.<div class="note" id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_note34977969"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="admin_guide_000171__en-us_topic_0193213980_p138271856111618">The host where the client is to be installed can be a node inside or outside the cluster. If the node is a server outside the cluster, it must be able to communicate with the cluster, and the NTP service must be enabled to ensure that the time is the same as that on the server.</p>
|
|
<div class="p" id="admin_guide_000171__en-us_topic_0193213980_p992418596245">For example, you can configure the same NTP clock source for external servers as that of the cluster. After the configuration, you can run the <strong id="admin_guide_000171__en-us_topic_0193213980_b16649135163713">ntpq -np</strong> command to check whether the time is synchronized.<ul id="admin_guide_000171__en-us_topic_0193213980_ul3992810193616"><li id="admin_guide_000171__en-us_topic_0193213980_li2273084364">If there is an asterisk (*) before the IP address of the NTP clock source in the command output, the synchronization is normal. For example:<pre class="screen" id="admin_guide_000171__en-us_topic_0193213980_screen938215466376">remote refid st t when poll reach delay offset jitter
|
|
==============================================================================
|
|
<strong id="admin_guide_000171__en-us_topic_0193213980_b3149828103813">*</strong>10.10.10.162 .LOCL. 1 u 1 16 377 0.270 -1.562 0.014</pre>
|
|
</li><li id="admin_guide_000171__en-us_topic_0193213980_li15679162453620">If there is no asterisk (*) before the IP address of the NTP clock source and the value of <strong id="admin_guide_000171__b681877726114618">refid</strong> is <strong id="admin_guide_000171__b150848319114618">.INIT.</strong>, or if the command output is abnormal, the synchronization is abnormal. Contact technical support.<pre class="screen" id="admin_guide_000171__en-us_topic_0193213980_screen118291523173712">remote refid st t when poll reach delay offset jitter
|
|
==============================================================================
|
|
10.10.10.162 <strong id="admin_guide_000171__en-us_topic_0193213980_b9837336173815">.INIT.</strong> 1 u 1 16 377 0.270 -1.562 0.014</pre>
|
|
</li></ul>
|
|
</div>
|
|
<p id="admin_guide_000171__en-us_topic_0193213980_p15360143104011">You can also configure the same chrony clock source for external servers as that for the cluster. After the configuration, run the <strong id="admin_guide_000171__en-us_topic_0193213980_b187491840194014">chronyc sources</strong> command to check whether the time is synchronized.</p>
|
|
<ul id="admin_guide_000171__en-us_topic_0193213980_ul584791513411"><li id="admin_guide_000171__en-us_topic_0193213980_li1084811159410">In the command output, if there is an asterisk (*) before the IP address of the chrony service on the active OMS node, the synchronization is normal. For example:<pre class="screen" id="admin_guide_000171__en-us_topic_0193213980_screen3473174504110">MS Name/IP address Stratum Poll Reach LastRx Last sample
|
|
===============================================================================
|
|
^* 10.10.10.162 10 10 377 626 +16us[ +15us] +/- 308us</pre>
|
|
</li><li id="admin_guide_000171__en-us_topic_0193213980_li1484810157415">In the command output, if there is no asterisk (*) before the IP address of the NTP service on the active OMS node, and the value of <strong id="admin_guide_000171__b1520722290114618">Reach</strong> is <strong id="admin_guide_000171__b2081559964114618">0</strong>, the synchronization is abnormal.<pre class="screen" id="admin_guide_000171__en-us_topic_0193213980_screen17848151520415">MS Name/IP address Stratum Poll Reach LastRx Last sample
|
|
===============================================================================
|
|
^? 10.1.1.1 0 10 0 - +0ns[ +0ns] +/- 0ns</pre>
|
|
</li></ul>
|
|
</div></div>
|
|
</div>
|
|
</p></li><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_u_login"><span>Log in as user <strong id="admin_guide_000171__b901470455114618">user_client</strong> to the server where the client is to be installed.</span></li><li id="admin_guide_000171__en-us_topic_0193213980_li40637408115839"><span>Decompress the software package.</span><p><p id="admin_guide_000171__en-us_topic_0193213980_p64472750115839">Go to the directory where the installation package is stored, for example, <strong id="admin_guide_000171__b8901161018323">/opt</strong><strong id="admin_guide_000171__b1190181010327">/Bigdata</strong><strong id="admin_guide_000171__b11901161083219">/hadoopclient</strong>. Run the following command to decompress the installation package to a local directory:</p>
|
|
<p id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_p41540743"><strong id="admin_guide_000171__en-us_topic_0193213980_b62735692115850">tar -xvf </strong><strong id="admin_guide_000171__en-us_topic_0193213980_b13193145991418">FusionInsight_Cluster_1_Services_Client.tar</strong></p>
|
|
</p></li><li id="admin_guide_000171__en-us_topic_0193213980_li2141688611590"><span>Verify the software package.</span><p><p id="admin_guide_000171__en-us_topic_0193213980_p4558596411591">Run the following command to verify the decompressed file and check whether the command output is consistent with the information in the <strong id="admin_guide_000171__b012972813533">sha256</strong> file:</p>
|
|
<p id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_p17103984"><strong id="admin_guide_000171__en-us_topic_0193213980_b4377976115922">sha256sum -c </strong><strong id="admin_guide_000171__en-us_topic_0193213980_b7722175017173">FusionInsight_Cluster_1_Services_ClientConfig.tar</strong><strong id="admin_guide_000171__en-us_topic_0193213980_b157602204191">.sha256</strong></p>
|
|
<pre class="screen" id="admin_guide_000171__en-us_topic_0193213980_s34b562fd0e714bc4aa8aba57b503ea70">FusionInsight_Cluster_1_Services_ClientConfig.tar: OK </pre>
|
|
</p></li><li id="admin_guide_000171__en-us_topic_0193213980_li62266957115938"><span>Decompress the obtained installation file.</span><p><p id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_p13221196"><strong id="admin_guide_000171__en-us_topic_0193213980_b31524290115943">tar -xvf </strong><strong id="admin_guide_000171__en-us_topic_0193213980_b18293612014">FusionInsight_Cluster_1_Services_ClientConfig.tar</strong></p>
|
|
</p></li><li id="admin_guide_000171__en-us_topic_0193213980_li10537097142542"><span>Configure network connections for the client.</span><p><ol type="a" id="admin_guide_000171__en-us_topic_0193213980_ol27725017142542"><li id="admin_guide_000171__en-us_topic_0193213980_li48198562142542">Ensure that the host where the client is installed can communicate with the hosts listed in the <strong id="admin_guide_000171__b1603600863114618">hosts</strong> file in the decompression directory (for example, <strong id="admin_guide_000171__b1323883368114618">/opt/Bigdata/hadoopclient/FusionInsight_Cluster_</strong><em id="admin_guide_000171__i1654553996114618"><Cluster ID></em><strong id="admin_guide_000171__b311059058114618">_Services_ClientConfig/hosts</strong>).</li><li id="admin_guide_000171__en-us_topic_0193213980_li31133879142542">If the host where the client is installed is not a host in the cluster, you need to set the mapping between the host name and the service plane IP address for each cluster node in <strong id="admin_guide_000171__b305802997114618">/etc/hosts</strong>, as user <strong id="admin_guide_000171__b1725473165114618">root</strong>. Each host name uniquely maps an IP address. You can perform the following steps to import the domain name mapping of the cluster to the <strong id="admin_guide_000171__b1923545008114618">hosts</strong> file:<ol class="substepthirdol" id="admin_guide_000171__en-us_topic_0193213980_ol050771119405"><li id="admin_guide_000171__en-us_topic_0193213980_li257176194011">Switch to user <strong id="admin_guide_000171__b258108036114618">root</strong> or a user who has the permission to modify the <strong id="admin_guide_000171__b935618953114618">hosts</strong> file.<p id="admin_guide_000171__en-us_topic_0193213980_p341423816468"><strong id="admin_guide_000171__en-us_topic_0193213980_b14218194134619">su - root</strong></p>
|
|
</li><li id="admin_guide_000171__en-us_topic_0193213980_li16977514194210">Go to the directory where the client package is decompressed.<p id="admin_guide_000171__en-us_topic_0193213980_p11448183334317"><a name="admin_guide_000171__en-us_topic_0193213980_li16977514194210"></a><a name="en-us_topic_0193213980_li16977514194210"></a><strong id="admin_guide_000171__en-us_topic_0193213980_b04481033134314">cd /opt/Bigdata/hadoopclient/FusionInsight</strong><strong id="admin_guide_000171__en-us_topic_0193213980_b1744817331434">_Cluster_1_Services_ClientConfig</strong></p>
|
|
</li><li id="admin_guide_000171__en-us_topic_0193213980_li1550179441">Run the <strong id="admin_guide_000171__b1384536012114618">cat realm.ini >> /etc/hosts</strong> command to import the domain name mapping to the <strong id="admin_guide_000171__b191800431114618">hosts</strong> file.</li></ol>
|
|
</li></ol>
|
|
<div class="note" id="admin_guide_000171__en-us_topic_0193213980_note57107492142542"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="admin_guide_000171__en-us_topic_0193213980_ul44205383142542"><li id="admin_guide_000171__en-us_topic_0193213980_li62304131142542">If the host where the client is installed is not a node in the cluster, configure network connections for the client to prevent errors when you run commands on the client.</li><li id="admin_guide_000171__en-us_topic_0193213980_li23866274142542">If Spark tasks are executed in yarn-client mode, add the <strong id="admin_guide_000171__b1689145094114618">spark.driver.host</strong> parameter to the file <em id="admin_guide_000171__i571779004114618">Client installation directory</em><strong id="admin_guide_000171__b1371617030114618">/Spark/spark/conf/spark-defaults.conf</strong> and set the parameter to the client IP address.</li><li id="admin_guide_000171__en-us_topic_0193213980_li54120017142542">If the yarn-client mode is used, you need to configure the mapping between the IP address and host name of the client in the <strong id="admin_guide_000171__b1466343784114618">hosts</strong> file on the active and standby Yarn nodes (ResourceManager nodes in the cluster) to make sure that the Spark web UI is properly displayed.</li></ul>
|
|
</div></div>
|
|
</p></li><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li64283975"><span>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="admin_guide_000171__b12238125516328"><span id="admin_guide_000171__ph2024073520157">/opt/client</span></strong>:</span><p><p id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_p41684868"><strong id="admin_guide_000171__en-us_topic_0193213980_b60975609115955">cd /opt/Bigdata/hadoopclient/FusionInsight</strong><strong id="admin_guide_000171__en-us_topic_0193213980_b11909569115955">_Cluster_1_Services_ClientConfig</strong></p>
|
|
<p id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_p20114008">Run the <strong id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_b46808346">./install.sh <span id="admin_guide_000171__ph1184492183916">/opt/client</span></strong> command to install the client. The client is successfully installed if information similar to the following is displayed:</p>
|
|
<pre class="screen" id="admin_guide_000171__en-us_topic_0193213980_sa1ec942b8a634a789cb524d480c9b987">The component client is installed successfully</pre>
|
|
<div class="note" id="admin_guide_000171__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="admin_guide_000171__en-us_topic_0193213980_ul17447615152417"><li id="admin_guide_000171__en-us_topic_0193213980_li1544771552416">If the <strong id="admin_guide_000171__b1122847310114618">/opt/hadoopclient</strong> directory has been used by existing service clients, you need to use another directory in this step when installing other service clients.</li><li id="admin_guide_000171__en-us_topic_0193213980_li164471115192413">You must delete the client installation directory when uninstalling a client.</li><li id="admin_guide_000171__en-us_topic_0193213980_li244718150244">To ensure that an installed client can only be used by the installation user (for example, <strong id="admin_guide_000171__b2074559611114618">user_client</strong>), add parameter <strong id="admin_guide_000171__b1280811159114618">-o</strong> during the installation. That is, run the <strong id="admin_guide_000171__b2008666325114618">./install.sh /opt/hadoopclient -o</strong> command to install the client.</li><li id="admin_guide_000171__en-us_topic_0193213980_li680118234433">If the NTP server is to be installed in <strong id="admin_guide_000171__b1883226944114618">chrony</strong> mode, ensure that the parameter <strong id="admin_guide_000171__b1266884323114618">chrony</strong> is added during the installation, that is, run the <strong id="admin_guide_000171__en-us_topic_0193213980_b1115742810447">./install.sh <span id="admin_guide_000171__ph14422151101612">/opt/client</span> -o</strong> <strong id="admin_guide_000171__en-us_topic_0193213980_b3449144918444">chrony</strong> command to install the client.</li><li id="admin_guide_000171__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 special characters (_-?.@+=) due to the limitation of the Ruby syntax used by HBase.</li><li id="admin_guide_000171__en-us_topic_0193213980_li105977183511">If the client node is a server outside the cluster and cannot communicate with the service plane IP address of the active OMS node or cannot access port 20029 of the active OMS node, the client can be successfully installed but cannot be registered with the cluster or displayed on the UI.</li></ul>
|
|
</div></div>
|
|
</p></li><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li123786"><span>Log in to the client to check whether the client is successfully installed.</span><p><ol type="a" id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_ol1114082"><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li10026740">Run the <strong id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_b23131803">cd <span id="admin_guide_000171__ph35517184166">/opt/client</span></strong> command to go to the client installation directory.</li><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li6859639">Run the <strong id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_b61736753">source bigdata_env</strong> command to configure environment variables for the client.</li><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li18759866">For a cluster in security mode, run the following command to set <strong id="admin_guide_000171__en-us_topic_0193213980_b4585587112238">kinit</strong> authentication and enter the password for logging in to the client. For a cluster in normal mode, user authentication is not required.<p class="litext" id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_p34621067"><strong id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_b43154149">kinit admin</strong></p>
|
|
<pre class="screen" id="admin_guide_000171__en-us_topic_0193213980_sa80889a6191c459aa37d2d5cfad35644">Password for xxx@HADOOP.COM: #Enter the login password of user <strong id="admin_guide_000171__b1045292956114618">admin</strong> (same as the user password for logging in to the cluster).</pre>
|
|
</li><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li5825185">Run the <strong id="admin_guide_000171__b165792411560">klist</strong> command to query and confirm authentication details.<pre class="screen" id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_screen2077973">Ticket cache: FILE:/tmp/krb5cc_0
|
|
Default principal: xxx@HADOOP.COM
|
|
|
|
Valid starting Expires Service principal
|
|
04/09/2021 18:22:35 04/10/2021 18:22:29 krbtgt/HADOOP.COM@HADOOP.COM</pre>
|
|
<div class="note" id="admin_guide_000171__en-us_topic_0193213980_note1045083433418"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="admin_guide_000171__en-us_topic_0193213980_ul13310154419386"><li id="admin_guide_000171__en-us_topic_0193213980_li531014483816">When kinit authentication is used, the ticket is stored in the <strong id="admin_guide_000171__b1252952716717">/tmp/krb5cc_</strong><em id="admin_guide_000171__en-us_topic_0193213980_i3420130133912">uid</em> directory by default.<p id="admin_guide_000171__en-us_topic_0193213980_p102953263359"><em id="admin_guide_000171__i073411408718">uid</em> indicates the ID of the user who logs in to the OS. For example, if the UID of user <strong id="admin_guide_000171__b201969587714">root</strong> is 0, the ticket generated for kinit authentication after user <strong id="admin_guide_000171__b25190265816">root</strong> logs in to the system is stored in the <strong id="admin_guide_000171__b137329161686">/tmp/krb5cc_0</strong> directory.</p>
|
|
<p id="admin_guide_000171__p9637131411011">If the current user does not have the read/write permission for the <span class="filepath" id="admin_guide_000171__filepath1068561092613"><b>/tmp</b></span> directory, the ticket cache path is changed to <span class="filepath" id="admin_guide_000171__filepath691019142616"><b>Client installation directory/tmp/krb5cc_uid</b></span>. For example, if the client installation directory is <span class="filepath" id="admin_guide_000171__filepath2052114362611"><b>/opt/hadoopclient</b></span>, the kinit authentication ticket is stored in <span class="filepath" id="admin_guide_000171__filepath1069212416273"><b>/opt/hadoopclient/tmp/krb5cc_uid</b></span>.</p>
|
|
</li></ul>
|
|
<ul id="admin_guide_000171__en-us_topic_0193213980_ul193519467387"><li id="admin_guide_000171__en-us_topic_0193213980_li7935146173818">If the same user is used to log in to the OS for kinit authentication, there is a risk that tickets are overwritten. You can set the <strong id="admin_guide_000171__en-us_topic_0193213980_b81982108256">-c </strong><em id="admin_guide_000171__en-us_topic_0193213980_i22001710102516">cache_name</em> parameter to specify the ticket cache path or set the <strong id="admin_guide_000171__b1185119191010">KRB5CCNAME</strong> environment variable to avoid this problem.</li></ul>
|
|
</div></div>
|
|
</li></ol>
|
|
</p></li><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li18701764"><span>After the cluster is reinstalled, the previously installed client is no longer available. Perform the following operations to deploy the client again:</span><p><ol type="a" id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_ol34098154"><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li38447936">Log in to the node where the client is deployed as user <strong id="admin_guide_000171__b1182546070114618">root</strong>.</li><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li10487112">Run the following command to view the directory where the client is located: (In the following example, <strong id="admin_guide_000171__b161805069114618">/opt/hadoopclient</strong> is the directory where the client is located.)<p class="litext" id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_p27275145"><strong id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_b44149718">ll /opt</strong></p>
|
|
<pre class="screen" id="admin_guide_000171__en-us_topic_0193213980_s9dfd4d1ec82644aa9df3efe39b1d3bd5">drwxr-x---. 6 root root 4096 Dec 11 19:00 hadoopclient
|
|
drwxr-xr-x. 3 root root 4096 Dec 9 02:04 godi
|
|
drwx------. 2 root root 16384 Nov 6 01:03 lost+found
|
|
drwxr-xr-x. 2 root root 4096 Nov 7 09:49 rh </pre>
|
|
</li><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li19357372">Run the following command to delete the files in the folder (for example, <strong id="admin_guide_000171__b35691179114618"><span id="admin_guide_000171__ph1198772821618">/opt/client</span></strong>) where all client programs are located:<p class="litext" id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_p39998624"><strong id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_b24443299">mv <span id="admin_guide_000171__ph14280235171610">/opt/client</span></strong> <em id="admin_guide_000171__i186922218313">/tmp/clientbackup</em></p>
|
|
</li><li id="admin_guide_000171__en-us_topic_0193213980_en-us_topic_0046662333_li18663102">Reinstall the client.</li></ol>
|
|
</p></li></ol>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="admin_guide_000170.html">Configuring Client</a></div>
|
|
</div>
|
|
</div>
|
|
|