forked from docs/doc-exports
Lu, Huayi
346ac31da9
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>
117 lines
19 KiB
HTML
117 lines
19 KiB
HTML
<a name="EN-US_TOPIC_0000001233800725"></a><a name="EN-US_TOPIC_0000001233800725"></a>
|
|
|
|
<h1 class="topictitle1">Installing DSC</h1>
|
|
<div id="body8662426"><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p14960940184913">Before using DSC, install it on a Linux or Windows server. DSC supports <a href="dws_mt_0014.html#EN-US_TOPIC_0000001188202622__en-us_topic_0218440498_section65156403">64-bit Linux OSs</a>. For details about other OSs supported by DSC, see <a href="dws_mt_0014.html#EN-US_TOPIC_0000001188202622__en-us_topic_0218440498_table1750314290446">Compatible OSs</a>.</p>
|
|
<div class="section" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_section30990961153729"><h4 class="sectiontitle">Prerequisites</h4><ul id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_ul2160042015253"><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li1340818504494">In Linux, do not install or perform operations on DSC as the <strong id="EN-US_TOPIC_0000001233800725__b37081623145117">root</strong> user. To execute the <strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_b19542628165318">install.sh</strong> script, you must have the permission for creating folders.</li><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li17165193911372">The size of the target folder must be at least four times that of the SQL files in the input folder.<p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p1851944319242"><a name="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li17165193911372"></a><a name="en-us_topic_0218440254_li17165193911372"></a>For example, if the size of the SQL files in the input folder is 100 KB, the target folder must have available disk space of at least 400 KB to process the SQL files.</p>
|
|
<div class="note" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_note178776536240"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_ul826915403268"><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li15269204019265">To query the available disk space of the target folder in Linux, run the following command:<pre class="screen" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_screen57111459191817">df -P <<em id="EN-US_TOPIC_0000001233800725__i15302124411">Folder path</em>></pre>
|
|
</li><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li42691940162617">To query the size of the input file in Linux, run the following command in the directory where the file resides:<pre class="screen" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_screen121912811269">ls -l</pre>
|
|
</li></ul>
|
|
</div></div>
|
|
</li></ul>
|
|
<ul id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_ul49341570152522"><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li63981350152522">JRE 1.8 or later and Perl have been installed. For details about the hardware and software requirements, see <a href="dws_mt_0014.html">System Requirements</a>.<div class="p" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p12263154123112">To check the installed Java version and set the Java path, perform the following steps:<ol id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_ol095164313501"><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li1995543185015">Check whether the Java version meets requirements.<pre class="screen" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_screen196115513538">java -version</pre>
|
|
</li><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li58801654123311">Ensure that the Java path is correctly set.<ul id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_ul884842173617"><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li6849826368">Linux<ol type="a" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_ol181612054219"><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li13816180154218">Check whether the Java path is correctly set.<pre class="screen" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_screen2016312174019">echo $JAVA_HOME</pre>
|
|
</li><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li1219085813451">If no information is returned, add the following two lines to the <strong id="EN-US_TOPIC_0000001233800725__b36144016510">.bashrc</strong> file of the current user, save the modification, and exit.<div class="p" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p1096119588457">Assume that the Java installation path is <strong id="EN-US_TOPIC_0000001233800725__b1561416281256">/home/user/Java/jdk1.8.0_141</strong>.<pre class="screen" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_screen8163023408"><strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_b216311216409">export</strong> JAVA_HOME=/home/user/Java/jdk1.8.0_141
|
|
<strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_b1816319264017">export</strong> PATH=<em id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_i7163162104019">$JAVA_HOME/bin:$PATH</em></pre>
|
|
</div>
|
|
</li><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li128161008422">Activate Java environment variables.<pre class="screen" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_screen1416315284016">source ~/.bashrc</pre>
|
|
</li></ol>
|
|
</li><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li188497263611">Windows<ol type="a" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_ol12812943613"><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li428139183616">Right-click <strong id="EN-US_TOPIC_0000001233800725__b1975634412417">My Computer</strong> and choose <strong id="EN-US_TOPIC_0000001233800725__b9757844845">Properties</strong> from the shortcut menu. The <strong id="EN-US_TOPIC_0000001233800725__b27572443414">System</strong> window is displayed.</li><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li628117963611">Click <strong id="EN-US_TOPIC_0000001233800725__b11698246161016">Advanced System Settings</strong>. The <strong id="EN-US_TOPIC_0000001233800725__b6704184615107">System Properties</strong> dialog box is displayed.</li><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li142815943615">On the <strong id="EN-US_TOPIC_0000001233800725__b621345241012">Advanced</strong> tab page, click <strong id="EN-US_TOPIC_0000001233800725__b621375219102">Environment Variables</strong>. The <strong id="EN-US_TOPIC_0000001233800725__b1921345211109">Environment Variables</strong> dialog box is displayed.</li><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li19281399363">Select <strong id="EN-US_TOPIC_0000001233800725__b115318711110">Path</strong> in the <strong id="EN-US_TOPIC_0000001233800725__b1059137141113">System variables</strong> area. Click <strong id="EN-US_TOPIC_0000001233800725__b3601777118">Edit</strong> and check the Java installation path.<p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p126115112475">If the Java installation path does not exist or is incorrect, add the Java path of this PC to <strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_b12461717161315">Path</strong>.</p>
|
|
<p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p7561192313437">Assume that the Java installation path is <strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_b17172548121116">C:\Program Files\Java\jdk1.8.0_141\bin</strong> and the environment variable in <strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_b63561511181213">Path</strong> is <em id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_i1132015274817">c:\windows\system32;</em>. Set <strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_b45640106598">Path</strong> to <em id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_i121637144313">c:\windows\system32;</em><strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_b182164784317">C:\Program Files\Java\jdk1.8.0_141\bin;</strong>.</p>
|
|
</li></ol>
|
|
</li></ul>
|
|
</li></ol>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_section64536037174643"><h4 class="sectiontitle">Procedure</h4><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p62711524574">DSC is an installation-free tool. You can use it after downloading and decompressing the software package.</p>
|
|
<p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p647812177811">The following procedure describes how to obtain the package. Decompress the package <strong id="EN-US_TOPIC_0000001233800725__b4278115819131">DSC.zip</strong> and then <strong id="EN-US_TOPIC_0000001233800725__b172862587138">DSC.rar</strong> to obtain the files shown in <a href="#EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_table9595434171818">Table 1</a>.</p>
|
|
<p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p42014133565">Windows:</p>
|
|
<ol id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_ol13941044175711"><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li883022519523"><span>Log in to the GaussDB(DWS) management console and download the DCS software package. For details, see <a href="dws_07_0002.html">Downloading Related Tools</a>.</span></li><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li510034455715"><span>Decompress the <strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_b1172113321806">DSC.zip</strong> package.</span><p><div class="p" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p1739182118915">The <strong id="EN-US_TOPIC_0000001233800725__b980528141717">DSC</strong> folder is generated.<div class="note" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_note92491339992"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p132505395910">You can decompress <strong id="EN-US_TOPIC_0000001233800725__b1044024314178">DSC.zip</strong> to any folder you need.</p>
|
|
</div></div>
|
|
</div>
|
|
</p></li><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li1153162464715"><span>Go to the <strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_b107913561939">DSC</strong> directory.</span></li><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li325419152520"><span>Find and check the files in the <strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_b1876425618317">DSC</strong> directory.</span><p><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p12422162717251"><a href="#EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_table9595434171818">Table 1</a> describes the obtained folders and files.</p>
|
|
</p></li></ol>
|
|
<p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p8286539576"><strong id="EN-US_TOPIC_0000001233800725__b3446154117200">Linux:</strong></p>
|
|
<ol id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_ol665819471720"><li id="EN-US_TOPIC_0000001233800725__li1123712249589"><span>Log in to the GaussDB(DWS) management console and download the DCS software package. For details, see <a href="dws_07_0002.html">Downloading Related Tools</a>.</span></li><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li86586473710"><span>Extract files from <strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_b1796416497450">DSC.zip</strong>.</span><p><pre class="screen" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_screen185852047386">sh install.sh</pre>
|
|
</p></li><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li1372919573813"><span>Go to the <strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_b20987105514513">DSC</strong> directory.</span><p><pre class="screen" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_screen6551204202">cd DSC</pre>
|
|
</p></li><li id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_li7550425794"><span>Check the files in the <strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_b166675864617">DSC</strong> directory.</span><p><pre class="screen" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_screen6450130590">ls
|
|
config lib scripts bin input output runDSC.sh runDSC.bat</pre>
|
|
</p></li></ol>
|
|
|
|
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_table9595434171818"></a><a name="en-us_topic_0218440254_table9595434171818"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_table9595434171818" frame="border" border="1" rules="all"><caption><b>Table 1 </b>DSC directory</caption><thead align="left"><tr id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_row059812340182"><th align="left" class="cellrowborder" colspan="2" valign="top" id="mcps1.3.3.8.2.4.1.1"><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p5600734151814"><strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_b1183818458206">Folder or File</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" id="mcps1.3.3.8.2.4.1.2"><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p1160293414183"><strong id="EN-US_TOPIC_0000001233800725__en-us_topic_0237712291_b2083964552019">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_row1374018191513"><td class="cellrowborder" rowspan="8" valign="top" width="7.5200000000000005%" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p319537538">DSC</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="33.35%" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p2741819012">bin</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="59.13%" headers="mcps1.3.3.8.2.4.1.2 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p37411919114">DSC-related JAR package (executable)</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_row10605183431818"><td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p2607203461813">config</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p1361015347181">Configuration file of DSC</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_row29596311011"><td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p59593311112">input</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p109604311117">Input folder</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_row76111434181820"><td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p26124344180">lib</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p10613634121813">Library files required for the normal running of DSC</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_row1719095319115"><td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p61901853811">output</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p71901953712">Output folder</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_row20615133412187"><td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p7615113418182">scripts</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p20616193413186">Customized configuration scripts for Oracle and Teradata migration, which can be executed to implement corresponding functions</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_row11473151620"><td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p72291654202111">runDSC.sh</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p1038913352041">Application executed on the Linux OS</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_row7673519211"><td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p122715413218">runDSC.bat</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p1482515017419">Application executed on the Windows OS</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_row19617434121810"><td class="cellrowborder" colspan="2" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p20564111715141">changelog</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.2 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p7450199852">To notify users of the current modifications</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_row14623183441817"><td class="cellrowborder" colspan="2" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p0275142161410">Install.sh</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.2 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p8276144216141">To set the file permissions for DSC</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_row16628153417181"><td class="cellrowborder" colspan="2" valign="top" headers="mcps1.3.3.8.2.4.1.1 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p18493310101510">readme</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" headers="mcps1.3.3.8.2.4.1.2 "><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p183821845359">Instructions of installation and configuration</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div class="note" id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_note215184318545"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233800725__en-us_topic_0218440254_p1937813067">If you do not need DSC, you can uninstall it by deleting the <strong id="EN-US_TOPIC_0000001233800725__b2067632115237">DSC</strong> folder.</p>
|
|
</div></div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_mt_index.html">DSC</a></div>
|
|
</div>
|
|
</div>
|
|
|