vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/tool/dws_07_0106.html
Lu, Huayi 346ac31da9 DWS TG 8.1.3.200 VERSION 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Reviewed-by: Jiang, Beibei <beibei.jiang@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2023-08-28 09:20:17 +00:00

42 lines
12 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001234200667"></a><a name="EN-US_TOPIC_0000001234200667"></a>
<h1 class="topictitle1">gds_install</h1>
<div id="body32001227"><div class="section" id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_section19772182813384"><h4 class="sectiontitle">Context</h4><p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_p986019352381">gds_install is a script tool used to install GDS in batches, improving GDS deployment efficiency.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_section382894134510"><h4 class="sectiontitle">Precautions</h4><ul id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_ul94581233511"><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li5164913162012">Configure environment variables before executing the script. For details, see "Importing Data &gt; Using a Foreign Table to Import Data in Parallel &gt; Installing, Configuring, and Starting GDS" in the <em id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_i19606481781641">Developer Guide</em>.</li><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li176115413484">The script must be executed in the Python 3 environment.</li><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li7612358191017">This script must be run by user <strong id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_b176397781581641">root</strong>.</li><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li1941421662712">Check the permission on the upper-layer directory to ensure that the GDS user has the read and write permissions on the installation operation directory, installation directory, and installation package.</li><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li234814816525">Cross-platform installation and deployment are not supported.</li><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li118481031145319">The node where the command is executed must be one of the installation and deployment nodes.</li><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li18548122915610">The passwords of all nodes specified by the <strong id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_b114201048081641">--host</strong> parameter must be the same so that the script can be executed to perform remote deployment successfully.</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_section189071947194518"><h4 class="sectiontitle">Syntax</h4><pre class="screen" id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_screen66511138181816">gds_install -I /path/to/install_dir -U user -G user_group --pkg /path/to/pkg.tar.gz --host [/path/to/hostfile | ipaddr1,ipaddr2...] [--ping-host [/path/to/hostfile | ipaddr1,ipaddr2...]]</pre>
</div>
<div class="section" id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_section12234900460"><h4 class="sectiontitle">Parameter Description</h4><ul id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_ul19603656125613"><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li460315561561">-I<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_p10336110135714"><a name="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li460315561561"></a><a name="en-us_topic_0000001188681064_en-us_topic_0000001145650691_li460315561561"></a>Installation directory.</p>
<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_p16991135338">Default value: <strong id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_b175856885981641">/opt/${<em id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_i135945313215">gds_user</em>}/packages/</strong>, in which <strong id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_b39809314581641">${<em id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_i63393617219">gds_user</em>}</strong> indicates the operating system user of the GDS service.</p>
</li><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li36041456165615">-U<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_p10338142115719"><a name="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li36041456165615"></a><a name="en-us_topic_0000001188681064_en-us_topic_0000001145650691_li36041456165615"></a>GDS user.</p>
</li><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li1960465618568">-G<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_p18451143135715"><a name="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li1960465618568"></a><a name="en-us_topic_0000001188681064_en-us_topic_0000001145650691_li1960465618568"></a>Group to which the GDS user belongs.</p>
</li><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li560485612566">--pkg<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_p91915582573"><a name="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li560485612566"></a><a name="en-us_topic_0000001188681064_en-us_topic_0000001145650691_li560485612566"></a>Path of the GDS installation package, for example, <strong id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_b1485442711522">/path/to/GaussDB-8.1.3-REDHAT-x86_64bit-Gds.tar.gz</strong>.</p>
</li><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li1660465614560">--host<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_p15439144145813"><a name="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li1660465614560"></a><a name="en-us_topic_0000001188681064_en-us_topic_0000001145650691_li1660465614560"></a>IP addresses of the nodes to be installed. The value can be a file name or a string.</p>
<ul id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_ul6486175501917"><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li4899143720192">File format: Each row contains an IP address, for example:<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_p7880457141912"><a name="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li4899143720192"></a><a name="en-us_topic_0000001188681064_en-us_topic_0000001145650691_li4899143720192"></a>192.168.2.200</p>
<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_p275075911911">192.168.2.201</p>
</li><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li18912151082020">String format: IP addresses are separated by commas (,), for example:<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_p1836512112010"><a name="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li18912151082020"></a><a name="en-us_topic_0000001188681064_en-us_topic_0000001145650691_li18912151082020"></a>192.168.2.200,192.168.2.201</p>
</li></ul>
<div class="note" id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_note7824901019"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_p5824706017">The node where the command is executed must be one of the nodes to be deployed. The IP address of the node must be in the list.</p>
</div></div>
</li><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_li5305190102711">--ping-host<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001098650744_p65661837541"><a name="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_li5305190102711"></a><a name="en-us_topic_0000001188681064_li5305190102711"></a>Destination IP address for the network ping check on each target node when <strong id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_b170940025281641">gds_check</strong> is called.</p>
<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001098650744_p123431331785">Value: IP address list in the file or string format. Generally, the value is the IP address of a DN, CN, or gateway.</p>
<ul id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001098650744_ul115331237171313"><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001098650744_li13150035121311">File format: Each row contains an IP address, for example:<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001098650744_p1479164131313"><a name="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001098650744_li13150035121311"></a><a name="en-us_topic_0000001188681064_en-us_topic_0000001098650744_li13150035121311"></a>192.168.2.200</p>
<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001098650744_p10483134211315">192.168.2.201</p>
</li><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001098650744_li1626314116142">String format: IP addresses are separated by commas (,), for example:<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001098650744_p19216122161417"><a name="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001098650744_li1626314116142"></a><a name="en-us_topic_0000001188681064_en-us_topic_0000001098650744_li1626314116142"></a>192.168.2.200,192.168.2.201</p>
</li></ul>
</li><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li10604456155616">-V<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_p28217563019"><a name="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li10604456155616"></a><a name="en-us_topic_0000001188681064_en-us_topic_0000001145650691_li10604456155616"></a>Version information.</p>
</li><li id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li960412568564">-h, --help<p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_p79207324118"><a name="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_li960412568564"></a><a name="en-us_topic_0000001188681064_en-us_topic_0000001145650691_li960412568564"></a>Help information.</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_section1055631084611"><h4 class="sectiontitle">Examples</h4><p id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_p18778153815119">Install GDS on nodes 192.168.1.100 and 192.168.1.101, and specify <strong id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_b52759948981641">/opt/gdspackages/install_dir</strong> as the installation directory. The GDS user is <strong id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_b174937088981641">gds_test:wheel</strong>.</p>
<pre class="screen" id="EN-US_TOPIC_0000001234200667__en-us_topic_0000001188681064_en-us_topic_0000001145650691_screen8839140172013">gds_install -I /opt/gdspackages/install_dir --host 192.168.1.100,192.168.1.101 -U gds_test -G wheel --pkg /home/gds_test/GaussDB-8.1.3-REDHAT-x86_64bit-Gds.tar.gz</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_07_0100.html">Server Tool</a></div>
</div>
</div>
View Git Blame Copy Permalink