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.
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
Je nach Operation, die Sie mit dem Befehl manageprofiles ausführen möchten, müssen Sie einen oder mehrere der folgenden Parameter angeben. Das Befehlszeilentool prüft, ob die erforderlichen Parameter angegeben wurden und ob die für diese Parameter angegebenen Werte gültig sind. Geben Sie die Namen der Parameter in der richtigen Groß-/Kleinschreibung an, da das Befehlszeilentool die Groß-/Kleinschreibung der Parameternamen nicht validiert. Sie können falsche Ergebnisse erhalten, wenn Sie die Namen nicht richtig eingeben.
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.
- Gibt den Knotennamen des Anwendungsservers an, den Sie in die Zelle einbinden möchten. Geben Sie diesen Parameter an, wenn Sie die Deployment-Manager-Komponente der Zelle erstellen und wenn Sie die Anwendungsserverkomponente der Zelle erstellen.
- 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 Network Deployment 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.
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. Beispiel:manageprofiles -augment -profileName Profilname -templatePath Schablonenpfad
Lesen 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_Sicherungsdatei
Wenn 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: Verwenden Sie auch dann einen eindeutigen Namen, wenn Sie das angepasste Profil oder das eigenständige Profil in eine Deployment Manager-Zelle einbinden möchten. Damit der Knoten in die Deployment-Manager-Zelle eingebunden werden kann, sind eindeutige Zellennamen erforderlich. Ein Zellenname muss in allen Fällen, in denen das Produkt auf derselben physischen Maschine oder in demselben Maschinencluster, wie z. B. einem Sysplex, ausgeführt wird, eindeutig sein. Außerdem muss ein Zellenname eindeutig sein, wenn die Netzkonnektivität zwischen Entitäten erforderlich ist, wie z. B. zwischen den Zellen oder zwischen einem Client und den Zellen, mit denen der Client kommunizieren muss. Zellennamen müssen auch eindeutig sein, wenn ihre Namespaces zusammengefasst werden sollen. Wenn die Zellennamen nicht eindeutig sind, können Symptome wie Fehler des Typs "javax.naming.NameNotFoundException" auftreten. In diesem Fall müssen Sie eindeutig benannte Zellen erstellen.gotcha
Dieser Parameter ist optional. Falls Sie den Parameter nicht angeben, wird ein Standardzellenname zugeordnet.
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.
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.
Fehler vermeiden: Wenn Sie einen alten migrierten Knoten löschen möchten, fahren Sie den neuen migrierten Deployment Manager herunter, bevor Sie den alten Knoten löschen. Auf diese Weise ist sichergestellt, dass der neue migrierte Knoten nicht versehentlich aus der neuen migrierten Zelle gelöscht wird. gotcha
- Löscht alle registrierten Profile.
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.
- Wenn Sie einen Knoten einbinden, geben Sie einen gültigen Benutzernamen für den Deployment Manager an, falls die Verwaltungssicherheit im Deployment Manager aktiviert ist. Verwenden Sie diesen Parameter mit den Parametern "-dmgrAdminUserName" und "-federateLater".
- Wenn Sie einen Knoten einbinden, geben Sie einen gültigen Benutzernamen für den Deployment Manager an, falls die Verwaltungssicherheit im Deployment Manager aktiviert ist. Verwenden Sie diesen Parameter mit den Parametern "-dmgrAdminPassword" und "-federateLater".
- Bezeichnet die Maschine, auf der der Deployment Manager ausgeführt wird. Geben Sie diesen Parameter und den
Parameter dmgrPort an, um ein angepasstes Profil bei der Erstellung einzubinden.
Der Hostname kann der lange oder kurze DNS-Name oder die IP-Adresse der Deployment-Manager-Maschine sein.
Dieser optionale Parameter weist den Befehl manageprofiles an, den angepassten Knoten in die Deployment-Manager-Zelle einzubinden, wenn er über den verwalteten Parameter "-templatePath" das angepasste Profil erstellt. Beim Erstellen eines Deployment-Manager-Profils oder eines Anwendungsserverprofils wird der Parameter "-dmgrHost" ignoriert.
Wenn Sie einen angepassten Knoten einbinden, obwohl der Deployment Manager nicht ausgeführt wird bzw. aufgrund der aktivierten Sicherheit oder aus einem anderen Grund nicht verfügbar ist, zeigt der Installationsanzeiger in den Protokollen mit INSTCONFFAIL ein vollständiges Scheitern der Installation an. Das daraus resultierende angepasste Profil ist unbrauchbar. Bevor Sie ein weiteres angepasstes Profil mit demselben Profilnamen erstellen, müssen Sie das angepasste Profilverzeichnis aus dem Profilrepository (dem Installationsstammverzeichnis für Profile) verschieben.
Falls Sie die Sicherheit aktiviert oder den Standard-JMX-Connector-Typ geändert haben, ist keine Einbindung mit dem Befehl manageprofiles möglich. Verwenden Sie stattdessen den Befehl addNode.
Der Standardwert für diesen Parameter ist "localhost". Der Wert für diesen Parameter muss ein ordnungsgemäß formatierter Hostname sein und darf weder Leerzeichen noch unzulässige Zeichen wie die folgenden enthalten: *, ?, ", <, >, ,, /, \, | usw. Wenn der Parameter dmgrPort angegeben wird, muss eine Verbindung zum Deployment Manager verfügbar sein.
- Bezeichnet den SOAP-Port des Deployment Manager. Geben Sie diesen Parameter und den
Parameter dmgrHost an, um ein angepasstes Profil bei der Erstellung einzubinden. Der Deployment Manager muss aktiv
und erreichbar sein.
Falls Sie die Sicherheit aktiviert oder den Standard-JMX-Connector-Typ (Java™ Management Extensions) geändert haben, ist keine Einbindung mit dem Befehl manageprofiles möglich. Verwenden Sie stattdessen den Befehl addNode.
Der Standardwert für diesen Parameter ist 8879. Der Port, den Sie angeben, muss eine positive ganze Zahl sein. Außerdem muss eine Verbindung zum Deployment Manager verfügbar sein, wenn Sie den Parameter dmgrHost verwenden.
- Gibt den Profilpfad zur Deployment-Manager-Komponente der Zelle an. Geben Sie diesen Parameter an, wenn Sie die Anwendungsserverkomponente der Zelle erstellen.
- 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.
Sie können den Parameter "-enableAdminSecurity" nicht zum Aktivieren der Verwaltungssicherheit für ein angepasstes Profil verwenden. Zum Aktivieren der Sicherheit für ein angepasstes Profil muss das angepasste Profil in einen Deployment Manager eingebunden werden. Die Verwaltungssicherheit muss für den Deployment Manager aktiviert sein, damit die Sicherheit für den das gebundene angepasste Profil aktiviert werden kann.
- Gibt an, ob das verwaltete Profil während der Profilerstellung eingebunden wird oder ob Sie das Profil später mit dem Befehl addNode einbinden. Wenn die Parameter dmgrHost, dmgrPort, dmgrAdminUserName und dmgrAdminPassword keine Werte haben, ist der Standardwert für diesen Parameter true. Die gültigen Werte sind true und false.
- 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. bprac
Wenn 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.
- Definiert eine Gruppe von Ports, wenn ein Profil mit einer Zellenschablone erstellt wird. Wenn Sie diese Option angeben, können Sie weder die Option "-nodePortsFile" noch die Option "nodeStartingPort" angeben.
- Gibt den Namen für den Knoten an, der mit dem neuen Profil erstellt wird.
Verwendet einen eindeutigen Wert in der Zelle oder auf der Maschine.
Jedes Profil, dass die Binärdateien des Produkts mit anderen Profilen gemeinsam nutzt, muss einen eindeutigen Knotennamen
haben. Die folgenden Standardknotennamen sind vorhanden:
Der Wert für diesen Parameter darf keine Leerzeichen und keine ungültigen Zeichen wie die folgenden enthalten: *, ?, ", <, >, ,, /, \, | usw.
- Gibt die Ports für die Knotenkomponente der zu erstellenden Zelle an. Wenn Sie diese Option angeben, können Sie weder die Option "-nodeDefaultPorts" noch die Option "nodeStartingPort" angeben.
- Gibt den Profilpfad der Knotenkomponente der Zelle an. Geben Sie diesen Parameter an, wenn Sie die Deployment-Manager-Komponente der Zelle erstellen.
- 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. Geben Sie den vollständigen Pfad an, um eine Einschränkung beim Ant-Scripting zu umgehen, die beim Einbinden des Profils in eine Zelle einen Fehler verursachen kann. Beispiel:
-profilePath Profilstammverzeichnis
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/Profilname
Anmerkung: 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.
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,myOptionalAction2
Beachten 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.
- 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 Dateiname
Gehen Sie zum Wiederherstellen eines Profils wie folgt vor: - Gibt die Anfangssicherheitsstufe für den sicheren Proxy-Server an. Die gültigen Werte sind low, medium und high. Der Standardwert ist high. Die Sicherheitsstufe basiert auf den Startberechtigungen des Benutzers, Routing-Aspekten, Verwaltungsoptionen und der Fehlerbehandlung. Sie können Ihre Sicherheitseinstellungen ändern, nachdem Sie das Profil für den sicheren Proxy-Server erstellt haben.
- 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 DEPLOYMENT_MANAGER für einen Deployment-Manager-Server, ADMIN_AGENT für einen Verwaltungsagentenserver und JOB_MANAGER für einen Job-Manager-Server an. Dieser Parameter ist erforderlich, wenn Sie ein Verwaltungsprofil erstellen.
- 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 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 die Protokolle an, die der sichere Proxy-Server verwenden kann, um Anforderungen weiterzuleiten. Die gültigen Werte sind SIP, HTTP und HTTP,SIP.
- 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. 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 10380
Die 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, 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, 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:
-
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.
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: Deployment-Manager-Profile erstellen
Nach der Installation der Basisproduktdateien können Sie ein Deployment-Manager-Profil erstellen. Der Deployment-Manager stellt für eine logische Gruppe von Anwendungsservern auf einer oder mehreren Maschinen eine einzige Verwaltungsschnittstelle bereit. Verwenden Sie zum Erstellen eines Deployment-Manager-Profils den Befehl "manageprofiles.sh -create".
Erstellen Sie wie folgt ein Deployment-Manager-Profil mit dem Namen shasti:
manageprofiles -create
-profileName shasti
-profilePath /shasti/WebSphere
-templatePath /opt/IBM/WebSphere/AppServer/profileTemplates/management
-serverType DEPLOYMENT_MANAGER
-cellName cell1
-hostName planetaix
-nodeName dmgr1
Wenn Sie eine der Portoptionen während der Profilerstellung nicht angeben, wird eine empfohlene Gruppe von Portwerten verwendet. Diese Ports werden von einem Algorithmus zur Behebung von Portkonflikten bestimmt. Die empfohlene Gruppe von Ports darf keine Konflikte hervorrufen. Wenn Sie die IBM Standardports verwenden möchten, verwenden Sie beim Erstellen des Profils die Option "-defaultPorts".
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
OVERLAY_UDP_LISTENER_ADDRESS=20020
OVERLAY_TCP_LISTENER_ADDRESS=20021
WC_defaulthost=20002
WC_defaulthost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
DCS_UNICAST_ADDRESS=20011
SIB_ENDPOINT_ADDRESS=20012
SIB_ENDPOINT_SECURE_ADDRESS=20013
SIB_MQ_ENDPOINT_ADDRESS=20014
SIB_MQ_ENDPOINT_SECURE_ADDRESS=20015
SIP_DEFAULTHOST=20016
SIP_DEFAULTHOST_SECURE=20017
NODE_MULTICAST_DISCOVERY_ADDRESS=20018
NODE_IPV6_MULTICAST_DISCOVERY_ADDRESS=20019
NODE_DISCOVERY_ADDRESS=20020
NODE_DCS_UNICAST_ADDRESS=20021
NODE_BOOTSTRAP_ADDRESS=20022
NODE_SOAP_CONNECTOR_ADDRESS=20023
NODE_ORB_LISTENER_ADDRESS=20024
NODE_SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20025
NODE_CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20026
NODE_CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20027
NODE_IPC_CONNECTOR_ADDRESS=20028OVERLAY_UDP_LISTENER_ADDRESS=20029
OVERLAY_TCP_LISTENER_ADDRESS=20030
NODE_XDAGENT_PORT=20031
NODE_OVERLAY_UDP_LISTENER_ADDRESS=20032
NODE_OVERLAY_TCP_LISTENER_ADDRESS=20033
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
CELL_DISCOVERY_ADDRESS=20011
DCS_UNICAST_ADDRESS=20012
XDAGENT_PORT=20013
OVERLAY_UDP_LISTENER_ADDRESS=20014
OVERLAY_TCP_LISTENER_ADDRESS=20015
STATUS_LISTENER_ADDRESS=20016
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
CELL_DISCOVERY_ADDRESS=20011
DCS_UNICAST_ADDRESS=20012
DataPowerMgr_inbound_secure=20013
XDAGENT_PORT=20014
OVERLAY_UDP_LISTENER_ADDRESS=20015
OVERLAY_TCP_LISTENER_ADDRESS=20016
STATUS_LISTENER_ADDRESS=20017
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
STATUS_LISTENER_ADDRESS=20011
WC_adminhost=20002
WC_adminhost_secure=20003
BOOTSTRAP_ADDRESS=20004
SOAP_CONNECTOR_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=20007
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=20008
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=20009
ORB_LISTENER_ADDRESS=20010
PROXY_HTTP_ADDRESS=20002
PROXY_HTTPS_ADDRESS=20003
PROXY_SIP_ADDRESS=20004
PROXY_SIPS_ADDRESS=20005
IPC_CONNECTOR_ADDRESS=20006
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:
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: Zellenprofile erstellen
Wenn Sie das Zellenprofil mit dem Befehl manageprofiles erstellen, müssen Sie das Zellenverwaltungsprofil für einen Deployment-Manager-Server und das Zellenknotenprofil mit zwei unterschiedlichen Befehlszeilenaufrufen von manageprofiles erstellen. Die Kombination dieser beiden Profile ist das Zellenprofil.
Für das Erstellen des Zellenprofils werden zwei Schablonen verwendet: cell_dmgr und cell_node. Die Schablonen sind verknüpft, und einige Erstellungsparameter in diesen beiden Aufrufen müssen übereinstimmen. Vergewissern Sie sich, dass die Aufrufe einander entsprechen.
Über die Befehlszeile können Sie die beiden Hälften der Zelle in beliebiger Reihenfolge und zu beliebigen Zeitpunkten erstellen. Es empfiehlt sich jedoch, den Deployment-Manager-Teil des Profils zuerst zu erstellen. Nachdem Sie die Zelle erstellt haben, enthält die Zelle einen Deployment Manager und einen eingebundenen Knoten. Der Deployment-Manager-Teil und der Knotenteil werden in unterschiedlichen Verzeichnissen erstellt.
Für jedes der beiden Profile, die Sie erstellen, können Sie mit dem Parameter -profilePath den vollständig qualifizierten Pfad des Profils angeben. Wenn Sie den Parameter nicht angeben, basiert der Standardwert für jeden Profilpfad auf dem Verzeichnis, dem Profilunterverzeichnis und dem Namen des Profils.
Die beiden Schablonen, aus denen sich ein Zellenprofil zusammensetzt, haben Abhängigkeiten voneinander, die erfordern, dass einige Parameterwerte der beiden Erstellungsaufrufe übereinstimmen. Zum Erstellen einer voll funktionsfähigen Zelle müssen die Werte der Parameter -nodeProfilePath, -cellName, -appServerNodeName und -nodeName des Profils cell_dmgr und des Profils cell_node übereinstimmen. Was die Ports, insbesondere dynamisch zugeordnete Ports, anbelangt, muss beim Erstellen der zweiten Hälfte der Zelle auf die Ports verwiesen werden, die in der ersten Hälfte der Zelle verwendet werden. Verwenden Sie die Argumente -portsFile und -nodePortsFile mit Referenzen auf die folgenden Dateien des Profils, das die erste Hälfte der Zelle darstellt:
Verwenden Sie die folgenden Befehle, um ausführliche Hilfe zum Erstellen eines Zellenprofils anzufordern:
Stammverzeichnis_des_Anwendungsservers/bin/manageprofiles -create
-templatePath
Stammverzeichnis_des_Anwendungsservers/profileTemplates/cell/dmgr
-help
oder
Stammverzeichnis_des_Anwendungsservers/bin/manageprofiles -create
-templatePath
Stammverzeichnis_des_Anwendungsservers/profileTemplates/cell/default
-help
Die Ausgabe des Parameters -help gibt an, welche Parameter beim Erstellen des Deployment-Manager-Profils und des Knotenprofils für die Zelle erforderlich und welche optional sind.
Nach der Erstellung der Deployment-Manager-Komponente und der Knotenkomponente des Zellenprofils muss eine Synchronisation zwischen den beiden Servern durchgeführt werden. Standardmäßig wird die Synchronisation zwischen den beiden Servern in einem angegebenen Intervall automatisch durchgeführt. Wenn die Synchronisation jedoch inaktiviert ist, das Intervall zu lang ist oder ein Problem auftritt, dass die rechtzeitige Durchführung der Synchronisation verhindert, müssen Sie den Befehl syncNode ausführen, um den Deployment Manager und den Knoten zu synchronisieren.
Sie müssen den Parameter portsFile oder den Parameter nodePortsFile und den Parameter startingPort oder den Parameter nodeStartingPort verwenden.
Wenn Sie den Befehl manageprofiles verwenden, können Sie das Profil auswählen, das Sie als Standardprofil verwenden möchten.
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 |
Zelle - Anwendungsserverkomponente | Stammverzeichnis_des_Anwendungsservers/profileTemplates/cell/dmgr/actions/portsUpdate/nodeportdef.props |
Zelle - Deployment-Manager-Komponente | Stammverzeichnis_des_Anwendungsservers/profileTemplates/cell/dmgr/actions/portsUpdate/portdef.props |
Angepasst | Stammverzeichnis_des_Anwendungsservers/profileTemplates/managed/actions/portsUpdate/portdef.props |
Verwaltungsprofil für einen Deployment-Manager-Server | Stammverzeichnis_des_Anwendungsservers/profileTemplates/management/actions/portsUpdate/dmgr.portdef.props |
Verwaltungsprofil für einen Verwaltungsagentenserver | Stammverzeichnis_des_Anwendungsservers/profileTemplates/management/actions/portsUpdate/adminagent.portdef.props |
Verwaltungsprofil für einen Job-Manager-Server | Stammverzeichnis_des_Anwendungsservers/profileTemplates/management/actions/portsUpdate/jmgr.portdef.props |
Sicherer Proxy | Stammverzeichnis_des_Anwendungsservers/profileTemplates/secureproxy/actions/portsUpdate/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
OVERLAY_UDP_LISTENER_ADDRESS=35062
OVERLAY_TCP_LISTENER_ADDRESS=35063
STATUS_LISTENER_ADDRESS=35064
Nach der Ausführung des Befehls manageprofiles zum Erstellen Ihres Profils mit den von Ihnen definierten Portwerten wird eine Erfolgs- oder Misserfolgsnachricht ausgegeben.
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.