ddm_umn_20240425

Reviewed-by: Wagner, Fabian <fabian.wagner@t-systems.com>
Co-authored-by: Ru, Li Yi <liyiru7@huawei.com>
Co-committed-by: Ru, Li Yi <liyiru7@huawei.com>

docs/ddm/umn/ddm_01_0017.html

@@ -14,12 +14,8 @@
 </tr>
 </thead>
 <tbody><tr id="ddm_01_0017__row60270212"><td class="cellrowborder" rowspan="3" valign="top" width="32%" headers="mcps1.3.2.2.5.1.1 "><p id="ddm_01_0017__p13662140115214">General-enhanced</p>
-<p id="ddm_01_0017__p193273510522"></p>
-<p id="ddm_01_0017__p69321535135213"></p>
 </td>
 <td class="cellrowborder" rowspan="3" valign="top" width="18%" headers="mcps1.3.2.2.5.1.2 "><p id="ddm_01_0017__p36621140165211">x86</p>
-<p id="ddm_01_0017__p282915334527"></p>
-<p id="ddm_01_0017__p082919336520"></p>
 </td>
 <td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.2.2.5.1.3 "><p id="ddm_01_0017__p15884152155812">8</p>
 </td>

docs/ddm/umn/ddm_02_0005.html

@@ -23,7 +23,7 @@
 <div class="note" id="ddm_02_0005__note14739638113218"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="ddm_02_0005__p1899110469321">Using Navicat to access a DDM instance is similar to using other visualized MySQL tools such as MySQL Workbench. Therefore, the procedure of using other visualized MySQL tools to connect to a DDM instance has been omitted.</p>
 </div></div>
 </div>
-<div class="section" id="ddm_02_0005__section1621624581510"><a name="ddm_02_0005__section1621624581510"></a><a name="section1621624581510"></a><h4 class="sectiontitle">Using the MySQL CLI to Log In to a Schema</h4><ol id="ddm_02_0005__ol1053254716256"><li id="ddm_02_0005__li35321947202517"><span>Log in to the required ECS, open the CLI, and run the following command:</span><p><pre class="screen" id="ddm_02_0005__screen1094816405448">mysql -h ${<em id="ddm_02_0005__i14013200175">DDM_SERVER_ADDRESS</em>} -P ${<em id="ddm_02_0005__i5062017175">DDM_SERVER_PORT</em>} -u ${<em id="ddm_02_0005__i12042051712">DDM_USER</em>} -p [-D ${<em id="ddm_02_0005__i2092061712">DDM_DBNAME</em>}] [--default -character -set=utf8][--default_auth=mysql_native_password]</pre>
+<div class="section" id="ddm_02_0005__section1621624581510"><a name="ddm_02_0005__section1621624581510"></a><a name="section1621624581510"></a><h4 class="sectiontitle">Using the MySQL CLI to Log In to a Schema</h4><ol id="ddm_02_0005__ol1053254716256"><li id="ddm_02_0005__li35321947202517"><span>Log in to the required ECS, open the CLI, and run the following command:</span><p><pre class="screen" id="ddm_02_0005__screen1094816405448">mysql -h ${<em id="ddm_02_0005__i14013200175">DDM_SERVER_ADDRESS</em>} -P ${<em id="ddm_02_0005__i5062017175">DDM_SERVER_PORT</em>} -u ${<em id="ddm_02_0005__i12042051712">DDM_USER</em>} -p [-D ${<em id="ddm_02_0005__i2092061712">DDM_DBNAME</em>}] [--default -character -set=utf8][--default_auth=mysql_native_password] [--ssl]</pre>
 
 <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="ddm_02_0005__table98862342274" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="ddm_02_0005__row388523412276"><th align="left" class="cellrowborder" valign="top" width="32%" id="mcps1.3.8.2.1.2.2.2.4.1.1"><p id="ddm_02_0005__p088519348279"><strong id="ddm_02_0005__b19810625114019">Parameter</strong></p>
 </th>
@@ -77,6 +77,14 @@
 <td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.8.2.1.2.2.2.4.1.3 "><p id="ddm_02_0005__p69981097121">-</p>
 </td>
 </tr>
