Utilisez le script updatePorts.ant pour modifier des ports
dans un profil installé.
Avant de commencer
Chaque modèle de profile possède son propre script updatePorts.ant.
Le script updatePorts.ant des profils de serveur d'applications est dans le répertoire racine_serveur_app/profileTemplates/nom_modèle/actions. Pour utiliser le script,
vous devez identifier quel est le profil à mettre à jour.
Eviter les incidents: Vous ne devez exécuter ce script
que si le profil n'est pas fédéré et que si la configuration
a conservé la structure qu'elle avait lors de la création du profil. Ainsi, ce script est parfaitement indiqué
lorsqu'on veut modifier les ports d'un profil non fédéré de serveur d'applications
après avoir créé le profil, mais avant de modifier sa configuration. Dans tous les autres cas de figure, utilisez les techniques décrites dans
Définition à l'aide de scripts des numéros de ports conservés dans le fichier serverindex.xml.
gotcha
Pourquoi et quand exécuter cette tâche
Utilisez la procédure suivante pour vous familiariser avec l'utilisation du script updatePorts.ant. Chaque étape est un exercice de réaffectation de ports à l'aide d'une méthode particulière
prise en charge par le script updatePorts.ant.
Regardez les
étapes de tous les systèmes d'exploitation mentionnés. Les différences sont principalement
l'extension du fichier script et le sens des délimiteurs de répertoire. Par exemple, les scripts shell
Linux
(*.sh) et les autres commandes nécessitent un
./ avant la commande pour indiquer au système
d'exploitation qu'elle se trouve dans le répertoire de travail en
cours.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Procédure
Affectez des ports n'entrant pas en conflit au profil AppSrv01. Par défaut, le script ANT affecte des ports n'entrant pas en conflit. Aucun
arguments spécial n'est nécessaire. Identifiez les chemins d'accès complets, le nom de profil,
le nom de noeud unique et le nom de cellule unique. Puis exécutez la commande.
- Créez le fichier de propriétés
Java™
codé en codage de fichier ISO8859-1 pour affecter au profil de
serveur d'applications des valeurs de port non conflictuelles.
Pour cet exemple, supposons que le système est un système
d'exploitation
Linux
et que vous créez le fichier de propriétés
/TMP/was_props/appserver.props suivant.
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_node01
cellName=appserver_cell01
hostName=myserver.ibm.com
- Ouvrez une fenêtre de shell de commande.
- Accédez au répertoire /opt/IBM/WebSphere/AppServer/bin.
cd /opt/IBM/WebSphere/AppServer/bin
Si le
produit est installé dans un répertoire autre que celui par défaut, accédez au
répertoire
racine_serveur_app/bin.
- Emettez la commande.
./ws_ant.sh -propertyfile /TMP/was_props/appserver.props \
-file /opt/IBM/WebSphere/AppServer/profileTemplates/default/actions/updatePorts.ant
- Ouvrez la console d'administration et visualisez les affectations de port modifiées.
Pour afficher les affectations de port, cliquez sur
.
- Exécutez à nouveau le script et visualisez les ports. Sont-ils les mêmes
qu'avant ?
Les valeurs de port résultantes affectées dynamiquement s'appliquent à tous
les ports actuellement affectés au profil AppSrv01, pour chaque serveur
listé dans le fichier serverindex.xml du nom de noeud de
profil. Chaque port reçoit une nouvelle valeur non conflictuelle. Aucune des anciennes affectations de valeur de port
n'est utilisée car les valeurs de port sont en cours d'utilisation au moment de la nouvelle
affectation.
Affectez les ports par défaut au profil AppSrv02. Par défaut, le script ANT affecte des ports n'entrant pas en conflit. L'argument spécial defaultPorts=true
est nécessaire. Identifiez les chemins d'accès complets, le nom de profil,
le nom de noeud unique et le nom de cellule unique. Puis exécutez la commande.
- Créez le fichier de propriétés
Java
codé en codage de fichier ISO8859-1 pour affecter au profil de
serveur d'applications des valeurs de port par défaut.
Pour cet exemple, supposons que le système est un système
d'exploitation
Windows
et que vous créez le fichier de propriétés
C:\temp\was_props\appserver.props suivant.
WAS_HOME="C:/Program Files/IBM/WebSphere/AppServer"
was.install.root="C:/Program Files/IBM/WebSphere/AppServer"
profileName=AppSrv02
profilePath="C:/Program Files/IBM/WebSphere/AppServer/profiles/AppSrv02"
templatePath="C:/Program Files/IBM/WebSphere/AppServer/profileTemplates/default"
nodeName=appserver_node02
cellName=appserver_cell02
hostName=myserver2.ibm.com
defaultPorts=true
Utilisez des guillemets autour d'un nom de chemin
d'accès
Windows
comportant des espaces. N'utilisez pas de guillemets autour du nom de chemin d'accès s'il
n'y a pas d'espace dans le chemin.
- Ouvrez une fenêtre de commande DOS.
- Accédez au répertoire C:\Program Files\IBM\WebSphere\AppServer\bin.
cd "C:\Program Files\IBM\WebSphere\AppServer\bin"
Si le
produit est installé dans un répertoire autre que celui par défaut, accédez au
répertoire
racine_serveur_app/bin.
- Emettez la commande.
ws_ant.bat -propertyfile C:\temp\was_props\appserver.props
-file "C:\Program Files\IBM\WebSphere\AppServer\profileTemplates\default\actions\updatePorts.ant"
- Ouvrez la console d'administration et visualisez les affectations de port modifiées.
Pour afficher les affectations de port, cliquez sur
.
- Exécutez à nouveau le script et visualisez les ports. Sont-ils les mêmes
qu'avant ?
Les valeurs de port résultantes affectées sont à chaque fois les mêmes car
les valeurs sont les valeurs par défaut. Cette méthode ne résout pas les affectations
de port conflictuelles. Pour visualiser toutes les affectations de port d'un profil, voir le fichier C:\Program
Files\IBM\WebSphere\AppServer\profiles\AppSrv02\config\cells\appserver_cell02\nodes\appserver_node02\serverindex.xml. Emettez la commande netstat -a pour visualiser les ports en cours d'utilisation sur
la machine.
Affectez des ports au profil AppSrv03 en commençant par 2050. Par défaut, le script ANT affecte des ports n'entrant pas en conflit. L'argument spécial startingPort=2050
est nécessaire. Identifiez les chemins d'accès complets, le nom de profil,
le nom de noeud unique et le nom de cellule unique. Puis exécutez la commande.
- Créez le fichier de propriétés
Java
codé en codage de fichier ISO8859-1 pour affecter au profil de
serveur d'applications des valeurs de port par défaut.
Pour cet exemple, supposons que le système est un système
d'exploitation
AIX
et que vous créez le fichier de propriétés
/usr/tmp/was_props/appserver.props suivant.
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_node03
cellName=appserver_cell03
hostName=myserver3.ibm.com
startingPort=2050
- Ouvrez une fenêtre de shell de commande.
- Accédez au répertoire /usr/IBM/WebSphere/AppServer/bin.
cd /usr/IBM/WebSphere/AppServer/bin
Si le
produit est installé dans un répertoire autre que celui par défaut, accédez au
répertoire
racine_serveur_app/bin.
- Emettez la commande.
./ws_ant.sh -propertyfile /usr/tmp/was_props/appserver.props \
-file /usr/IBM/WebSphere/AppServer/profileTemplates/default/actions/updatePorts.ant
- Ouvrez la console d'administration et visualisez les affectations de port modifiées.
Pour afficher les affectations de port, cliquez sur
.
- Exécutez à nouveau le script et visualisez les ports. Sont-ils les mêmes
qu'avant ?
Après utilisation de l'option -startingPort, les valeurs de port résultantes affectées
dynamiquement ne sont pas toujours les mêmes, car le script ANT affecte
des valeurs de port n'entrant pas en conflit en commençant par le numéro startingPort (dans ce cas, port 2050). Cette méthode résout les affectations
de port conflictuelles.
![[HP-UX]](../images/hpux.gif)
Utilisez un fichier de propriétés de définition de port pour affecter des ports
au profil AppSrv04. Par défaut, le script ANT affecte des ports n'entrant pas en conflit. L'argument spécial portsFile=/opt/was/portdefs.our_appsrv_ex.props
est nécessaire. Identifiez les chemins d'accès complets, le nom de profil,
le nom de noeud unique et le nom de cellule unique. Exécutez ensuite la commande.
- Créez le fichier de propriétés
Java
codé en codage de fichier ISO8859-1 pour affecter au profil de
serveur d'applications des valeurs de port non conflictuelles.
Supposons
que vous créez le fichier de propriétés
/opt/was/portdefs.our_appsrv_ex.props
suivant :
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
Remarque : Les ports utilisés dans le fichier de propriétés
de définition de port doivent refléter le type modèle. Dans cet exemple, les ports
sont ceux du type modèle par défaut et ils peuvent être différents pour d'autres types modèle. Le modèle de gestion possède trois fichiers portdef.props
différents, un pour chaque servertype. Il s'agit de
adminagent.portdef.props, dmgr.portdef.props et jmgr.portdef.props. Ils peuvent être modélisés d'après le fichier portdef.props
qui se trouve dans le répertoire de modèles.
Supposons que vous créez le fichier de propriétés /TMP/was_props/appserver.props
suivant :
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_node04
cellName=appserver_cell04
hostName=myserver4.ibm.com
portsFile=/opt/was/portdefs.our_appsrv_ex.props
- Ouvrez une fenêtre de shell de commande.
- Accédez au répertoire /opt/IBM/WebSphere/AppServer/bin.
cd /opt/IBM/WebSphere/AppServer/bin
Si le
produit est installé dans un répertoire autre que celui par défaut, accédez au
répertoire
racine_serveur_app/bin.
- Emettez la commande.
./ws_ant.sh -propertyfile /TMP/was_props/appserver.props \
-file /opt/IBM/WebSphere/AppServer/profileTemplates/default/actions/updatePorts.ant
- Ouvrez la console d'administration et visualisez les affectations de port modifiées.
Pour afficher les affectations de port, cliquez sur
.
- Exécutez à nouveau le script et visualisez les ports. Sont-ils les mêmes
qu'avant ?
Les valeurs de ports affectées résultantes sont issues d'un fichier props. C'est pourquoi
les valeurs ne sont pas modifiées.
Cette méthode ne résout pas les affectations
de port conflictuelles.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Résultats
Cette procédure donne quatre méthode différentes d'affectation de port
avec le script updatePorts.ant.