forked from docs/doc-exports
Lu, Huayi
e6fa411af0
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com> Co-authored-by: Lu, Huayi <luhuayi@huawei.com> Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
117 lines
24 KiB
HTML
117 lines
24 KiB
HTML
<a name="EN-US_TOPIC_0000001233883171"></a><a name="EN-US_TOPIC_0000001233883171"></a>
|
|
|
|
<h1 class="topictitle1">Configuring a Data Source in the Windows OS</h1>
|
|
<div id="body8662426"><p id="EN-US_TOPIC_0000001233883171__en-us_topic_0059779273_p85094522012">Configure the ODBC data source using the ODBC data source manager preinstalled in the Windows OS.</p>
|
|
<div class="section" id="EN-US_TOPIC_0000001233883171__sa802ec504bf7461e975a02e2e6ecd7b0"><h4 class="sectiontitle">Procedure</h4><ol id="EN-US_TOPIC_0000001233883171__o5cf92eae501941178167a645722d261c"><li id="EN-US_TOPIC_0000001233883171__l5cfb06c960204324b13f5ae2c4ddbde9"><span>Replace the <span id="EN-US_TOPIC_0000001233883171__text139621122135915">GaussDB(DWS)</span> client driver.</span><p><p id="EN-US_TOPIC_0000001233883171__ad75714f6110d4b3bb4cf64b2992ba057">Decompress <strong id="EN-US_TOPIC_0000001233883171__b1177012261210">GaussDB-8.1.3-Windows-Odbc.tar.gz</strong> and install <strong id="EN-US_TOPIC_0000001233883171__b13775102615114">psqlodbc.msi</strong> (for 32-bit OS) or <strong id="EN-US_TOPIC_0000001233883171__b167752261018">psqlodbc_x64.msi</strong> (for 64-bit OS).</p>
|
|
</p></li><li id="EN-US_TOPIC_0000001233883171__l2378f1d16f3647ffb374c5e5616a688e"><span>Open Driver Manager.</span><p><p id="EN-US_TOPIC_0000001233883171__a5431ff8aaabf41e3b001bd10e03aa3aa">Use the Driver Manager suitable for your OS to configure the data source. (Assume the Windows system drive is drive C.)</p>
|
|
<ul id="EN-US_TOPIC_0000001233883171__u9022c1d8e8f74bf9a02770dbc7f246aa"><li id="EN-US_TOPIC_0000001233883171__l8e7973077a404467909d61d4c33e144f">If you develop 32-bit programs in the 64-bit Windows OS, open the 32-bit Driver Manager at <strong id="EN-US_TOPIC_0000001233883171__b842352706152254">C:\Windows\SysWOW64\odbcad32.exe</strong> after you install the 32-bit driver.<p id="EN-US_TOPIC_0000001233883171__af2d8cb5005e1492babf0d1f3478e86de">Do not open Driver Manager by choosing <strong id="EN-US_TOPIC_0000001233883171__en-us_topic_0058965178_b842352706113347">Control Panel</strong>, clicking <strong id="EN-US_TOPIC_0000001233883171__en-us_topic_0058965178_b842352706113358">Administrative Tools</strong>, and clicking <strong id="EN-US_TOPIC_0000001233883171__en-us_topic_0058965178_b84235270611348">Data Sources (ODBC)</strong>.</p>
|
|
<div class="note" id="EN-US_TOPIC_0000001233883171__nb81cfaa31e984bce8267b6e2c465304e"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233883171__ad2359ca0482b40f6a7e6fc6cd7cfb35d">WoW64 is the acronym for "Windows 32-bit on Windows 64-bit". <strong id="EN-US_TOPIC_0000001233883171__b842352706143615">C:\Windows\SysWOW64\</strong> stores the 32-bit environment on a 64-bit system.</p>
|
|
</div></div>
|
|
</li><li id="EN-US_TOPIC_0000001233883171__li18219258486">If you develop 64-bit programs in the 64-bit Windows OS, open the 64-bit Driver Manager at <strong id="EN-US_TOPIC_0000001233883171__b95941210">C:\Windows\System32\odbcad32.exe</strong> after you install the 64-bit driver.<p id="EN-US_TOPIC_0000001233883171__p17482584816">Do not open <strong id="EN-US_TOPIC_0000001233883171__b84235270611313">Driver Manager</strong> by choosing <strong id="EN-US_TOPIC_0000001233883171__b442590971">Control Panel</strong>, clicking <strong id="EN-US_TOPIC_0000001233883171__b1761379857">Administrative Tools</strong>, and clicking <strong id="EN-US_TOPIC_0000001233883171__b1418468026">Data Sources (ODBC)</strong>.</p>
|
|
<div class="note" id="EN-US_TOPIC_0000001233883171__note206721249172813"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233883171__p6721445290"><strong id="EN-US_TOPIC_0000001233883171__b196931246172813">C:\Windows\System32\</strong> stores the environment consistent with the current OS. For technical details, see Windows technical documents.</p>
|
|
</div></div>
|
|
</li><li id="EN-US_TOPIC_0000001233883171__ld03be269d8a940a092758b6528f9e8cf">In a 32-bit Windows OS, open <strong id="EN-US_TOPIC_0000001233883171__b84235270611338">C:\Windows\System32\odbcad32.exe</strong>.<p id="EN-US_TOPIC_0000001233883171__a15ae1cd990d043ffb941c19e1be92b8c">In the Windows OS, click <strong id="EN-US_TOPIC_0000001233883171__b842352706144226">Computer</strong>, and choose <strong id="EN-US_TOPIC_0000001233883171__b842352706144230">Control Panel</strong>. Click <strong id="EN-US_TOPIC_0000001233883171__b842352706144234">Administrative Tools</strong> and click <strong id="EN-US_TOPIC_0000001233883171__b842352706144239">Data Sources (ODBC)</strong>.</p>
|
|
</li></ul>
|
|
</p></li><li id="EN-US_TOPIC_0000001233883171__lcdec44fce3004aa59f97b442d50b0928"><span>Configure the data source.</span><p><p id="EN-US_TOPIC_0000001233883171__a8f6ccd2377aa45b7bcc17221dc4ad91b">On the <strong id="EN-US_TOPIC_0000001233883171__b842352706144339">User DSN</strong> tab, click <strong id="EN-US_TOPIC_0000001233883171__b842352706144345">Add</strong>, and choose <strong id="EN-US_TOPIC_0000001233883171__b842352706144359">PostgreSQL Unicode</strong> for setup. (An identifier will be displayed for the 64-bit OS.)</p>
|
|
<p id="EN-US_TOPIC_0000001233883171__a7b8b23892fa746d0bd5bb60cc10b824f"></p>
|
|
<p id="EN-US_TOPIC_0000001233883171__p34755258113354"><span><img id="EN-US_TOPIC_0000001233883171__image54272210113349" src="figure/en-us_image_0000001233681835.jpg"></span></p>
|
|
<p id="EN-US_TOPIC_0000001233883171__p64284715113452"></p>
|
|
<div class="notice" id="EN-US_TOPIC_0000001233883171__note41362334443"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0000001233883171__p01361233164414">The entered username and password will be recorded in the Windows registry and you do not need to enter them again when connecting to the database next time. For security purposes, you are advised to delete sensitive information before clicking <strong id="EN-US_TOPIC_0000001233883171__b187591623145514">Save</strong> and enter the required username and password again when using ODBC APIs to connect to the database.</p>
|
|
</div></div>
|
|
</p></li><li id="EN-US_TOPIC_0000001233883171__l4dd168526eef4e9f84490fa978474370"><span>Enable the SSL mode.</span><p><p id="EN-US_TOPIC_0000001233883171__a0fe3752d37aa4e8e92c9f0826dc38bd6">To use SSL certificates for connection, decompress the certificate package contained in the <span id="EN-US_TOPIC_0000001233883171__text702540260">GaussDB(DWS)</span> installation package, and double-click the <strong id="EN-US_TOPIC_0000001233883171__b842352706194628">sslcert_env.bat</strong> file to deploy certificates in the default location.</p>
|
|
<div class="notice" id="EN-US_TOPIC_0000001233883171__n36ea0e56ccc44780acca3fba5fb60d02"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0000001233883171__a55ca8013481e483f9612c0155751cca8">The <strong id="EN-US_TOPIC_0000001233883171__b485554617118">sslcert_env.bat</strong> file ensures the purity of the certificate environment. When the <span class="filepath" id="EN-US_TOPIC_0000001233883171__filepath386074617116"><b>%APPDATA%\postgresql</b></span> directory exists, a message will be prompted asking you whether you want to remove related directories. If you want to remove related directories, back up files in the directory.</p>
|
|
</div></div>
|
|
<p id="EN-US_TOPIC_0000001233883171__a4d3c76bcd35d483e826ec52aae93c854">Alternatively, you can copy the <strong id="EN-US_TOPIC_0000001233883171__b92623112232">client.crt</strong>, <strong id="EN-US_TOPIC_0000001233883171__b152711119234">client.key</strong>, <strong id="EN-US_TOPIC_0000001233883171__b527115122317">client.key.cipher</strong>, and <strong id="EN-US_TOPIC_0000001233883171__b1827214117237">client.key.rand</strong> files in the certificate file folder to the manually created <span class="filepath" id="EN-US_TOPIC_0000001233883171__filepath327310142315"><b>%APPDATA%\postgresql</b></span> directory. Change <strong id="EN-US_TOPIC_0000001233883171__b5273151122313">client</strong> in the file names to <strong id="EN-US_TOPIC_0000001233883171__b72741182320">postgres</strong>, for example, change <strong id="EN-US_TOPIC_0000001233883171__b13274121102314">client.key</strong> to <strong id="EN-US_TOPIC_0000001233883171__b12764114237">postgres.key</strong>. Copy the <strong id="EN-US_TOPIC_0000001233883171__b427710172317">cacert.pem</strong> file to the <span class="filepath" id="EN-US_TOPIC_0000001233883171__filepath152778142313"><b>%APPDATA%\postgresql</b></span> directory and change its name to <strong id="EN-US_TOPIC_0000001233883171__b827813112313">root.crt</strong>.</p>
|
|
<p id="EN-US_TOPIC_0000001233883171__a20c554c23b5b48b6936f02de5f56b9f8">Change the value of <strong id="EN-US_TOPIC_0000001233883171__b842352706202147">SSL Mode</strong> in step 2 to <strong id="EN-US_TOPIC_0000001233883171__b842352706202156">verify-ca</strong>.</p>
|
|
|
|
<div class="tablenoborder"><a name="EN-US_TOPIC_0000001233883171__tbff3516afc1b4dd59cf87017f2af1d56"></a><a name="tbff3516afc1b4dd59cf87017f2af1d56"></a><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001233883171__tbff3516afc1b4dd59cf87017f2af1d56" frame="border" border="1" rules="all"><caption><b>Table 1 </b>sslmode options</caption><thead align="left"><tr id="EN-US_TOPIC_0000001233883171__r467e701476a24c6f9196bb7fa7b9f3c7"><th align="left" class="cellrowborder" valign="top" width="14.87%" id="mcps1.3.2.2.4.2.5.2.4.1.1"><p id="EN-US_TOPIC_0000001233883171__a66b3bc6e9f7647f68a29ba7f33250e8e">sslmode</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.87%" id="mcps1.3.2.2.4.2.5.2.4.1.2"><p id="EN-US_TOPIC_0000001233883171__ab74ea4ae63ca487aa7120192238e43df">Whether SSL Encryption Is Enabled</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="66.25999999999999%" id="mcps1.3.2.2.4.2.5.2.4.1.3"><p id="EN-US_TOPIC_0000001233883171__a638fcaffe80647faa40b71979c167a78">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="EN-US_TOPIC_0000001233883171__r4f8c4d32bc6a4a1facd85e19bb359db3"><td class="cellrowborder" valign="top" width="14.87%" headers="mcps1.3.2.2.4.2.5.2.4.1.1 "><p id="EN-US_TOPIC_0000001233883171__a0622dc1940ec4f918948786b42b93bc2">disable</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.87%" headers="mcps1.3.2.2.4.2.5.2.4.1.2 "><p id="EN-US_TOPIC_0000001233883171__ae8c3f1b9186146c5886718e27600bdd1">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="66.25999999999999%" headers="mcps1.3.2.2.4.2.5.2.4.1.3 "><p id="EN-US_TOPIC_0000001233883171__acc6c1739d8544afb94b149c4d5f3bb35">The SSL secure connection is not used.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001233883171__rfea1eff85b7c4980ba891b5814f5b323"><td class="cellrowborder" valign="top" width="14.87%" headers="mcps1.3.2.2.4.2.5.2.4.1.1 "><p id="EN-US_TOPIC_0000001233883171__a94d48f6129364cbeaf3e219d399fef4e">allow</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.87%" headers="mcps1.3.2.2.4.2.5.2.4.1.2 "><p id="EN-US_TOPIC_0000001233883171__aa85c33175d824b67a0d214bb14e05ea5">Probably</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="66.25999999999999%" headers="mcps1.3.2.2.4.2.5.2.4.1.3 "><p id="EN-US_TOPIC_0000001233883171__a9b92bbd1c8d74c2bbb0f6284db365532">The SSL secure encrypted connection is used if required by the database server, but does not check the authenticity of the server.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001233883171__rcd5124ce02a7438ca7c104115a08f53a"><td class="cellrowborder" valign="top" width="14.87%" headers="mcps1.3.2.2.4.2.5.2.4.1.1 "><p id="EN-US_TOPIC_0000001233883171__a9cc9c9ea7d3e46c4a061165a977d3100">prefer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.87%" headers="mcps1.3.2.2.4.2.5.2.4.1.2 "><p id="EN-US_TOPIC_0000001233883171__a2fa0b39ef952458f8724527f20d814d9">Probably</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="66.25999999999999%" headers="mcps1.3.2.2.4.2.5.2.4.1.3 "><p id="EN-US_TOPIC_0000001233883171__aeb50f8bfcd7948499d7f468ad4dfc6ef">The SSL secure encrypted connection is used as a preferred mode if supported by the database, but does not check the authenticity of the server.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001233883171__r93a1dd5857954346b1845362494c0e09"><td class="cellrowborder" valign="top" width="14.87%" headers="mcps1.3.2.2.4.2.5.2.4.1.1 "><p id="EN-US_TOPIC_0000001233883171__a4f8ce698085e473ea33fc946d0e1f9da">require</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.87%" headers="mcps1.3.2.2.4.2.5.2.4.1.2 "><p id="EN-US_TOPIC_0000001233883171__a859ea97985874f679f551ea05525c945">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="66.25999999999999%" headers="mcps1.3.2.2.4.2.5.2.4.1.3 "><p id="EN-US_TOPIC_0000001233883171__acfefba8dba4443b6967bd977437e3f56">The SSL secure connection must be used, but it only encrypts data and does not check the authenticity of the server.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001233883171__r0a1e6b8c220f4fa18dbf7fd1af998c56"><td class="cellrowborder" valign="top" width="14.87%" headers="mcps1.3.2.2.4.2.5.2.4.1.1 "><p id="EN-US_TOPIC_0000001233883171__abdf41bcac4a3483b8260fe244bae440a">verify-ca</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.87%" headers="mcps1.3.2.2.4.2.5.2.4.1.2 "><p id="EN-US_TOPIC_0000001233883171__a817f11ef93ec42888158b98f8a5eb2a2">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="66.25999999999999%" headers="mcps1.3.2.2.4.2.5.2.4.1.3 "><p id="EN-US_TOPIC_0000001233883171__a61760fcc2c144d2fbc768c7bacba5acb">The SSL secure connection must be used, and it checks whether the database has certificates issued by a trusted CA.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="EN-US_TOPIC_0000001233883171__r032adefecf0b4f67ad0c7e25587f1f36"><td class="cellrowborder" valign="top" width="14.87%" headers="mcps1.3.2.2.4.2.5.2.4.1.1 "><p id="EN-US_TOPIC_0000001233883171__a8649c02de7f34708bd80e3018a989c04">verify-full</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.87%" headers="mcps1.3.2.2.4.2.5.2.4.1.2 "><p id="EN-US_TOPIC_0000001233883171__a2526b46093dc4db1b1675ba6d77b822b">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="66.25999999999999%" headers="mcps1.3.2.2.4.2.5.2.4.1.3 "><p id="EN-US_TOPIC_0000001233883171__a53e35adab9704397831426c0d68a8166">The SSL secure connection must be used. In addition to the check scope specified by <strong id="EN-US_TOPIC_0000001233883171__b190949413">verify-ca</strong>, it checks whether the name of the host where the database resides is the same as that on the certificate.</p>
|
|
<div class="note" id="EN-US_TOPIC_0000001233883171__note89834307325"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="EN-US_TOPIC_0000001233883171__p698414302322">This mode cannot be used.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</p></li><li id="EN-US_TOPIC_0000001233883171__li029811551184"><span>Add the IP address segment of the host where the client is located to the security group rules of GaussDB(DWS) to ensure that the host can communicate with GaussDB(DWS).</span></li></ol>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001233883171__sb8ca15bfccdc4b83981f2c04a25a6a95"><h4 class="sectiontitle">Testing Data Source Configuration</h4><p id="EN-US_TOPIC_0000001233883171__a6ae13d21fc0b42c8bc6da4e5c98e6bbd">Click <strong id="EN-US_TOPIC_0000001233883171__b84235270621020">Test</strong>.</p>
|
|
<ul id="EN-US_TOPIC_0000001233883171__u32d38d74ab6c449c9c798d6e198afdbe"><li id="EN-US_TOPIC_0000001233883171__l0510c085cf2a472ca259cd828c5cb4b1">If the following information is displayed, the configuration is correct and the connection succeeds.<p id="EN-US_TOPIC_0000001233883171__af71d087c05154ef29b456392f24495da"><a name="EN-US_TOPIC_0000001233883171__l0510c085cf2a472ca259cd828c5cb4b1"></a><a name="l0510c085cf2a472ca259cd828c5cb4b1"></a><span><img id="EN-US_TOPIC_0000001233883171__en-us_topic_0059779273_icdf17aa60fca4a908fc8e92c67dd3b46" src="figure/en-us_image_0000001233563343.jpg"></span></p>
|
|
</li><li id="EN-US_TOPIC_0000001233883171__ld9a44133785743918735a189089f77d6">If error information is displayed, the configuration is incorrect. Check the configuration.</li></ul>
|
|
</div>
|
|
<div class="section" id="EN-US_TOPIC_0000001233883171__s537ab4cf91b144bfb1db18f5f2887dda"><h4 class="sectiontitle">Troubleshooting</h4><ul id="EN-US_TOPIC_0000001233883171__u7776fddf02864515bc3b6cb46fc658da"><li id="EN-US_TOPIC_0000001233883171__l309a7bb269f2407eaeaf73ea16e34680">Server common name "xxxx" does not match host name "xxxxx"<p id="EN-US_TOPIC_0000001233883171__a781a060b1c0c460c99d8630dd5605c69"><a name="EN-US_TOPIC_0000001233883171__l309a7bb269f2407eaeaf73ea16e34680"></a><a name="l309a7bb269f2407eaeaf73ea16e34680"></a>This problem occurs because when <strong id="EN-US_TOPIC_0000001233883171__b599215141631">verify-full</strong> is used for SSL encryption, the driver checks whether the host name in certificates is the same as the actual one. To solve this problem, use <strong id="EN-US_TOPIC_0000001233883171__b84235270619533">verify-ca</strong> to stop checking host names, or generate a set of CA certificates containing the actual host names.</p>
|
|
</li><li id="EN-US_TOPIC_0000001233883171__l207845817409472096a8c04d2fca889c">connect to server failed: no such file or directory<p id="EN-US_TOPIC_0000001233883171__ae5c584bc53d444e0b37ce3873fcfb843"><a name="EN-US_TOPIC_0000001233883171__l207845817409472096a8c04d2fca889c"></a><a name="l207845817409472096a8c04d2fca889c"></a>Possible causes:</p>
|
|
<ul id="EN-US_TOPIC_0000001233883171__u5d37a7021e7c440e93ca64799bfacccc"><li id="EN-US_TOPIC_0000001233883171__ld8f04c5894d644fb8456807bc4000d9a">An incorrect or unreachable database IP address or port was configured.<p id="EN-US_TOPIC_0000001233883171__a9cc2636fc97140c19bccff17f919c3ed"><a name="EN-US_TOPIC_0000001233883171__ld8f04c5894d644fb8456807bc4000d9a"></a><a name="ld8f04c5894d644fb8456807bc4000d9a"></a>Check the <strong id="EN-US_TOPIC_0000001233883171__b84235270617125">Servername</strong> and <strong id="EN-US_TOPIC_0000001233883171__b84235270617126">Port</strong> configuration items in data sources.</p>
|
|
</li><li id="EN-US_TOPIC_0000001233883171__l342e077459fb4a0c8620c88cb828729a">Server monitoring is improper.<p id="EN-US_TOPIC_0000001233883171__a1181b137caeb4cb5be4bff4e5fe1f2a7"><a name="EN-US_TOPIC_0000001233883171__l342e077459fb4a0c8620c88cb828729a"></a><a name="l342e077459fb4a0c8620c88cb828729a"></a>If <strong id="EN-US_TOPIC_0000001233883171__b1122492246171315">Servername</strong> and <strong id="EN-US_TOPIC_0000001233883171__b787426547171315">Port</strong> are correctly configured, ensure the proper network adapter and port are monitored based on database server configurations in the procedure in this section.</p>
|
|
</li><li id="EN-US_TOPIC_0000001233883171__l088bd25572a5400fa69492e7505adffd">Firewall and network gatekeeper settings are improper.<p id="EN-US_TOPIC_0000001233883171__aefc58f1f50394df5b76ea29be1a21930"><a name="EN-US_TOPIC_0000001233883171__l088bd25572a5400fa69492e7505adffd"></a><a name="l088bd25572a5400fa69492e7505adffd"></a>Check firewall settings, ensuring that the database communication port is trusted.</p>
|
|
<p id="EN-US_TOPIC_0000001233883171__ac6509f367175443b9b4d7990134b84fa">Check to ensure network gatekeeper settings are proper (if any).</p>
|
|
</li></ul>
|
|
</li><li id="EN-US_TOPIC_0000001233883171__l2d4a4eacdf1641719da8812576fabfb1">In the specified DSN, the system structures of the drive do not match those of the application.<p id="EN-US_TOPIC_0000001233883171__aa94f0ff8255640848237f641dea93ca0"><a name="EN-US_TOPIC_0000001233883171__l2d4a4eacdf1641719da8812576fabfb1"></a><a name="l2d4a4eacdf1641719da8812576fabfb1"></a>Possible cause: The bit versions of the drive and program are different.</p>
|
|
<p id="EN-US_TOPIC_0000001233883171__a785a698d6dfb4e93bb37b2715e421c39"><strong id="EN-US_TOPIC_0000001233883171__b842352706195339">C:\Windows\SysWOW64\odbcad32.exe</strong> is a 32-bit ODBC Drive Manager.</p>
|
|
<p id="EN-US_TOPIC_0000001233883171__a0775c2863f334ca295429963dace6086"><strong id="EN-US_TOPIC_0000001233883171__b1747704201">C:\Windows\System32\odbcad32.exe</strong> is a 64-bit ODBC Drive Manager.</p>
|
|
</li><li id="EN-US_TOPIC_0000001233883171__l2d0b8cb6103e40449973f6608f2a6bc6">The password-stored method is not supported.<p id="EN-US_TOPIC_0000001233883171__a33b551dbbb064424a3389c34979d071b"><a name="EN-US_TOPIC_0000001233883171__l2d0b8cb6103e40449973f6608f2a6bc6"></a><a name="l2d0b8cb6103e40449973f6608f2a6bc6"></a>Possible causes:</p>
|
|
<p id="EN-US_TOPIC_0000001233883171__a4c6370ba455c472ea1d9b48e8166fb64"><strong id="EN-US_TOPIC_0000001233883171__b2026418191313">sslmode</strong> is not configured for the data source. Set this configuration item to <strong id="EN-US_TOPIC_0000001233883171__b1826911191036">allow</strong> or a higher level to enable SSL connections. For details about <strong id="EN-US_TOPIC_0000001233883171__b826910198317">sslmode</strong>, see <a href="#EN-US_TOPIC_0000001233883171__tbff3516afc1b4dd59cf87017f2af1d56">Table 1</a>.</p>
|
|
</li><li id="EN-US_TOPIC_0000001233883171__li15833327382">authentication method 10 not supported.<p id="EN-US_TOPIC_0000001233883171__p145841632103816"><a name="EN-US_TOPIC_0000001233883171__li15833327382"></a><a name="li15833327382"></a>If this error occurs on an open source client, the cause may be:</p>
|
|
<p id="EN-US_TOPIC_0000001233883171__p10105114685419">The database stores only the SHA-256 hash of the password, but the open source client supports only MD5 hashes.</p>
|
|
<div class="note" id="EN-US_TOPIC_0000001233883171__note16467135295418"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001233883171__ul11574125164710"><li id="EN-US_TOPIC_0000001233883171__li65741051184712">The database stores the hashes of user passwords instead of actual passwords.</li><li id="EN-US_TOPIC_0000001233883171__li35747517478">In versions earlier than V100R002C80SPC300, the database stores only SHA-256 hashes and no MD5 hashes. Therefore, MD5 cannot be used for user password authentication.</li><li id="EN-US_TOPIC_0000001233883171__li65752051134716">In V100R002C80SPC300 and later, if a password is updated or a user is created, both types of hashes will be stored, compatible with open-source authentication protocols.</li><li id="EN-US_TOPIC_0000001233883171__li1357517513474">An MD5 hash can only be generated using the original password, but the password cannot be obtained by reversing its SHA-256 hash. If your database is upgraded from a version earlier than V100R002C80SPC300, passwords in the old version will only have SHA-256 hashes and not support MD5 authentication.</li></ul>
|
|
</div></div>
|
|
<p id="EN-US_TOPIC_0000001233883171__p15173910115119">To solve this problem, perform the following operations:</p>
|
|
<ol id="EN-US_TOPIC_0000001233883171__ol5132944165213"><li id="EN-US_TOPIC_0000001233883171__en-us_topic_0000001188163678_li18674101613513">Set <strong id="EN-US_TOPIC_0000001233883171__en-us_topic_0000001188163678_b314515199521">password_encryption_type</strong> to <strong id="EN-US_TOPIC_0000001233883171__en-us_topic_0000001188163678_b10146141955212">1</strong>. For details, see "Modifying Database Parameters" in <em id="EN-US_TOPIC_0000001233883171__en-us_topic_0000001188163678_i114681945217">User Guide</em>.</li><li id="EN-US_TOPIC_0000001233883171__en-us_topic_0000001188163678_li8674191619518">Create a new database user for connection or reset the password of the existing database user.<ul id="EN-US_TOPIC_0000001233883171__en-us_topic_0000001188163678_ul136741416145115"><li id="EN-US_TOPIC_0000001233883171__en-us_topic_0000001188163678_li867431618515">If you use an administrator account, reset the password. For details, see "Resetting a Password" in <em id="EN-US_TOPIC_0000001233883171__en-us_topic_0000001188163678_i172682043125616">User Guide</em>.</li><li id="EN-US_TOPIC_0000001233883171__en-us_topic_0000001188163678_li1745295113575">If you are a common user, use another client tool (such as Data Studio) to connect to the database and run the <strong id="EN-US_TOPIC_0000001233883171__en-us_topic_0000001188163678_b16424510193312">ALTER USER</strong> statement to change your password.</li></ul>
|
|
</li><li id="EN-US_TOPIC_0000001233883171__en-us_topic_0000001188163678_li176328710583">Connect to the database.</li></ol>
|
|
</li><li id="EN-US_TOPIC_0000001233883171__li5727551235">unsupported frontend protocol 3.51: server supports 1.0 to 3.0<p id="EN-US_TOPIC_0000001233883171__p1217219362238"><a name="EN-US_TOPIC_0000001233883171__li5727551235"></a><a name="li5727551235"></a>The database version is too early or the database is an open-source database. Use the driver of the required version to connect to the database.</p>
|
|
</li></ul>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_04_0117.html">ODBC-Based Development</a></div>
|
|
</div>
|
|
</div>
|
|
|