+<tr id="ddm_02_0005__row941550133814"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.3.8.2.1.2.2.2.4.1.1 "><p id="ddm_02_0005__p711725617123">ssl</p>
+</td>
+<td class="cellrowborder" valign="top" width="52%" headers="mcps1.3.8.2.1.2.2.2.4.1.2 "><p id="ddm_02_0005__p11173562127">(Optional) To use SSL to encrypt connections, you need to enable SSL first.</p>
+<p id="ddm_02_0005__p106322307419">If you have enabled SSL, encrypted connections are used by default.</p>
+</td>
+<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.8.2.1.2.2.2.4.1.3 "><p id="ddm_02_0005__p1311720563125">-</p>
+</td>
+</tr>
 </tbody>
 </table>
 </div>
@@ -110,8 +118,8 @@ Connection con = DriverManager.getConnection(url , username , password);</pre>
 </p></li><li id="ddm_02_0005__li5620164510391"><span>Create a Statement object.</span><p><pre class="screen" id="ddm_02_0005__screen1144085505211">Statement stmt = con.createStatement();</pre>
 </p></li><li id="ddm_02_0005__li1841819444011"><span>Execute the required SQL statement.</span><p><pre class="screen" id="ddm_02_0005__screen01151822195615">ResultSet rs = stmt.executeQuery("select now() as Systemtime");
 con.close();</pre>
