Über die Befehlszeile von Configuration Manager können Sie eine Content Engine-Instanz, für die ein Upgrade durchgeführt wurde, auf einem Webanwendungsserver konfigurieren.
Stellen Sie vor Beginn sicher, dass Sie über die erforderlichen Konten und die entsprechenden Berechtigungen verfügen.
So konfigurieren Sie die Content Engine-Instanz, für die Upgrades durchgeführt wurden:
- Melden Sie sich an der Maschine, auf der Content Engine installiert ist, als Config_Mgr-Benutzer an. Dies ist der Configuration Manager-Benutzer.
- Wechseln Sie vom aktuellen Verzeichnis zu CE-Installationspfad/tools/configure,
wobei CE-Installationspfad der Pfad ist, in dem Sie Content Engine installiert haben.
CE-Installationspfad kann beispielsweise
/opt/FileNet/ContentEngine sein.
- Führen Sie den Befehl generateupgrade in der Eingabeaufforderung aus, um das Upgradeprofil
zu generieren. Geben Sie den Befehl als einzelne Zeile ohne Zeilenumbrüche ein.
configmgr_cl generateupgrade [-appserver Anwendungsservertyp] -server Servername
[-deploy Implementierungstyp] -profile mein_Profil [-silent] [-force] [-help]
Dabei gilt Folgendes:
- -appserver Anwendungsservertyp
- Der Parameter -appserver Anwendungsservertyp ist nur erforderlich, wenn die Datei
CE-Installationspfad/Servers.xml nicht vorhanden ist oder keine Server enthält. Dieser Parameter gibt den Typ des Anwendungsservers an und muss einen der folgenden Werte aufweisen: WebSphere, WebLogic oder JBoss.
- -server Servername
- Der Parameter -server Servername gibt den Server an, für den das Upgradeprofil erstellt werden soll. Mit dem Befehl listservers können Sie eine Liste der gültigen Werte für Servername anzeigen, bevor Sie den Befehl generateupgrade ausführen.
- -deploy Implementierungstyp
- Der Parameter -deploy Implementierungstyp ist nur erforderlich, wenn die Datei
CE-Installationspfad/Servers.xml nicht vorhanden ist oder nicht den Implementierungstyp für den ausgewählten Server enthält. Dieser Parameter gibt den Typ der Content Engine-Implementierung an.
Falls in der Datei Servers.xml ein Wert für den Implementierungstyp für den ausgewählten Server vorhanden ist, wird der Wert aus der Datei Servers.xml anstatt des von Ihnen in der Befehlszeile eingegebenen Werts verwendet.
Wählen Sie einen der folgenden Werte
aus: standard, cluster
oder netdeploy (Netzimplementierung).
Geben Sie standard an, wenn Sie Content Engine auf einem der folgenden Standalone-Server (dies sind nicht verwaltete Server oder Server, die nicht zu einem Cluster gehören) implementieren: WebSphere Application Server, Oracle WebLogic Server oder JBoss Application Server.
Geben Sie cluster an, wenn
Sie Content Engine in einem WebSphere Application Server-, Oracle WebLogic Server- oder JBoss Application Server-Cluster implementieren.
Geben Sie netdeploy an, wenn Sie Content Engine für eine verwaltete WebSphere Application Server-Instanz implementieren.
Das heißt, Sie verwenden Network Deployment zum Verwalten einzelner Server, die nicht unbedingt zu einem Cluster gehören müssen.
- -profile mein_Profil
- Der Parameter -profile mein_Profil gibt das zu verwendende Profil an. Der Wert von mein_Profil kann eines der folgenden Elemente sein:
- Der Name des Profils, wie zum Beispiel ce_was_tiv_db2. Das Profil muss sich im Verzeichnis CE-Installationspfad/tools/configure/profiles befinden, wobei
CE-Installationspfad die Position ist, an der die Content Engine-Software installiert ist.
- Der absolute Pfad zum Profilverzeichnis, wie zum Beispiel "C:\Programme\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2" oder opt/IBM/FileNet/ContentEngine/tools/configure/profiles/ce_was_tiv_db2.
- Der absolute Pfad zur Profileingabedatei, wie zum Beispiel "C:\Programme\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2\ce_was_tiv_db2.cfg" oder opt/IBM/FileNet/ContentEngine/tools/configure/profiles/ce_was_tiv_db2/ce_was_tiv_db2.cfg.
Hinweis: Wenn der Pfad einen Verzeichnisnamen mit Leerzeichen enthält, müssen Sie den vollständigen Pfad in Anführungszeichen einschließen. Geben Sie zum Beispiel "C:\Programme\IBM\FileNet\ContentEngine\tools\configure\profiles\ce_was_tiv_db2\ce_was_tiv_db2.cfg" ein.
- -silent
- Der Parameter -silent ist optional. Wenn -silent angegeben wird, werden in der Konsole keine Eingabeaufforderungen oder Informationsnachrichten angezeigt, sondern werden die Fehler in das Protokoll geschrieben. Fehlernachrichten und Gültigkeitsfehlernachrichten wie Nachrichten zu fehlenden Kennwörtern oder ungültigen Portnummern werden bedarfsorientiert angezeigt. Wenn Sie den Befehl execute zum Ausführen aller Tasks in einem Profil ausführen und den Parameter -silent angeben, müssen Sie auch den Parameter -force angeben.
- -help
- Der Parameter -help ist optional und zeigt eine Kurznachricht zur Befehlssyntax an, anstatt den Befehl auszuführen.
Die Datei upgrade.xml und das Verzeichnis, das für jede vorhandene Content Engine-Instanz bestimmt wurde, wird im Profilverzeichnis erstellt.
Wichtig: Gibt der Befehl
generateupgrade eine Nachricht zurück, die darüber informiert, dass
bereits ein Upgradeprofil vorhanden ist, fahren Sie mit
4 fort.
- (Nur IBM® WebSphere Application Server oder Oracle WebLogic Server) So legen Sie die Eigenschaften für den Administrator des Anwendungsservers fest:
- Navigieren Sie in das Verzeichnis mein_Profil/meine_CE-Instanz.
- Öffnen Sie die Datei applicationserver.xml in einem Texteditor.
- Legen Sie den Wert für die Eigenschaft ApplicationServerAdminUsername fest.
<propertyname="ApplicationServerAdminUsername">
<value>Benutzer_mit_Administratorberechtigung </value>
</property>
- Speichern Sie Ihre Änderungen und schließen Sie die Datei.
- Führen Sie den Befehl storepasswords aus, der Sie fragt, ob Sie das Administratorkennwort für den Webanwendungsserver in der Datei applicationserver.xml verschlüsseln und speichern wollen. (Antworten Sie mit Yes oder No.) Wenn Sie das Kennwort nicht speichern wollen, müssen Sie applicationserver.xml bearbeiten. Geben Sie dazu den Klartext des Kennworts für die Eigenschaft ApplicationServerAdminPassword an.
configmgr_cl storepasswords -profile mein_Profil
Tipp: Wenn Sie vom Befehl storepasswords aufgefordert werden, Kennwörter in Konfigurationsdateien auf Platte zu speichern, müssen Sie mit yes oder no (statt mit y oder n) antworten.
- Wiederholen Sie diesen Schritt bei Bedarf, um die Eigenschaften des Anwendungsservers für jedes erstellte Verzeichnis für die Content Engine-Instanz
zu bearbeiten.
- (Nur WebSphere) Wenn Sie für Content Engine ein Upgrade von Version 4.0.1 oder 4.5.0 durchführen, führen Sie an einer Eingabeaufforderung den Befehl execute aus, um die Anmeldemodule zu konfigurieren:
configmgr_cl generateconfig -appserver Anwendungsservertyp
-repositorytype LDAP-Repository-Typ -task configureloginmodules
-profile mein_Profil
Dabei gilt Folgendes:
- -repositorytype LDAP-Repository-Typ
- Nur WebSphere Application Server. Der Parameter -repositorytype LDAP-Repository-Typ gibt den zu verwendenden Typ des LDAP-Repositorys an, der standalone oder federated sein muss.
- (Nur JBoss) Wenn Sie für Content Engine ein Upgrade von Version 4.0.1, 4.5.0 oder 4.5.1 durchführen, führen Sie an einer Eingabeaufforderung den Befehl execute aus, um die Anmeldemodule zu konfigurieren:
configmgr_cl execute -task configureloginmodules -profile mein_Profil
- Führen Sie den Befehl execute an einer Eingabeaufforderung aus, um die Bootstrap-Eigenschaften zu konfigurieren.
configmgr_cl execute -task configurebootstrap -profile mein_Profil
Die Statusnachrichten werden in der Konsole angezeigt.
- Optional: Prüfen Sie an einer Eingabeaufforderung den Beendigungsstatus der Task, indem Sie den Befehl checkStatus ausführen.
configmgr checkStatus -task configurebootstrap -profile mein_Profil