12.6.3 SQL Server für manuell installierte JBoss-Software konfigurieren

Damit JBoss eine Verbindung zur SQL Server-Datenbank herstellen kann, in der LiveCycle-Daten gespeichert werden, müssen Sie die folgenden Aufgaben ausführen:

  • Besorgen Sie sich die JDBC-Treiberdateien für SQL Server und kopieren Sie sie in die JBoss-Instanz, in der Sie LiveCycle bereitstellen werden.

  • Erstellen Sie eine SQL Server-Datenquellendatei und stellen Sie sie auf der JBoss-Instanz bereit, auf der LiveCycle bereitgestellt werden soll. Dies kann z. B. „[Anwendungsserver-Stammordner]/server/<Profilname>/deploy“ sein.

  • Verschlüsseln Sie das Kennwort in den Datenquellendateien (adobe-ds.xml und mssql-ds.xml) und in der Datei login-config.xml mit einer der unter http://community.jboss.org/wiki/EncryptingDataSourcePasswords beschriebenen Methoden. Sie können auch die Anweisungen unter http://blogs.adobe.com/livecycle/2009/10/livecycle_-_encrypting_clearte.html verwenden.

12.6.3.1 Konfigurieren der SQL Server-Datenbankverbindung

Die SQL Server-Datenquelle kann erst konfiguriert werden, nachdem die LiveCycle-Datenbank auf SQL Server erstellt wurde. (Siehe Erstellen einer SQL Server-Datenbank.)

12.6.3.2 Den SQL-Datenbanktreiber für JBoss installieren

  1. Rufen Sie den Datenbanktreiber „SQL Server JDBC 3.0“ von der Microsoft-Website ab.

    Hinweis: Verwenden Sie den SQL Server-JDBC-Treiber 3.0 sowohl für Microsoft SQL Server 2005 SP2 als auch für Microsoft SQL Server 2008.
  2. (Windows) Laden Sie die EXE-Datei herunter, führen Sie sie aus und extrahieren Sie die Dateien in einen temporären Ordner (der im restlichen Verlauf dieses Abschnitts als [SQL-Stammordner] bezeichnet wird).

  3. (Linux) Extrahieren Sie die Dateien mit dem Format „*.tar.gz“ in einen temporären Ordner (der im restlichen Verlauf dieses Abschnitts als [SQL-Stammordner]bezeichnet wird).

  4. Kopieren Sie die Datei „sqljdbc.jar“ aus dem Ordner „[SQL-Stammordner]/sqljdbc_3.0/enu“ in den Ordner „[Anwendungsserver-Stammordner]/server/<Profilname>/lib“.

  5. Löschen Sie die Datei „mysql-connector-java-3.1.12-bin.jar“, die sich im Ordner „[Anwendungsserver-Stammordner]/server/<Profilname>/lib“ befindet.

12.6.3.3 Datei „adobe-ds.xml“ bearbeiten

  1. Kopieren Sie die Datei „adobe-ds.xml“ aus dem Ordner „[DVD-Stammordner]/third_party/additional/datasources/lc_sqlserver/deploy “ in den Ordner „[Anwendungsserver-Stammordner]/server/<Profilname>/deploy“.

  2. Öffnen Sie die Datei „adobe-ds.xmll“ in einem Texteditor und ändern Sie das Element <local-tx-datasource > entsprechend Ihren SQL Server-Verbindungseinstellungen:

    <connection-url>jdbc:sqlserver://localhost:1433;DatabaseName=adobe</connection-url> 
    <driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class> 
    <user-name>adobe</user-name> 
    <password>adobe</password>
  3. Ersetzen Sie die folgenden Werte durch die entsprechenden Werte für Ihre Datenbank:

    • localhost: Der Name, die IP-Adresse oder der vollständig angegebene Pfad des Computers, der die Datenbank hostet. Der Standardwert ist localhost.

    • 1433: Der für den Zugriff auf die Datenbank verwendete Anschluss.

    • adobe: Der Name der Datenbank, in der die LiveCycle-Daten gespeichert werden. Sie müssen den Standardwert adobe durch Ihren Datenbanknamen ersetzen.

  4. Ändern Sie das Element <driver-class> wie folgt:

    <driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class>
  5. Suchen Sie in den Zeilen, die auf die <driver-class>-Einstellungen folgen, die Einstellungen user-name und password und ersetzen Sie die Standardwerte durch den Benutzernamen und das Kennwort, mit denen der Anwendungsserver auf Ihre Datenbank zugreift. Ändern Sie die Minimal- und Maximalwerte für die Datenquellenverbindungen:

    • IDP_DS:

      <min-pool-size>1</min-pool-size> 
      <max-pool-size>30</max-pool-size>
    • EDC_DS:

      <min-pool-size>1</min-pool-size> 
      <max-pool-size>20</max-pool-size>
      Hinweis: Erhöhen Sie bei hoher Auslastung Ihres LiveCycle-Servers die Anzahl der maximalen JDBC-Verbindungen, um sicherzustellen, dass alle Aufträge verarbeitet werden. Erhöhen Sie in diesen Fällen <max-pool-size> sowohl für IDP_DS als auch für EDC_DS auf 50 oder höher.
  6. Speichern und schließen Sie die Datei.