-</p></li><li id="ddm_02_0005__li139111931387"><a name="ddm_02_0005__li139111931387"></a><a name="li139111931387"></a><span>(Optional) Optimize code as needed.</span><p><pre class="screen" id="ddm_02_0005__screen69311015919">loadBalanceAutoCommitStatementThreshold=5&amp;loadBalanceHostRemovalGracePeriod=15000&amp;loadBalanceBlacklistTimeout=60000&amp;loadBalancePingTimeout=5000&amp;retriesAllDown=10&amp;connectTimeout=10000</pre>
+</p></li><li id="ddm_02_0005__li139111931387"><a name="ddm_02_0005__li139111931387"></a><a name="li139111931387"></a><span>(Optional) Optimize code as needed.</span><p><pre class="screen" id="ddm_02_0005__screen69311015919">loadBalanceAutoCommitStatementThreshold=5&amp;loadBalanceHostRemovalGracePeriod=15000&amp;loadBalanceBlacklistTimeout=60000&amp;loadBalancePingTimeout=5000&amp;retriesAllDown=10&amp;connectTimeout=10000&amp;useSSL=true;</pre>
-<div class="note" id="ddm_02_0005__note19978141913917"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="ddm_02_0005__ul066216919107"><li id="ddm_02_0005__li85394701412">Parameters <strong id="ddm_02_0005__b179951315155414">loadBalanceAutoCommitStatementThreshold</strong> and <strong id="ddm_02_0005__b316162548">retriesAllDown</strong> must be configured based on the example in <a href="#ddm_02_0005__li139111931387">5</a>. Otherwise, an infinite loop may occur during the connection switchover, resulting in stack overflow.</li><li id="ddm_02_0005__li61276200129"><strong id="ddm_02_0005__b454065617124">loadBalanceAutoCommitStatementThreshold</strong>: defines the number of matching statements which will trigger the driver to potentially swap physical server connections. </li><li id="ddm_02_0005__li18127720101218"><strong id="ddm_02_0005__b112491434112216">loadBalanceHostRemovalGracePeriod</strong>: indicates the grace period to wait for a host being removed from a load-balanced connection, to be released when it is the active host.</li><li id="ddm_02_0005__li512712071217"><strong id="ddm_02_0005__b1579516475259">loadBalanceBlacklistTimeout</strong>: indicates the time in milliseconds between checks of servers which are unavailable, by controlling how long a server lives in the global blacklist.</li><li id="ddm_02_0005__li9127182010127"><strong id="ddm_02_0005__b2670149113616">loadBalancePingTimeout</strong>: indicates the time in milliseconds that the connection will wait for a response to a ping operation when you set <strong id="ddm_02_0005__b79673516447">loadBalanceValidateConnectionOnSwapServer</strong> to <strong id="ddm_02_0005__b39810533442">true</strong>.</li><li id="ddm_02_0005__li2127122012121"><strong id="ddm_02_0005__b192903512133">retriesAllDown</strong>: indicates the maximum number of connection attempts before an exception is thrown when a valid host is searched. SQLException will be returned if the threshold of retries is reached with no valid connections obtained.</li><li id="ddm_02_0005__li512715206124"><strong id="ddm_02_0005__b4918143918474">connectTimeout</strong>: indicates the maximum amount of time in milliseconds that the JDBC driver is willing to wait to set up a socket connection. <strong id="ddm_02_0005__b17990131613523">0</strong> indicates that the connection does not time out. This parameter is available to JDK-1.4 or later versions. The default value is <strong id="ddm_02_0005__b941111461320">0</strong>.</li></ul>
+<div class="note" id="ddm_02_0005__note19978141913917"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="ddm_02_0005__ul066216919107"><li id="ddm_02_0005__li85394701412">Parameters <strong id="ddm_02_0005__b179951315155414">loadBalanceAutoCommitStatementThreshold</strong> and <strong id="ddm_02_0005__b316162548">retriesAllDown</strong> must be configured based on the example in <a href="#ddm_02_0005__li139111931387">5</a>. Otherwise, an infinite loop may occur during the connection switchover, resulting in stack overflow.</li><li id="ddm_02_0005__li61276200129"><strong id="ddm_02_0005__b454065617124">loadBalanceAutoCommitStatementThreshold</strong>: defines the number of matching statements which will trigger the driver to potentially swap physical server connections. </li><li id="ddm_02_0005__li18127720101218"><strong id="ddm_02_0005__b112491434112216">loadBalanceHostRemovalGracePeriod</strong>: indicates the grace period to wait for a host being removed from a load-balanced connection, to be released when it is the active host.</li><li id="ddm_02_0005__li512712071217"><strong id="ddm_02_0005__b1579516475259">loadBalanceBlacklistTimeout</strong>: indicates the time in milliseconds between checks of servers which are unavailable, by controlling how long a server lives in the global blacklist.</li><li id="ddm_02_0005__li9127182010127"><strong id="ddm_02_0005__b2670149113616">loadBalancePingTimeout</strong>: indicates the time in milliseconds that the connection will wait for a response to a ping operation when you set <strong id="ddm_02_0005__b79673516447">loadBalanceValidateConnectionOnSwapServer</strong> to <strong id="ddm_02_0005__b39810533442">true</strong>.</li><li id="ddm_02_0005__li2127122012121"><strong id="ddm_02_0005__b192903512133">retriesAllDown</strong>: indicates the maximum number of connection attempts before an exception is thrown when a valid host is searched. SQLException will be returned if the threshold of retries is reached with no valid connections obtained.</li><li id="ddm_02_0005__li512715206124"><strong id="ddm_02_0005__b4918143918474">connectTimeout</strong>: indicates the maximum amount of time in milliseconds that the JDBC driver is willing to wait to set up a socket connection. <strong id="ddm_02_0005__b17990131613523">0</strong> indicates that the connection does not time out. This parameter is available to JDK-1.4 or later versions. The default value is <strong id="ddm_02_0005__b941111461320">0</strong>.</li><li id="ddm_02_0005__li1473152310426"><strong id="ddm_02_0005__b1236512941112">useSSL</strong>: indicates that an SSL connection is used to connect to DDM. This parameter is set to <strong id="ddm_02_0005__b98291934121118">true</strong> by default.</li></ul>
 </div></div>
 </p></li></ol>
 </div>

docs/ddm/umn/ddm_03_0051.html

@@ -219,7 +219,7 @@
 </thead>
 <tbody><tr id="ddm_03_0051__en-us_topic_0242898940_row1373815507314"><td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.1.3.1.1 "><p id="ddm_03_0051__en-us_topic_0242898940_p17728647413">node_id</p>
 </td>
