FileNet Collaboration Services ab Version 2.0.3 neu konfigurieren

Verwenden Sie das Konfigurations- und Implementierungstool von IBM® Content Navigator, um FileNet Collaboration Services 2.0.3 für die Unterstützung von Änderungen an IBM Connections Content Manager zu rekonfigurieren. Beispiel: Konfigurieren Sie FileNet Collaboration Services erneut, wenn ein Host oder ein Port, der zum Herstellen einer Verbindung mit Connections Content Manager verwendet wird, geändert wird. Diese Version von FNCS ist eine Komponente von IBM Content Navigator 2.0.3.

Vorbereitende Schritte

Legen Sie alle relevanten Eigenschaften und die entsprechenden Werte in der Datei <FNCS-Installationsposition>\configure\explodedformat\fncs\WEB-INF\classes\fncs-sitePrefs.properties fest, wie im Abschnitt Site preference parameters (Parameter für Sitevorgaben) im IBM Knowledge Center für IBM FileNet Collaboration Services beschrieben. Legen Sie insbesondere anonymousAccessEnabled=true und enablePropertySheetTemplateMinMax=true fest.
Wichtig: Setzen Sie die Eigenschaften fncsServerURL und fncsServerURLSecure auf die Basis-URL, die dazu verwendet wird, FileNet Collaboration Services zu adressieren. Beispiele: http://example.com und https://example.com. Setzen Sie die Eigenschaft icURI auf die Basis-URL, die zur Adressierung von IBM Connections verwendet wird, wie z. B. http://example.com. Diese Werte müssen möglicherweise geändert werden, wenn Sie einen Sicherheits-Proxy wie z. B. Tivoli Access Manager konfiguriert haben. Sicherheits-Proxys ändern die URL oder den Hostnamen, die oder den Benutzer für den Zugriff auf Ihre Implementierung verwenden.

Informationen zu diesem Vorgang

Im folgenden Verfahren wird erläutert, wie Sie FileNet Collaboration Services neu konfigurieren, die in eine neue Installation von FileNet über Connections Content Manager eingebettet sind.

Bei einer bereits vorhandenen FileNet-Installation finden Sie eine vollständige Liste der verfügbaren Konfigurationsoptionen im FileNet Collaboration Services Information Center.

Wenn Connections Content Manager und eine neue FileNet-Implementierung installiert werden, sind diese Konfigurationsoptionen unter <connections_install_root>\addons\ccm\FNCS\configure\profiles\CCM verfügbar. Beispiel: <connections_install_root>/addons/ccm/FNCS/configure/profiles/CCM on Linux.
Anmerkung: Der Pfad lautet möglicherweise <connections_install_root>\FileNet\ContentEngine\FNCS....

