Difference between revisions of "Installation Guide for the ODBC Plugin"

From ESS-WIKI
Jump to: navigation, search
(Replaced content with "<span style="font-size:large;">'''Please refer [http://ess-wiki.advantech.com.tw/view/ODBC_Service ODBC Service]'''</span>")
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
<font face="Droid Sans Mono, sans-serif"><font size="6">Overview</font></font>
+
<span style="font-size:large;">'''Please refer&nbsp;[http://ess-wiki.advantech.com.tw/view/ODBC_Service ODBC Service]'''</span>
 
 
<font face="Droid Sans Mono, sans-serif"><font size="3">This document is a quick start guide for user to know how to install ODBC Plugin.</font></font>
 
 
 
<font face="Droid Sans Mono, sans-serif"><font size="3">In this document,&nbsp;you may follow the steps to install and configure the plugin.</font></font>
 
 
 
 
 
 
 
<font face="Droid Sans Mono, sans-serif"><font size="6">Required Package</font></font>
 
 
 
<font face="Droid Sans Mono, sans-serif"><font size="3">1.RMM Agent:</font></font>
 
 
 
<font face="Droid Sans Mono, sans-serif"><font size="3">RMM 3.3 Agent Plus Setup_3.3.18.exe</font></font>
 
 
 
 
 
 
 
<font face="Droid Sans Mono, sans-serif"><font size="3">2.ODBC Plugin:</font></font>
 
 
 
<font face="Droid Sans Mono, sans-serif" size="3">ODBCPlugin_standard_v1.0.xxxx.zip</font>
 
 
 
 
 
 
 
<font face="Droid Sans Mono, sans-serif"><font size="6">How to install ODBC Plugin</font></font>
 
 
 
 
 
 
 
<span style="font-size:medium;">1.Install '''WISE-PaaS Agent 3.3'''.</span>
 
 
 
 
 
 
 
<span style="font-size:medium;">2.Stop the services '''SAWatchdog''' and '''AgentService_32''' from Task Manager.</span>
 
 
 
 
 
 
 
<span style="font-size:medium;">3.UnZIP the ODBC plugin package and install below files manually:</span>
 
 
 
<span style="font-size:medium;">3.1.Copy the files '''ODBC_Handler.ini '''to the folder where the WISE-PaaS Agent installed. ( by default, the path is C:\Program Files (x86)\Advantech\RMM 3.3 Agent )</span>
 
 
 
<span style="font-size:medium;">3.2.Copy the file '''ODBC_Handler.dll '''to sub-folder \module where the WISE-PaaS Agent installed. ( by default, this path is C:\Program Files (x86)\Advantech\RMM 3.3 Agent\module )</span>
 
 
 
&nbsp;
 
 
 
<span style="font-size:medium;">4.Open the file '''ODBC_Handler.ini '''and set the [Text] session</span>
 
 
 
<span style="font-size:medium;">4.1FilePath: Set path of the CSV file locate, for example C:\Test</span>
 
 
 
<span style="font-size:medium;">4.2FieldName & FieldDataType: Set data type of the each field name which includes CSV file. The item of&nbsp;FieldDataType belong&nbsp;FieldName is relative position.</span>
 
 
 
<span style="font-size:medium;">&nbsp; &nbsp; &nbsp;Support data type: timestamp, double, string, float, boolean.</span>
 
 
 
<span style="font-size:medium;">&nbsp; &nbsp; &nbsp;For example: 1. TIME = timestamp 2. No#1EC = double 3. No#1ph = float ……</span>
 
 
 
&nbsp;
 
 
 
<span style="font-size:medium;">'''[Setting]'''</span>
 
 
 
<span style="font-size:medium;">#ODBCDriver=Microsoft Access Driver (*.mdb)</span>
 
 
 
<span style="font-size:medium;">#ODBCDriver=MySQL ODBC 5.3 Unicode Driver</span>
 
 
 
<span style="font-size:medium;">#ODBCDriver=PostgreSQL ANSI</span>
 
 
 
<span style="font-size:medium;">#ODBCDriver=Microsoft Excel Driver</span>
 
 
 
<span style="font-size:medium;">'''ODBCDriver=Microsoft Text Driver (*.txt; *.csv)'''</span>
 
 
 
<span style="font-size:medium;">'''ReadOnly=0'''</span>
 
 
 
<span style="font-size:medium;">'''…'''</span>
 
 
 
<span style="font-size:medium;">&nbsp;</span>
 
 
 
<span style="font-size:medium;">'''[Text]'''</span>
 
 
 
<span style="font-size:medium;">'''FilePath=C:\Test'''</span>
 
 
 
<span style="font-size:medium;">'''FieldName=TIME,No#1EC,No#1ph,No#2EC,No#1es,No#1e,No#1HumidityRatio,No#2ph'''</span>
 
 
 
<span style="font-size:medium;">'''FieldDataType=timestamp,double,float,string,float,double,double,float'''</span>
 
 
 
&nbsp;
 
 
 