-<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.1.3.1.2 "><p id="ddm_03_0051__en-us_topic_0242898940_p97286413418">DDM nodes</p>
+<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.2.1.3.1.2 "><p id="ddm_03_0051__en-us_topic_0242898940_p97286413418">DDM node ID</p>
 </td>
 </tr>
 </tbody>

docs/ddm/umn/ddm_06_0040.html

@@ -14,6 +14,8 @@
 </li>
 <li class="ulchildlink"><strong><a href="ddm_06_0039.html">Changing the Security Group of a DDM Instance</a></strong><br>
 </li>
+<li class="ulchildlink"><strong><a href="ddm_06_0041.html">Configuring SSL</a></strong><br>
+</li>
 </ul>
 </div>
 

docs/ddm/umn/ddm_06_0041.html

@@ -0,0 +1,22 @@
+<a name="ddm_06_0041"></a><a name="ddm_06_0041"></a>
+
+<h1 class="topictitle1">Configuring SSL</h1>
+<div id="body8662426"><p id="ddm_06_0041__en-us_topic_0000001507144302_p1123715413617">Secure Socket Layer (SSL) is an encryption-based Internet security protocol for establishing secure links between a server and a client. It provides privacy, authentication, and integrity to Internet communications. SSL:</p>
+<ul id="ddm_06_0041__en-us_topic_0000001507144302_ul763418455716"><li id="ddm_06_0041__en-us_topic_0000001507144302_li17634445377">Authenticates users and servers, ensuring that data is sent to the correct clients and servers.</li><li id="ddm_06_0041__en-us_topic_0000001507144302_li6634124511717">Encrypts data to prevent it from being intercepted during transfer.</li><li id="ddm_06_0041__en-us_topic_0000001507144302_li1363418453718">Ensures data integrity during transmission</li></ul>
+<p id="ddm_06_0041__en-us_topic_0000001507144302_p2023712411060">SSL is disabled for new DDM instances by default. Enabling SSL increases CPU usage and makes it take a little longer to establish a network connection, so you are advised to evaluate these impacts on service performance before enabling SSL.</p>
+<p id="ddm_06_0041__p1786765252715">You can connect to a DDM schema through a client using an SSL or non-SSL connection.</p>
+<ul id="ddm_06_0041__ul76031313134419"><li id="ddm_06_0041__li1692144182614">If SSL is enabled, you can connect to a DDM schema using an SSL or non-SSL connection. SSL encrypts connections to the DB instance, making in-transit data more secure.</li><li id="ddm_06_0041__li260341314446">If SSL is disabled, you can only connect to a DDM schema using a non-SSL connection.<div class="notice" id="ddm_06_0041__note11914105011116"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="ddm_06_0041__p181511004151">Enabling or disabling SSL will cause instances to reboot and interrupt connections. Exercise caution when performing this operation.</p>
+</div></div>
+</li></ul>
+<div class="section" id="ddm_06_0041__en-us_topic_0000001507144302_section138969541593"><h4 class="sectiontitle">Enabling SSL</h4><ol id="ddm_06_0041__en-us_topic_0000001507144302_ol20309814111014"><li id="ddm_06_0041__en-us_topic_0000001507144302_li7239163311433"><span>On the <strong id="ddm_06_0041__en-us_topic_0000001507144302_b1465903313011">Instances</strong> page, locate the instance that you want to connect to and click its name.</span></li><li id="ddm_06_0041__en-us_topic_0000001507144302_li102395337433"><span>On the <strong id="ddm_06_0041__en-us_topic_0000001507144302_b142031120119">Basic Information</strong> page, at the <strong id="ddm_06_0041__en-us_topic_0000001507144302_b14081033518">Instance Information</strong> area, click <span><img id="ddm_06_0041__en-us_topic_0000001507144302_image76431781115" src="en-us_image_0000001897028497.png"></span> in the <strong id="ddm_06_0041__en-us_topic_0000001507144302_b73591104114">SSL</strong> field.</span></li><li id="ddm_06_0041__en-us_topic_0000001507144302_li6617142151017"><span>In the displayed dialog box, click <strong id="ddm_06_0041__en-us_topic_0000001507144302_b245419123510">Yes</strong>.</span></li><li id="ddm_06_0041__en-us_topic_0000001507144302_li978164516118"><span>On the <span class="uicontrol" id="ddm_06_0041__en-us_topic_0000001507144302_uicontrol371141518519"><b>Basic Information</b></span> page, view the results. Click <span><img id="ddm_06_0041__image1144344012147" src="en-us_image_0000001900945965.png"></span> next to the <strong id="ddm_06_0041__b54610127296">SSL</strong> field to download the CA certificate.</span><p><p id="ddm_06_0041__p19605111514479">You can use SSL to connect to a schema. For details, see <a href="ddm_02_0005.html">Step 4: Log In to the DDM Schema</a>.</p>
+</p></li></ol>
+</div>
+<div class="section" id="ddm_06_0041__en-us_topic_0000001507144302_section1070285720122"><h4 class="sectiontitle">Disabling SSL</h4><ol id="ddm_06_0041__en-us_topic_0000001507144302_ol13138179131"><li id="ddm_06_0041__en-us_topic_0000001507144302_li1813937191319"><span>On the <strong id="ddm_06_0041__en-us_topic_0000001507144302_b721714441653">Instances</strong> page, locate the instance that you want to connect to and click its name.</span></li><li id="ddm_06_0041__en-us_topic_0000001507144302_li11139377137"><span>On the <strong id="ddm_06_0041__en-us_topic_0000001507144302_b123812487515">Basic Information</strong> page, at the <strong id="ddm_06_0041__en-us_topic_0000001507144302_b1840048252">Instance Information</strong> area, click <span><img id="ddm_06_0041__en-us_topic_0000001507144302_image1382302061314" src="en-us_image_0000001896908953.png"></span> in the <strong id="ddm_06_0041__en-us_topic_0000001507144302_b44114481516">SSL</strong> field.</span></li><li id="ddm_06_0041__en-us_topic_0000001507144302_li169402416135"><span>In the displayed dialog box, click <strong id="ddm_06_0041__en-us_topic_0000001507144302_b5789856952">Yes</strong>.</span></li><li id="ddm_06_0041__en-us_topic_0000001507144302_li1294004116133"><span>On the <span class="uicontrol" id="ddm_06_0041__en-us_topic_0000001507144302_uicontrol4267109610"><b>Basic Information</b></span> page, view the results.</span></li></ol>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="ddm_06_0040.html">Connection Management</a></div>
+</div>
+</div>
+

