5.18 Connectors für ECM konfigurieren

1. (JBoss 4.2.1) Öffnen Sie die Anwendungsserver-run-Datei „[JBoss-Stammordner]/bin/run.bat“ in einem Texteditor.

   (JBoss 5.1) Öffnen Sie die Anwendungsserver-run-Datei „[JBoss-Stammordner]/bin/run.conf.bat“ in einem Texteditor.

2. Fügen Sie den Speicherort der FileNet-Konfigurationsdateien als Java-Option dem Startbefehl des Anwendungsservers hinzu und speichern Sie die Datei.

   Hinweis: Wenn JBoss als Dienst ausgeführt wird, fügen Sie die Java-Option in der Registrierung an der Stelle hinzu, wo andere JVM-Argumente definiert sind.

3. -Dwasp.location= <configuration files location>

   Fügen Sie beispielsweise bei Verwendung einer Standardinstallation des FileNet-Anwendungsmoduls unter einem Windows-Betriebssystem folgende Java-Option hinzu:

   -Dwasp.location=C:/Progra~1/FileNet/AE/CE_API/wsi

4. Wenn Ihre Bereitstellung den Prozess-Engine-Connector-Dienst verwendet, kopieren Sie die Datei „[JBoss-Stammordner]\client\logkit.jar“ in den folgenden Ordner:

   • [JBoss-Stammordner]/server/lc_turnkey/lib

5. Suchen Sie die Datei „adobe-component-ext.properties“ im Ordner „[JBoss-Stammordner]/bin“. (Wenn die Datei nicht vorhanden ist, erstellen Sie sie.)

6. Fügen Sie eine neue Systemeigenschaft hinzu, die den Speicherort dieser JAR-Dateien des FileNet-Anwendungsmoduls angibt:

   Fügen Sie für FileNet 4.x die folgenden JAR-Dateien hinzu.

   • javaapi.jar

   • soap.jar

   • wasp.jar

   • builtin_serialization.jar (nur FileNet 4.0)

   • wsdl_api.jar

   • jaxm.jar

   • jaxrpc.jar

   • saaj.jar

   • jetty.jar

   • runner.jar

   • p8cjares.jar

   • Jace.jar

   • (Optional) pe.jar

   Fügen Sie für FileNet 5.0 die folgenden JAR-Dateien hinzu.

   • Jace.jar

   • javaapi.jar

   • log4j.jar

   • mailapi.jar

   • pe.jar

   • stax-api.jar

   • xlxpScanner.jar

   • xlxpScannerUtils.jar

   • xml.jar

   Hinweis: Fügen Sie die Datei „pe.jar“ nur hinzu, wenn Ihre Bereitstellung den IBMFileNetProcessEngineConnector-Dienst verwendet. Die neue Systemeigenschaft sollte diese Struktur aufweisen:

   [component id].ext=[JAR files and/or folders]

   Hinweis: Überschreiben Sie nicht den vorhandenen Inhalt der Eigenschaftendatei. Fügen Sie die neue Systemeigenschaft einfach dem Inhalt hinzu.

   Beispielsweise kann ausgehend von der Standardinstallation des FileNet-Anwendungsmoduls unter einem Windows-Betriebssystem der Datei die folgende Systemeigenschaft in einer neuen Zeile hinzugefügt werden (wobei keine Zeilenumbrüche verwendet werden dürfen und die Zeile mit einem Wagenrücklauf abgeschlossen werden muss):

   Hinweis: Der folgende Text enthält Formatierungszeichen für Zeilenwechsel. Wenn dieser Text an eine Stelle außerhalb dieses Dokuments kopiert wird, entfernen Sie die Formatierungszeichen, wenn der Text an der neuen Stelle eingefügt werden.
   Hinweis: Fügen Sie für FileNet 4.x die folgenden Dateien hinzu.

   com.adobe.livecycle.ConnectorforIBMFileNet.ext= 
   C:/Program Files/FileNet/AE/CE_API/lib2/javaapi.jar, 
   C:/Program Files/FileNet/AE/Workplace/WEB-INF/lib/soap.jar, 
   C:/Program Files/FileNet/AE/CE_API/wsi/lib/wasp.jar, 
   C:/Program Files/FileNet/AE/CE_API/wsi/lib/builtin_serialization.jar, 
   C:/Program Files/FileNet/AE/CE_API/wsi/lib/wsdl_api.jar, 
   C:/Program Files/FileNet/AE/CE_API/wsi/lib/jaxm.jar, 
   C:/Program Files/FileNet/AE/CE_API/wsi/lib/jaxrpc.jar, 
   C:/Program Files/FileNet/AE/CE_API/wsi/lib/saaj.jar, 
   C:/Program Files/FileNet/AE/CE_API/wsi/lib/jetty.jar, 
   C:/Program Files/FileNet/AE/CE_API/wsi/lib/runner.jar, 
   C:/Program Files/FileNet/AE/CE_API/lib2/p8cjares.jar, 
   C:/Program Files/FileNet/AE/CE_API/lib/Jace.jar, 
   C:/Program Files/FileNet/AE/Workplace/WEB-INF/lib/pe.jar

   Hinweis: Fügen Sie C:/Programme/FileNet/AE/Workplace/WEB-INF/lib/pe.jar nur hinzu, wenn Ihre Bereitstellung den IBMFileNetProcessEngineConnector-Dienst verwendet.
   Hinweis: Entfernen Sie bei FileNet 4.5 die Zeile C:/Programme/FileNet/AE/CE_API/wsi/lib/builtin_serialization.jar,
   Hinweis: Fügen Sie für FileNet 5.0 die folgenden JAR-Dateien hinzu.

   C:/Program Files/FileNet/AE/CE_API/lib/Jace.jar, 
   C:/Program Files/FileNet/AE/CE_API/lib2/javaapi.jar, 
   C:/Program Files/FileNet/AE/CE_API/lib2/log4j.jar, 
   C:/Program Files/FileNet/AE/Router/lib/mailapi.jar, 
   C:/Program Files/FileNet/AE/Workplace/WEB-INF/lib/pe.jar, 
   C:/Program Files/FileNet/AE/CE_API/lib/stax-api.jar, 
   C:/Program Files/FileNet/AE/CE_API/lib/xlxpScanner.jar, 
   C:/Program Files/FileNet/AE/CE_API/lib/xlxpScannerUtils.jar, 
   C:/Program Files/FileNet/AE/Router/java/jre/lib/xml.jar

