![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Befehl "manageprofiles"
Verwenden Sie den Befehl manageprofiles, um Profile, die Laufzeitumgebungen definieren, zu erstellen, zu löschen, zu erweitern, zu sichern und wiederherzustellen. Die Verwendung von Profilen an Stelle mehrerer Produktinstallationen spart Plattenspeicherplatz und vereinfacht die Aktualisierung des Produkts, da eine einzige Gruppe von Stammproduktdateien verwaltet wird.
Der Befehl manageprofiles und die entsprechende grafische Benutzerschnittstelle, Profile Management Tool, sind die einzigen Hilfsmittel für das Erstellen von Laufzeitumgebungen.
Die Befehlsdatei befindet sich im Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin. Die Befehlsdatei ist ein Script mit dem Namen manageprofiles.
Syntax
Stammverzeichnis_des_Anwendungsservers\bin\manageprofiles.bat -augment -help
Stammverzeichnis_des_Anwendungsservers/bin/manageprofiles.sh -create
-profileName Profilname
-profilePath Profilstammverzeichnis
-templatePath Schablonenpfad
Parameter
Die folgenden Optionen sind für den Befehl manageprofiles verfügbar:
- Geben Sie das Kennwort für die mit dem Parameter -adminUserName angegebene Benutzer-ID für die Verwaltungssicherheit an.
- Geben Sie die Benutzer-ID an, die für die Verwaltungssicherheit verwendet wird.
- Gibt die Einstellung "performance-tuning" an, die am besten mit dem Typ von Umgebung übereinstimmt, in der der Anwendungsserver
ausgeführt werden soll.
Dieser Parameter ist nur für die Standardprofilschablone gültig.
- Die Einstellungen für "standard" sind sofort einsatzfähige Standardkonfigurationseinstellungen, die für allgemeine Verwendungszwecke optimiert wurden.
- Die Einstellungen für "peak" sind passend für eine Produktionsumgebung, in der Anwendungsänderungen selten vorkommen und eine optimale Laufzeitleistung wichtig ist.
- Die Einstellungen für "development" sind
für eine Entwicklungsumgebung optimiert, in der häufig Anwendungsaktualisierungen
durchgeführt werden und die verfügbaren Systemressourcen auf ein Mindestmaß beschränkt sind. Wichtig: Verwenden Sie diese Einstellungen für "development" nicht für Produktionsserver.
Wenn Sie keine Option mit dem Parameter -applyPerfTuningSetting angeben, lautet der Standardwert standard.
Wenn Sie sowohl den Parameter -isDeveloperServer als auch den Parameter -applyPerfTuningSetting angeben, kann -applyPerfTuningSetting abhängig von der Option, die für -applyPerfTuningSetting ausgewählt wurde, -isDeveloperServer überschreiben.
- Verwenden Sie den Parameter "augment", wenn Sie unter Verwendung einer Erweiterungsschablone Änderungen an einem vorhandenen Profil vornehmen möchten.
Der Parameter "augment" bewirkt, dass der Befehl manageprofiles
das mit dem Parameter -profileName angegebene Profil unter Verwendung der mit dem Parameter
-templatePath angegebenen Schablone aktualisiert bzw. erweitert.
Die Erweiterungsschablonen, die Sie verwenden können, richten sich nach den
IBM® Produkten und Produktversionen,
die in Ihrer Umgebung installiert sind.
Wichtig: Die in WebSphere Application Server Base bereitgestellten Schablonen können nur für die Erstellung von Profilen und nicht für die Erweiterung vorhandener Profile verwendet werden, weil im Lieferumfang des Produkts nur Erstellungsschablonen enthalten sind.
Die Dateien im Verzeichnis "Installationsverzeichnis/profileTemplates" sollten nicht manuelle geändert werden. Wenn Sie beispielsweise die Ports während der Profilerstellung ändern, verwenden Sie die Argumente "-startingPort" und "-portsFile" mit dem Befehl manageprofiles, anstatt die Datei im Verzeichnis mit den Profilschablonen zu ändern.
Geben Sie mit -templatePath
den vollständig qualifizierten Dateipfad an.
Beispiel:manageprofiles(.bat)(.sh) -augment -profileName Profilname -templatePath SchablonenpfadSie können einen relativen Pfad für den Parameter -templatePath angeben, wenn die Profilschablonen relativ zum Verzeichnis Stammverzeichnis_des_Anwendungsservers/profileTemplates sind. Andernfalls geben Sie den vollständig qualifizierten Schablonenpfad an. Beispiel:manageprofiles -augment -profileName Profilname -templatePath SchablonenpfadLesen Sie auch die Informationen zum Parameter -unaugment.
- Sichert die Profilregistrierungsdatei in der angegebenen Datei. Sie müssen für Name_der_Sicherungsdatei den vollständig qualifizierten Dateipfad angeben.
- Sichert das Dateisystem eines Profilordners und die Profilmetadaten aus der Profilregistrierungsdatei.
Alle Server, die das zu sichernde Profil verwenden, müssen vor dem Aufruf des Befehls
manageprofiles mit der Option -backupProfile gestoppt werden.
Der Parameter -backupProfile muss zusammen mit den Parametern
-backupFile und -profileName verwendet werden. Beispiel:
manageprofiles(.bat)(.sh) -backupProfile -profileName Profilname -backupFile Name_der_SicherungsdateiWenn Sie ein Profil mit der Option -backupProfile sichern, müssen Sie den Server und die aktiven Prozesse für das zu sichernde Profil zuerst stoppen.
- Gibt den Zellennamen des Profils an. Verwenden Sie für jedes Profil einen eindeutigen Zellennamen.
Fehler vermeiden: Zellennamen müssen eindeutig sein. Wenn mehrere Zellen denselben Namen haben,
führt dies möglicherweise zu Problemen bei der fernen Kommunikation zwischen Zellen, z. B. bei
Fernaufrufen von Enterprise JavaBeans. gotchaDieser Parameter ist optional. Falls Sie den Parameter nicht angeben, wird ein Standardzellenname zugeordnet.
Der Standardwert für diesen Parameter
setzt sich aus dem Kurznamen des Hosts, dem konstanten Zellennamen und einer
abschließenden Nummer zusammen:
Die Standardzellennamen sind wie folgt: Der Wert für diesen Parameter darf keine Leerzeichen und keine ungültigen Zeichen wie die folgenden enthalten: *, ?, ", <, >, ,, /, \, | usw.
- Erstellt das Profil. Geben Sie manageprofiles -create -templatePath vollständig_qualifizierter_Dateipfad_der_Schablone -help an, um spezifische Informationen zum Erstellen eines Profils zu erhalten. Verfügbare Schablonen:
- Aktiviert die Debug-Funktion des Dienstprogramms Ant, das vom Befehl manageprofiles verwendet wird.
- Ein optionaler Parameter, der angibt, wie lange (Jahre) das persönliche Standardzertifikat gültig ist. Wenn Sie diesen Parameter nicht zusammen mit dem Parameter -personalCertDN angeben, ist das persönliche Standardzertifikat ein Jahr gültig.
- Ordnet dem Profil die Standard- oder Basisportwerte zu.
Wenn Sie den Parameter -startingPort oder -portsFile verwenden, dürfen Sie diesen Parameter nicht angeben.
Während der Profilerstellung verwendet der Befehl manageprofiles eine automatisch generierte Gruppe empfohlener Ports, wenn Sie den Parameter -startingPort, den Parameter -defaultPorts oder den Parameter -portsFile nicht angeben. Die empfohlenen Portwerte können je nach Verfügbarkeit der Standardports von den Standardportwerten abweichen.
Hinweis: Verwenden Sie diesen Parameter nicht, wenn Sie die Schablone für verwaltete Profile verwenden. - Löscht das Profil.
Wenn ein Profil gelöscht wird, wird das Profilverzeichnis nicht gelöscht.
Angenommen, Sie erstellen ein Profil im Verzeichnis /usr/WebSphere/AppServer/profiles/managedProfile.
Dieses Verzeichnis ist auch nach dem Löschen des Profils weiterhin vorhanden.
Sie können das Verzeichnis löschen oder beibehalten.
Das Verzeichnis Profilstammverzeichnis/logs enthält jedoch Informationen zur Deinstallation
des Profils.
Sie können die Datei _nodeuninst.log beispielsweise behalten, um die Ursache für Probleme während der Deinstallation
zu bestimmen.
Das Profilverzeichnis wird gelöscht, wenn Sie das Profil löschen. Deshalb können Sie
das Profil erneut erstellen, ohne das Verzeichnis manuell löschen zu müssen. Wenn Sie ein Profil löschen, für das Erweiterungsschablonen in der Profilregistrierung registriert sind, werden die Aktionen zum Entfernen der Erweiterungen automatisch durchgeführt.
- Löscht alle registrierten Profile.
Wenn ein Profil gelöscht wird, wird das Profilverzeichnis nicht gelöscht.
Angenommen, Sie erstellen ein Profil im Verzeichnis /usr/WebSphere/AppServer/profiles/managedProfile.
Dieses Verzeichnis ist auch nach dem Löschen des Profils weiterhin vorhanden.
Sie können das Verzeichnis löschen oder beibehalten.
Das Verzeichnis Profilstammverzeichnis/logs enthält jedoch Informationen zur Deinstallation
des Profils.
Sie können die Datei _nodeuninst.log beispielsweise behalten, um die Ursache für Probleme während der Deinstallation
zu bestimmen.
Das Verzeichnis für das Profil wird gelöscht, wenn Sie den Profil löschen.
Deshalb müssen Sie keine veralteten Informationen mehr verwalten, wenn Sie das Profil erneut erstellen. Wenn Sie ein Profil löschen, für das Erweiterungsschablonen in der Profilregistrierung registriert sind, werden die Aktionen zum Entfernen der Erweiterungen automatisch durchgeführt.
- Aktiviert die Verwaltungssicherheit. Die gültigen Werte sind true und false. Der Standardwert ist false.
- Wenn Sie enableAdminSecurity auf true setzen, müssen Sie auch die Parameter -adminUserName und -adminPassword mit Werten angeben.
Ermöglicht das Erstellen von Linux-Services. Die gültigen Werte sind true und false.
Der Standardwert für diesen Parameter ist false.
Wenn Sie den Befehl manageprofiles mit der Option -enableService=true ausführen, wird der Linux-Service mit dem Profil erstellt, wenn der Befehl von Root ausgeführt wird. Wenn ein Benutzer ohne Rootberechtigung den Befehl manageprofiles ausführt, wird zwar das Profil, aber nicht der Linux-Service erstellt. Der Linux-Service wird nicht erstellt, weil die Berechtigungen des Benutzers nicht ausreichen, um den Service zu konfigurieren. Das Ergebnis INSTCONPARTIALSUCCESS wird am Ende der Profilerstellung angezeigt, und das Profilerstellungsprotokoll Stammverzeichnis_des_Anwendungsservers/logs/manageprofiles_create_Profilname.log enthält eine Nachricht, die darauf hinweist, dass der aktuelle Benutzer nicht berechtigt ist, den Linux-Service einzurichten.
- Gibt den Namen des Standardprofils zurück.
- Ruft die Dateisystemposition für ein Profil mit dem angegebenen Namen ab. Erfordert den Parameter –profileName.
- Ruft den Namen für ein Profil ab, das unter dem mit dem Parameter -profilePath angegebenen Profilpfad registriert wurde.
- Zeigt die Befehlssyntax an.
- Gibt den Namen des Hosts an, auf dem Sie das Profil erstellen. Dieser Name muss mit dem Hostnamen, den Sie bei der Installation des Ausgangsprodukts angegeben haben, übereinstimmen. Der Standardwert für diesen Parameter ist die Langform des Domänennamenssystems. Der Wert für diesen Parameter muss ein gültiger IPv6-Hostname sein und darf weder Leerzeichen noch unzulässige Zeichen wie die folgenden enthalten: *, ?, ", <, >, ,, /, \, | usw.
- Ein optionaler Parameter, der mit dem Parameter "-templatePath" verwendet wird, um die Erweiterung eines bestimmten erweiterten Profils rückgängig zu machen. Weitere Informationen finden Sie in der Beschreibung des Parameters "-unaugment".
- Gibt den Pfad der Keystore-Datei an, die Sie zum Importieren eines persönlichen Zertifikats verwenden, wenn Sie das Profil erstellen.
Das persönliche Zertifikat ist das persönliche Standardzertifikat für den Server.
Der Parameter -importPersonalCertKS und der Parameter -personalCertDN schließen sich gegenseitig aus. Wenn Sie nicht explizit ein persönliches Zertifikat erstellen oder importieren, wird standardmäßig eines erstellt.
Bewährtes Verfahren: Wenn Sie ein persönliches Zertifikat als persönliches Standardzertifikat importieren,
importieren Sie das Stammzertifikat, das zum Signieren des persönlichen Zertifikats verwendet wurde.
Andernfalls fügt der Befehl manageprofiles den öffentlichen Schlüssel des persönlichen Zertifikats der Datei "trust.p12" hinzu und erstellt ein Stammsignierzertifikat. bpracWenn Sie einen von den Parametern angeben, die mit "-importPersonal" beginnen, müssen Sie alle angeben.
- Gibt den Alias des Zertifikats an, das in der mit dem Parameter -importPersonalCertKS angegebenen Keystore-Datei enthalten ist.
Das Zertifikat wird der Standard-Keystore-Datei des Servers hinzugefügt und als persönliches Standardzertifikat des Servers verwendet.
Wenn Sie einen von den Parametern angeben, die mit "-importPersonal" beginnen, müssen Sie alle angeben.
- Gibt das Kennwort für die mit dem Parameter -importPersonalCertKS angegebene Keystore-Datei an.
Wenn Sie einen von den Parametern angeben, die mit "-importPersonal" beginnen, müssen Sie alle angeben.
- Gibt den Typ der mit dem Parameter -importPersonalCertKS angegebenen Keystore-Datei an.
Die gültigen Werte sind JCEKS, CMSKS, PKCS12, PKCS11 und
JKS. Diese Liste kann sich jedoch je nach Provider, der in der Datei "java.security" angegeben ist, ändern.
Wenn Sie einen von den Parametern angeben, die mit "-importPersonal" beginnen, müssen Sie alle angeben.
- Gibt den Pfad der Keystore-Datei an, die Sie zum Importieren eines Stammzertifikats verwenden, wenn Sie das Profil erstellen.
Das Stammzertifikat ist das Zertifikat, das Sie als Standardstammzertifikat für den Server verwenden.
Der Parameter -importSigningCertKS und der Parameter
-signingCertDN schließen sich gegenseitig aus. Wenn Sie nicht explizit ein Stammsignierzertifikat erstellen oder importieren,
wird standardmäßig eines erstellt.
Wenn Sie einen von den Parametern angeben, die mit "-importSigning" beginnen, müssen Sie alle angeben.
- Gibt den Alias des Zertifikats an, das in der mit dem Parameter -importSigningCertKS angegebenen Keystore-Datei enthalten ist.
Das Zertifikat wird dem Standardstamm-Keystore des Servers hinzugefügt und als Standardstammzertifikat für den Server
verwendet.
Wenn Sie einen von den Parametern angeben, die mit "-importSigning" beginnen, müssen Sie alle angeben.
- Gibt das Kennwort für die mit dem Parameter -importSigningCertKS angegebene Keystore-Datei an.
Wenn Sie einen von den Parametern angeben, die mit "-importSigning" beginnen, müssen Sie alle angeben.
- Gibt den Typ der mit dem Parameter -importSigningCertKS angegebenen Keystore-Datei an.
Die gültigen Werte sind JCEKS, CMSKS, PKCS12, PKCS11 und
JKS. Diese Liste kann sich jedoch je nach Provider, der in der Datei "java.security" angegeben ist, ändern.
Wenn Sie einen von den Parametern angeben, die mit "-importSigning" beginnen, müssen Sie alle angeben.
- Gibt an, dass das mit dem zugehörigen Parameter -profileName angegebene Profil als Standardprofil registriert werden soll. Wenn Sie Befehle absetzen, die auf das Standardprofil verweisen, muss das Attribut -profileName des Befehls nicht angegeben werden.
- Gibt an, ob der Server nur für Entwicklungszwecke bestimmt ist.
Dieser Parameter ist hilfreich, wenn Sie Profile erstellen, um Anwendungen in einem
Server außerhalb der Produktionsumgebung zu testen, bevor sie in Anwendungsservern in der Produktionsumgebung
implementiert werden.
Der Parameter ist nur für die Standardprofilschablone gültig.
Wenn Sie sowohl den Parameter -isDeveloperServer als auch den Parameter -applyPerfTuningSetting angeben, kann -applyPerfTuningSetting abhängig von der Option, die für -applyPerfTuningSetting ausgewählt wurde, -isDeveloperServer überschreiben.
- Gibt das Kennwort an, das für alle Keystore-Dateien verwendet werden soll, die während der Profilerstellung erstellt werden. Keystore-Dateien werden für das persönliche Standardzertifikat und für das Stammsignierzertifikat erstellt.
- Listet die registrierten Erweiterungen in einem Profil in der Profilregistry auf. Sie müssen den Parameter "-profileName" mit dem Parameter "-listAugments" angeben.
- Listet die in der Profilregistry enthaltenen Profile auf.
- Gibt den Namen für den Knoten an, der mit dem neuen Profil erstellt wird.
Verwendet einen eindeutigen Wert auf der Maschine.
Jedes Profil, dass die Binärdateien des Produkts mit anderen Profilen gemeinsam nutzt, muss einen eindeutigen Knotennamen
haben.
Der Standardwert für diesen Parameter setzt sich aus dem Kurznamen des Hosts, dem Profiltyp und einer abschließenden Nummer zusammen.
Die folgenden Standardknotennamen sind vorhanden:Der Wert für diesen Parameter darf keine Leerzeichen und keine ungültigen Zeichen wie die folgenden enthalten: *, ?, ", <, >, ,, /, \, | usw.
- Ein optionaler Parameter, der Profilfeatures ausschließt. Jede Profilschablone enthält vordefinierte optionale Features. Die folgenden optionalen Features können mit dem Parameter -omitAction für die folgenden Profilschablonen angegeben werden:
- Gibt den definierten Namen des persönliches Zertifikats an, das Sie beim Erstellen des Profils erstellen. Geben Sie den definierten Namen in Anführungszeichen an. Dieses persönliche Standardzertifikat befindet sich in der Keystore-Datei des Servers. Der Parameter -importPersonalCertKSType und der Parameter -personalCertDN schließen sich gegenseitig aus. Weitere Informationen finden Sie in den Informationen zu den Parametern -personalCertValidityPeriod und -keyStorePassword.
- Ein optionaler Parameter, der den Pfad zu einer Datei angibt, die die Porteinstellungen für das neue
Profil definiert.
Wenn Sie den Parameter -startingPort oder -defaultPorts verwenden, dürfen Sie diesen Parameter nicht angeben.
Während der Profilerstellung verwendet der Befehl manageprofiles eine automatisch generierte Gruppe empfohlener Ports, wenn Sie den Parameter -startingPort, den Parameter -defaultPorts oder den Parameter -portsFile nicht angeben. Die empfohlenen Portwerte können je nach Verfügbarkeit der Standardports von den Standardportwerten abweichen.
- Gibt den Namen des Profils an. Verwenden Sie beim Erstellen eines Profils einen eindeutigen Wert. Jedes Profil, dass die Binärdateien des Produkts mit anderen Profilen gemeinsam nutzt, muss einen eindeutigen Namen
haben. Der Standardprofilname setzt sich aus dem Profiltyp und einer abschließenden Nummer zusammen. Beispiel:
Für diese Angaben gilt Folgendes:<Profiltyp><Profilnummer>Der Wert für diesen Parameter darf keine Leerzeichen und keine ungültigen Zeichen wie die folgenden enthalten: *, ?, ", <, >, ,, /, \, | usw.
Der ausgewählte Profilname darf nicht im Gebrauch sein.
- Gibt den vollständig qualifizierten Pfad zum Profil an, der als Profilstammverzeichnis bezeichnet wird.
Wenn der vollständig qualifizierte Pfad Leerzeichen enthält,
schließen Sie den Wert in Anführungszeichen ein.
Der Standardwert basiert auf dem Verzeichnis
Stammverzeichnis_des_Anwendungsservers, dem Profilunterverzeichnis
und dem Namen des Profils.
Der Standardwert basiert auf dem Verzeichnis
Benutzerdatenstammverzeichnis, dem Profilunterverzeichnis
und dem Namen des Profils.Der Standardwert können beispielsweise wie folgt lauten:
Das Element WS_WSPROFILE_DEFAULT_PROFILE_HOME ist in der Datei wasprofile.properties im Verzeichnis Stammverzeichnis_des_Anwendungsservers/properties definiert.WS_WSPROFILE_DEFAULT_PROFILE_HOME/ProfilnameAnmerkung: Die Datei wasprofile.properties enthält die folgenden Eigenschaften:- WS_CMT_PI_MODPERMS
- Diese Eigenschaft gibt an,
ob das Programm zur Installationsnachbereitung
die Berechtigungen von Dateien, die es erstellt, ändern sollte. Die gültigen Werte sind true und false. Bei Eingabe eines anderen
Werts wird standardmäßig false verwendet. Auch wenn Sie diese Eigenschaft aus der Datei entfernen,
wird die Standardeinstellung false verwendet. Der Wert false bewirkt, dass alle Dateien, die vom Programm zur Installationsnachbereitung
erstellt wurden, Berechtigungen besitzen, die auf der umask-Einstellung des Systems basieren.
Der Wert für diesen Parameter muss ein gültiger Pfad für das Zielsystem sein und darf derzeit nicht im Gebrauch sein.
Sie müssen berechtigt sein, in das Verzeichnis zu schreiben.
Das Profil
QEJBSVR muss berechtigt sein, in das Verzeichnis zu schreiben. - WS_CMT_PI_LOGS
- Diese Eigenschaft gibt an, ob und wann das Programm zur Installationsnachbereitung seine Protokolle für jedes Produkt, das sich im
Verzeichnis PROFILE_HOME/logs/service/productDir
befindet, löschen soll.
Die Einstellungen für diese Eigenschaft ermöglichen Ihnen, die folgenden Kriterien für die Protokollbereinigung anzugeben:
- Sie können die Anzahl der Protokolle angeben, die Sie für jedes Produkt im Verzeichnis PROFILE_HOME/logs/service/productDir beibehalten möchten. Der angegebene Wert kann eine ganze Zahl zwischen 1 und 999 sein. Wenn Sie beispielsweise WS_CMT_PI_LOGS=5 angeben, behält das Programm zur Installationsnachbereitung für jedes Produkt jeweils die fünf aktuellsten Protokolle bei.
- Sie können angeben, wie viel Speicher die Protokolle maximal belegen dürfen.
Der angegebene Wert kann eine ganze Zahl zwischen 1 und 999 in Verbindung mit einer der folgenden Angaben sein:
- KB, wenn Sie den Wert in Kilobyte angeben.
- MB, wenn Sie den Wert in Megabyte angeben.
- GB, wenn Sie den Wert in Gigabyte angeben.
Fehler vermeiden: Da die angegebenen Werte die Beachtung der Groß-/Kleinschreibung erfordern, müssen die Buchstaben im angegebenen Wert groß geschrieben sein.gotcha - Sie können angeben, wie lange das Programm zur Installationsnachbereitung die Protokolle beibehalten soll. Der angegebene Wert
kann eine ganze Zahl zwischen 1 und 999 in Verbindung mit einer der folgenden Angaben sein:
- D, wenn Sie den Wert in Tagen angeben.
- W, wenn Sie den Wert in Wochen angeben.
- M, wenn Sie den Wert in Monaten angeben.
- Y, wenn Sie den Wert in Jahren angeben.
Fehler vermeiden: Da die angegebenen Werte die Beachtung der Groß-/Kleinschreibung erfordern, müssen die Buchstaben im angegebenen Wert groß geschrieben sein.gotcha - Sie können ein bestimmtes Datum angeben, nach dem ein Protokoll gelöscht wird.
Der Wert muss mit numerischen Werten mit Bindestrichen als Trennzeichen im Format DD-MM-YYYY angegeben werden. Wenn Sie beispielsweise
WS_CMT_PI_LOGS=12-31-2013 angeben, werden alle Protokolle am 31. Dezember 2013 gelöscht.
Fehler vermeiden: Wenn Sie den Wert nicht im angegebenen Format angeben und die Zahlen nicht durch Bindestriche getrennt sind,
wird diese Eigenschafteneinstellung ignoriert. gotcha
- Greift über die Befehlszeile mit dem Befehl manageprofiles auf alle API-Funktionen zu.
Die Befehlszeilenschnittstelle kann über eine Antwortdatei gesteuert werden, die die Eingabeargumente für einen bestimmten Befehl in der Eigenschaftendatei im Schlüssel=Wert-Format enthält. Verwenden Sie den Befehl manageprofiles mit dem Parameter "-help", um die Eingabeargumente zu bestimmen, die für die verschiedenen Typen von Profilschablonen und Aktionen erforderlich sind.
Verwenden Sie die folgende Beispielantwortdatei für die Ausführung einer Erstellungsoperation:createprofileName=testResponseFileCreate profilePath=Profilstammverzeichnis templatePath=Stammverzeichnis_des_Anwendungsservers/profileTemplates/default nodeName=myNodeName cellName=myCellName hostName=myHostName omitAction=myOptionalAction1,myOptionalAction2Beachten Sie die folgenden Richtlinien, wenn Sie eine Antwortdatei erstellen:- Verwenden Sie beim Angeben von Werten keine Anführungszeichen (") am Anfang und Ende eines Wertes, selbst wenn der Wert Leerzeichen enthält.
Anmerkung: Dies ist eine andere Regel als die für die Angabe von Werten in einer Befehlszeile.
- Wenn Sie einen Einzelwert angeben, der ein Komma enthält,
z. B. die definierten Namen (DN) für
die Parameter "personalCertDN" und "signingCertDN", verwenden Sie vor dem Komma einen doppelten Backslash.
Beispiel für die Angabe eines definierten Namens als
Wert für "signingCertDN":
signingCertDN=cn=testserver.ibm.com\\,ou=Root Certificate\\, ou=testCell\\,ou=testNode01\\,o=IBM\\,c=US - Wenn Sie mehrere Werte eingeben, trennen Sie sie durch Kommas, und verwenden Sie keine doppelten Backslashes.
Beispiel für die Angabe mehrerer Werte für den parameter
"omitAction":
omitAction=deployAdminConsole,defaultAppDeployAndConfig - Geben Sie in einer Antwortdatei keine leere Zeile ein. Dies kann einen Fehler verursachen.
Mit der Anweisung "path" können
unter dem Betriebssystem Windows
Schrägstriche (/) oder Backslashes (\) angegeben werden. Wenn Sie in der Anweisung path
Schrägstriche verwenden, müssen in der Antwortdatei doppelte Backslashes
verwendet werden, damit der Pfad ordnungsgemäß interpretiert wird.
Im Folgenden sehen Sie eine Beispielantwortdatei für die Operation create, in der
doppelte Backslashes verwendet werden:
createtemplatePath=C:\\WebSphere\\AppServer\\profileTemplates\\default
Bewährtes Verfahren: Verwenden Sie Schrägstriche, um das Risiko von Fehlern beim Wechsel zwischen Plattformen zu reduzieren.bprac
- Verwenden Sie beim Angeben von Werten keine Anführungszeichen (") am Anfang und Ende eines Wertes, selbst wenn der Wert Leerzeichen enthält.
- Wichtig: Der Befehl manageProfiles -restoreProfile wird nur unterstützt bei einer Sicherung desselben Fixpack-Levels.Stellt eine Profilsicherung wieder her. Dieser Parameter muss zusammen mit dem Parameter -backupFile verwendet werden. Beispiel:
manageprofiles(.bat)(.sh) -restoreProfile -backupFile DateinameGehen Sie zum Wiederherstellen eines Profils wie folgt vor: - Gibt den Namen des Servers an. Geben Sie diesen Parameter nur für Standard- und sichere Proxy-Serverschablonen an. Wenn Sie diesen Parameter für Standard- und sichere Proxy-Serverschablonen nicht angeben, wird der Standardservername "server1" für das Standardprofil und der Standardname "proxy1" für das sichere Proxy-Profil verwendet.
- Gibt den Typ des Verwaltungsprofils an. Geben Sie ADMIN_AGENT für einen Verwaltungsagentenserver an. Dieser Parameter ist erforderlich, wenn Sie ein Verwaltungsprofil erstellen.
Gibt die Benutzer-ID an, die während der Erstellung des
Linux-Service
verwendet wird, damit der Linux-Service
unter dieser Benutzer-ID ausgeführt wird.
Der Linux-Service wird ausgeführt,
sobald sich der Benutzer unter dieser ID anmeldet.- Legt eines der vorhandenen Profile als Standardprofil fest. Dieser Parameter muss zusammen mit dem Parameter
-profileName verwendet werden. Beispiel:
manageprofiles(.bat)(.sh) -setDefaultName -profileName Profilname - Gibt den definierten Namen des Stammsignierzertifikats an, das Sie beim Erstellen des Profils erstellen. Geben Sie den definierten Namen in Anführungszeichen an. Dieses persönliche Standardzertifikat befindet sich in der Keystore-Datei des Servers. Der Parameter -importSigningCertKS und der Parameter -signingCertDN schließen sich gegenseitig aus. Wenn Sie nicht explizit ein Stammsignierzertifikat erstellen oder importieren, wird standardmäßig eines erstellt. Weitere Informationen finden Sie in den Informationen zu den Parametern -signingCertValidityPeriod und -keyStorePassword.
- Ein optionaler Parameter, der angibt, wie lange (Jahre) das Stammsignierzertifikat gültig ist. Wenn Sie diesen Parameter nicht zusammen mit dem Parameter -signingCertDN angeben, ist das Stammsignierzertifikat 15 Jahre gültig.
- Gibt die Anfangsportnummer für die Generierung und Zuordnung aller Ports für das Profil an.
Portwerte
werden ausgehend vom -startingPort-Wert
sequenziell zugeordnet. Dabei werden Ports, die bereits im Gebrauch sind, ausgelassen. Das System erkennt Ports,
die derzeit im Gebrauch sind, und löst sie auf. Ferner bestimmt es die Portzuordnungen, um Portkonflikte zu vermeiden.
Portwerte werden fortlaufend zugeordnet, beginnend mit dem
durch den Parameter -startingPort angegebenen Wert. Verwenden Sie diesen Parameter nicht zusammen mit den Parametern -defaultPorts und -portsFile.
Während der Profilerstellung verwendet der Befehl manageprofiles eine automatisch generierte Gruppe empfohlener Ports, wenn Sie den Parameter -startingPort, den Parameter -defaultPorts oder den Parameter -portsFile nicht angeben. Die empfohlenen Portwerte können je nach Verfügbarkeit der Standardports von den Standardportwerten abweichen.
Achtung: Verwenden Sie diesen Parameter nicht, wenn Sie die Schablone für verwaltete Profile verwenden. - Gibt den Verzeichnispfad der Schablonendateien im Installationsstammverzeichnis an.
Das Verzeichnis profileTemplates enthält mehrere Verzeichnisse,
die den unterschiedlichen Profiltypen entsprechen und je nach installiertem Produkttyp variieren.
Die Profilverzeichnisse sind die Pfade, die Sie mit der Option
-templatePath angeben.
Sie können Profilschablonen außerhalb des Installationsstammverzeichnisses angeben, falls welche vorhanden sind.
Sie können einen relativen Pfad für den Parameter -templatePath angeben,
wenn die Profilschablonen relativ zum Verzeichnis Stammverzeichnis_des_Anwendungsservers/profileTemplates sind.
Andernfalls geben Sie den vollständig qualifizierten Schablonenpfad an. F
Der Standardschablonenpfad ist
Stammverzeichnis_des_Anwendungsservers/profileTemplates/default.
Sie können für den Parameter -templatePath einen relativen Pfad verwenden.
Der Pfad ist relativ zum aktuellen Arbeitsverzeichnis bzw. zum
Verzeichnis Stammverzeichnis_des_Anwendungsservers/profileTemplates
(in dieser Reihenfolge). Im folgenden Beispiel wird, basierend auf der Standardeinstellung für einen eigenständigen
Anwendungsserver, ein Profil erstellt: manageprofiles -create -profileName MyProfile -startingPort 10380Die verfügbaren Vorlagen sind unter Profilkonzepte beschrieben.
- Erweiterung ist die Möglichkeit, ein vorhandenes Profil mit einer Erweiterungsschablone zu ändern.
Wenn Sie die Erweiterung eines erweiterten Profils rückgängig machen möchten, müssen Sie die Parameter
"-unaugment" und "-profileName" angeben. Wenn mehrere Erweiterungen mit "manageprofiles" durchgeführt wurden und
Sie nur diese beiden Parameter angeben, um eine Profilerweiterung rückgängig zu machen, wird zuerst die zuletzt durchgeführte
Erweiterungsaktion rückgängig gemacht.
Wenn Sie die Erweiterung eines bestimmten erweiterten Profils rückgängig machen möchten, geben Sie zusätzlich den Parameter "-ignoreStack" mit dem Parameter "-templatePath" an. Normalerweise machen Sie die Erweiterung eines bestimmten Profils nicht rückgängig, weil Sie sicherstellen müssen, dass keine Profilschablonenabhängigkeiten verletzt werden.
Wenn Sie den
Parameter "-templatePath" verwenden, geben Sie den vollständig qualifizierten Pfad für den Parameter an.
Wenn Sie
den Parameter "-templatePath" verwenden, können Sie für den Parameter einen relativen Dateipfad angeben. Lesen Sie auch die Informationen zum Parameter "augment".
- Macht die Erweiterung aller Profile rückgängig, die mit einer bestimmten Erweiterungsschablone erweitert wurden.
Der Parameter "-templatePath" ist erforderlich, wenn der Parameter "-unaugmentAll" angegeben ist.
Wenn Sie den
Parameter "-templatePath" verwenden, geben Sie den vollständig qualifizierten Pfad für den Parameter an.
Wenn Sie
den Parameter "-templatePath" verwenden, können Sie für den Parameter einen relativen Dateipfad angeben. Geben Sie optional den Parameter "-unaugmentDependents" mit dem Parameter "-unaugmentAll" an, um die Erweiterung alle Profile rückgängig zu machen, die Voraussetzungen für das Profil sind, dessen Erweiterung rückgängig gemacht werden soll.
Anmerkung: Wenn Sie diesen Parameter verwenden und keine Profile mit den Profilschablonen erweitert haben, kann ein Fehler auftreten.Lesen Sie auch die Informationen zum Parameter "augment".
- Wird dieser Parameter angegeben, wird die Erweiterung aller erweiterten Profile aufgehoben gemacht, die Voraussetzungen für die Profile
sind, deren Erweiterung mit dem Parameter "-unaugmentAll" aufgehoben gemacht werden soll.
Wird der Parameter nicht angegeben, wird die Erweiterung dieser Profile nicht aufgehoben.
Geben Sie den Parameter "-unaugmentDependents" mit dem Parameter "-unaugmentAll" an.
- Überprüft, ob alle in der Profilregistry aufgeführten Profile im Dateisystem vorhanden sind. Fehlende Profile werden aus der Registry entfernt. Gibt eine Liste der fehlenden Profile zurück, die aus der Registry gelöscht wurden.
- Prüfen sie die Ports, um sicherzustellen, dass sie nicht reserviert oder im Gebrauch sind. Mit Hilfe dieses Parameters können Sie Ports ermitteln, die nicht im Gebrauch sind. Wenn festgestellt wird, dass ein Port im Gebrauch ist, wird die Profilerstellung gestoppt und eine Fehlernachricht ausgegeben. Sie können diesen Parameter jederzeit in der Befehlszeile absetzen. Es wird empfohlen, diesen Parameter zusammen mit dem Parameter –portsFile zu verwenden.
- Überprüft, ob alle in der Profilregistry aufgeführten Profile im Dateisystem vorhanden sind. Gibt eine Liste der fehlenden Profile zurück.
- Gibt an, ob Web-Server-Definitionen definiert werden sollen. Die gültigen Werte sind true und false. Der Standardwert für diesen Parameter ist false.
- Der Hostname des Servers. Der Standardwert für diesen Parameter ist der ausgeschriebene Hostname der lokalen Maschine.
- Der Installationspfad des Web-Servers, lokal oder fern. Der Standardwert für diesen Parameter ist vom Betriebssystem der lokalen Maschine und vom Wert des Parameters webServerType abhängig. Beispiel:
![[Windows]](../images/windows.gif)
webServerType=IHS: webServerInstallPath defaulted to “C:\Program Files\IBM\HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “C:\” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “C:\” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”![[Linux]](../images/linux.gif)
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”![[AIX]](../images/aixlogo.gif)
webServerType=IHS: webServerInstallPath defaulted to “/usr/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “?” webServerType=APACHE: webServerInstallPath defaulted to “?” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”![[HP-UX]](../images/hpux.gif)
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”![[Solaris]](../images/solaris.gif)
webServerType=IHS: webServerInstallPath defaulted to “/opt/IBM/HTTPServer” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “/opt/sun/webserver” webServerType=DOMINO: webServerInstallPath defaulted to “” webServerType=APACHE: webServerInstallPath defaulted to “” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n/a”![[IBM i]](../images/iseries.gif)
webServerType=IHS: webServerInstallPath defaulted to “n\a” webServerType=IIS: webServerInstallPath defaulted to “n\a” webServerType=SUNJAVASYSTEM: webServerInstallPath defaulted to “n\a” webServerType=DOMINO: webServerInstallPath defaulted to “n\a” webServerType=APACHE: webServerInstallPath defaulted to “n\a” webServerType=HTTPSERVER_ZOS: webServerInstallPath defaulted to “n\a”- Der Name des Web-Servers. Der Standardwert für diesen Parameter ist "webserver1".
- Das Betriebssystem, auf dem sich der Web-Server befindet. Die gültigen Werte sind windows, linux, solaris, aix, hpux, os390 und os400. Verwenden Sie diesen Parameter zusammen mit dem Parameter webServerType.
- Der Pfad der Plug-ins, die der Web-Server verwendet. Der Standardwert für diesen Parameter ist WAS_HOME/plugins.
- Gibt den Port an, über den auf den Web-Server zugegriffen wird. Der Standardwert für diesen Parameter ist 80.
- Der Typ des Web-Servers. Die gültigen Werte sind IHS, SUNJAVASYSTEM, IIS, DOMINO, APACHE und HTTPSERVER_ZOS. Verwenden Sie diesen Parameter zusammen mit dem Parameter webServerOS.
Der Eigneraccount des für das Profil erstellten Windows-Dienstes.
Die gültigen Werte sind "specifieduser" und "localsystem".
Wenn Sie den Wert "localsystem" angeben,
wird der Windows-Dienst
unter dem lokalen Account des Benutzers ausgeführt, der das Profil erstellt.
Der Standardwert für diesen Parameter ist "localsystem". Wenn der Wert "specifieduser" angegeben ist, ist der Parameter "winservicePassword" erforderlich. Der Parameter "winserviceUserName" verwendet standardmäßig den Benutzernamenswert der Umgebung, wenn kein Benutzername angegeben ist.
Der Wert kann true oder false sein. Geben Sie true an, wenn für den Serverprozess, der innerhalb des Profils erstellt wird,
ein Windows-Dienst eingerichtet werden soll.
Geben Sie false an, wenn kein Windows-Dienst eingerichtet werden soll. Der Standardwert für diesen Parameter ist false.
Wichtig: Mit einem angepassten Profil kann dieser Parameter nicht für die Erstellung eines Windows-Dienstes verwendet werden. Verwenden Sie stattdessen den Befehl WASService, um den Dienst gesondert zu erstellen.
Geben Sie das Kennwort für den angegebenen Benutzer oder den lokalen Account des Eigners des
Windows-Dienstes an.
Gültige Werte für den Starttyp: Weitere Informationen zu Windows-Diensten finden Sie im Artikel zum Befehl WASService.
Der Standardwert für diesen Parameter ist "automatic".
Geben Sie Ihre Benutzer-ID an, damit das Betriebssystem
Windows überprüfen kann,
ob Sie berechtigt sind, einen Windows-Dienst
zu erstellen. Ihre Benutzer-ID muss zur Administratorgruppe gehören und die folgenden erweiterten
Benutzerberechtigungen besitzen:
Wichtig: Wenn Sie ein Profil mit einem Windows-Dienst erstellen, für den ein Benutzer und ein Kennwort festgelegt sind, und der Benutzer ein Domänenbenutzer ist, müssen Sie, wie im folgenden Beispiel gezeigt, einen doppelten umgekehrten Schrägstrich verwenden:winServiceUserName=DOMAIN\\DOMAINUSER winServicePassword=DOMAINUSERPASSWORD
Einsatzszenario
Die folgenden Beispiele veranschaulichen die richtige Syntax. Setzen Sie die in den folgenden Beispielen gezeigten Befehle in einer Zeile ab. Die Befehle in den Beispielen sind aus Gründen der Übersichtlichkeit hier auf mehrere Zeilen verteilt.
Protokolle
Beispiel: Verwendung fortlaufender Standardportnummern ab einem bestimmten Ausgangspunkt
Der Befehl manageprofiles kann Portnummern basierend auf einem Anfangsportwert zuordnen. Mit dem Parameter -startingPort können Sie den Anfangsportwert über die Befehlszeile angeben. Der Befehl definiert fortlaufende Portnummern, die mit der Anfangsportnummer beginnen. Wenn ein Portwert in der Folge jedoch mit einer vorhandenen Portzuordnung in Konflikt steht, wird der nächste verfügbare Portwert verwendet.
Die Portnummern werden jedoch in beliebiger Reihenfolge zugeordnet. Welche Zuordnungen vorgenommen werden, ist nicht vorhersehbar.
Ports, die mit -startingPort 20002 erstellt werden, könnten wie im folgenden Beispiel zugeordnet werden:
WC_defaulthost=20002
WC_adminhost=20003
WC_defaulthost_secure=20004
WC_adminhost_secure=20005
BOOTSTRAP_ADDRESS=20006
SOAP_CONNECTOR_ADDRESS=20007
IPC_CONNECTOR_ADDRESS=20008
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20009
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20010
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20011
ORB_LISTENER_ADDRESS=20012
DCS_UNICAST_ADDRESS=20013
SIB_ENDPOINT_ADDRESS=20014
SIB_ENDPOINT_SECURE_ADDRESS=20015
SIB_MQ_ENDPOINT_ADDRESS=20016
SIB_MQ_ENDPOINT_SECURE_ADDRESS=20017
SIP_DEFAULTHOST=20018
SIP_DEFAULTHOST_SECURE=20019
Im folgenden Beispiel wird der Parameter startingPort des Befehls manageprofiles mit dem Inhalt aus dem vorherigen Beispiel verwendet, um Ports ab dem Anfangswert 20002 zu erstellen:
![[Windows]](../images/windows.gif)
manageprofiles.bat -create
-profileName shasti
-profilePath G:\shasti\WebSphere
-templatePath G:\shasti\WebSphere\profileTemplates\default
-nodeName W2K03
-cellName W2K03_Cell01
-hostName planetnt
-startingPort 20002
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
Stammverzeichnis_des_Anwendungsservers/bin/manageprofiles.sh -create
-profileName shasti
-profilePath Stammverzeichnis_des_Anwendungsservers/profiles/shasti
-templatePath Stammverzeichnis_des_Anwendungsservers/profileTemplates/default
-nodeName W2K03
-cellName W2K03_Cell01
-hostName planetnt
-startingPort 20002
![[IBM i]](../images/iseries.gif)
Stammverzeichnis_des_Anwendungsservers/bin/manageprofiles -create
-profileName shasti
-profilePath Stammverzeichnis_für_Benutzerdaten/profiles/shasti
-templatePath Stammverzeichnis_des_Anwendungsservers/profileTemplates/default
-nodeName W2K03
-cellName W2K03_Cell01
-hostName planetnt
-startingPort 20002
Beispiel: Vordefinierte Portnummern verwenden
Der Befehl manageprofiles gibt Empfehlungen für die Anfangsportwerte, wenn Sie die Portwerte nicht explizit definieren. Stattdessen können Sie vordefinierte Portwerte verwenden.
| Profil | Dateipfad |
|---|---|
| Anwendungsserver | Stammverzeichnis_des_Anwendungsservers/profileTemplates/default/actions/portsUpdate/portdef.props |
| Verwaltungsprofil für einen Verwaltungsagentenserver | Stammverzeichnis_des_Anwendungsservers/profileTemplates/management/actions/portsUpdate/adminagent.portdef.props |
WC_defaulthost=39080
WC_adminhost=39060
WC_defaulthost_secure=39443
WC_adminhost_secure=39043
BOOTSTRAP_ADDRESS=32809
SOAP_CONNECTOR_ADDRESS=38880
IPC_CONNECTOR_ADDRESS=39633
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=39401
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=39403
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=39402
ORB_LISTENER_ADDRESS=39100
DCS_UNICAST_ADDRESS=39353
SIB_ENDPOINT_ADDRESS=37276
SIB_ENDPOINT_SECURE_ADDRESS=37286
SIB_MQ_ENDPOINT_ADDRESS=35558
SIB_MQ_ENDPOINT_SECURE_ADDRESS=35578
SIP_DEFAULTHOST=35060
SIP_DEFAULTHOST_SECURE=35061
Nach der Ausführung des Befehls manageprofiles zum Erstellen Ihres Profils mit den von Ihnen definierten Portwerten wird eine Erfolgs- oder Misserfolgsnachricht ausgegeben.
Anmerkung: Wenn Sie ein Profil ordnungsgemäß erstellt haben, wird Ihnen in der Konsole eine entsprechende Nachricht angezeigt, in der Sie darauf hingewiesen werden, die Datei
AboutThisProfile.txt zu prüfen.
Es wird jedoch keine Datei AboutThisProfile.txt generiert, wenn Sie ein Clientprofil oder ein Plug-in-Profil unter IBM i erstellen. Der Befehl manageprofiles erstellt eine Kopie der aktuellen Datei portdefs.props im Verzeichnis Profilstammverzeichnis\properties.
Geben Sie einen der drei Portparameter (-startingPort, -defaultPorts oder -portsFile) mit dem Befehl manageprofiles an. Die drei Parameter schließen sich gegenseitig aus.
![[AIX HP-UX Solaris]](../images/unix.gif)
Referenzartikel