Acrolinx IQ. Verbindungen mit externen Terminologiedatenbanken 2.9

Transkript

1 Acrolinx IQ Verbindungen mit externen Terminologiedatenbanken 2.9

2 2 Inhalt Einleitung 3 Über diesen Leitfaden...3 Verbinden mit externen Terminologiedatenbanken 4 Erstellen von Sicherungen vorhandener Terminologiedatenbanken...5 Vorbereiten externer Terminologiedatenbanken...5 Bearbeiten der Konfiguration der Datenbank...6 Wiederherstellen von Sicherungen...7

3 3 1 Einleitung Über diesen Leitfaden Verwendungszweck In diesem Leitfaden wird beschrieben, wie Sie Acrolinx IQ Server mit einer Datenbank verbinden, deren Format nicht automatisch mit Acrolinx IQ Server installiert wird. Zielgruppe Dieser Leitfaden richtet sich an Systemadministratoren und fortgeschrittene Benutzer. Es werden Kenntnisse der verwendeten Betriebssystems, über TCP/IP-Netzwerke, Client/Server-Systeme, die notwendigen Kommunikationsprotokolle sowie XML vorausgesetzt. Außerdem müssen Sie mit den Inhalten des Acrolinx IQ Server Administrationshandbuchs vertraut sein.

4 4 Verbinden mit externen Terminologiedatenbanken 2 Verbinden mit externen Terminologiedatenbanken In der folgenden Tabelle sind die wichtigsten verfügbaren Datenbankformate und Informationen darüber aufgeführt, wie sie von Acrolinx IQ Server für die Speicherung von Terminologiedaten unterstützt werden. Datenbank Apache Derby H2 Terminologieunterstützung? - Ja (Standarddatenbank) Version Die neueste unterstützte Datenbankversion wird mit Acrolinx IQ installiert. Oracle Hinweis: Die RAC-Option wird nicht unterstützt. IBM DB2 Ja Versionen 10g und 11g Hinweis: Die RAC-Option wird nicht unterstützt. Ja Version 9.5 oder höher PostgreSQL Ja Nur Version 8.2, 8.3 und 8.4 MySQL MS SQL Server - Ja SQL Server Bit â So stellen Sie Verbindungen mit externen Terminologiedatenbanken her 1. (Führen Sie diesen Schritt aus, wenn Sie Terme aus einer nativen Acrolinx IQ Terminologiedatenbank migrieren) Erstellen Sie eine Sicherung der vorhandenen Terminologiedatenbank. 2. (Führen Sie diesen Schritt aus, wenn Sie Acrolinx IQ Server auf einem neuen Computer installieren) Installieren Sie Acrolinx IQ Server und die Sprachressourcen entsprechend der standardmäßigen Vorgehensweisen, wie sie im Acrolinx IQ Server Administrationshandbuch beschrieben werden. 3. Bereiten Sie die externe Terminologiedatenbank vor. 4. Bearbeiten Sie die Konfiguration der Datenbank. 5. (Führen Sie diesen Schritt aus, wenn Sie Terme aus einer nativen Acrolinx IQ Terminologiedatenbank migrieren) Stellen Sie die Sicherung der vorhandenen Terminologiedatenbank wieder her.

5 5 Erstellen von Sicherungen vorhandener Terminologiedatenbanken Wenn Sie eine vorhandene Acrolinx IQ Terminologiedatenbank zu einer externen Datenbank migrieren, müssen Sie zuerst eine Sicherung der Datenbank in der vorhandenen Installation von Acrolinx IQ Server anlegen. â So öffnen Sie die Seite für die Sicherungen Klicken Sie im Navigationsmenü auf Terminologie > Import und Export > Sicherungen. â So erstellen Sie eine Sicherung 1. Klicken Sie auf Sicherung erstellen. 2. Klicken Sie mit der rechten Maustaste auf den Downloadlink und wählen Sie Ziel speichern unter. Vorbereiten externer Terminologiedatenbanken â So bereiten Sie externe Terminologiedatenbanken für Acrolinx IQ Server vor 1. Erstellen Sie eine neue, leere Datenbank mit einem beliebigen Namen auf dem Datenbankserver. Es wird empfohlen, die Datenbank mit UTF-8 zu kodieren, da so gewährleistet wird, dass Terme in allen Sprachen gespeichert werden können. Achtung: Wenn Sie eine MS SQL Server-Datenbank verwenden, müssen Sie für die Datenbank eine Kollation verwenden, bei der zwischen Großund Kleinschreibung unterschieden wird. Die standardmäßige Kollation, bei der nicht zwischen Groß- und Kleinschreibung unterschieden wird, kann Probleme mit Acrolinx IQ verursachen. 2. Richten Sie einen Benutzer (Benutzername und Passwort) ein, der vollen Schreibzugriff auf die neue Datenbank hat. Hinweis: Wenn Sie eine Oracle-Datenbank zum Speichern der Berichtsund Terminologiedaten verwenden, müssen Sie sicherstellen, dass der Benutzername für die Terminologiedatenbank sich von dem für die Berichtsdatenbank unterscheidet. In Oracle-Datenbanken werden Benutzernamen mit einem bestimmten Datenbankschema assoziiert.

