forked from docs/doc-exports
Yang, Tong
3f5759eed2
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>
30 lines
6.9 KiB
HTML
30 lines
6.9 KiB
HTML
<a name="mrs_01_1737"></a><a name="mrs_01_1737"></a>
|
|
|
|
<h1 class="topictitle1">Using the HetuEngine Client</h1>
|
|
<div id="body32001227"><div class="section" id="mrs_01_1737__en-us_topic_0000001173949702_section269942919298"><h4 class="sectiontitle">Scenario</h4><p id="mrs_01_1737__en-us_topic_0000001173949702_p13548153933716">If a compute instance is not created or started, you can log in to the HetuEngine client to create or start the compute instance. This section describes how to manage a compute instance on the client in the O&M or service scenario.</p>
|
|
</div>
|
|
<div class="section" id="mrs_01_1737__en-us_topic_0000001173949702_section1476992516195"><h4 class="sectiontitle">Prerequisites</h4><ul id="mrs_01_1737__en-us_topic_0000001173949702_ul719191514144"><li id="mrs_01_1737__en-us_topic_0000001173949702_li121919156148">The cluster client has been installed. For example, the installation directory is <strong id="mrs_01_1737__en-us_topic_0000001173949702_b2666104410314">/opt/</strong><strong id="mrs_01_1737__en-us_topic_0000001173949702_b116669446315"></strong><strong id="mrs_01_1737__en-us_topic_0000001173949702_b146661448310">client</strong>.</li><li id="mrs_01_1737__en-us_topic_0000001173949702_li519121541412">You have created a common HetuEngine user, for example, <strong id="mrs_01_1737__en-us_topic_0000001173949702_b78217307529">hetu_test</strong> who has the permissions of the Hive (with Ranger disabled), <strong id="mrs_01_1737__en-us_topic_0000001173949702_b13821183012524">hetuuser</strong>, and <strong id="mrs_01_1737__en-us_topic_0000001173949702_b16821143016522">default</strong> queues.<p id="mrs_01_1737__en-us_topic_0000001173949702_p121971591413">For details about how to create a user, see <a href="mrs_01_1714.html">Creating a HetuEngine User</a>.</p>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="mrs_01_1737__en-us_topic_0000001173949702_section53799862110"><h4 class="sectiontitle">Procedure</h4><ol id="mrs_01_1737__en-us_topic_0000001173949702_ol150713539343"><li id="mrs_01_1737__en-us_topic_0000001173949702_li13507125373419"><span>Log in to the node where the <span id="mrs_01_1737__en-us_topic_0000001173949702_text230821682217">HetuEngine</span> client resides as the user who installs the client, and switch to the client installation directory.</span><p><p id="mrs_01_1737__en-us_topic_0000001173949702_p310152911224"><strong id="mrs_01_1737__en-us_topic_0000001173949702_b31941511148">cd /opt/client</strong></p>
|
|
</p></li><li id="mrs_01_1737__en-us_topic_0000001173949702_li250816535342"><span>Run the following command to configure environment variables:</span><p><p id="mrs_01_1737__en-us_topic_0000001173949702_p30260676141247"><strong id="mrs_01_1737__en-us_topic_0000001173949702_b10818837141247">source bigdata_env</strong></p>
|
|
</p></li><li id="mrs_01_1737__en-us_topic_0000001173949702_li8503113010214"><span>Log in to the <span id="mrs_01_1737__en-us_topic_0000001173949702_text3883175283516">HetuEngine</span> client based on the cluster authentication mode.</span><p><ul id="mrs_01_1737__en-us_topic_0000001173949702_ul134861562374"><li id="mrs_01_1737__en-us_topic_0000001173949702_li8466135743912">In security mode, run the following command to complete user authentication and log in to the <span id="mrs_01_1737__en-us_topic_0000001173949702_text1483205873516">HetuEngine</span> client:<p id="mrs_01_1737__en-us_topic_0000001173949702_p1853018313404"><strong id="mrs_01_1737__en-us_topic_0000001173949702_b49141793477">kinit hetu_test</strong></p>
|
|
<p id="mrs_01_1737__en-us_topic_0000001173949702_p26951059143919"><strong id="mrs_01_1737__en-us_topic_0000001173949702_b134951512472">hetu-cli --catalog hive --tenant default --schema default</strong></p>
|
|
</li><li id="mrs_01_1737__en-us_topic_0000001173949702_li66631185400">In normal mode, run the following command to log in to the <span id="mrs_01_1737__en-us_topic_0000001173949702_text1941041363">HetuEngine</span> client:<p id="mrs_01_1737__en-us_topic_0000001173949702_p2577121394014"><strong id="mrs_01_1737__en-us_topic_0000001173949702_b1891509474">hetu-cli --catalog hive --tenant default --schema default --user hetu_test</strong></p>
|
|
<div class="note" id="mrs_01_1737__en-us_topic_0000001173949702_note14314192411561"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="mrs_01_1737__en-us_topic_0000001173949702_p101611347175719"><strong id="mrs_01_1737__en-us_topic_0000001173949702_b14659111565412">hetu_test</strong> is a service user who has at least the tenant role specified by <strong id="mrs_01_1737__en-us_topic_0000001173949702_b18417172425411">--tenant</strong> and cannot be an OS user.</p>
|
|
</div></div>
|
|
</li></ul>
|
|
<p id="mrs_01_1737__en-us_topic_0000001173949702_p1545119144219">Parameter description:</p>
|
|
<ul id="mrs_01_1737__en-us_topic_0000001173949702_ul4946194044215"><li id="mrs_01_1737__en-us_topic_0000001173949702_li1794684016421"><strong id="mrs_01_1737__en-us_topic_0000001173949702_b1438163020547">--catalog:</strong> (Optional) Specifies the name of the specified data source.</li><li id="mrs_01_1737__en-us_topic_0000001173949702_li109460406421"><strong id="mrs_01_1737__en-us_topic_0000001173949702_b619643510549">--tenant</strong>: (Optional) Specifies the tenant resource queue started by the cluster. Do not specify it as the default queue of a tenant. When this parameter is used, the service user must have the role permission of the tenant.</li><li id="mrs_01_1737__en-us_topic_0000001173949702_li189481740124213"><strong id="mrs_01_1737__en-us_topic_0000001173949702_b10492020556">--schema</strong>: (Optional) Specifies the name of the schema of the data source to be accessed.</li><li id="mrs_01_1737__en-us_topic_0000001173949702_li42323744615"><strong id="mrs_01_1737__en-us_topic_0000001173949702_b14233527135513">--user</strong>: (Mandatory in normal mode) Specifies the name of the user who logs in to the client to execute services. The user must have at least the role of the queue specified by <strong id="mrs_01_1737__en-us_topic_0000001173949702_b362854718558">--tenant</strong>.</li></ul>
|
|
<div class="note" id="mrs_01_1737__en-us_topic_0000001173949702_note8152123552320"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="mrs_01_1737__en-us_topic_0000001173949702_ul2153133522315"><li id="mrs_01_1737__en-us_topic_0000001173949702_li1515343515231">When you log in to the client for the first time, you need to start the <span id="mrs_01_1737__en-us_topic_0000001173949702_text14153183572312">HetuEngine</span> cluster on the server. The client page is displayed 40 seconds later.</li><li id="mrs_01_1737__en-us_topic_0000001173949702_li6153163592317">The client supports SQL syntax and is compatible with the SQL syntax of the open-source openLooKeng 1.2.0.</li></ul>
|
|
</div></div>
|
|
</p></li></ol>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="mrs_01_1710.html">Using HetuEngine</a></div>
|
|
</div>
|
|
</div>
|
|
|