Verwenden Sie das Script
updatePorts.ant, um Ports in einem installierten Profil zu ändern.
Vorbereitende Schritte
Jede Profilschablone verfügt über ein eigenes Script
mit dem Namen updatePorts.ant.
Das Script
updatePorts.ant für Anwendungsserverprofile befindet sich im Verzeichnis
Stammverzeichnis_des_Anwendungsservers/profileTemplates/Schablonenname/actions.
Zur Verwendung des Scripts muss angegeben werden,
welches Profil aktualisiert werden soll.
Fehler vermeiden: Führen Sie dieses Script nur aus,
wenn das Profil nicht eingebunden ist und wenn die Konfiguration dieselbe Struktur hat wie zu dem Zeitpunkt, zu dem
das Profil erstellt wurde. Dieses Script eignet sich beispielsweise ideal, um die Ports für ein nicht eingebundenes Anwendungsserverprofil
zu ändern, nachdem Sie das Profil erstellt, aber bevor Sie seine Konfiguration geändert haben. Verwenden Sie für alle anderen Situationen die im Abschnitt
In der Datei serverindex.xml aufbewahrte Portnummern mit Scripting festlegen beschriebenen Techniken.
gotcha
Informationen zu diesem Vorgang
Befolgen Sie diese Prozedur, um
sich mit der Verwendung des Scripts
updatePorts.ant vertraut zu machen. Jeder Schritt ist eine Übung, die bewirkt, dass die Ports mittels
einer bestimmten vom Script
updatePorts.ant unterstützten Methode
neu zugeordnet werden.
Schauen Sie sich die Schritte für alle genannten Betriebssysteme an.
Die Unterschiede liegen hauptsächlich in der Erweiterung der Scriptdatei und der
Richtung der Verzeichnisbegrenzer. Bei Linux-Shell-Scripts (*.sh) und anderen Befehlen muss vor dem Befehl ./ hinzugefügt werden,
um dem Betriebssystem mitzuteilen, dass sich der Befehl im aktuellen Arbeitsverzeichnis befindet.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Vorgehensweise
Dem Profil AppSrv01 Ports zuordnen, die nicht in Konflikt stehen. Das ANT-Script ordnet standardmäßig Ports zu, die nicht in Konflikt zueinander
stehen. Es sind keine speziellen Argumente erforderlich. Geben Sie die vollständig qualifizierten Verzeichnispfade, den Profilnamen, den eindeutigen Knotennamen,
und den eindeutigen Zellennamen an. Setzen Sie anschließend den Befehl ab.
- Erstellen Sie die in ISO8859-1 codierte Java™-Eigenschaftendatei, um dem Anwendungsserverprofil Portwerte zuzuordnen,
die nicht in Konflikt stehen.
In diesem Beispiel wird davon ausgegangen, dass auf dem System das Betriebssystem Linux ausgeführt wird
und dass die Eigenschaftendatei /TMP/was_props/appserver.props mit folgendem Inhalt erstellt wird.
WAS_HOME=/opt/IBM/WebSphere/AppServer
was.install.root=/opt/IBM/WebSphere/AppServer
profileName=AppSrv01
profilePath=/opt/IBM/WebSphere/AppServer/profiles/AppSrv01
templatePath=/opt/IBM/WebSphere/AppServer/profileTemplates/default
nodeName=appserver_Knoten01
cellName=appserver_Zelle01
hostName=meinserver.ibm.com
- Öffnen Sie ein Fenster mit Befehls-Shell.
- Wechseln Sie in das Verzeichnis /opt/IBM/WebSphere/AppServer/bin.
cd /opt/IBM/WebSphere/AppServer/bin
(Wenn das Produkt in einem vom Standard abweichenden
Verzeichnis installiert ist, wechseln Sie in das Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin.)
- Setzen Sie den Befehl ab.
./ws_ant.sh -propertyfile /TMP/was_props/appserver.props \
-file /opt/IBM/WebSphere/AppServer/profileTemplates/default/actions/updatePorts.ant
- Öffnen Sie die Administrationskonsole, und
zeigen Sie die geänderten Portzuordnungen an.
Zum Anzeigen der Portzuordnungen klicken Sie auf .
- Führen Sie das Script erneut aus, und zeigen Sie die Ports an. Sind es noch dieselben wie vorher?
Die dynamisch zugeordneten Portwerte, die als Ergebnis angezeigt werden,
gelten für alle Ports, die derzeit dem Profil AppSrv01
zugeordnet sind, für jeden Server, der in der Datei
serverindex.xml für den Profilknotennamen aufgelistet ist. Jeder Port erhält einen neuen Wert, der keine Konflikte verursacht. Es wird keine der alten Portzuordnungen verwendet,
weil diese Portwerte zum Zeitpunkt der Neuzuordnung verwendet wurden.
Dem Profil AppSrv02 Standardports zuordnen. Das ANT-Script ordnet standardmäßig Ports zu, die nicht in Konflikt zueinander
stehen. Das spezielle Argument defaultPorts=true ist erforderlich. Geben Sie die vollständig qualifizierten Verzeichnispfade, den Profilnamen, den eindeutigen Knotennamen,
und den eindeutigen Zellennamen an. Setzen Sie anschließend den Befehl ab.
- Erstellen Sie die in ISO8859-1 codierte Java-Eigenschaftendatei, um dem Anwendungsserverprofil Standardportwerte zuzuordnen.
In diesem Beispiel wird davon ausgegangen, dass auf dem System das Betriebssystem Windows ausgeführt wird und
dass die Eigenschaftendatei C:\temp\was_props\appserver.props mit dem folgenden Inhalt erstellt wird.
WAS_HOME="C:/Programme/IBM/WebSphere/AppServer"
was.install.root="C:/Programme/IBM/WebSphere/AppServer"
profileName=AppSrv02
profilePath="C:/Programme/IBM/WebSphere/AppServer/profiles/AppSrv02"
templatePath="C:/Programme/IBM/WebSphere/AppServer/profileTemplates/default"
nodeName=appserver_Knoten02
cellName=appserver_Zelle02
hostName=meinserver2.ibm.com
defaultPorts=true
Ein Windows-Pfadname mit Leerzeichen muss in Anführungszeichen gesetzt werden. Falls keine Leerzeichen im Pfad sind, dürfen keine Anführungszeichen verwendet werden.
- Öffnen Sie ein DOS-Befehlsfenster.
- Wechseln Sie in das Verzeichnis
C:\Programme\IBM\WebSphere\AppServer\bin.
cd "C:\Programme\IBM\WebSphere\AppServer\bin"
(Wenn das Produkt in einem vom Standard abweichenden
Verzeichnis installiert ist, wechseln Sie in das Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin.)
- Setzen Sie den Befehl ab.
ws_ant.bat -propertyfile C:\temp\was_props\appserver.props
-file "C:\Programme\IBM\WebSphere\AppServer\profileTemplates\default\actions\updatePorts.ant"
- Öffnen Sie die Administrationskonsole, und
zeigen Sie die geänderten Portzuordnungen an.
Zum Anzeigen der Portzuordnungen klicken Sie auf .
- Führen Sie das Script erneut aus, und zeigen Sie die Ports an. Sind es noch dieselben wie vorher?
Die zugeordneten Portwerte, die als Ergebnis angezeigt werden,
sind dieselben wie vorher, weil es die Standardwerte sind. Mit dieser Methode werden Konflikte durch Portzuordnungen nicht aufgelöst. Rufen Sie die Datei C:\Programme\IBM\WebSphere\AppServer\profiles\AppSrv02\config\cells\appserver_cell02\nodes\appserver_node02\serverindex.xml auf, um
alle Portzuordnungen für ein Profil anzuzeigen.
Verwenden Sie den Befehl netstat -a, um alle auf der Maschine
verwendeten Ports anzuzeigen.
Dem Profil AppSrv03 Ports beginnend mit 2050 zuordnen. Das ANT-Script ordnet standardmäßig Ports zu, die nicht in Konflikt zueinander
stehen. Das spezielle Argument startingPort=2050 ist erforderlich. Geben Sie die vollständig qualifizierten Verzeichnispfade, den Profilnamen, den eindeutigen Knotennamen,
und den eindeutigen Zellennamen an. Setzen Sie anschließend den Befehl ab.
- Erstellen Sie die in ISO8859-1 codierte Java-Eigenschaftendatei, um dem Anwendungsserverprofil Standardportwerte zuzuordnen.
In diesem Beispiel wird davon ausgegangen, dass auf dem System das Betriebssystem AIX ausgeführt wird
und dass die Eigenschaftendatei /usr/tmp/was_props/appserver.props mit folgendem Inhalt erstellt wird.
WAS_HOME=/usr/IBM/WebSphere/AppServer
was.install.root=/usr/IBM/WebSphere/AppServer
profileName=AppSrv03
profilePath=/usr/IBM/WebSphere/AppServer/profiles/AppSrv03"
templatePath=/usr/IBM/WebSphere/AppServer/profileTemplates/default"
nodeName=appserver_Knoten03
cellName=appserver_Zelle03
hostName=meinserver3.ibm.com
startingPort=2050
- Öffnen Sie ein Fenster mit Befehls-Shell.
- Wechseln Sie in das Verzeichnis /usr/IBM/WebSphere/AppServer/bin.
cd /usr/IBM/WebSphere/AppServer/bin
(Wenn das Produkt in einem vom Standard abweichenden
Verzeichnis installiert ist, wechseln Sie in das Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin.)
- Setzen Sie den Befehl ab.
./ws_ant.sh -propertyfile /usr/tmp/was_props/appserver.props \
-file /usr/IBM/WebSphere/AppServer/profileTemplates/default/actions/updatePorts.ant
- Öffnen Sie die Administrationskonsole, und
zeigen Sie die geänderten Portzuordnungen an.
Zum Anzeigen der Portzuordnungen klicken Sie auf .
- Führen Sie das Script erneut aus, und zeigen Sie die Ports an. Sind es noch dieselben wie vorher?
Wenn Sie die Option
-startingPort verwenden, werden als Ergebnis jedes Mal dieselben dynamisch zugeordneten
Portwerte angezeigt, weil das ANT-Script Portwerte, die keine Konflikte verursachen, beginnend mit der
startingPort-Nummer (in diesem Fall Port 2050) zuordnet. Mit dieser Methode können Konflikte durch Portzuordnungen aufgelöst werden.
![[HP-UX]](../images/hpux.gif)
Verwenden Sie eine Eigenschaftendatei der Portdefinition für die Zuordnung von
Ports zum Profil AppSrv04. Das ANT-Script ordnet standardmäßig Ports zu, die nicht in Konflikt zueinander
stehen. Das spezielle Argument portsFile=/opt/was/portdefs.our_appsrv_ex.props ist erforderlich. Geben Sie die vollständig qualifizierten Verzeichnispfade, den Profilnamen, den eindeutigen Knotennamen,
und den eindeutigen Zellennamen an. Setzen Sie anschließend den Befehl ab.
- Erstellen Sie die in ISO8859-1 codierte Java-Eigenschaftendatei, um dem Anwendungsserverprofil Portwerte zuzuordnen,
die nicht in Konflikt stehen.
Nehmen Sie an, die Eigenschaftendatei
/opt/was/portdefs.our_appsrv_ex.props wird mit folgendem Inhalt erstellt:
WC_defaulthost=19080
WC_adminhost=19060
WC_defaulthost_secure=19443
WC_adminhost_secure=19043
BOOTSTRAP_ADDRESS=22809
SOAP_CONNECTOR_ADDRESS=28880
IPC_CONNECTOR_ADDRESS=9633
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=29401
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=29403
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=29402
ORB_LISTENER_ADDRESS=39100
DCS_UNICAST_ADDRESS=39353
SIB_ENDPOINT_ADDRESS=37276
SIB_ENDPOINT_SECURE_ADDRESS=37286
SIB_MQ_ENDPOINT_ADDRESS=45558
SIB_MQ_ENDPOINT_SECURE_ADDRESS=45578
SIP_DEFAULTHOST=45060
SIP_DEFAULTHOST_SECURE=45061
Anmerkung: Die in der Eigenschaftendatei der Portdefinition
verwendeten Ports sollten den Schablonentyp angeben.
Die Ports in diesem Beispiel entsprechen dem Standardschablonentyp und können bei Verwendung anderer
Schablonentypen abweichen. Die Verwaltungsschablone hat drei verschiedene Dateien "portdef.props", eine für jeden
Servertyp.
Es gibt die Dateien "adminagent.portdef.props",
"dmgr.portdef.props" und "jmgr.portdef.props".
Sie können entsprechend der im Schablonenverzeichnis (template)
enthaltenen Datei
portdef.props modelliert sein.
In diesem Beispiel wird davon ausgegangen, dass die
Eigenschaftendatei
/TMP/was_props/appserver.props mit folgendem Inhalt
erstellt wird:
WAS_HOME=/opt/IBM/WebSphere/AppServer
was.install.root=/opt/IBM/WebSphere/AppServer
profileName=AppSrv04
profilePath=/opt/IBM/WebSphere/AppServer/profiles/AppSrv04
templatePath=/opt/IBM/WebSphere/AppServer/profileTemplates/default
nodeName=appserver_Knoten04
cellName=appserver_Zelle04
hostName=meinserver4.ibm.com
portsFile=/opt/was/portdefs.our_appsrv_ex.props
- Öffnen Sie ein Fenster mit Befehls-Shell.
- Wechseln Sie in das Verzeichnis /opt/IBM/WebSphere/AppServer/bin.
cd /opt/IBM/WebSphere/AppServer/bin
(Wenn das Produkt in einem vom Standard abweichenden
Verzeichnis installiert ist, wechseln Sie in das Verzeichnis Stammverzeichnis_des_Anwendungsservers/bin.)
- Setzen Sie den Befehl ab.
./ws_ant.sh -propertyfile /TMP/was_props/appserver.props \
-file /opt/IBM/WebSphere/AppServer/profileTemplates/default/actions/updatePorts.ant
- Öffnen Sie die Administrationskonsole, und
zeigen Sie die geänderten Portzuordnungen an.
Zum Anzeigen der Portzuordnungen klicken Sie auf .
- Führen Sie das Script erneut aus, und zeigen Sie die Ports an. Sind es noch dieselben wie vorher?
Die zugeordneten Portwerte, die als Ergebnis angezeigt werden, stammen aus
einer props-Datei. Daher ändern sich die Werte nicht. Mit dieser Methode werden Konflikte durch Portzuordnungen nicht aufgelöst.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Ergebnisse
Das Ergebnis dieser Prozedur sind vier verschiedene Methoden der Portzuordnung mit dem Script
updatePorts.ant.