doc-exports/docs/dws/dev/dws_04_0264.html

<a name="EN-US_TOPIC_0000001811491133"></a><a name="EN-US_TOPIC_0000001811491133"></a>

<h1 class="topictitle1">Installing, Configuring, and Starting GDS</h1>
<div id="body8662426"><p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0117407720_p655902199110">GDS is a data service tool provided by <span id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_text1604689277">GaussDB(DWS)</span>. Using the foreign table mechanism, this tool helps export data at a high speed.</p>
<p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0117407720_p534410599110">To install, configure, and start GDS, perform the following steps. For details, see <a href="dws_04_0193.html#EN-US_TOPIC_0000001811610317">Installing, Configuring, and Starting GDS</a>.</p>
<div class="section" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_section1180453203815"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_o213c59f9072d48fd905ceb73687c4f2b"><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_l242cf61617ff44ffbcfa868e55b91d88"><a name="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_l242cf61617ff44ffbcfa868e55b91d88"></a><a name="en-us_topic_0000001233883321_en-us_topic_0000001188163708_l242cf61617ff44ffbcfa868e55b91d88"></a><span>Log in as user <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b10429114127">root</strong> to the data server where GDS is to be installed and run the following command to create the directory for storing the GDS package:</span><p><pre class="screen" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_s58ae87fad6d045b1a5f9546c58e6c912"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_aae0c14df172e45dbb802cd19ea14559e">mkdir -p </strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_en-us_topic_0117407708_ad72482db75884492bfc4a099330d9db7">/opt/bin/dws</em></pre>
</p></li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li17170131917913"><span>Upload the GDS package to the created directory.</span><p><p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p1378019206920">Use the SUSE Linux package as an example. Upload the GDS package <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b1527259161216"></strong><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b1727216913125">dws_client_8.</strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_i8272209191216">x.x</em><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b1827220918128">_suse_x64.zip</strong> to the directory created in the previous step.</p>
</p></li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li16883354813"><a name="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li16883354813"></a><a name="en-us_topic_0000001233883321_en-us_topic_0000001188163708_li16883354813"></a><span>(Optional) If SSL is used, upload the SSL certificates to the directory created in <a href="#EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_l242cf61617ff44ffbcfa868e55b91d88">1</a>.</span></li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_ld8bed05b353f406880669fe49e1e7b64"><span>Go to the directory and extract the package.</span><p><pre class="screen" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_s247e3cb84fe747dab5432e40bad96c2d"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_ae4592ad74b8f458298ba5455631fa193">cd<em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i19453101245115"> </em></strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i1941214774616">/opt/bin/dws</em>
<em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i1073014140224">unzip dws_client_8.x.x_suse_x64.zip</em></pre>
</p></li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_le097b7d9742d44e0bb3e053909abf995"><span>Create a GDS user and the user group to which the user belongs. This user is used to start GDS and read source data.</span><p><pre class="screen" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_s87cd50a7bf9e4c5ea82dbe07cb685e25"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0117407708_b2851994648">groupadd</strong> gdsgrp
<strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_a299d862a8c414cfab5aac6c22cbc23e1">useradd -g</strong> gdsgrp gds_user</pre>
</p></li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_l49ccb26244d446e8991ddb3c32dc0cac"><span>Change the owner of the GDS package directory and source data file directory to the GDS user.</span><p><pre class="screen" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_sd38e3e3e6a5a4e1092580559a1337f0d"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_a6d99c661be8140bfbe0b3eab523e267e">chown -R </strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_a96562d1acfb1463e9196cc9d2f217b9a">gds_user:gdsgrp </em><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_en-us_topic_0117407708_i3077079994810">/opt/bin/dws/gds</em>
<strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0117407704_b542515095412">chown -R </strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_a826a8efb3bba43eca47dd0aa55379f87">gds_user:gdsgrp </em><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0117407704_i472181201076">/input_data </em></pre>
</p></li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li175611031175618"><span>Switch to user <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b174174641315">gds_user</strong>.</span><p><pre class="screen" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_screen4561193113566"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b1056217312560">su -</strong> <em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i8562183185618">gds_user</em></pre>
<p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p1135991195919">If the current cluster version is 8.0.<em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_i185441455181313">x</em> or earlier, skip <a href="#EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li14421575388">8</a> and go to <a href="#EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li22515537437">9</a>.</p>
<p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p1439316819">If the current cluster version is 8.1.<em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_i31981210121415">x</em>, go to the next step.</p>
</p></li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li14421575388"><a name="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li14421575388"></a><a name="en-us_topic_0000001233883321_en-us_topic_0000001188163708_li14421575388"></a><span>Execute the script on which the environment depends (applicable only to version 8.1.<em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_i870651718142">x</em>).</span><p><pre class="screen" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_screen166571749113911">cd /opt/bin/dws/gds/bin
source gds_env</pre>
</p></li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li22515537437"><a name="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li22515537437"></a><a name="en-us_topic_0000001233883321_en-us_topic_0000001188163708_li22515537437"></a><span>Start GDS.</span><p><p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p19261863505">GDS is green software and can be started after being decompressed. There are two ways to start GDS.</p>
<p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p17229932165012">Method 1: Run the <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b1336343201411">gds</strong> command to set startup parameters.</p>
<p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p74307452507">Method 2: Write the startup parameters into the <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b13860143718142">gds.conf</strong> configuration file and run the <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b12860113761415">gds_ctl.py</strong> command to start GDS.</p>
<div class="p" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p14392195934313">The first method is recommended when you do not need to import data again. The second method is recommended when you need to import data regularly.<ul id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_ul195484314543"><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li17545431105416">Method 1: Run the <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b122986492121">gds</strong> command to start GDS.<ul id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_ul185441831165418"><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li2543631185418">If data is transmitted in non-SSL mode, run the following command to start GDS:<pre class="screen" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_screen145431831105412"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b554343118547">gds -d</strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i4543143116548"> dir </em><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b554383110546">-p</strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i195431931185413"> ip:port </em><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b954383111542">-H</strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i17543183115548"> </em><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i45439313549">address_string</em> <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b1154313125415">-l</strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i854318313548"> log_file </em><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b15543143119544">-D </strong><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b157821057269">-t</strong> <em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i1938416132710">worker_num</em></pre>
<p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p116451418511">Example:</p>
<pre class="screen" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_screen156421475119">
<strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_b45436313548">/opt/bin/dws/gds/bin/gds -d</strong> <em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_i11543831195410">/input_data/</em> <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_b19543131115413">-p </strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_i154363110545">192.168.0.90:5000</em> <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_b1543153165413">-H</strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_i95431331175411"> 10.10.0.1/24</em> <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_b954311312540">-l</strong> <em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_i105434317544">/opt/bin/dws/gds/gds_log.txt</em> <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_b155431031155415">-D</strong> <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_b198572315269">-t</strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_i662692819269"> 2</em></pre>
</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li254443135419">If data is transmitted in SSL mode, run the following command to start GDS:<pre class="screen" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_screen854410311542"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b1044214716296">gds -d</strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i94429722912"> dir </em><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b134420722913">-p</strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i11442167112918"> ip:port </em><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b1244215782916">-H</strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i3442187152919"> </em><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i144210752914">address_string</em> <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b1844220710291">-l</strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i14422792915"> log_file </em><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b12442774296">-D</strong> 
<strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b7439124032610">-t</strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i1645444022615"> worker_num</em><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b142787152919"> </strong><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b155446316544">--enable-ssl --ssl-dir </strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i1354473120546">Cert_file</em></pre>
<p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p125441831175415">Example:</p>
<div class="p" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p175441631105419">Run the following commands to upload the SSL certificates mentioned in <a href="#EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li16883354813">3</a> to <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b88312083615">/opt/bin</strong>:<pre class="screen" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_screen85441231145411">
<strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_b135442031135415">/opt/bin/dws/gds/bin/gds -d</strong> <em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_i6544133105417">/input_data/</em> <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_b55441531125419">-p </strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_i2544113119544">192.168.0.90:5000</em> <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_b754443185416">-H</strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_i1544103118542"> 10.10.0.1/24</em> <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_b1254453145416">-l</strong> <em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_i45442031115413">/opt/bin/dws/gds/gds_log.txt</em> <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_b12544133115544">-D</strong> <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_b054418314549">--enable-ssl --ssl-dir </strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_en-us_topic_0125634743_i6544163125419">/opt/bin/</em></pre>
</div>
</li></ul>
<p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p654493110547">Replace the information in italic as required.</p>
<ul id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_ul1545193111540"><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li8544531145418"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b6693194019165">-d</strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_i8694140111611"> dir</em>: directory to store data files that contain data to import. This tutorial uses <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b919312110171">/input_data/</strong> as an example.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li165451631195418"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b872912615172">-p </strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_i0729862179">ip:port</em>: listening IP address and port for GDS. The default value is <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b1957941141710">127.0.0.1</strong>. Replace it with the IP address of a 10GE network that can communicate with <span id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_text1580191115176">GaussDB(DWS)</span>. The port number ranges from 1024 to 65535. The default value is <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b1974114526179">8098</strong>. This tutorial uses <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b1656635410172">192.168.0.90:5000</strong> as an example.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li854533110544"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b7477191271815">-H </strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_i047761218183">address_string</em>: servers that are allowed to connect to and use GDS. The value must be in CIDR format. Set this parameter to enable a <span id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_text1020552961812">GaussDB(DWS)</span> cluster to access GDS for data import. Ensure that the network segment covers all hosts in a <span id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_text1332393811189">GaussDB(DWS)</span> cluster.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li18545143185415"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b3227134410181">-l </strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_i2227124417181">log_file</em>: GDS log directory and log file name. This tutorial uses <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b5539124931813">/opt/bin</strong><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b11540149111817">/dws</strong><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b55401749171812">/gds/gds_log.txt</strong> as an example.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li254533115543"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b116861256131811">-D</strong>: GDS in daemon mode. This command can only be used in Linux.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li20481737101317"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b63244359195">-t </strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_i2324203501913">worker_num</em>: number of concurrent GDS threads. If the data server and <span id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_text5544939191911">GaussDB(DWS)</span> have available I/O resources, you can increase the number of concurrent GDS threads.<p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p76318380132">GDS determines the number of threads based on the number of parallel import transactions. Even if multi-thread import is configured before GDS startup, the import of a single transaction will not be accelerated. By default, an <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b17451911201">INSERT</strong> statement is an import transaction.</p>
</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li19545173155416"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b10630513182010">--enable-ssl</strong>: enables SSL for data transmission.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li654573145414"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b453511842013">--ssl-dir </strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_i253531862014">Cert_file</em>: SSL certificate directory. Set this parameter to the certificate directory in <a href="#EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li16883354813">3</a>.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li1945162221114">For details about GDS parameters, see "GDS - Parallel Data Loader &gt; gds" in the <em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_i485793810201">Data Warehouse Service (DWS) Tool Guide</em>.</li></ul>
</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li6548153185417">Method 2: Write the startup parameters into the <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b17021238131418">gds.conf</strong> configuration file and run the <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b137021338151411">gds_ctl.py</strong> command to start GDS.<ol type="a" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_ol125481431145415"><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li854723110549">Run the following command to go to the <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b1762515016211">config</strong> directory of the GDS package and modify the <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b1762517017211">gds.conf</strong> configuration file. For details about the parameters in the <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b171301515162112">gds.conf</strong> configuration file, see <a href="dws_04_0193.html#EN-US_TOPIC_0000001811610317__en-us_topic_0000001188163708_t051f8c4ef816412c85e082e7fb7297dd">Table 1</a>.<pre class="screen" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_screen1545931185419"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b85454316543">vim </strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i20545173195410">/opt/bin<span id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_ph361219310815">/dws</span>/gds/config/</em><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b1754512317544">gds.conf</strong></pre>
<p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p15545163110546">Example:</p>
<p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p1154683116547">Configure the <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b594916481212">gds.conf</strong> file as follows:</p>
<pre class="screen" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_screen205464319546">&lt;?xml version="1.0"?&gt;
&lt;config&gt;
&lt;gds name="gds1" ip="192.168.0.90" port="5000" data_dir="/input_data/" err_dir="/err" data_seg="100MB" err_seg="100MB" log_file="/log/gds_log.txt" host="10.10.0.1/24" daemon='true' recursive="true" parallel="32"&gt;&lt;/gds&gt;
&lt;/config&gt;</pre>
<p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p15463310549">Information in the configuration file is as follows:</p>
<ul id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_ul7547193114548"><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li454615314541">The data server IP address is <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b2747171192219">192.168.0.90</strong>, and the GDS listening port is <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b19747111192216">5000</strong>.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li45462318545">Data files are stored in <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b542621210599">/input_data/</strong>.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li554613316546">Error log files are stored in <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b39681125155915">/err</strong>. This directory must be created by a user with GDS read and write permissions.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li20546231205411">The size of a single data file is 100 MB.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li20546113155413">The size of each error log file is 100 MB.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li1854611312541">Logs are stored in the <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b166731423919">/log/gds_log.txt</strong> file. This directory must be created by a user with GDS read and write permissions.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li125471031115415">Only nodes with the IP address <strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_b947217551112">10.10.0.</strong><em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_i54733557117">*</em> can be connected.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li145471331145419">The GDS process runs in the background.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li1154733114547">Data file directories are recursive.</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li5547153113544">The number of concurrent import threads is 2.</li></ul>
</li><li id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_li55481331145419">Start GDS and check whether it has been started.<pre class="screen" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_screen1454783120545"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b754711311548">python3 gds_ctl.py start</strong></pre>
<p id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_p45470314547">Example:</p>
<pre class="screen" id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_screen205484317540"><strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b10547113175416">cd </strong>/opt/bin<em id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_i195471631155417"><span id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_ph095215409719">/dws</span>/gds/bin</em>
<strong id="EN-US_TOPIC_0000001811491133__en-us_topic_0000001233883321_en-us_topic_0000001188163708_b65471831145411">python3 gds_ctl.py start</strong>
Start GDS gds1                  [OK]
gds [options]:
 -d dir            Set data directory.
 -p port           Set GDS listening port.
    ip:port        Set GDS listening ip address and port.
 -l log_file       Set log file.
 -H secure_ip_range
                   Set secure IP checklist in CIDR notation. Required for GDS to start.
 -e dir            Set error log directory.
 -E size           Set size of per error log segment.(0 &lt; size &lt; 1TB)
 -S size           Set size of data segment.(1MB &lt; size &lt; 100TB)
 -t worker_num     Set number of worker thread in multi-thread mode, the upper limit is 200. If without setting, the default value is 8.
 -s status_file    Enable GDS status report.
 -D                Run the GDS as a daemon process.
 -r                Read the working directory recursively.
 -h                Display usage.</pre>
</li></ol>
</li></ul>
</div>
</p></li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_04_0261.html">Using GDS to Export Data to a Remote Server</a></div>
</div>
</div>