Pervasive.SQL ODBC
Werbung
Inhaltsverzeichnis Pervasive.SQL ODBC Treiber ab ABACUS 2006.20er-Version Installationsanleitung Mai 2013 / CL 1 Serverinstallation .............................................................................................................. 1 2 Clientinstallation ............................................................................................................... 8 WICHTIG Alle untenstehenden Schritte müssen direkt auf dem Server (keine Terminalserver- oder RDP- Verbindungen, auch keine NetViewer- oder TeamViewerVerbindungen o. Ä.) ausgeführt werden, da es ansonsten Probleme geben kann. Beachten Sie bitte auch die nachfolgenden Hinweise! HINWEIS 1: Mit den aktuellen Versionen ab ABACUS Version2012 wird auf dem ABACUS-Server kein \pvsw\bin-Ordner mitinstalliert. Beachten Sie bitte die Clientinstallation bzw. Konfiguration auf der Seite 8 + 9, Punkt 2.2.1! HINWEIS 2: Kriegen Sie beim Öffnen der PCC.exe eine Java-Fehler-Meldung? Beachten Sie bitte die Umgehungsmöglichkeit auf der Seite 3, Punkt 1.2.2! HINWEIS 3: Mit der Installation der aktuellen ABACUS Version2008 (CD - 16.03.2009) und ABACUS Version2009 wird die neue Pervasive-Software 10.10.125.000 mitinstalliert. Beachten Sie bitte die Clientinstallation bzw. Konfiguration auf der Seite 8, Punkt 2.2.1! Pervasive.SQL ODBC Seite I Inhaltsverzeichnis 1 Serverinstallation .............................................................................................................. 1 1.1 Path Eintrag .................................................................................................................. 1 1.2 Pervasive Control Center .............................................................................................. 1 1.2.1 Mögliche Fehler .................................................................................................... 2 1.2.2 PCC.exe Java-Fehler ............................................................................................ 3 1.3 Neue Datenbank für ODBC Zugriff erstellen .................................................................. 4 1.4 Sicherheit ...................................................................................................................... 6 2 Clientinstallation ............................................................................................................... 8 2.1 Client Installation ........................................................................................................... 8 2.2 Batchfile ausführen oder Path-Eingabe (sh. 2.2.1) auf dem Client ................................. 8 2.2.1 Path-Eingabe auf dem Client ................................................................................ 9 2.2.2 Path-Eingabe auf dem Client ab ABACUS Version2012 ....................................... 9 2.3 ODBC Quelle definieren ...............................................................................................11 Pervasive.SQL ODBC Seite II Serverinstallation 1 1 Serverinstallation WICHTIG Alle untenstehenden Schritte müssen direkt auf dem Server (keine Terminalserver- oder RDP- Verbindungen, auch keine NetViewer- oder TeamViewerVerbindungen o. Ä.) ausgeführt werden, da es ansonsten Probleme geben kann. 1.1 Path Eintrag Auf dem Server muss in den Umgebungsvariablen der „Path“- Eintrag mit „c:\abasys\pvsw\bin“ erweitert werden. Bild 1: Path Einstellung 1.2 Pervasive Control Center Danach kann im Verzeichnis c:\abasys\pvsw\bin das Pervasive Control Center (pcc.exe) gestartet werden. Pervasive.SQL ODBC Seite 1 Serverinstallation 1 Bild 2: Pervasive Control Center 1.2.1 Mögliche Fehler Falls untenstehende Fehlermeldung beim starten des Pervasive Control Center (pcc.exe) auftritt, muss die aktuellste Java Runtime installiert werden (www.java.com) Bild 3: Fehlermeldung Pervasive.SQL ODBC Seite 2 Serverinstallation 1 1.2.2 PCC.exe Java-Fehler Sollten Sie die untenstehende Fehlermeldung beim Starten der PCC.exe erhalten so löschen Sie den Inhalt und kopieren Sie folgenden Text in die PCC.ini-Datei (Die ini-Datei finden Sie unter C:\abasys\pvsw\bin\pcc.ini): # Eclipse RCP application launchers receive startup arguments # via a configuration file. The file must be given the name # <launcher>.ini. The launcher simply reads the configuration # file and passes the contents to the startup.jar. Our install # allows the user to change where the Application Data is stored. # So we rely on the PSQL Windows install to append the # -configuration and -data options to the <lancher>.ini. # The Eclipse product to be launched -product com.pervasive.psql.utilities.ui.pem # The location the startup.jar will find the config.ini file -configuration \abasys\pvsw\data\rcp\configuration # The location Eclipse will create the rcp workspace -data \abasys\pvsw\data\rcp\workspace-pcc Bild 4: PCC-Fehlermeldung Pervasive.SQL ODBC Seite 3 Serverinstallation 1 1.3 Neue Datenbank für ODBC Zugriff erstellen Nachdem das Pervasive Control Center gestartet wurde, muss für jeden Mandanten eine neue Verbindung erstellt werden. Um die Verbindung zu erstellen, klicken Sie mit der rechten Maustaste auf den Servernamen und danach auf New – Database. Bild 5: New Database Danach muss der Database Name (z. B. Abacus7777) und der Pfad (E:\abac\db\nrXXXX) angegeben werden. Mit Klick auf „Finish“ geht es weiter. HINWEIS: Wenn Sie das Flag „Create DSN“ aktiv lassen, wird auf dem Server ein DSN Eintrag erstellt. Somit könnte man nun auf dem Server via ODBC zugreifen. Falls Sie auf dem Client via ODBC auf die Datenbank zugreifen möchten, müssen Sie auf dem Client einen DSN Eintrag erstellen. (siehe unten). Pervasive.SQL ODBC Seite 4 Serverinstallation 1 Bild 6: New Database Definition Nun ist die Verbindung erstellt und kann benutzt werden. HINWEIS: Aktivieren Sie „Long metadata“ falls die Tabellen im PCC leer sind. Pervasive.SQL ODBC Seite 5 Serverinstallation 1 Bild 7: New Database im PCC HINWEIS: Um die ABACUS Zent Tabellen auszulesen, muss zwingend eine neue Verbindung erstellt werden (Location: E:\abac\db) 1.4 Sicherheit WICHTIG Es wird dringend empfohlen ein Passwort auf dem jeweiligen „Mandanten“ zu erstellen. Um dies zu erstellen klicken Sie mit der rechten Maustaste auf den vorher erstellten „Mandanten“ und wählen Sie „Properties“ Pervasive.SQL ODBC Seite 6 Serverinstallation 1 Bild 8: Properties im PCC Danach wechseln Sie ins Verzeichnis „Security“, aktivieren Sie das Flag „Enable Security“ und geben Sie ein sicheres Passwort ein. Bild 9: Security WICHTIG Der User „Master“ wird automatisch vom Pervasive Control Center erstellt. Pervasive.SQL ODBC Seite 7 Clientinstallation 2 2 Clientinstallation 2.1 Client Installation Um von einem Client aus via ODBC auf die ABACUS Datenbank zuzugreifen, muss zuerst der neue Clientsetup ausgeführt werden (ab 2006.2 / 09.03.2007). 2.2 Batchfile ausführen oder Path-Eingabe (sh. 2.2.1) auf dem Client Damit alle nötigen Files vom Server auf den Client kopiert werden, muss das Batchfile „odbcinst.bat“ ausgeführt werden. Sie finden das Batchfile im Verzeichnis „Y:\abac\pvsw\bin\odbcinst.bat“ Damit das Batchfile auch richtig funktioniert, müssen Sie in die Eingabeaufforderung wechseln und dort auf das gemappte ABACUS Laufwerk zugreifen. Danach in den Ordner „\abac\pvsw\bin“ wechseln und dort das Batchfile „odbcinst.bat“ starten. Bild 10: Dateien kopieren Pervasive.SQL ODBC Seite 8 Clientinstallation 2 2.2.1 Path-Eingabe auf dem Client Es ist nicht zwingend notwendig die Dateien vom Server auf den Client zu kopieren. Sie können den Pfad des Servers in die Umgebungsvariable des Clients eintragen. So werden die Dateien des Servers für die ODBC-Verbindung eingesetzt. Bsp: Y:\abac\pvsw\bin als ABACUS-Netzwerkpfad oder siehe Bild 10 (wobei "SRV01" für den "Servernamen" und "ABACUS" für den "Freigabenamen" steht. Im Verzeichnis "\abac\pvsw\bin" sind die ODBC-Files bzw. DLL-Files abgelegt). Bild 11: Path Einstellung auf dem Client HINWEIS: Mit der Installation der aktuellen ABACUS Version2008 (CD - 16.03.2009) und Version2009 wird die neue Pervasive-Software 10.10.125.000 mitinstalliert. Die "odbcinst.bat" wird nicht mehr eingesetzt! 2.2.2 Path-Eingabe auf dem Client ab ABACUS Version2012 Die ODBC-Client-Files werden mit dem Client-Setup direkt auf dem Client installiert. Sie finden die ODBC-Files unter c:\abasys\pvsw\bin. Hinterlegen bzw. überprüfen Sie ob dieser Pfad in der Umgebungsvariable hinterlegt ist: Bild 12: Path Einstellung auf dem Client ab V2012 Überprüfen Sie ebenfalls ob der Pfad c:\abasys\pvsw\bin auch in der Registry (DSN und Treiber) korrekt hinterlegt ist. Pervasive.SQL ODBC Seite 9 Clientinstallation 2 Bild 13: Registy-Eintrag DSN Bild 14: Registy-Eintrag Treiber HINWEIS: Die 32bit-DSN-Einträge sind im Windows unter c:\windows\syswow64\ odbcad32.exe zu finden. In diesem Fall in der Registry unter \Software\wow6432Node\Odbc\. Die 64bit hingegen unter c:\windows\system32\odbcad32.exe und somit in der Registry unter dem Pfad \Software\Odbc\. Pervasive.SQL ODBC Seite 10 Clientinstallation 2 2.3 ODBC Quelle definieren Danach kann im ODBC Datenquellen Administrator ein neuer Eintrag erstellt werden. Bild 15: ODBC Datenquellen Administrator Hinzufügen anklicken. Hier muss „Pervasive ODBC Client Interface“ gewählt werden. Bild 16: ODBC Datenquellen Auswahl Pervasive.SQL ODBC Seite 11 Clientinstallation 2 Bei „Data Source Name“ wird der gewünschte Verbindungsnamen eingegeben, und bei „Address“ wird der Server Name angegeben. Danach auf „Get DSN List“ klicken um den Data Source Name zu erhalten. Bild 17: ODBC Datenquellen Definition Somit ist auf dem Client die DSN Verbindung eingerichtet und kann wie gewohnt benutzt werden. Pervasive.SQL ODBC Seite 12 Clientinstallation 2 Bild 18: ODBC Datenquelle ACHTUNG Verschiedene Applikationen (z.B. MS Access oder MS Excel) haben die Möglichkeit den Usernamen und das Kennwort in der ODBC-Verbindung zu speichern. Wenn das gemacht wird, hat somit jeder der Zugriff auf diese Datei hat auch Zugriff auf die entsprechenden Daten. Der ODBC-Treiber von Pervasive.SQL ist ein nativer Treiber und prüft somit logischerweise keine abacusspezifischen Zugriffsrechte. Er ist aber im Abacus Umfeld so definiert, dass nur ein Lesezugriff möglich ist. Pervasive.SQL ODBC Seite 13
