5.4.3 SQL Server für die von Adobe vorkonfigurierte JBoss-Software konfigurieren

Damit JBoss mit der SQL Server-Datenbank, in der LiveCycle-Daten gespeichert werden, eine Verbindung herstellen kann, müssen Sie eine SQL Server-Datenquelldatei erstellen und diese auf der JBoss-Instanz bereitstellen, auf der Sie LiveCycle bereitstellen (beispielsweise „[Anwendungsserver-Stammordner]/server/lc_sqlserver/deploy“).

Hinweis: 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.

5.4.3.1 Datei „adobe-ds.xml“ bearbeiten

  1. Öffnen Sie die Datei „[Anwendungsserver-Stammordner]/server/lc_sqlserver/deploy/adobe-ds.xml“ in einem Texteditor und suchen Sie die folgende Zeile:

    <connection-url>jdbc:sqlserver://localhost:1433;DatabaseName=adobe</connection-url> 
    <driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class> 
    <security-domain>MSSQLDbRealm</security-domain>
  2. Ersetzen Sie Folgendes in der oberen Zeile durch die für Ihre Datenbank spezifischen Werte:

    • localhost: Der Name, die IP-Adresse oder der vollständig angegebene Pfad des Computers, der als Host für die Datenbank dient. Der Standardwert ist localhost.

    • 1433: Der Anschluss, der für den Zugriff auf die Datenbank verwendet wird. Der Standardanschluss ist 1433.

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

  3. Suchen Sie in den Zeilen, die auf die Einstellungen für <connection-url> folgen, die Einstellungen für user-name und password und ersetzen Sie die Standardwerte durch den Benutzernamen und das Kennwort, mit denen der Anwendungsserver auf Ihre Datenbank zugreift.

  4. Stellen Sie sicher, dass die Minimal- und Maximalwerte für die Datenquellenverbindungen wie folgt festgelegt sind:

    • Für IDP_DS:

      <min-pool-size>1</min-pool-size> 
      <max-pool-size>30</max-pool-size>
    • Für 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.
  5. Speichern und schließen Sie die Datei.

5.4.3.2 Datei „mssql-ds.xml“ bearbeiten

Wenn Sie LiveCycle mit einer MS SQL Server-Datenbank ausführen, müssen Sie SQL Server als Standarddatenquelle für JBoss festlegen. Dieses Verfahren setzt voraus, dass der JDBC-Treiber für SQL Server im Ordner „[Anwendungsserver-Stammordner]/server/lc_sqlserver/lib“ installiert ist.

  1. Öffnen Sie die Datei „[Anwendungsserver-Stammordner]/server/lc_sqlserver/deploy/mssql-ds.xml“ in einem Texteditor und ändern Sie das Element <local-tx-datasource> entsprechend Ihren SQL Server-Verbindungseinstellungen:

    <jndi-name>DefaultDS</jndi-name> 
    <connection-url>jdbc:sqlserver://localhost:1433;DatabaseName=adobe</connection-url> 
    <driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class> 
    <security-domain>MSSQLDbRealm</security-domain>
  2. Ersetzen Sie den fett gedruckten Text in den vorangehenden Zeilen durch die für Ihre Datenbank spezifischen Werte:

    localhost: Ersetzen Sie diesen Wert durch den Hostnamen Ihres SQL Server.

    1433: Wenn SQL Server nicht den Standardanschluss verwendet, ersetzen Sie diesen Wert durch die entsprechende Anschlussnummer.

    adobe: Ersetzen Sie diesen Wert durch den Namen Ihrer SQL Server-Datenbank.

  3. Suchen Sie in den Zeilen, die auf die Einstellungen für <connection-url> folgen, die Einstellungen für user-name und password und ersetzen Sie die Standardwerte durch den Benutzernamen und das Kennwort, mit denen der Anwendungsserver auf Ihre Datenbank zugreift.

    Hinweis: Der JDBC-Treiber für SQL Server analysiert keine numerischen IPv6-Adressen. Verwenden Sie den SQL Server in einer IPv6-Umgebung, muss der Servername im folgenden Format angegeben werden:
    <connection-url>jdbc:sqlserver://;serverName=<IPv6 address>; portNumber=<port>;databaseName=<db_name></connection-url>
    Hinweis: Wenn Sie die IPv6-Adresse des Servers in diesem Format angeben, müssen Sie beachten, dass die Zeichenfolge ;serverName ein Schlüsselwort ist und nicht durch den tatsächlichen Servernamen ersetzt werden darf.
  4. Speichern und schließen Sie die Datei.

