OPC2DataBase Tutorial Erste Schritte

1. 2.

EINLEITUNG ...........................................................................................................................................................2 ORACLE 10G EXPRESS EDITION ....................................................................................................................3 2.1. 2.2. 2.3. 2.4. 2.5. 2.6. INSTALLATION DER ORACLE DATENBANK .............................................................................................................3 INSTALLATION DES DATENBANK-CLIENT ..............................................................................................................4 UMSTELLEN DES HTTP-PORTS DER DATENBANK ..................................................................................................5 STARTEN DER DATENBANK .................................................................................................................................8 FREISCHALTEN DES DATENBANK-BENUTZERS HR .............................................................................................9 ANLEGEN DER TABELLE OCT IN DER DATENBANK ...........................................................................................10 KONFIGURATIONSDATEI SUBSCRIPTION.TXT ....................................................................................................12 KONFIGURATIONSDATEI TASK.TXT ..................................................................................................................13 SPEICHERN VON EXCEL-TABELLEN ALS TEXT-DATEIEN ......................................................................................14 OPC KONFIGURATOR.......................................................................................................................................15 DIE SERVER CONNECTION ................................................................................................................................16 TASK ...............................................................................................................................................................17 ADDON............................................................................................................................................................18 SUBSCRIPTION .................................................................................................................................................19 STARTEN DER SOFTING OPC EASY CONNECT...................................................................................................20 ERGEBNIS........................................................................................................................................................21

3.

ERSTELLEN DER KONFIGURATIONSFILES FR OPC2DATABASE .............................................................12 3.1. 3.2. 3.3.

4.

OPC EASY CONNECT KONFIGURATION ......................................................................................................15 4.1. 4.2. 4.3. 4.4. 4.5.

5.

INBETRIEBNAHME ..............................................................................................................................................20 5.1. 5.2.

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 1 / 19

1.

Einleitung

In diesem Tutorial wird die Konfiguration von "OPC2DataBase" Schritt fr Schritt gezeigt. Sie werden OPC-Daten aus dem "Softing OPC Toolbox Demo Server" abrufen und in eine SQL Datenbank ablegen.

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 2 / 19

2.

Oracle 10g Express Edition

Fr die Durchfhrung dieses Tutorials ist die Installation der Oracle Datenbank 10g Express Edition und dem dazugehrigen Datenbank Client notwendig. Diese Datenbank steht kostenlos zum Herunterladen auf der Oracle Webseite zur Verfgung. Sie bentigen die folgenden Dateien: OracleXE.exe (Oracle Datenbank, ca. 160 MByte) OracleXEClient.exe (Datenbank-Client, ca. 30 MByte) Wichtiger Hinweis: Der Softing OPC Toolbox Demo Server benutzt fr die OPC XML-DA Kommunikation den IP Port 8080, den auch die Oracle Datenbank fr die Web Oberflche nutzt. Deshalb kann der Demo Server nach Installation der Datenbank nicht mehr durch einen OPC-Client gestartet werden. Aus diesem Grund werden wir in diesem Tutorial die Datenbank auf den Port 8079 umstellen.

2.1. Installation der Oracle Datenbank

Starten Sie "OracleXE.exe" Akzeptieren Sie die Lizenzvereinbarung Whlen Sie das Zielverzeichnis fr die Oracle Datenbank (bentigt ca. 1,6 GByte freien Speicher) Legen Sie das Kennwort fr den Systemadministratoren der Datenbank fest. Dieses Kennwort werden wir spter noch brauchen. Starten Sie die Installation.

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 3 / 19

2.2. Installation des Datenbank-Client

Um auf die Datenbank lesend und schreibend zuzugreifen werden ODBC-Treiber bentigt. Diese stellt Oracle zusammen mit dem Datenbank-Client zur Verfgung. Fhren Sie als nchstes die Datei OracleXEClient.exe aus. Starten Sie nach der Installation den Rechner neu.

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 4 / 19

2.3. Umstellen des Http-Ports der Datenbank

Der Softing OPC Toolbox Demo Server benutzt fr die OPC XML-DA Kommunikation den IP Port 8080, den auch die Oracle Datenbank fr die Web Oberflche nutzt. Deshalb kann der Demo Server nach Installation der Datenbank nicht mehr durch einen OPC-Client gestartet werden. Wir werden deshalb jetzt den Port der Datenbank mit Hilfe eines Kommandozeilentools auf dem Port 8079 umstellen Um den Port umzustellen ffnet man die Oracle SQL-Befehlszeile.

Als erstes meldet man sich als Benutzer System mit dem bei der Installation vergebenen Passwort an. Danach sind wie im Screenshot 3 Zeilen SQL-Code einzugeben (Port wie gewnscht einstellen) und mit / abzuschlieen. Der Port ist nun dauerhaft umgestellt, die Befehlszeile kann mit Exit wieder geschlossen werden.

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 5 / 19

Nun muss nur noch der Link auf die Datenbankhomepage angepasst werden, hierzu die Eigenschaften des Links mit der rechten Maustaste ffnen:

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 6 / 19

