Bei der Verwendung des Profilerstellungsassistenten (interaktiv oder automatisch) zur erstmaligen Erstellung oder Erweiterung eines Profils wird eine Befehlszeilenversion der Profilerstellung oder -erweiterung in eine Protokolldatei geschrieben. Diese Befehlszeile kann aus der Protokolldatei extrahiert, modifiziert und zur Erstellung oder Erweiterung weiterer Profile verwendet werden.
Um den Befehl manageprofiles mit WebSphere ESB verwenden zu können, sollten Sie mit Hilfe des Profilerstellungsassistenten (grafische Benutzerschnittstelle) oder mit Antwortdateien für die automatische Installation bereits ein Profil mit den gewünschten Optionen neu erstellt oder erweitert haben. (Verwenden Sie manageprofiles nicht zur erstmaligen Konstruktion eines Erweiterungs- oder Erstellungsbefehls.)
Die Befehlszeile, die bei der Verwendung des Profilerstellungsassistenten oder bei der automatischen Installation entsteht, wird in eine Protokolldatei geschrieben. Aus dem Inhalt dieser Protokolldatei kann eine ähnliche Befehlszeile erstellt werden, die mit dem Befehl
manageprofiles in nachfolgenden Operationen zur Erstellung oder Erweiterung von Profilen verwendet werden kann.
Eine gespeicherte Befehlszeile, die zur Erstellung eines Profils verwendet wurde, enthält den Parameter -create (normalerweise in der Form manageprofiles -create). Eine gespeicherte Befehlszeile, die zur Erweiterung eines Profils verwendet wurde, enthält den Parameter -augment (normalerweise in der Form manageprofiles -augment). Achten Sie darauf, dass diese Befehlszeilenparameter nicht verwechselt werden. Das heißt zum Beispiel, dass -augment nicht durch -create ersetzt werden darf.
Die entstehenden Scripts würden dann nicht funktionieren, da andere Parameter und Argumente falsch wären.
Anmerkung: WebSphere ESB unterstützt die Erweiterung eines Profils, das in einen Bereitstellungsmanager eingebunden wurde, nicht.
Sie müssen dann zuerst die Einbindung dieses Profils rückgängig machen, es anschließend erweitern und können dann mit dem Befehlszeilentool addNode die erneute Einbindung vornehmen.
- Öffnen Sie nach der Erstellung oder Erweiterung eines Profils mit Hilfe des Profilerstellungsassistenten oder durch automatische Installation die dabei generierte Protokolldatei. Dateipfad und Dateiname lauten wie folgt: profilstammverzeichnis/logs/pcatLogNNNNNNNNNNNNN.txt, wobei profilstammverzeichnis das Verzeichnis ist, in dem das Profil erstellt wurde, und NNNNNNNNNNNNN eine Zeitmarke darstellt.
- Lokalisieren Sie in der Protokolldatei die Zeile, die mit "CAPTURED COMMAND LINE" beginnt, und speichern Sie diese Zeile (einschließlich des gesamten eingeschlossenen Textes unter ihr) in einer neuen Datei.
- Markieren Sie den mit "CAPTURED COMMAND LINE" beginnenden Text bis zum Ende der Datei.
- Kopieren Sie diesen Text in eine neue Datei.
- Entfernen Sie in der neuen Datei aus der kopierten Zeichenfolge nach oben alles einschließlich der Wörter "CAPTURED COMMAND LINE."
- Speichern Sie die Datei. (Jeder eindeutige und gültige Dateiname kann verwendet werden). Nun ist in dieser Datei eine Entsprechung der Befehlszeile zur vorher erfolgten Ausführung des Profilerstellungsassistenten gespeichert.
- Modifizieren Sie die Befehlszeile mit den gewünschten Änderungen. Mit einem Texteditor müssen Sie nun den gespeicherten Befehl so modifizieren, dass eine neue Profilerstellung oder -erweiterung in der gewünschten Form ausgeführt werden kann. Die folgenden Werte müssen oder können geändert werden.
Anmerkung: Ändern Sie andere Werte nicht, und fügen Sie zu den in der Befehlszeile bereits vorhandenen oder in
Parameter zum Befehl manageprofiles angegebenen Parametern auch keine zusätzlichen Parameter ein.
.
Beim... |
Ist es Ihre Aufgabe,... |
Erstellen oder Erweitern eines Profils |
Sie müssen an allen Fundstellen in der Datei die Zeichenfolge "MASKED_PARAMETER_VALUE" durch gültige Kennwörter ersetzen. Die Zeichenfolge "MASKED_PARAMETER_VALUE" wurde aus Sicherheitsgründen an Stelle des Kennworts eingefügt. Sie müssen diese Zeichenfolgen ersetzen. Weitere Informationen hierzu finden Sie unter Parameter zum Befehl manageprofiles. |
Erweitern eines vorhandenen Profils |
Stellen Sie sicher, dass die Werte der Parameter -profileName, -profilePath, -cellName und -nodeName exakt mit den Parametern des Profils übereinstimmen, das Sie erweitern möchten. Sie sollten die Werte je nach der Herkunft der Befehlszeile und dem zu modifizierenden Profils entsprechend ändern. |
Erweitern eines vorhandenen Profils |
Stellen Sie sicher, dass der Typ der Profilvorlage in der Befehlszeile mit dem Typ des Profils, das Sie erweitern möchten, identisch ist (eigenständig, Bereitstellungsmanager oder angepasst). Wird diese Bedingung nicht eingehalten, können Fehler entstehen. |
Erstellen eines neuen Profils |
Modifizieren Sie -profileName, -profilePath, -cellName und -nodeName so, dass eindeutige Werte angegeben sind. |
Erstellen eines neuen Profils |
Spezifizieren Sie die Ports, die Sie im Profilerstellungsassistenten definiert haben, neu. Die Befehlszeile enthält keine Angaben zu den Ports, die Sie ursprünglich mit Hilfe des Profilerstellungsassistenten definiert haben. Fügen Sie am Ende der Befehlszeile entweder den Parameter -portsFile oder den Parameter -startPort sowie einen geeigneten Portwert ein. Weitere Informationen zum Spezifizieren dieser Ports finden Sie in den Informationen zum Befehl "wasprofile" im Informationszentrum zu WebSphere Application Server. |
Verwenden dieser Befehlszeile für eine weitere Installation von WebSphere ESB (entweder auf dem Computer, für den das Originalprofil erstellt wurde oder auf einem anderen Computer) |
Modifizieren Sie bei Bedarf die Pfadnamen so, dass sie für das Verzeichnis der anderen Installation von WebSphere ESB geeignet sind, und modifizieren Sie den qualifizierten Pfad zu der Verzeichnisposition, an der sich diese Befehlsdatei befindet. |
- Verwenden Sie die geänderte Befehlszeilendatei, um ein neues Profil zu erstellen oder ein vorhandenes Profil zu erweitern.
- Machen Sie aus der Datei eine ausführbare Datei.
- Für UNIX- und Linux-Systeme geben Sie der Datei die Erweiterung .sh und erteilen ihr die Ausführungsberechtigung.
- Für Windows-Systeme geben Sie der Datei die Erweiterung .bat.
- Führen Sie die Datei von der Befehlszeile aus. Der Befehl zeigt während seiner Ausführung den Status an. Warten Sie, bis er beendet ist.
Es folgt ein Beispiel für eine aufgezeichnete (nicht modifizierte) Befehlszeile für das Erstellen eines neuen Profils. In diesem Fall wurde der Befehl verwendet, um ein neues Profil zu erstellen, wie es auch am Parameter -create zu erkennen ist:
(Nov 3, 2005 9:24:08 AM), Install, com.ibm.ws.install.wbiserver.ismp.actions.
CalculateManagedProfileInvocationAction, msg1, CAPTURED_COMMAND_LINE:
/opt/o0544.1 2/bin/manageprofiles.sh -create -profileName "ESB01" -profilePath
"/opt/o054 4.12/profiles/ESB01" -templatePath "/opt/o0544.12/profileTemplates/default. wbiserver"
-federateLater "true" -hostName "eexfvt99.rchland.ibm.com" -nodeName "eexfvt99Node28"
-cellName "eexfvt99Node26Cell" -dmgrHost "localhost" -dmgrP ort "8879" -OS_NAME "Linux"
-winserviceCheck "true" -winserviceAccountType " localsystem" -winserviceUserName "root"
-winservicePassword "MASKED_PARAMETER_ VALUE" -winserviceStartupType "manual" -dbJDBCClasspath
"null" -dbType "CLOUD SCAPE" -ceiSampleJmsUser "root" -ceiSampleJmsPwd "MASKED_PARAMETER_VALUE"
-cei SampleServerName "server1" -ceiDbProduct "CLOUDSCAPE_V51_1" -ceiDbName ""
-ce iDbUser "" -ceiDbPwd "MASKED_PARAMETER_VALUE" -ceiDbSysUser ""
-ceiDbSysPwd "MASKED_PARAMETER_VALUE" -ceiDbJdbcDriverClasspath ""
-ceiDbJdbcDriverType "" -ceiDbServerName "" -ceiDbServerPort ""
-ceiDbNodeName "" -ceiDbExecuteScript s "" -configureScaSecurity "true" -scaSecurityUserId
"root" -scaSecurityPassword "MASKED_PARAMETER_VALUE"
Es folgt ein Beispiel für die Befehlszeile nach der Modifizierung, das heißt, nachdem die Dateiheaderinformationen entfernt und die maskierten Kennwörter ersetzt wurden.
/opt/o0544.1 2/bin/manageprofiles.sh -create -profileName "myProfile"
-profilePath "/opt/o054 4.12/profiles/myProfile"
-templatePath "/opt/o0544.12/profileTemplates/default. wbiserver"
-federateLater "true" -hostName "eexfvt99.rchland.ibm.com"
-nodeName "myNodeName" -cellName "myCellName" -dmgrHost "localhost"
-dmgrPort "8879" -OS_NAME "Linux" -winserviceCheck "true" -winserviceAccountType
" localsystem" -winserviceUserName "root" -winservicePassword "rootPassword"
-winserviceStartupType "manual" -dbJDBCClasspath "null" -dbType "CLOUD SCAPE"
-ceiSampleJmsUser "root" -ceiSampleJmsPwd "myRootPwd"
-cei SampleServerName "server1" -ceiDbProduct "CLOUDSCAPE_V51_1" -ceiDbName ""
-ce iDbUser "" -ceiDbPwd "myPassword" -ceiDbSysUser "" -ceiDbSysPwd "myPassword"
-ceiDbJdbcDriverClasspath "" -ceiDbJdbcDriverType "" -ceiDbServerName ""
-ceiDbServerPort "" -ceiDbNodeName "" -ceiDbExecuteScript s "" -configureScaSecurity
"true" -scaSecurityUserId "root" -scaSecurityPassword "myRootPwd"
Das folgende Beispiel zeigt ein solches Script, das in einem UNIX-System ausgeführt wird. In diesem Fall ist
"myCommandline.sh" der Name des Scripts, das erstellt wurde:
/opt/IBM/WebSphere/ESB/bin>myCommandline.sh
INSTCONFSUCCESS: Das Profil ist jetzt vorhanden.
INSTCONFSUCCESS: Profilerweiterung erfolgreich.
INSTCONFSUCCESS: Profilerweiterung erfolgreich.
/opt/IBM/WebSphere/ESB/bin>
Das folgende Beispiel zeigt ein solches Script, das in einem Windows-System ausgeführt wird. In diesem Fall ist
"myComnmandline.bat" der Name des Scripts, das erstellt wurde:
C:\Program Files\IBM\WebSphere\ESB\bin>myCommandline.bat
INSTCONFSUCCESS: Das Profil ist jetzt vorhanden.
INSTCONFSUCCESS: Profilerweiterung erfolgreich.
INSTCONFSUCCESS: Profilerweiterung erfolgreich.
C:\Program Files\IBM\WebSphere\ESB\bin>