5.4.3.3 Datei „login-config.xml“ bearbeiten

  1. Öffnen Sie die Datei „[Anwendungsserver-Stammordner]/server/lc_sqlserver/conf/login-config.xml“ in einem Texteditor und ändern Sie den folgenden Code im Element <policy>:

    <application-policy name="MSSQLDbRealm"> 
        <authentication> 
            <login-module 
            code="org.jboss.resource.security.SecureIdentityLoginModule" 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 den fett gedruckten Text durch die entsprechenden Werte für Ihre Datenbank, damit der Anwendungsserver auf Ihre Datenbank zugreifen kann.

  3. Speichern und schließen Sie die Datei.

  4. Starten Sie JBoss.

5.4.3.4 Windows-Anmeldung dem LiveCycle-Datenbankbenutzer zuordnen

  1. Stellen Sie in Microsoft SQL Server Management Studio eine Verbindung mit dem Datenbankserver her, auf dem sich die LiveCycle-Datenbank befindet.

  2. Legen Sie den Authentifizierungsmodus auf Windows-Authentifizierung fest.

  3. Erstellen Sie unter Sicherheit > Anmeldungen ein neues Konto für den Windows-Domänenbenutzer und wählen Sie Windows-Authentifizierung.

  4. Klicken Sie im Bildschirm „Anmeldung – Neu“ auf Benutzerzuordnung und legen Sie die Datenbank und das Standardschema für den neuen Benutzer fest.

  5. Wählen Sie db_owner als Datenbankrolle aus und klicken Sie auf OK.

Um zu prüfen, ob der Benutzer erstellt wurde, erweitern Sie die LiveCycle-Datenbank in der Struktur und öffnen Sicherheit > Benutzer. Der neue Benutzer wird in der Liste der Benutzer angezeigt.

5.4.3.5 SQL Server-Datenbanktreiber installieren

Hinweis: Sofern Sie dies noch nicht getan haben, laden Sie den SQL Server JDBC-Treiber 3.0 (für alle Plattformen) vom Microsoft Download Center herunter oder kopieren Sie den Treiber aus dem Ordner „[DVD-Stammordner]/third_party/“ in den Ordner „[Anwendungsserver-Stammordner]/server/<Profilname>/lib“.

Wenn Sie über Microsoft Download Center installieren, folgen Sie den Anweisungen auf der Website zum Herunterladen und Installieren des Treibers. Notieren Sie sich den Ordner, in den Sie den Treiber auf Ihrem System installieren.

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.

5.4.3.6 Integrierte Sicherheit unter Windows konfigurieren

Hinweis: Sie müssen den JBoss-Dienst als wie im Abschnitt 5.4.3.4 Windows-Anmeldung dem LiveCycle-Datenbankbenutzer zuordnen konfigurierter Windows-Benutzer ausführen. Wenn JBoss nicht als Dienst ausgeführt wird, müssen Sie sich als dieser bestimmte Benutzer bei Windows anmelden, bevor Sie JBoss an einer Eingabeaufforderung starten.
  1. Bearbeiten Sie die Dateien „adobe-ds.xml“ und „mssql-ds.xml“ im Ordner „[Anwendungsserver-Stammordner]\server\lc_sqlserver\deploy“, wobei Sie der Verbindungs-URL wie im folgenden Beispiel gezeigt, den Eintrag integratedSecurity=true hinzufügen:

    jdbc:sqlserver://<Hostname>:<Anschluss>;databaseName=<Datenbankname>;integratedSecurity=true.

  2. Ersetzen Sie die fett gedruckten Werte im Beispiel oben durch für Ihre Datenbank geeignete Werte.

  3. 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“ liegt bei der Microsoft SQL JDBC 3.0-Treiberinstallation, die sich standardmäßig bei 32-Bit-Betriebssystemen unter [SQL-Stammordner]/sqljdbc_3.0/enu/auth/x86 und bei 64-Bit-Betriebssystemen unter [SQL-Stammordner]/sqljdbc_3.0/enu/auth/x64 befindet.

    Hinweis: Verwenden Sie den SQL Server-JDBC-Treiber 3.0 für Microsoft SQL Server 2008.
  4. Öffnen Sie die Eigenschaften für den Dienst „JBoss für Adobe LiveCycle ES4“ oder den von Ihnen konfigurierten JBoss-Dienst und klicken Sie auf die Registerkarte Anmelden.

  5. Wählen Sie DiesesKonto aus und geben Sie den Wert des Benutzerkontos ein, das Sie, wie im Abschnitt 5.4.3.4 Windows-Anmeldung dem LiveCycle-Datenbankbenutzer zuordnen beschrieben, zugeordnet haben. Führen Sie JBoss über die Befehlszeile aus, müssen Sie als dieser Benutzer angemeldet sein.