7. (Nur für FileNet-Prozess-Engine-Connector) Konfigurieren Sie die Verbindungseigenschaften für die Prozess-Engine wie folgt:

   • Erstellen Sie mithilfe eines Texteditors eine Datei mit folgendem Inhalt in einer einzigen Zeile, die mit einem Wagenrücklauf abgeschlossen werden muss:

     RemoteServerUrl = cemp:http://[contentserver_IP]:[contentengine_port]/ 
     wsi/FNCEWS40DIME/

   • Speichern Sie die Datei in einem gesonderten Ordner unter dem Namen „WcmApiConfig.properties“ und fügen Sie den Speicherort des Ordners mit der Datei „WcmApiConfig.properties“ der Datei „adobe-component-ext.properties“ hinzu.

     Wenn Sie beispielsweise die Datei als „c:/pe_config/WcmApiConfig.properties“ speichern, fügen Sie in der Datei „adobe-component-ext.properties“ den Pfad „c:/pe_config“ hinzu.

   Hinweis: Beim Dateinamen muss die Groß-/Kleinschreibung beachtet werden.

8. Suchen Sie die Datei „login-config.xml“ im folgenden Ordner und fügen Sie die folgende Anwendungsrichtlinie als untergeordnetes Element des Knotens „<policy>“ hinzu:

   • [JBoss-Stammordner]/server/lc_turnkey/conf

   <application-policy name = "FileNetP8WSI"> 
        <authentication>  
        <login-module code = "com.filenet.api.util.WSILoginModule" flag = 
       "required" /> 
        </authentication>  
   </application-policy>

9. (Nur FileNet-Prozess-Engine-Connector) Wenn Ihre Bereitstellung die Prozess-Engine verwendet, fügen Sie den folgenden Knoten der Datei „login-config“ hinzu:

   <application-policy name = "FileNetP8"> 
       <authentication> 
           <login-module code = "com.filenet.api.util.WSILoginModule" flag = 
           "required" /> 
       </authentication> 
   </application-policy>

10. Wenn der Anwendungsserver aktuell nicht ausgeführt wird, starten Sie den Dienst. Beenden Sie andernfalls den Server und starten Sie ihn neu.