Und den Port entsprechend anpassen:

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 7 / 19

2.4. Starten der Datenbank

Starten Sie die Datenbank-Homepage ber das Windows-Startmen (Programme / Oracle Database 10g Express Edition / Gehe zu Datenbank-Homepage) Melden Sie sich als Benutzer System an. Benutzen Sie das Kennwort, das Sie whrend der Installation vergeben haben.

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 8 / 19

2.5. Freischalten des Datenbank-Benutzers HR

Zunchst existiert nur der System-Account. Um auf die Datenbank zugreifen zu knnen schalten wir als nchstes den Datenbank-Benutzer HR frei. Navigieren Sie mit Hilfe der Piktogramme zu Home > Administration > Manage Database Users Whlen Sie das Piktogramm fr den Benutzer HR. Vergeben Sie fr den Benutzer HR das Passwort HR Setzen Sie den Account Status auf Unlocked. Besttigen Sie die Einstellungen mit der Schaltflche Alter User. Melden Sie sich als Benutzer System ab.

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 9 / 19

2.6. Anlegen der Tabelle OCT in der Datenbank

Melden Sie sich als Benutzer HR an. Navigieren Sie zum Object Browser. Drcken Sie auf Create. Whlen Sie Table. Geben Sie der Tabelle den Namen OCT. Legen Sie die Spalten ITEMID, VALUE und QUALITY mit dem Datentyp VARCHAR2 an. Drcken Sie auf der linken Navigationsleiste auf Confirm. Drcken Sie auf die Schaltflche Create. Die Tabelle OCT kann jetzt im Obect Browser angesehen werden.

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 10 / 19

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 11 / 19

3.

Erstellen der Konfigurationsfiles fr OPC2DataBase

Excel-Tabellen knnen als Text-Dateien (Tabs getrennt) gespeichert werden. Wir werden als nchstes mit Hilfe von Excel-Schablonen die Konfigurationsdateien Task.txt und Subscriptions.txt erstellen. Eine Zeile in Excel entspricht einer Befehlszeile in der Konfiguration. Eine Zelle entspricht einem Statement. Sie finden die Excel-Schablonen mit einem Beispielprojekt im Installationsverzeichnis der Softing OPC Easy Connect.

3.1. Konfigurationsdatei Subscription.txt

Die Konfigurationsdatei Subscription.txt legt fest, auf welche Daten des OPC-Servers zugegriffen wird. Wir werden die Datei in diesem Tutorial nicht verndern. Sie beinhaltet bereits eine Beispielkonfiguration fr den Softing Demo OPC Server als Datenquelle mit folgenden Einstellungen: Die Daten des OPC Servers werden mit einer Aktualisierungsrate von 1000 ms auf Wertenderungen berprft, und gegebenenfalls in die Datenbank geschrieben. Es wird ein OPC-Item SIN definiert, das ber den FullyQualified ItemIdentifier Demo.maths.sin aus dem Namensraum des OPC-Server gelesen wird. Vor jedem Itemidentifierfinden Sie den ItemPrefix Demo. Der ItemPrefix ist ein Parameter der Server Connection und legt fest, auf welchen OPC-Server zugegriffen werden soll. Weitere Informationen zur Server Connection finden Sie in Kapitel 4.2 Mit dem SQL-Statement wird festgelegt, das der Name, der Wert und die Qualitt in die Datenbank geschrieben werden soll. Eine bersicht der mglichen SQL-Statements finden Sie in der Hilfe im Kapitel Konfiguration / Tasks / <TaskID> / AddOns / Database / Subscription Konfigurationsdatei

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 12 / 19

3.2. Konfigurationsdatei Task.txt

In der Konfigurationsdatei Task.txt wird der Zugriff auf die Datenbank festgelegt. Die im Lieferumfang der OPC Easy Connect enthaltene Beispielkonfiguration enthlt exemplarisch den Zugriff auf die vier ODBC Datenbanken Oracle Express, IBM DB2, SQL Server und MySQL. ffnen Sie aus dem Installationsverzeichnis der OPC Easy Connect Suite die Datei Task.xls mit Excel Entfernen Sie in der 4. und 5. Zeile das Rautezeichen (mit Rautezeichen werden Zeilen auskommentiert) Fgen Sie in Zeile 4 in der Spalte User Name und Password: HR ein.

Die Felder Driver, Statement und Host sind bereits fr die 10g Express Edition vorbereitet. Das Feld Database Name wird von dieser Datenbank nicht ausgewertet.

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 13 / 19

3.3. Speichern von Excel-Tabellen als Text-Dateien

Speichern Sie die Excel-Tabelle mit folgenden Einstellungen in das Installationsverzeichnis ab: o o Dateiname: Task.txt Dateityp Text (Tabstopp-getrennt) (*.txt)

Microsoft warnt eventuell, das nicht alle Merkmale der Excel-Datei gespeichert werden knnen. Besttigen Sie mit Ja.

