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
- 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.
- 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:
- Starten Sie die WebSphere Integrated Solutions Console in einem Web-Browser.
- Navigieren Sie zu
.
- Stellen Sie sicher, dass FileNetEngine in der Liste Unternehmensanwendungen
aufgeführt ist.
- Gehen Sie wie folgt vor, um das CCM-Profil zu laden:
- Laden Sie das CCM-Standardprofil. Wechseln Sie zu
.
- Wechseln Sie zu <FNCS-Ausgangsverzeichnis>\configure\profiles\CCM.
- Wählen Sie CCM.cfgp aus.
- 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.
- Konfigurieren Sie WebSphere Application Server wie folgt:
- Klicken Sie in der Ansicht "Content Navigator-Task" mit der rechten Maustaste auf CCM und
wählen Sie dann Profileigenschaften bearbeiten aus.
- 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.
- 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.
- Wenn die Zusammenfassung unter Erfolgreich implementiert angezeigt wird, schließen Sie die CMUI.
- Melden Sie sich bei der WebSphere Application Server Integrated Solutions
Console für den Deployment Manager an und klicken Sie auf
.
- Wählen Sie die Kontrollkästchen für die Knoten aus und klicken Sie auf die Option für die vollständige Resynchronisation.
- Installieren Sie den Authentifizierungsfiltercode wie folgt. Sie müssen bei jeder
FNCS-Rekonfiguration den Authentifizierungsfilter erneut installieren.
- Navigieren Sie in der Administrationskonsole von WebSphere Application
Server zu "WebSphere-Unternehmensanwendungen".
- Wählen Sie die Option FileNet Collaboration Services aus.
Anmerkung: Im 2.0.3-Release ist der
Standardanwendungsname navigator.
- Klicken Sie auf Aktualisieren.
- Wählen Sie unter Optionen für die Aktualisierung der Anwendung die Option Mehrere Dateien ersetzen, hinzufügen
oder löschen aus.
- 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.
- Klicken Sie auf Weiter und OK, um
die Anwendung zu aktualisieren.
- 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.
- Navigieren Sie in der Administrationskonsole von WebSphere Application Server zu
"WebSphere-Unternehmensanwendungen".
- Klicken Sie auf die FileNet Collaboration Services (navigator).
- Klicken Sie auf Zuordnung von Sicherheitsrollen zu
Benutzern/Gruppen unter Detaileigenschaften.
- Wählen Sie die Option OAuthClient aus.
- Klicken Sie unter der Option Sondersubjekte zuordnen auf Alle Authentifizierten im Realm der Anwendung und klicken Sie auf OK, um die Änderungen zu speichern.
- Klicken Sie auf Speichern, um die Einstellungen direkt in der Master-Konfiguration zu speichern.
- Überprüfen Sie die Richtlinie für das Klassenladeprogramm für FNCS. Führen Sie die folgenden Schritte aus:
- Öffnen Sie die Integrated Solutions Console des IBM
WebSphere Application Servers, der der Host
der Anwendung "navigator" ist.
- Klicken Sie auf
und wählen Sie WebSphere-Unternehmensanwendungen aus.
- Klicken Sie auf .
- 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.
- Klicken Sie auf OK.
- Klicken Sie auf .
- 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.
- Klicken Sie auf OK, um Ihre Änderungen zu speichern.
- Starten Sie die Anwendung "navigator" erneut.
- 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.