6 6 Verbinden mit externen Terminologiedatenbanken Bearbeiten der Konfiguration der Datenbank Acrolinx IQ Server wird mit verschiedenen beispielhaften Persistenzkonfigurationen zur Verbindung mit unterschiedlichen Datenbankformaten installiert. Diese werden als XML-Dateien im folgenden Verzeichnis gespeichert: <INSTALL_VER>/server/persistence/META-INF/persistence.<DATENBANK_FORMAT>.xml Jede dieser Konfigurationen enthält Einstellungen, die in Elementen vom Typ <persistence-unit> eingeschlossen sind. Konfigurationsdateien enthalten in der Regel die folgende, terminologiespezifische Persistence Unit: <persistence-unit name="terminology"> Sie können diese Einheiten aus den Beispieldateien kopieren und die entsprechenden Einheiten in der Persistenzkonfigurationsdatei damit ersetzen. â So konfigurieren Sie den Acrolinx IQ Terminologiemanager für die Verbindung mit eigenen Datenbanken 1. Stoppen Sie den Hauptserver. 2. Öffnen Sie das Verzeichnis <INSTALL_VER>/server/persistence/META-INF/ 3. Öffnen Sie die Datei persistence.xml und suchen Sie die terminologierelevante Persistence Unit: <persistence-unit name="terminology"> 4. Öffnen Sie die beispielhafte Konfigurationsdatei, die dem gewünschten Datenbankformat entspricht. Beispiel: Öffnen Sie die Datei persistence.db2.xml, wenn Sie eine DB2-Datenbank verwenden. 5. Ersetzen Sie in der Datei persistence.xml die entsprechenden Persistence Units mit denen aus der Beispieldatei. Beispiel für eine DB2-Datenbank: a. Öffnen Sie die Datei persistence.db2.xml und kopieren Sie den Abschnitt, der mit <persistence-unit name="terminology"> beginnt. b. Öffnen Sie die Datei persistence.xml und ersetzen Sie den Abschnitt, der mit <persistence-unit name="terminology"> beginnt, mit dem im vorigen Schritt kopierten Abschnitt. 6. Suchen Sie in der Datei persistence.xml die ersetzte Persistence Unit. Suchen Sie in der Persistence Unit die folgenden Zeilen: <!--Adapt to your specific database access data between these two lines:--> <!--********************************************************************--> 7. Bearbeiten Sie zwischen den kommentierten Zeilen die folgenden drei Elemente vom Typ <property>.

7 7 <property name="eclipselink.jdbc.user" value= <BENUTZER_NAME>"/> <property name="eclipselink.jdbc.password" value= <DB_PASSWORT>"/> <property name="eclipselink.jdbc.url" value="<jdbc_url>"/> Bearbeiten Sie die Platzhalter: Ersetzen Sie <BENUTZER_NAME> mit dem Benutzernamen, den Sie im Abschnitt Vorbereiten externer Terminologiedatenbanken erstellt haben. Ersetzen Sie <DB_PASSWORT> mit dem Passwort, das Sie im Abschnitt Vorbereiten externer Terminologiedatenbanken erstellt haben. Bearbeiten Sie <JDBC_URL> so, dass es dem Verzeichnis der Datenbank entspricht. Nicht vergessen!: Die Syntax des Parameters <JDBC_URL> hängt dabei vom verwendeten Datenbankformat ab. Für ein besseres Verständnis der Syntax ist in allen beispielhaften Konfigurationsdateien ein Beispielwert für den Parameter <JDBC_URL> enthalten. Der Parameter setzt sich in der Regel aus der IP-Adresse, der Portnummer und dem Namen der Datenbank zusammen. 8. Speichern und schließen Sie die Datei persistence.xml. 9. Starten Sie den Dienst oder Prozess des Hauptservers neu. Damit die Änderungen korrekt geladen werden, müssen Sie den Dienst oder Prozess direkt über das Betriebssystem und nicht vom Dashboard aus neu starten. 10. Prüfen Sie die Hauptserver-Protokolldateien auf Fehlermeldungen. Fehler in der Datei coreserver.log werden erwartet, wenn die externe Datenbank noch keine Tabellen enthält. Wenn eine leere Datenbank erkannt wird, wird eine Fehlermeldung aufgezeichnet, weil kein Schema existiert, und die Tabellen werden automatisch erstellt. Wenden Sie sich an den Acrolinx Support, wenn Sie sich nicht sicher sind, welche Fehler das Ergebnis dieses erwarteten Verhaltens sind. Wiederherstellen von Sicherungen Wenn Sie Acrolinx IQ für die Verbindung mit anderen Datenbanken für die Speicherung von Terminologie konfigurieren und die bereits vorhandenen Terminologiedaten weiterhin verwenden möchten, müssen Sie die Sicherung der Terminologiedatenbank wiederherstellen. â So öffnen Sie die Seite für die Sicherungen Klicken Sie im Navigationsmenü auf Terminologie > Import und Export > Sicherungen. â So stellen Sie eine Sicherung wieder her 1. Klicken Sie auf Durchsuchen und wählen Sie die Sicherung aus. 2. Klicken Sie auf Sicherung importieren. 3. Geben Sie im Sicherheitsdialog das Wort ja ein und klicken Sie auf OK.

8 8 Verbinden mit externen Terminologiedatenbanken Tipp: Diese Sicherheitsabfrage ist eine zusätzliche Vorsichtsmaßnahme, die verhindert, dass die Terminologiedatenbank versehentlich überschrieben wird. Nach Abschluss des Importvorgangs wird eine Bestätigungsmeldung angezeigt. 4. Starten Sie alle Server neu (weitere Informationen finden Sie im Acrolinx IQ Server Administrationshandbuch). Wichtig: Die Konfigurationen der installierten Sprachserver müssen neu geladen werden, damit die Termhilfedateien korrekt geladen werden.