Vorgehensweise

  1. Gehen Sie beim Ausführen des Enterprise Content Manager-Tools für die Clientkonfiguration und -implementierung (Benutzerschnittstelle von Configuration Manager oder CMUI) wie folgt vor:
    • Windows: connections_root\FNCS\configure\configmgr.exe
    • Linux oder AIX: /opt/IBM/Connections/FNCS/configure/configmgr.bin
      Anmerkung: Wenn Sie configmgr.bin nicht ausführen können, weil Ihr System keine Benutzerschnittstelle unterstützt, können Sie die xml-Dateien manuell in <FNCS home>/configure/profiles/CCM ändern. Anschließend können Sie sie mit dem in Schritt 3 beschriebenen Befehl ausführen.
    • Wählen Sie in der Liste mit Implementierungsoptionen Vorhandenes Implementierungsprofil ändern aus.
  2. Stellen Sie sicher, dass die Content Platform Engine installiert ist und ausgeführt wird und klicken Sie dann auf Weiter. Gehen Sie wie folgt vor, um zu überprüfen, ob die Content Platform Engine installiert ist und ausgeführt wird:
    1. Starten Sie die WebSphere Integrated Solutions Console in einem Web-Browser.
    2. Navigieren Sie zu Anwendungen > Anwendungstypen > WebSphere-Unternehmensanwendungen.
    3. Stellen Sie sicher, dass FileNetEngine in der Liste Unternehmensanwendungen aufgeführt ist.
  3. Gehen Sie wie folgt vor, um das CCM-Profil zu laden:
    1. Laden Sie das CCM-Standardprofil. Wechseln Sie zu Datei > Implementierungsprofil öffnen.
    2. Wechseln Sie zu <FNCS-Ausgangsverzeichnis>\configure\profiles\CCM.
    3. Wählen Sie CCM.cfgp aus.
  4. Es gibt sechs Standardtasks. Sie können die gewünschten Tasks erneut konfigurieren und sie anschließend erneut ausführen, indem Sie doppelt auf jede Task klicken, Werte eingeben und Ihre Aktualisierungen anschließend speichern. Konfigurieren Sie die Tasks wie folgt neu:
    • Task 1: FileNet P8 Client Connectors-Dateien aktualisieren (TaskName: downloadcejarstask)

      Durch diese Task wird die Datei Jace.jar vom FileNet Content Engine-Server heruntergeladen. Der WebSphere Application Server Community Edition-Server muss ausgeführt werden, damit Sie diese Task ausführen können. Geben Sie den Hostnamen und den HTTP-Port des FileNet Content Engine-Servers ein (normalerweise 9080 oder 80). Diese Werte werden nur einmal zum Herunterladen der Clientbibliotheken vom Server verwendet. Bei einem Cluster können Sie bei Bedarf den Hostnamen für einen einzelnen Server verwenden.

    • Task 2: Verbindung zu Ihrem LDAP-Server konfigurieren (TaskName: configureldap)

      Diese Task ist nur erforderlich, wenn Sie eine Implementierung auf einem neuen WebSphere Application Server-Server durchführen, der noch nicht für LDAP-basierte Sicherheit konfiguriert ist. Auf den meisten CCM-Zielsystemen ist diese Task bereits beendet.

    • Task 3: Ihre Content Engine-LTPA-Schlüssel importieren (TaskName: importltpakey)

      Diese Task ist nur dann erforderlich, wenn Connections und/oder Content Engine in verschiedenen WebSphere Application Server-Zellen ausgeführt werden und Sie zuvor keine Schlüssel von diesen Servern importiert hatten. Auf einem normalen CCM-Zielsystem, werden CE und FNCS in einer einzelnen Zelle zusammen mit Connections ausgeführt, sodass diese Task nicht erforderlich ist.

    • Task 4: FileNet Collaboration Services konfigurieren (TaskName: configurefncstask)

      Wählen Sie die neue Funktion Zusammengefasst mit Content Engine aus, wenn FNCS auf demselben WebSphere Application Server-Server wie CE ausgeführt wird und Sie eine lokale EJB-Verbindung verwenden möchten.

      Anmerkung: Diese Option wird für die meisten CCM-Implementierungen empfohlen.
      • Wenn Sie für diesen Wert “True” angeben, müssen Sie keine CE-URL eingeben. Das Feld wird ausgeblendet.
      • Wenn die FNCS nicht mit CE zusammengefasst sind, geben Sie hier die CE-EJB-URL ein. Das Standardformat lautet: http://<Hostname>:<EJB-Port>/FileNet/Engine, wie z. B. http://ccv01233.usca.example.com:2809/FileNet/Engine.
      HA-Cluster-URLs werden unterstützt. Beispiel:
      corbaloc::cm-cfgsvr59vm2.usca.example.com:9810,:cm-cfgsvr59vm4.usca.example.com:9810/cell/clusters/cecluster/FileNet/Engine
      • Geben Sie den Community-Bibliotheksobjektspeicher, die Community-HTTP-URL und die Community-HTTPS-URL ein.
      • Wenn Sie die zusätzlichen benutzerdefinierten Eigenschaften für FNCS ändern möchten, verwenden Sie die vorhandene Vorlageneigenschaftsdatei connections_root\IBM\Connections\addons\ccm\FNCS\configure\explodedformat\fncs\WEB-INF\classes\fncs-sitePrefs.properties.
      • Die Eigenschaft, die für CCM verwendet werden muss, lautet anonymousAccessEnabled=true.
      • Die erforderliche Eigenschaft, wenn Sie IBM Docs im Bibliothekswidget verwenden: enableSharedDrafts=true.
    • Task 5: Webanwendung erstellen (TaskName: rebuildear) - Diese Task ist erforderlich, wenn Sie eine der Rekonfigurationstasks 1 bis 4 ausgeführt haben.
      Diese Task generiert eine .ear-Datei auf der Grundlage der Optionen, die Sie in den vorherigen Tasks angegeben haben. Der Standardanwendungsname ist navigator. Der Standard-EAR-Name ist navigatorEAR.ear. In einem einfachen CCM-Profil enthält diese .ear-Datei nur die Anwendung "FNCS".
      Anmerkung: Ändern Sie nicht das Kontextstammverzeichnis.
      • Geben Sie den richtigen Build-Script-Pfad an, wie z. B. connections_root\addons\ccm\FNCS\configure\explodedformat\create_ear.bat, und den richtigen tmp-Pfad, wie z. B. connections_root\addons\ccm\FNCS\configure\tmp.
      • Wenn diese Task abgeschlossen ist, verfügen Sie über eine vollständige .ear-Datei, die für die Implementierung auf dem WebSphere Application Server bereit ist. Sie können sie mithilfe der Administrationskonsole von WebSphere Application Server manuell implementieren oder Sie können die Task "Webanwendung implementieren" in CMUI verwenden. Die Datei navigatorEAR.ear befindet sich im Verzeichnis connections_root\addons\ccm\FNCS\configure\deploy.
    • Task 6: Webanwendung implementieren (TaskName: deployapplication)

      Wenn Sie in Task 5 eine neue .ear-Datei erstellt haben, müssen Sie sie erneut auf dem WebSphere Application Server implementieren, um sie verwenden zu können. Wählen Sie den Implementierungstyp, den Anwendungsserverknoten und den Anwendungsservernamen aus und führen Sie sie aus.

  5. Konfigurieren Sie WebSphere Application Server wie folgt:
    1. Klicken Sie in der Ansicht "Content Navigator-Task" mit der rechten Maustaste auf CCM und wählen Sie dann Profileigenschaften bearbeiten aus.
    2. Füllen Sie die WebSphere Application Server-Parameter aus. Beachten Sie dabei die folgenden Parametereinstellungen:
      • Application Server-Version: - Die Version muss 8.5 sein.
      • Profil: - Das Profil muss <WebSphere Application Server pathname>/Dmgr01 sein.
      • Benutzername, Kennwort und Kennwortbestätigung des DMGR-Administrators.
      • SOAP-Connector-Port: - Der Port muss der DMGR-Port sein.
      • Hostname: - Der Hostname muss der Name des DMGR-Hosts sein.
      • Implementierungsitzungszeitlimit: - Der Standardwert (180) muss angegeben werden.
    3. Klicken Sie auf Fertigstellen. Möglicherweise müssen Sie das Administratorkennwort für den WebSphere Application Server erneut eingeben, wenn Sie die FNCS-Configuration Manager-Sitzung erneut starten.

    Wenn Sie die WebSphere Application Server-Eigenschaften angegeben und die Tasks, die Sie benötigen, neu konfiguriert haben, können Sie diese Tasks ausführen. Falls Sie einige der Tasks nicht konfigurieren müssen, können Sie mit der rechten Maustaste auf die betreffende Task klicken und sie inaktivieren.

  6. Wenn die Zusammenfassung unter Erfolgreich implementiert angezeigt wird, schließen Sie die CMUI.
  7. Melden Sie sich bei der WebSphere Application Server Integrated Solutions Console für den Deployment Manager an und klicken Sie auf Systemverwaltung > Knoten.
  8. Wählen Sie die Kontrollkästchen für die Knoten aus und klicken Sie auf die Option für die vollständige Resynchronisation.
  9. Installieren Sie den Authentifizierungsfiltercode wie folgt. Sie müssen bei jeder FNCS-Rekonfiguration den Authentifizierungsfilter erneut installieren.
    1. Navigieren Sie in der Administrationskonsole von WebSphere Application Server zu "WebSphere-Unternehmensanwendungen".
    2. Wählen Sie die Option FileNet Collaboration Services aus.
      Anmerkung: Im 2.0.3-Release ist der Standardanwendungsname navigator.
    3. Klicken Sie auf Aktualisieren.
    4. Wählen Sie unter Optionen für die Aktualisierung der Anwendung die Option Mehrere Dateien ersetzen, hinzufügen oder löschen aus.
    5. Wenn Sie den Browser auf dem Deployment Manager-Knoten ausführen, wählen Sie das lokale Dateisystem aus und suchen Sie die Datei auth_filter_patch.zip.
      Anmerkung: Die Datei auth_filter_patch.zip befindet sich in einem der beiden folgenden Verzeichnisse, abhängig von Ihrer Systemkonfiguration:
      Anmerkung: Wenn der Browser nicht auf dem Deployment Manager-Knoten ausgeführt wird, wählen Sie das ferne Dateisystem aus und wählen Sie das DM-Dateisystem, indem Sie die Datei auth_filter_patch.zip im oben genannten Verzeichnis suchen.
    6. Klicken Sie auf Weiter und OK, um die Anwendung zu aktualisieren.
  10. Setzen Sie die OAuthClient-Sicherheitsrolle wie folgt auf die Benutzer-/Gruppenzuordnung zurück:
    Anmerkung: Sie müssen die OAuthClient-Zuordnung jedes Mal zurücksetzen, wenn FNCS neu konfiguriert wird.
    1. Navigieren Sie in der Administrationskonsole von WebSphere Application Server zu "WebSphere-Unternehmensanwendungen".
    2. Klicken Sie auf die FileNet Collaboration Services (navigator).
    3. Klicken Sie auf Zuordnung von Sicherheitsrollen zu Benutzern/Gruppen unter Detaileigenschaften.
    4. Wählen Sie die Option OAuthClient aus.
    5. Klicken Sie unter der Option Sondersubjekte zuordnen auf Alle Authentifizierten im Realm der Anwendung und klicken Sie auf OK, um die Änderungen zu speichern.
    6. Klicken Sie auf Speichern, um die Einstellungen direkt in der Master-Konfiguration zu speichern.
  11. Überprüfen Sie die Richtlinie für das Klassenladeprogramm für FNCS. Führen Sie die folgenden Schritte aus:
    1. Öffnen Sie die Integrated Solutions Console des IBM WebSphere Application Servers, der der Host der Anwendung "navigator" ist.
    2. Klicken Sie auf Anwendungen > Anwendungstypen und wählen Sie WebSphere-Unternehmensanwendungen aus.
    3. Klicken Sie auf navigator > Erkennung für Laden und Aktualisierung von Klassen.
    4. Stellen Sie im Abschnitt Reihenfolge der Klassenladeprogramme sicher, dass die Option Klassen mit lokalem Klassenladeprogramm an erster Stelle geladen (übergeordnetes Element zuletzt) ausgewählt ist.
    5. Klicken Sie auf OK.
    6. Klicken Sie auf navigator > Module verwalten > IBM FileNet Collaboration Services.
    7. Stellen Sie im Abschnitt Allgemeine Eigenschaften sicher, dass die Option Klassen mit lokalem Klassenladeprogramm an erster Stelle geladen (übergeordnetes Element zuletzt) in Reihenfolge der Klassenladeprogramme ausgewählt ist.
    8. Klicken Sie auf OK, um Ihre Änderungen zu speichern.
  12. Starten Sie die Anwendung "navigator" erneut.
  13. Möglicherweise müssen Sie die HTTP-Serverzuordnungen aktualisieren, wenn Sie das Rekonfigurieren der FileNet Collaboration Services fertigstellen. Weitere Informationen finden Sie unter Anwendungen dem IBM HTTP server zuordnen.

Ergebnisse

Eine Zusammenfassung bietet Vorschläge dazu, wie bestätigt werden kann, dass der Service in Betrieb ist.