8.13 Connector for IBM FileNet konfigurieren

LiveCycle unterstützt nur die Versionen 4.0, 4.5 und 5.0 von IBM FileNet. Vergewissern Sie sich, dass ECM entsprechend aktualisiert wurde.

Wenn Connector für IBM FileNet-Dienst als Teil von LiveCycle installiert wurde, müssen Sie den Dienst für das Herstellen einer Verbindung mit dem FileNet-Objektspeicher konfigurieren.

Hinweis: Achten Sie darauf, dass der Client für die Connectors installiert wird und Kopieren der JAR-Datei und Konfigurationsänderungen auf allen Knoten des Clusters durchgeführt werden.

Wählen Sie eines der folgenden Verfahren zum Konfigurieren von„Connector für IBM FileNet“:

  • Konfigurieren von Connector für IBM FileNet mit FileNet 4.x und CEWS-Transport

  • Konfigurieren von Connector für IBM FileNet mit FileNet 4.x und EJB-Transport

Connector für IBM FileNet mit FileNet 4.x oder FileNet 5.0.x und CEWS-Transport konfigurieren

  1. Suchen Sie die Datei „[Anwendungsserverdomäne]/config/config.xml“ und erstellen Sie eine Sicherungskopie.

  2. Klicken Sie in WebLogic Server Administration Console unter „Domain Structure“ auf Environment > Servers und klicken Sie dann im rechten Bereich auf den Namen Ihres Servers.

  3. Klicken Sie auf die Registerkarte Configuration und dann auf Server Start.

  4. Klicken Sie unter „Change Center“ auf Lock & Edit.

  5. (Nur für FileNet 4.x) Geben Sie in das Feld „Arguments“ folgenden Text ein und klicken Sie anschließend auf „Save“.

    -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
  6. Suchen Sie die Datei „adobe-component-ext.properties“ im Ordner [Anwendungsserverdomäne]. (Wenn die Datei nicht vorhanden ist, erstellen Sie sie.)

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

    • log4j-1.2.13.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

    • pe.jar

    • stax-api.jar

    • xlxpScanner.jar

    • xlxpScannerUtils.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]

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

    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.
    com.adobe.livecycle.ConnectorforIBMFileNet.ext= 
    C:/Program Files/FileNet/AE/CE_API/lib2/javaapi.jar, 
    C:/Program Files/FileNet/AE/CE_API/lib2/log4j-1.2.13.jar
  8. (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 „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 den Pfad „c:/pe_config“ in der Datei „adobe-component-ext.properties“ hinzu.

      Hinweis: Beim Dateinamen muss die Groß-/Kleinschreibung beachtet werden.
  9. Wenn eine benutzerdefinierte JAAS-Konfigurationsdatei verwendet wird, fügen Sie dieser Datei die folgenden Zeilen hinzu:

            FileNetP8 {weblogic.security.auth.login.UsernamePasswordLoginModule 
                required authOnLogin=true;}; 
            FileNetP8WSI {com.filenet.api.util.WSILoginModule required;}; 
            FileNetP8Engine 
                {weblogic.security.auth.login.UsernamePasswordLoginModule required 
                authOnLogin=true;}; 
            FileNetP8Server 
                {weblogic.security.auth.login.UsernamePasswordLoginModule required 
                authOnLogin=true;}; 
    Sie können anhand des Wertes der Eigenschaft -Djava.security.auth.login.config im Anwendungsserver-Startbefehl ermitteln, ob eine benutzerdefinierte JAAS-Konfigurationsdatei verwendet wird.
  10. (Nur FileNet-Prozess-Engine-Connector) Wenn Ihre Bereitstellung den FileNet-Prozess-Engine-Connector verwendet, führen Sie je nach Ihrer Konfiguration eine der folgenden Aktionen aus:

    • Wenn Ihre Bereitstellung eine benutzerdefinierte JAAS-Datei verwendet, fügen Sie dieser Datei folgende Zeile hinzu:

      FileNetP8 {com.filenet.api.util.WSILoginModule required;};
    • Wenn Ihre Bereitstellung keine benutzerdefinierte JAAS-Datei verwendet, verwenden Sie einen Texteditor, um eine Datei mit folgendem Inhalt zu erstellen:

      FileNetP8 {com.filenet.api.util.WSILoginModule required;};

      Speichern Sie die Datei unter dem Namen „jaas.conf.WSI“ und fügen Sie den Speicherort der Datei als folgende Java-Option dem WebLogic Server-Startbefehl hinzu:

      -Djava.security.auth.login.config=<JAAS file location>

      Wenn Sie beispielsweise die Datei als „C:/pe_config/jaas.conf.WSI“ speichern, fügen Sie die folgende Java-Option hinzu:

      -Djava.security.auth.login.config=C:/pe_config/jaas.conf.WSI
  11. Öffnen Sie die Datei „config.xml“ und suchen Sie den Wert „<credential-encrypted>“ für die Benutzerdomäne des verwalteten Servers. Wenn kein Wert für dieses Element vorhanden ist, öffnen Sie die Sicherungskopie der Datei „config.xml“, die Sie in Schritt 1 erstellt haben, und kopieren Sie den Wert „<credential-encrypted>“.

  12. Fügen Sie den Wert in die neue Datei „config.xml“ ein. Speichern und schließen Sie anschließend die Datei.

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

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

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

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

    Benutzername: administrator

    Kennwort: password

  16. Klicken Sie auf Dienste > LiveCycle 11 Connector für IBM FileNet.

  17. 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.
  18. Klicken Sie auf Speichern und navigieren Sie zu Dienste > Anwendungen und Dienste > Dienstverwaltung.

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

    • IBMFileNetAuthProviderService

    • IBMFileNetContentRepositoryConnector

    • IBMFileNetRepositoryProvider

    • IBMFileNetProcessEngineConnector (falls konfiguriert)

    Falls nicht alle Dienste richtig gestartet werden, überprüfen Sie die Prozess-Engine-Einstellungen.

  20. 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 16 angegebenen Anmeldeinformationen verwenden in diesem Fall den standardmäßigen LiveCycle-Autorisierungsdienst für den Zugriff auf das Standardrepository.

  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.

    Bei Verwendung von DB2 als LiveCycle-Datenbank beträgt die maximal zulässige Länge der ID 100 Einzelbyte-Zeichen (ASCII) oder 50 Doppelbyte-Zeichen oder 25 Vierbyte-Zeichen. (Siehe „Eine Unternehmensdomäne hinzufügen“ in Administration-Hilfe.)

  24. Fügen Sie einen benutzerdefinierten Authentifizierungsanbieter hinzu:

    • Klicken Sie auf Authentifizierung hinzufügen.

    • Wählen Sie in der Liste Authentifizierungsanbieter die Option 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 ein LDAP-Verzeichnis 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 Gruppeneinstellungen wie erforderlich und klicken Sie erneut auf Weiter.

      Detailinformationen zu den Einstellungen erhalten Sie, wenn Sie rechts oben auf der Seite auf den Link Hilfe 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 16 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.

    Nachdem Sie Connector für IBM FileNet konfiguriert haben, empfiehlt sich, in der LiveCycle Administration-Hilfe Informationen zum ordnungsgemäßen Konfigurieren von Workbench ES-Funktionen mit dem FileNet-Repository nachzulesen.