Pervasive.SQL ODBC Treiber. ab ABACUS er-Version Installationsanleitung

Transkript

1 Inhaltsverzeichnis Pervasive.SQL ODBC Treiber ab ABACUS er-Version Installationsanleitung Mai 2013 / CL 1 Serverinstallation Clientinstallation... 8 WICHTIG Alle untenstehenden Schritte müssen direkt auf dem Server (keine Terminalserver- oder RDP- Verbindungen, auch keine NetViewer- oder TeamViewer- Verbindungen 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 ) und ABACUS Version2009 wird die neue Pervasive-Software mitinstalliert. Beachten Sie bitte die Clientinstallation bzw. Konfiguration auf der Seite 8, Punkt 2.2.1! Pervasive.SQL ODBC Seite I

2 Inhaltsverzeichnis 1 Serverinstallation Path Eintrag Pervasive Control Center Mögliche Fehler PCC.exe Java-Fehler Neue Datenbank für ODBC Zugriff erstellen Sicherheit Clientinstallation Client Installation Batchfile ausführen oder Path-Eingabe (sh ) auf dem Client Path-Eingabe auf dem Client Path-Eingabe auf dem Client ab ABACUS Version ODBC Quelle definieren...11 Pervasive.SQL ODBC Seite II

3 Serverinstallation 1 1 Serverinstallation WICHTIG Alle untenstehenden Schritte müssen direkt auf dem Server (keine Terminalserver- oder RDP- Verbindungen, auch keine NetViewer- oder TeamViewer- Verbindungen 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

4 Serverinstallation 1 Bild 2: Pervasive Control Center Mögliche Fehler Falls untenstehende Fehlermeldung beim starten des Pervasive Control Center (pcc.exe) auftritt, muss die aktuellste Java Runtime installiert werden ( Bild 3: Fehlermeldung Pervasive.SQL ODBC Seite 2

5 Serverinstallation 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

6 Serverinstallation 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

7 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

8 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

9 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

10 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 / ). 2.2 Batchfile ausführen oder Path-Eingabe (sh ) 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

11 Clientinstallation 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 ) und Version2009 wird die neue Pervasive-Software mitinstalliert. Die "odbcinst.bat" wird nicht mehr eingesetzt! 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

12 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

13 Clientinstallation 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

14 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

15 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