<span style="font-size:medium;">5.Open the file '''\module\module_config.xml''' and add the new session &lt;ModuleNameXX&gt;, &lt;ModulePathXX&gt; and &lt;ModuleEnableXX&gt; for keep ODBC_Handler configurations, also remember to update total module number for the session '''&lt;ModuleNum&gt;''', for example:</span>
 
 
 
<span style="font-size:medium;">&lt;?xml version="1.0"?&gt;</span>
 
 
 
<span style="font-size:medium;">&lt;XMLConfigSettings&gt;&lt;BaseSettings&gt;</span>
 
 
 
<span style="font-size:medium;">'''&lt;ModuleNum&gt;1''''''8''''''&lt;/ModuleNum&gt;'''</span>
 
 
 
<span style="font-size:medium;">…</span>
 
 
 
<span style="font-size:medium;">'''<ModuleName1''''''8''''''>''''''ODBC_''''''Handler</ModuleName1''''''8''''''><ModulePath1''''''8''''''>\module\''''''ODBC_''''''Handler.dll</ModulePath1''''''8''''''><ModuleEnable1''''''8''''''>TRUE</ModuleEnable1''''''8''''''>'''</span>
 
 
 
<span style="font-size:medium;">&lt;/BaseSettings&gt;&lt;/XMLConfigSettings&gt;</span>
 
 
 
 
 
 
 
 
 
 
 
<span style="font-size:medium;">6.Make sure the settings in the agent_config.xml are correct, include &lt;ServerIP&gt;, &lt;DeviceName&gt;, &lt;DevID&gt; and &lt;WorkDir&gt; of your machine, for example:</span>
 
 
 
<span style="font-size:medium;">&lt;?xml version="1.0" encoding="utf-8" standalone="yes"?&gt;</span>
 
 
 
<span style="font-size:medium;">&lt;XMLConfigSettings&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp; &lt;BaseSettings&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp;&nbsp; &lt;RunMode&gt;RemoteConnect&lt;/RunMode&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp;&nbsp; &lt;AutoStart&gt;True&lt;/AutoStart&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp; '''&nbsp;&lt;ServerIP&gt;''''''127.0.0.1''''''&lt;/ServerIP&gt;'''</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp;&nbsp; &lt;ServerPort&gt;1883&lt;/ServerPort&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp;&nbsp; &lt;ConnAuth&gt;fENl4B7tnuwpIbs61I5xJQ==&lt;/ConnAuth&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp;&nbsp; &lt;TLSType&gt;0&lt;/TLSType&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp;&nbsp; &lt;CAFile/&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp;&nbsp; &lt;CAPath/&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp;&nbsp; &lt;CertFile/&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp;&nbsp; &lt;KeyFile/&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp;&nbsp; &lt;CertPW/&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp;&nbsp; &lt;PSK&gt;05155853&lt;/PSK&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp;&nbsp; &lt;PSKIdentify/&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp;&nbsp; &lt;PSKCiphers/&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp; &lt;/BaseSettings&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp; &lt;Profiles&gt;</span>
 
 
 
<span style="font-size:medium;">'''&nbsp;&nbsp;&nbsp; &lt;DeviceName&gt;''''''ODBCTEST''''''&lt;/DeviceName&gt;'''</span>
 
 
 
<span style="font-size:medium;">'''&nbsp;&nbsp;&nbsp; &lt;DevID&gt;0000D850E6C4CED3&lt;/DevID&gt;'''</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp;&nbsp; &lt;SN&gt;60A44CE9EA69&lt;/SN&gt;</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp;&nbsp; &lt;DevType&gt;IPC&lt;/DevType&gt;</span>
 
 
 
<span style="font-size:medium;">'''&nbsp;&nbsp;&nbsp; &lt;WorkDir&gt;C:\Program Files (x86)\Advantech\RMM 3.''''''3''''''Agent\&lt;/WorkDir&gt;'''</span>
 
 
 
<span style="font-size:medium;">'''&nbsp;&nbsp;&nbsp; &lt;SWVersion&gt;3.''''''3''''''.1''''''5''''''.0&lt;/SWVersion&gt;'''</span>
 
 
 
<span style="font-size:medium;">&nbsp;&nbsp; …</span>
 
 
 
<span style="font-size:medium;">&nbsp;</span>
 
 
 
<span style="font-size:medium;">7.Prepare your data file (.csv) and copy the file into the folder you assigned in the ODBCHandler.ini.</span>
 
 
 
<span style="font-size:medium;">&nbsp;</span>
 
 
 
<span style="font-size:medium;">8.Re-start '''SAWatchdog''' and '''AgentService_32''' and open the RMM 3.3 web page, for example [http://127.0.0.1:8080 http://127.0.0.1:8080] if you install RMM 3.3 Server and Agent in same host. then input user id & password to login.</span>
 
 
 
<span style="font-size:medium;">&nbsp;</span>
 
 
 
<span style="font-size:medium;">9.Add your device and check if ODBC_Handler tab is created in the hardware information screen.</span>
 
 
 
<span style="font-size:medium;"></span>
 
 
 
<span style="font-size:medium;">10. Finally you can see the last set of data as below.</span>
 

Latest revision as of 10:51, 22 January 2019

Please refer ODBC Service