![[IBM i]](../images/iseries.gif)
commande chgwassvr
La commande chgwassvr vous permet de modifier les ports d'un serveur d'applications dans un profil.
Pour obtenir des instructions d'utilisation et des exemples, consultez la rubrique Modification des propriétés du serveur d'applications. Pour exécuter ce script, votre profil d'utilisateur doit disposer du l'autorisation *ALLOBJ.
Utilisez la commande chgwassvr depuis un profil de déploiement réseau pour modifier les valeurs des ports des serveurs gérés par le gestionnaire de déploiement pour la cellule. Utilisez le paramètre -profileName pour spécifier le profil de gestionnaire de déploiement affecté. Lorsque vous modifiez un port d'un serveur géré, vous devez utiliser le paramètre -node pour définir le nom de noeud du noeud géré contenant le serveur que vous voulez modifier. Les documents de configuration des serveurs sont mis à jour lors de la synchronisation suivante entre le gestionnaire de déploiement et les noeuds. Vous pouvez également synchroniser la configuration avec la commande syncNode. Pour plus d'informations, voir la rubrique Commande syncNode. Exécutez la commande syncNode à partir de WebSphere Application Server (base) pour le noeud.
Vous pouvez également utiliser la console d'administration pour créer et gérer des serveurs d'applications. Pour plus d'informations, reportez-vous à la rubrique Administration des serveurs d'applications.
Syntaxe
La syntaxe de la commande est la suivante :
chgwassvr -server servername
[instance instancename] [-profileName instancename]
[-node nodename] [-portblock portnumber]
[-transport -oldport oldvalue -newport newvalue]
[-endpoint endpointname -port newvalue]
[-inthttp inthttpport]
[-inthttpssl inthttpsslport] [-admin adminport]
[-adminssl adminsslport] [-soap soapport]
[-nameservice nameserviceport]
[-celldiscovery celldiscoveryport]
[-sas sasserverport] [-csiv2server csiv2serverauthport]
[-csiv2client csiv2clientauthport] [-nodediscovery nodediscport]
[-nodemulti nodemultdiscport] [-verbose] [-help | -?]
Paramètres
Les options suivantes sont disponibles pour la commande chgwassvr :
- -server
- Paramètre obligatoire. La valeur servername définit le nom du serveur d'applications à changer. Pour le profil WebSphere Application Server par défaut, le nom de serveur par défaut est server1. Pour le profil de déploiement réseau par défaut, le nom du serveur par défaut est dmgr. La valeur de ce paramètre est sensible à la casse et doit correspondre exactement au nom du serveur. Vous pouvez utiliser la commande dspwasinst pour afficher les serveurs associés à un profil. Pour plus d'informations, voir la rubrique Commande dspwasinst.
- -profileName
- Paramètre facultatif. La valeur profile définit le nom du profil contenant le serveur d'applications que vous voulez modifier. La valeur par défaut est default.
- -node
- Paramètre facultatif. La valeur nodename définit le noeud qui héberge le serveur d'applications que vous voulez modifier. La valeur par défaut est le profil de gestionnaire de déploiement réseau.
- -portblock
- Paramètre facultatif. La valeur portblock définit le premier numéro d'un bloc de ports que votre profil utilise. Si vous définissez ce paramètre, le script modifie tous les numéros de ports de votre serveur d'applications. Si vous ne définissez pas ce paramètre, les numéros de ports de votre serveur
d'applications ne sont pas modifiés, à moins que vous n'ayez défini une modification pour
un paramètre de ports (voir les paramètres de ports ci-après). Vous pouvez utiliser la commande Work with TCP/IP Network Status (NETSTAT
*CNN) pour afficher la liste des numéros de ports actuellement utilisés.
- Un profil WebSphere
Application Server utilise plusieurs ports pour diverses fonctions. Lorsque vous modifiez les propriétés d'un serveur d'applications, les ports sont affectés en fonction des conditions demandées suivantes :
- Paramètres de port
- Si vous définissez des valeurs pour des paramètres de port, le script utilise ces valeurs. Les paramètres de ports spécifiques sont -inthttp (serveur d'applications de base), -admin, -jmsqueued (serveur d'applications de base), -jmsdirect (serveur d'applications de base), -jmssecure (serveur d'applications de base), -soap, -orblistener (déploiement réseau), -nameservice, -drsclient et -celldiscovery (déploiement réseau).
- Paramètre -portblock
- Les services pour lesquels vous n'avez pas défini de numéro de port sont affectés à des ports séquentiellement en commençant par la valeur du paramètre -portblock. Si un script rencontre un port qui est en cours d'utilisation, il saute ce numéro de port et passe au port inutilisé suivant.
- Valeurs en cours
- Si -portblock n'est pas défini, tous les services pour lesquels vous n'avez pas défini de paramètre de port conservent leur valeur courante.
- Pour le paramètre -portblock, le script vérifie uniquement un index principal de tous les WebSphere Application Server. Le script n'est pas en mesure de détecter l'utilisation des ports par d'autres applications, y compris par des versions précédentes de WebSphere Application Server.
- Un profil WebSphere
Application Server utilise plusieurs ports pour diverses fonctions. Lorsque vous modifiez les propriétés d'un serveur d'applications, les ports sont affectés en fonction des conditions demandées suivantes :
- -transport
- Cet ensemble de paramètres est facultatif. La valeur oldvalue définit le
numéro de port du transport de conteneur Web que vous voulez modifier.
La valeur newvalue définit le nouveau numéro de port que vous voulez affecter au transport de conteneur
Web. Si le transport de conteneur Web est également défini dans l'alias d'hôte d'un hôte virtuel, le port de l'alias d'hôte est aussi mis à jour.
Utilisez l'ensemble de paramètres -transport à la place des paramètres -admin, -adminssl, -inthttp ou -inthttpssl. Ces paramètres sont obsolètes.
- -endpoint
- Paramètre facultatif. La valeur endpointname définit le nom du port de noeud final à modifier. La valeur newvalue définit le numéro de port sur lequel définir le port du noeud final.
- -inthttp
- Paramètre facultatif. La valeur inthttpport définit le numéro du port sur lequel le conteneur Web écoute les requêtes provenant du serveur Web. Si ni le paramètre -portblock ni le paramètre -inthttp ne sont définis, ce port n'est pas modifié. Voir l'article sur le paramètre -portblock pour plus d'informations.
- -inthttpssl
- Paramètre facultatif. La valeur inthttpsslport définit le numéro de port que votre serveur d'applications utilise pour les communications sécurisées avec un serveur HTTP interne. Si ni le paramètre -portblock ni le paramètre -inthttpssl ne sont définis, ce port n'est pas modifié. Voir l'article sur le paramètre -portblock pour plus d'informations.
- -admin
- Paramètre facultatif. La valeur adminport définit le numéro de port à utiliser pour la console d'administration. Si ni le paramètre -portblock ni le paramètre -admin ne sont définis, ce port n'est pas modifié. Voir l'article sur le paramètre -portblock pour plus d'informations.
- -adminssl
- Paramètre facultatif. La valeur adminportssl définit le numéro de port à utiliser pour les communications sécurisées avec la console d'administration. Si ni le paramètre -portblock ni le paramètre -adminssl ne sont définis, ce port n'est pas modifié. Voir l'article sur le paramètre -portblock pour plus d'informations.
- -soap
- Paramètre facultatif. La valeur soapport définit le numéro de port à utiliser pour SOAP. Si ni le paramètre -portblock ni le paramètre -soap ne sont définis, ce port n'est pas modifié. Voir l'article sur le paramètre -portblock pour plus d'informations.
- -nameservice
- Paramètre facultatif. La valeur nameserviceport définit le numéro de port à utiliser pour le port du service de noms (ou connecteur RMI). Si ni le paramètre -portblock ni le paramètre -nameservice ne sont définis, ce port n'est pas modifié. Voir l'article sur le paramètre -portblock pour plus d'informations.
- -celldiscovery
- Paramètre facultatif. La valeur celldiscoveryport définit le port sur lequel le profil de déploiement réseau écoute les tentatives faites par un noeud pour trouver la cellule à laquelle le noeud appartient. Si ni le paramètre -portblock ni le paramètre -celldiscovery ne sont définis, ce port n'est pas modifié. Voir l'article sur le paramètre -portblock pour plus d'informations.
- -sas
- Paramètre facultatif. La valeur sasserverport définit le port sur lequel les Secure Association Services (SAS) écoutent les requêtes d'authentification entrantes. Si le paramètre -sas n'est pas défini, ce port n'est pas modifié. Ce port est défini par la propriété SAS_SSL_SERVERAUTH_LISTENER_ADDRESS dans serverindex.xml.
- -csiv2server
- Paramètre facultatif. La valeur csiv2serverauthport définit le port sur lequel le service Common Secure Interoperability Version 2 (CSIV2) écoute les requêtes d'authentification de serveur entrantes. Si le paramètre -csiv2server n'est pas défini, ce port n'est pas modifié. Ce port est défini par la propriété CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS dans serverindex.xml.
- -csiv2client
- Paramètre facultatif. La valeur csiv2clientauthport définit le port sur lequel le service Common Secure Interoperability Version 2 (CSIV2) écoute les requêtes d'authentification de client entrantes. Si le paramètre -csiv2client n'est pas défini, ce port n'est pas modifié. Ce port est défini par la propriété CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS dans serverindex.xml.
- -nodediscovery
- Paramètre facultatif. La valeur nodediscport définit le port sur lequel le noeud du service de découverte d'agent de noeud écoute.
- -nodemulti
- Paramètre facultatif. La valeur nodemultidiscport définit le port sur lequel le service de découverte multidiffusion de l'agent de noeud écoute.
- -verbose
- Ce paramètre facultatif active les messages en mode prolixe, ce qui peut s'avérer utile si vous devez déboguer le script.
- -help
- Ce paramètre facultatif affiche le message d'aide. Si vous définissez ce paramètre, le script ignore tous les autres paramètres.