11. Wenn JBoss als Dienst ausgeführt wird, starten Sie den JBoss for Adobe LiveCycle ES3-Dienst bzw. starten Sie ihn neu.

12. Öffnen Sie einen Webbrowser und geben Sie diese URL ein:

    http://[Host]:[Anschluss]/adminui

13. Melden Sie sich mit dem standardmäßigen Benutzernamen und Kennwort an:

    Benutzername: administrator

    Kennwort: password

14. Klicken Sie auf Dienste > Connector für IBM FileNet.

15. Geben Sie alle erforderlichen FileNet-Repository-Informationen ein und wählen Sie unter „Repository Service Provider-Informationen“ den Eintrag IBM FileNet Repository Provider aus.

    Wenn Ihre Bereitstellung den optionalen Prozess-Engine-Dienst verwendet, aktivieren Sie unter „Prozess-Engine-Einstellungen“ die Option Prozess-Engine-Connectordienst verwenden und geben Sie die Prozess-Engine-Einstellungen an. Weitere Informationen erhalten Sie, wenn Sie rechts oben auf der Seite auf den Link Hilfe klicken.

    Hinweis: Die in diesem Schritt angegebenen Anmeldeinformationen werden später überprüft, wenn die IBM FileNet-Repository-Dienste gestartet werden. Wenn sie ungültig sind, wird ein Fehler erzeugt und die Dienste werden nicht gestartet.

16. Klicken Sie auf Speichern und wechseln Sie zu Dienste > Anwendungen und Dienste > Dienstverwaltung.

17. Aktivieren Sie das Kontrollkästchen neben IBMFileNetProcessEngineConnector (sofern konfiguriert) und klicken Sie auf Starten.

18. Aktivieren Sie die Kontrollkästchen neben diesen Diensten und klicken Sie auf Starten:

    • IBMFileNetAuthProviderService

    • IBMFileNetContentRepositoryConnector

    • IBMFileNetRepositoryProvider

    • IBMFileNetProcessEngineConnector (falls konfiguriert)

    Wenn einer der Dienste nicht ordnungsgemäß gestartet wird, überprüfen Sie die in Schritt 15 eingegebenen Einstellungen.

19. Führen Sie eine der folgenden Aufgaben aus:

    • Um mithilfe des FileNet Authorization-Dienstes (IBMFileNetAuthProviderService) Inhalte eines FileNet-Objektspeichers in der Ansicht „Resources“ von Workbench anzuzeigen, fahren Sie mit diesem Vorgang fort. Beim Verwenden des FileNet-Autorisierungsdienstes wird die standardmäßige LiveCycle-Autorisierung außer Kraft gesetzt. In diesem Fall ist eine Konfiguration für die Anmeldung bei Workbench unter Verwendung von FileNet-Anmeldedaten erforderlich.

    • Melden Sie sich zur Verwendung des LiveCycle-Repositorys bei Workbench an, wobei Sie die Anmeldeinformationen des LiveCycle-Superadministrators verwenden (standardmäßig Administrator und password). Die in Schritt 15 angegebenen Anmeldeinformationen verwenden in diesem Fall den standardmäßigen LiveCycle-Autorisierungsdienst für den Zugriff auf das Standardrepository.

20. Aktivieren Sie die Remoting- und EJB-Endpunkte, indem Sie diese Aufgaben ausführen:

    • Melden Sie sich bei Administration Console an und klicken Sie auf Startseite > Dienste > Anwendungen und Dienste > Dienstverwaltung.

    • Filtern Sie die Kategorie Connector für IBM FileNet und klicken Sie auf IBMFileNetContentRepositoryConnector:1.0.

    • Wählen Sie die deaktivierten Endpunkte aus und aktivieren Sie sie.

21. Starten Sie den Anwendungsserver neu.

22. Melden Sie sich bei Administration Console an und wechseln Sie zu Einstellungen > User Management > Domänenverwaltung.

23. Klicken Sie auf Neue Unternehmensdomäne und geben Sie eine ID und einen Namen für die Domäne ein. Die Domänen-ID ist der eindeutige Bezeichner der Domäne. Der Name ist eine beschreibende Bezeichnung der Domäne.

    Hinweis: Verwenden Sie, wenn Sie MySQL für Ihre LiveCycle-Datenbank einsetzen, nur Einzelbyte-Zeichen (ASCII) für die ID. (Siehe „Hinzufügen von Unternehmensdomänen“ in der LiveCycle Administration-Hilfe.)