docs/ddm/umn/ddm_history_0003.html

@@ -8,7 +8,12 @@
 </th>
 </tr>
 </thead>
-<tbody><tr id="ddm_history_0003__row146721817163812"><td class="cellrowborder" valign="top" width="23.849999999999998%" headers="mcps1.3.1.1.3.1.1 "><p id="ddm_history_0003__p1467201710385">2024-03-14</p>
+<tbody><tr id="ddm_history_0003__row1444118290490"><td class="cellrowborder" valign="top" width="23.849999999999998%" headers="mcps1.3.1.1.3.1.1 "><p id="ddm_history_0003__p5441142919492">2024-04-15</p>
+</td>
+<td class="cellrowborder" valign="top" width="76.14999999999999%" headers="mcps1.3.1.1.3.1.2 "><ul id="ddm_history_0003__ul7922204318498"><li id="ddm_history_0003__li752519615507">Added SSL parameters to the command for connecting to a schema in <a href="ddm_02_0005.html">Step 4: Log In to the DDM Schema</a>.</li><li id="ddm_history_0003__li892234317498">Added the SSL encryption function in <a href="ddm_06_0041.html">Configuring SSL</a>.</li></ul>
+</td>
+</tr>
+<tr id="ddm_history_0003__row146721817163812"><td class="cellrowborder" valign="top" width="23.849999999999998%" headers="mcps1.3.1.1.3.1.1 "><p id="ddm_history_0003__p1467201710385">2024-03-14</p>
 </td>
 <td class="cellrowborder" valign="top" width="76.14999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="ddm_history_0003__p14672171773810">Optimized the prerequisites and procedures in <a href="ddm_06_0017.html">Restoring Metadata</a>.</p>
 </td>