Beenden Sie Excel Wichtiger Hinweis: Solange Excel geffnet ist blockiert es den Zugriff auf die Dateien Subscription.txt, bzw. Task.txt. Deshalb muss Excel geschlossen werden, bevor OPC2DataBase diese Dateien benutzen kann.

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 14 / 19

4.

OPC Easy Connect Konfiguration

4.1. OPC Konfigurator

Die Komponenten der OPC Easy Connect werden ber eine XML Konfigurationsdatei mit dem Namen "OCT.xml" konfiguriert. Der Inhalt kann mit dem OPC Konfigurator, oder mit einem Konfigurationsassistenten bearbeitet werden. Der Konfigurationsassistent fr OPC2DataBase steht erst ab der Version 1.5 der OPC Easy Connect Suite zur Verfgung. Im folgenden werden wir die Konfiguration mit dem OPC-Konfigurator vornehmen. Im Start Men finden Sie diesen unter "Programme / Softing OPC Easy Connect / Konfigurator". Starten Sie den OPC Konfigurator Sollte der Konfigurationsassistent erscheinen drcken Sie auf Abbrechen

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 15 / 19

4.2. Die Server Connection

Von welchem OPC-Server die Daten abgerufen werden, wird in einer Server Connection festgelegt. Die Datei OCT.xml beinhaltet bereits die vorgefertigte Server Connection DemoDA. Das Attribut URL verweist auf den Softing OPC Toolbox Demo Server. Der ItemPrefix heit Demo.

Wichtiger Hinweis: Sollten Sie bereits mit Softing OPC Easy Connect gearbeitet haben, kann es sein, das die Server Connection DemoDA berschrieben wurde. Legen Sie in diesem Fall bitte eine neue Server Connection an, die auf den Softing OPC Toolbox Demo Server verweist und den ItemPrefix Demo hat.

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 16 / 19

4.3. Task
Die Aufgabe, OPC-Daten in eine SQL-Datenbank zu schreiben wird in einem Task zusammengefasst. Diesen legen wir als nchstes mit dem OPC-Konfigurator an. Markieren Sie auf der linken Seite des OPC-Konfigurator den Ordner Tasks ffnen Sie mit der rechten Maustaste das Kontext-Men und whlen Sie Add Setzen Sie das Attribut ID auf DBTask und whlen Sie als Path die Datei Task.txt, die Sie in einem vorherigen Schritt erstellt haben.

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 17 / 19

4.4. AddOn
Die Funktionalitt von OPC2DataBase ist in der Datei OCTDatabase.dll definiert. Diese Datei wird als AddOn verlinkt. Markieren Sie den Ordner Tasks / DBTask / AddOns ffnen Sie das Kontext-Men und whlen Sie Add Machen Sie folgende Einstellungen: o ID: DBAddon o Type: Database o Path: C:\Programme\Softing\OCT\OCTDatabase.dll

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 18 / 19

4.5. Subscription
Als letztes verknpfen wir noch das Konfigurationsfile Subscription.txt: Markieren Sie den Ordner Tasks / DBTask / Subscriptions ffnen Sie das Kontext-Men und whlen Sie Add Machen Sie folgende Einstellungen: o ID: DBSubscription o Type: DA o Path: C:\Programme\Softing\OCT\Subscription.txt Beenden Sie anschlieend den OPC-Konfigurator

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 19 / 19

5.

Inbetriebnahme

5.1. Starten der Softing OPC Easy Connect

Fhren Sie einen Doppelklick auf das SystemTray-Icon der OPC Easy Connect aus Markieren Sie die erste Zeile und drcken Sie auf die Schaltflche Neu starten

Wichtiger Hinweis: Auf manchen Systemen kann es vorkommen, dass Sie beim Start des Easyconnect ein Fehlermeldung SQResus.dll nicht gefunden bekommen. Hierbei handelt es sich um ein Problem der Oracle ODBC-Treiber Installation. Um das Problem zu beheben mssen Sie die Datei C:\oraclexe\app\oracle\product\10.2.0\server\BIN\mfc71.dll nach C:\XEClient\bin\ kopieren.

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 20 / 19

5.2. Ergebnis
Starten Sie die Datenbank-Homepage ber das Windows-Startmen Melden Sie sich als Benutzer HR an und sehen Sie sich das Ergebnis an

Herzlichen Glckwunsch. Sie haben in diesem Tutorial erfolgreich OPC-Daten des Softing Toolbox Demo Servers in eine Oracle SQL-Datenbank geschrieben. Sie knnen natrlich auch eine andere SQL-Datenbank benutzen (Anpassungen in Task.txt), andere Daten in die Datenbank schreiben (Anpassungen in Subscription.txt) oder Daten von einem anderen OPCServer in die Datenbank schreiben (Anpassen der Server Connection im OPC-Konfigurator). Die Softing AG wnscht Ihnen viel Erfolg beim Einsatz dieser Software. Falls Sie Fragen und Anregungen haben steht Ihnen unser Support support.automation@softing.com gerne zur Verfgung.

Copyright Softing AG, Okt 2007, OPC2Dat-Tutorial.doc

Seite 21 / 19