12.6.3.4 Datei „mssql-ds.xml“ bearbeiten

  1. Wechseln Sie zum Ordner „[Anwendungsserver-Stammordner]/server/<Profilname>/deploy“ und löschen Sie die Datei „hsqldb-ds.xml“.

  2. Wechseln Sie zum Ordner „[Anwendungsserver-Stammordner]/docs/examples/jca“ und kopieren Sie die Datei „mysql-ds.xml“ in den Ordner „[Anwendungsserver-Stammordner]/server/<Profilname>/deploy“.

  3. Öffnen Sie die Datei „mssql-ds.xml“ in einem Texteditor und ändern Sie das Element <local-tx-datasource> entsprechend Ihren SQL Server-Verbindungseinstellungen (nicht unbedingt in aufeinander folgenden Zeilen):

    <jndi-name>MSSQLDS</jndi-name> 
    <datasource-mapping>MS SQLSERVER2000</datasource-mapping> 
    <connection-url>jdbc:sqlserver://localhost:1433;         DatabaseName=MyDatabase</connection-url> 
    <driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver             </driver-class> 
    <user-name>x</user-name> 
    <password>y</password>
    • Das Element <jndi-name> in DefaultDS

    • Das Element <datasource-mapping> in MS SQLSERVER2000

    • Den Datenbanknamen MyDatabase in den Namen Ihrer Datenbank

    • Das Element <Benutzername>xin Ihren Benutzernamen

    • Das Element <Kennwort>yin Ihr Kennwort

      Hinweis: Das Element <datasource-mapping> muss auf MS SQLSERVER2000 verweisen, auch wenn Sie MS SQL Server 2005 verwenden.
  4. Speichern und schließen Sie die Datei.

12.6.3.5 Die Datei „login-config.xml“ bearbeiten

  1. Öffnen Sie die Datei „[Anwendungsserver-Stammordner]/server/<Profilname>/conf/login-config.xml“ in einem Texteditor und fügen Sie im Element <policy> die folgenden Zeilen hinzu:

    <application-policy name = "MSSQLDbRealm"> 
        <authentication> 
        <login-module code = 
        "org.jboss.resource.security.ConfiguredIdentityLoginModule"                  flag = "required"> 
        <module-option name = "principal">adobe</module-option> 
        <module-option name = "userName">adobe</module-option> 
        <module-option name ="password">adobe</module-option> 
        <module-option name = 
        "managedConnectionFactoryName">jboss.jca:service=LocalTxCM,name= DefaultDS             </module-option> 
        </login-module> 
        </authentication> 
    </application-policy>
  2. Ersetzen Sie die fett gedruckten Werte durch die entsprechenden Werte für Ihre Datenbank.

  3. Speichern und schließen Sie die Datei.

  4. Starten Sie JBoss.

12.6.3.6 Die integrierte Sicherheit unter Windows konfigurieren

  1. Bearbeiten Sie die Dateien „adobe-ds.xml“ and „mssql-ds.xml“ im Ordner „[Anwendungsserver-Stammordner]\server\<Profilname>\deploy“, wobei Sie der Verbindungs-URL wie im folgenden Beispiel gezeigt, den Eintrag integratedSecurity=true hinzufügen:

    <connection-url>jdbc:sqlserver://<serverhost>:<port>; databaseName=<dbname>;integratedSecurity=<true></connection-url>

  2. Fügen Sie die Datei „sqljdbc_auth.dll“ zum Windows-Systempfad (C:\Windows) auf dem Computer hinzu, auf dem JBoss ausgeführt wird. Die Datei „sqljdbc_auth.dll“ wird zusammen mit dem Microsoft SQL JDBC 3.0-Treiber installiert. Der Standardspeicherort ist [SQL-Stammordner]/sqljdbc_3.0/enu/auth/x86 (32-Bit-Betriebssysteme) bzw. [SQL_root]/sqljdbc_3.0/enu/auth/x64 (64-Bit-Betriebssysteme).

  3. Öffnen Sie die Eigenschaften für den Dienst „JBoss für Adobe LiveCycle ES3“ oder den von Ihnen konfigurierten JBoss-Dienst und klicken Sie auf die Registerkarte Anmelden.

  4. Wählen Sie DiesesKonto und geben Sie den Wert für ein gültiges Benutzerkonto ein. Diese Änderung ist nicht erforderlich, wenn Sie JBoss von der Befehlszeile ausführen.

  5. Ändern Sie die Sicherheitseinstellung von SQL Server von „Mixed Mode“ in „Windows Authentication Mode“.