Acrolinx IQ Verbindung mit einer externen Terminologiedatenbank herstellen 2.7
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...8
3 1 Einleitung Über diesen Leitfaden Verwendungszweck In dieser Anleitung 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 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 1.2.128 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 2008 64-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 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 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.<DATENBAN K_FORMAT>.xml (<DATENBANK_FORMAT> steht für den Namen des Datenbankformats.) Jede dieser Konfigurationen enthält Einstellungen, die in bestimmten Elementen (<persistence-unit>) eingeschlossen sind. Konfigurationsdateien enthalten in der Regel die folgenden, terminologiespezifischen Persistence Units: <persistence-unit name= terminology-<datenbank_format>-init"> <persistence-unit name="terminology-<datenbank_format>"> 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 terminologierelevanten Persistence Units: <persistence-unit name= terminology-<datenbank_format>-init"> <persistence-unit name="terminology-<datenbank_format>"> 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 den Einheiten aus der Beispieldatei. Beispiel für eine DB2 Datenbank: a. Öffnen Sie die Datei persistence.db2.xml und kopieren Sie alle Abschnitte, die mit <persistence-unit name="terminology-db2-init "> und <persistence-unit name="terminology-db2"> beginnen. b. Öffnen Sie die Datei persistence.xml und ersetzen Sie alle Abschnitte, die mit <persistence-unit name="terminology-h2-init"> und <persistence-unit name="terminology-h2"> beginnen, mit den im vorigen Schritt kopierten Abschnitten. 6. Suchen Sie in der Datei persistence.xml die ersetzten Persistence Units. Suchen Sie in jeder Persistence Unit die folgenden Zeilen: <!--Adapt to your specific database access data between these two lines:--> <!--****************************************** **************************-->
7 7. Bearbeiten Sie zwischen den kommentierten Zeilen die folgenden drei Elemente vom Typ <property>. <property name="eclipselink.jdbc.user" value= <BENUTZER_NAME> "/> <property name="eclipselink.jdbc.password" value= <DB_PAS SWORT>"/> <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 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. Löschen Sie in der Datei persistence.xml die Persistence Unit termino logy-h2-test. 9. Speichern und schließen Sie die Datei persistence.xml. 10. Öffnen Sie die Datei <INSTALL_VER>/server/bin/coreserver.wrapper. conf und suchen Sie den folgenden Header: # Application parameters 11. Suchen Sie die folgenden Eigenschaften: wrapper.app.parameter.2=-backend_db wrapper.app.parameter.3=h2 12. Ändern Sie den Wert H2 entsprechend dem gewünschten Datenbankformat. Hier sind folgende Werte zulässig: POSTGRES, H2, ORACLE, DB2, MSSQL Beispiel: Ändern Sie die Eigenschaft wie im folgenden Beispiel, um eine Verbindung mit einer Oracle-Datenbank herzustellen: wrapper.app.parameter.3=oracle 13. Speichern und schließen Sie die Datei. 14. 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. 15. 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.
8 Verbinden mit externen Terminologiedatenbanken 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. 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.