forked from docs/doc-exports
Yang, Tong
5914b67d13
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com> Co-authored-by: Yang, Tong <yangtong2@huawei.com> Co-committed-by: Yang, Tong <yangtong2@huawei.com>
34 lines
9.5 KiB
HTML
34 lines
9.5 KiB
HTML
<a name="admin_guide_000023"></a><a name="admin_guide_000023"></a>
|
|
|
|
<h1 class="topictitle1">Batch Upgrading Clients</h1>
|
|
<div id="body1566465445965"><div class="section" id="admin_guide_000023__section2098374842018"><h4 class="sectiontitle">Scenario</h4><p id="admin_guide_000023__p17813105152019">The client package downloaded from <span id="admin_guide_000023__text154091129192818">MRS</span> Manager contains the client batch upgrade tool. When multiple clients need to be upgraded after the cluster upgrade or scale-out, you can use this tool to upgrade the clients in batches with a few clicks. In addition, the tool provides the lightweight function of batch updating the <span class="filepath" id="admin_guide_000023__filepath5184659122717"><b>/etc/hosts</b></span> file on the nodes where the clients are located.</p>
|
|
</div>
|
|
<div class="section" id="admin_guide_000023__section19698195420203"><h4 class="sectiontitle">Procedure</h4><p id="admin_guide_000023__p174411771188"><strong id="admin_guide_000023__b164403791812">Prepare for the client upgrade.</strong></p>
|
|
<ol id="admin_guide_000023__ol9434120122112"><li id="admin_guide_000023__li13434140152112"><span>Log in to <span id="admin_guide_000023__text117431293116">MRS</span> Manager.</span></li><li id="admin_guide_000023__li978097131616"><span>Choose <strong id="admin_guide_000023__b13361243142016">Cluster</strong>, click the name of the desired cluster, click <strong id="admin_guide_000023__b9937654182011">More</strong>, and select <strong id="admin_guide_000023__b161421120152612">Download Client</strong> (for MRS 3.3.0 or later, click <strong id="admin_guide_000023__b3947123122719">Download Client</strong> on the <strong id="admin_guide_000023__b15657101122714">Homepage</strong> page) to download the complete client to the specified directory on the server.</span><p><p id="admin_guide_000023__p12910225182911">For details, see <a href="admin_guide_000014.html">Downloading the Client</a>.</p>
|
|
<p id="admin_guide_000023__p1356275303414">Decompress the downloaded client package and find the <strong id="admin_guide_000023__b99293432267">batch_upgrade</strong> directory, for example, <strong id="admin_guide_000023__b416665822618">/tmp/FusionInsight-Client/FusionInsight_Cluster_1_Services_ClientConfig/batch_upgrade</strong>.</p>
|
|
</p></li><li id="admin_guide_000023__li1361014342011"><span>Choose <strong id="admin_guide_000023__b18469102762714">Cluster</strong>, click the name of the desired cluster, and choose <strong id="admin_guide_000023__b563513339273">Client Management</strong>. On the <strong id="admin_guide_000023__b5980438202712">Client Management</strong> page, click <strong id="admin_guide_000023__b11416114192712">Export All</strong> to export all client information to the local PC.</span></li><li id="admin_guide_000023__li655310347208"><span>Decompress the exported client information and upload the <strong id="admin_guide_000023__b1682918239287">client-info.cfg</strong> file to the <strong id="admin_guide_000023__b176562792810">batch_upgrade</strong> directory.</span></li><li id="admin_guide_000023__li15943263010"><span>Supplement the password in the <strong id="admin_guide_000023__b16782951202813">client-info.cfg</strong> file by referring to <a href="#admin_guide_000023__section596192114916">Reference Information</a>.</span></li></ol>
|
|
<p id="admin_guide_000023__p1780511256334"><strong id="admin_guide_000023__b148421323173317">Upgrade clients in batches.</strong></p>
|
|
<ol start="6" id="admin_guide_000023__ol16843152316331"><li id="admin_guide_000023__li16842142373319"><span>Run the <strong id="admin_guide_000023__b178920245013">sh client_batch_upgrade.sh -u -f /tmp/FusionInsight-Client/FusionInsight_Cluster_1_Services_Client.tar</strong> <strong id="admin_guide_000023__b20597203111817">-g </strong><strong id="admin_guide_000023__b1659912318184">/tmp/FusionInsight-Client/FusionInsight_Cluster_1_Services_ClientConfig/batch_upgrade</strong><strong id="admin_guide_000023__b1060043119182">/client-info.cfg</strong> command to perform the upgrade.</span><p><div class="notice" id="admin_guide_000023__note7991048134113"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="admin_guide_000023__p89944814114">You are advised to delete the <strong id="admin_guide_000023__b1012364254116">client-info.cfg</strong> file as soon as possible after the upgrade because the password has been configured.</p>
|
|
</div></div>
|
|
</p></li><li id="admin_guide_000023__li8842923123310"><span>After the upgrade is complete, verify the upgrade result by running the <strong id="admin_guide_000023__b827061819536">sh client_batch_upgrade.sh -c</strong> command.</span></li><li id="admin_guide_000023__li158422023103316"><span>If the client is faulty, run the <strong id="admin_guide_000023__b13540132285311">sh client_batch_upgrade.sh -s</strong> command to roll back the client.</span><p><div class="note" id="admin_guide_000023__note168424237333"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="admin_guide_000023__ul1999014719565"><li id="admin_guide_000023__li8121451583">The client batch upgrade tool moves the original client to the backup directory, and then uses the client package specified by the <strong id="admin_guide_000023__b35064126206">-f</strong> parameter to install the client. Therefore, if the original client contains customized content, manually save the customized content from the backup directory or move the customized content to the client directory after the upgrade before running the <strong id="admin_guide_000023__b2601125516208">-c</strong> command. The backup path on the client is <em id="admin_guide_000023__i122314323310">{Original client path}</em><strong id="admin_guide_000023__b1278317475336">-backup</strong>.</li><li id="admin_guide_000023__li49901715567">The <strong id="admin_guide_000023__b649918202215">-u</strong> command is the prerequisite for the <strong id="admin_guide_000023__b19270812102216">-c</strong> and <strong id="admin_guide_000023__b197021310224">-s</strong> commands. You can run the <strong id="admin_guide_000023__b72646509359">-c</strong> command to commit the upgrade or the <strong id="admin_guide_000023__b1511775417353">-s</strong> command to perform a rollback only after the <strong id="admin_guide_000023__b578672116366">-u</strong> command is executed to perform an upgrade.</li><li id="admin_guide_000023__li1325962325618">You can run the <strong id="admin_guide_000023__b2697459193619">-u</strong> command multiple times to upgrade only the clients that fail to be upgraded.</li><li id="admin_guide_000023__li84451853125619">The client batch upgrade tool also supports the clients of earlier versions.</li><li id="admin_guide_000023__li45352618394">When upgrading a client installed by a non-root user, ensure that the user has the read and write permissions on the directory where the client is located and the parent directory on the target node. Otherwise, the upgrade will fail.</li><li id="admin_guide_000023__li412583711297">The client package specified by the <strong id="admin_guide_000023__b822519139912">-f</strong> parameter must be a full client package. The client packages of a single component or some components cannot be used as the input.</li></ul>
|
|
</div></div>
|
|
</p></li></ol>
|
|
</div>
|
|
<div class="section" id="admin_guide_000023__section596192114916"><a name="admin_guide_000023__section596192114916"></a><a name="section596192114916"></a><h4 class="sectiontitle">Reference Information</h4><p id="admin_guide_000023__p105091943195810">Before upgrading clients in batches, you need to manually configure the user password for remotely logging in to the client node.</p>
|
|
<p id="admin_guide_000023__p180114013171">Run the <strong id="admin_guide_000023__b102722512134">vi client-info.cfg</strong> command to add a user password.</p>
|
|
<p id="admin_guide_000023__p148520386159">Example:</p>
|
|
<pre class="screen" id="admin_guide_000023__screen1857114428153">clientIp,clientPath,user,password
|
|
10.10.10.100,/home/omm/client /home/omm/client2,omm,<em id="admin_guide_000023__i1269392505513">Password</em></pre>
|
|
<p id="admin_guide_000023__p12606341941">The fields in the configuration file are as follows:</p>
|
|
<ul id="admin_guide_000023__ul17873141017181"><li id="admin_guide_000023__li11873141081819"><strong id="admin_guide_000023__b46405190407">clientIp</strong>: indicates the IP address of the node where the client is located.</li><li id="admin_guide_000023__li1599773331810"><strong id="admin_guide_000023__b15386324184011">clientPath</strong>: indicates the client installation path. Multiple paths are separated by spaces. Note that the path cannot end with a slash (/).</li><li id="admin_guide_000023__li17441105671815"><strong id="admin_guide_000023__b186445619403">user</strong>: indicates the username of the node.</li><li id="admin_guide_000023__li9343162151911"><strong id="admin_guide_000023__b37567811419">password</strong>: indicates the user password of the node.<div class="note" id="admin_guide_000023__note67351140113411"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="admin_guide_000023__p591264404512">If the execution fails, view the <strong id="admin_guide_000023__b168272017124712">node.log</strong> file in the <strong id="admin_guide_000023__b16762017135010">work_space/log</strong>_<em id="admin_guide_000023__i129787566497">XXX</em> directory.</p>
|
|
</div></div>
|
|
</li></ul>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="admin_guide_000021.html">Managing Clients</a></div>
|
|
</div>
|
|
</div>
|
|
|