24. Fügen Sie einen benutzerdefinierten Authentifizierungsanbieter hinzu:

    • Klicken Sie auf Authentifizierung hinzufügen.

    • Wählen Sie in der Liste Authentifizierungsanbieter den Eintrag Benutzerdefiniert.

    • Wählen Sie IBMFileNetAuthProviderService und klicken Sie auf OK.

25. Fügen Sie einen LDAP-Authentifizierungsanbieter hinzu:

    • Klicken Sie auf Authentifizierung hinzufügen.

    • Wählen Sie in der Liste Authentifizierungsanbieter den Eintrag LDAP und klicken Sie auf OK.

26. Fügen Sie einen LDAP-Ordner hinzu:

    • Klicken Sie auf Verzeichnis hinzufügen, geben Sie im Feld Profilname einen eindeutigen Namen ein und klicken Sie auf Weiter.

    • Geben Sie Werte für die Optionen Server, Anschluss, SSL, Bindung, und Seite mit folgenden Elementen füllen an. Wenn Sie Benutzer für die Option Bindung auswählen, müssen Sie auch Werte für die Felder Name und Kennwort eingeben.

    • (Optional) Wählen Sie Basis-DNs abrufen, um erforderlichenfalls Domänennamen abzurufen. Klicken Sie auf Weiter, wenn Sie diesen Schritt abgeschlossen haben.

    • Konfigurieren Sie die Benutzereinstellungen, klicken Sie auf Weiter, konfigurieren Sie gegebenenfalls Gruppeneinstellungen und klicken Sie auf Weiter.

      Detailinformationen zu den Einstellungen erhalten Sie, wenn Sie rechts oben auf der Seite auf den Hilfe-Link klicken.

27. Klicken Sie auf OK, um die Seite „Verzeichnis hinzufügen“ zu verlassen, und klicken Sie zum Beenden erneut auf OK.

28. Wählen Sie die neue Unternehmensdomäne aus und klicken Sie auf Jetzt synchronisieren. Der Synchronisierungsvorgang kann – je nach der Anzahl der Benutzer und Gruppen im LDAP-Netzwerk und der Verbindungsgeschwindigkeit – einige Minuten in Anspruch nehmen.

    (Optional) Klicken Sie zum Überprüfen des Synchronisierungsstatus auf Aktualisieren. Der Status wird in der Spalte Aktueller Synchronisierungsstatus angezeigt.

29. Wechseln Sie zu Einstellungen > User Management > Benutzer und Gruppen.

30. Suchen Sie nach Benutzern, die aus LDAP synchronisiert wurden, und führen Sie die folgenden Aufgaben durch:

    • Wählen Sie mindestens einen Benutzer aus und klicken Sie auf Rolle zuweisen.

    • Wählen Sie mindestens eine LiveCycle-Rolle aus und klicken Sie auf OK.

    • Klicken Sie ein weiteres Mal auf OK, um die Rollenzuweisung zu bestätigen.

    Wiederholen Sie diesen Schritt für alle Benutzer, denen Sie Rollen zuweisen möchten. Weitere Informationen erhalten Sie, wenn Sie rechts oben auf der Seite auf den Link Hilfe klicken.

31. Starten Sie Workbench und melden Sie sich mit den folgenden Anmeldeinformationen für das IBM FileNet-Repository an:

    Benutzername:[Benutzername]@[Repository-Name]

    Kennwort: [Kennwort]

    Der FileNet-Objektspeicher sollte jetzt in der Ansicht „Resources“ in Workbench angezeigt werden. Wenn Sie sich nicht unter Verwendung von Benutzername @Repository-Name anmelden, versucht Workbench eine Anmeldung bei dem in Schritt 15 angegebenen Standardrepository.

32. (Optional) Wenn Sie die LiveCycle-Beispiele für den Connector für IBM FileNet installieren möchten, erstellen Sie einen FileNet-Objektspeicher namens Samples und installieren Sie dann die Beispiele in diesen Objektspeicher.

Wir empfehlen, nach der Konfiguration des Connector für IBM FileNet-Diensts die LiveCycle Administration-Hilfe heranzuziehen. Informationen zur ordnungsgemäßen Konfiguration der Workbench-Funktionen für das FileNet-Repository.