Scripts de configuration des paramètres de serveur
La bibliothèque de scripts propose de nombreuses procédures de script pour automatiser la configuration des serveurs d'applications. Utilisez les scripts de serveur d'applications pour configurer les chargeurs de classes, les paramètres de la JVM (machine virtuelle Java™), les conteneurs EJB (Enterprise JavaBeans), la surveillance des performances, la mémoire cache dynamique, et ainsi de suite. Vous pouvez exécuter chaque script individuellement ou combiner des procédures pour créer des scripts d'automatisation personnalisés pour votre environnement.
Toutes les procédures de script de gestion de serveur se trouvent dans le répertoire app_server_root/scriptLibraries/servers/V70.
configureAdminService
Ce script configure les paramètres de l'interface AdminService. L'interface AdminService est l'interface côté serveur donnant accès aux fonctions d'administration du serveur d'applications.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
localAdminProtocol | Indique le type de connecteur à utiliser pour connecter l'interface AdminService au serveur d'applications via une connexion locale. |
remoteAdminProtocol | Indique le type de connecteur à utiliser pour connecter l'interface AdminService au serveur d'applications via une connexion à distance. |
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant : [["enabled", "true"], ["pluginConfigService", "(cells/timmieNode02Cell/nodes/timmieNode01/servers/server1|server.xml#PluginConfigService_1183122130078)"]] |
Syntaxe
AdminServerManagement.configureAdminService(nodeName, serverName, localAdminProtocol, remoteAdminProtocol, otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configureAdminService(""myNode"", "myServer", "IPC", "SOAP",
[["enabled", "true"], ["pluginConfigService",
"(cells/timmieNode02Cell/nodes/timmieNode01/servers/server1|server.xml#PluginConfigService_1183122130078)"]])
configureApplicationServerClassloader
Ce script configure un chargeur de classe pour le serveur d'applications. Ils activent les applications qui sont déployées sur le serveur d'applications pour accéder aux référentiels de classes et de ressources disponibles.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
policy | Indique la règle du chargeur de classes d'applications, qui prend la valeur SINGLE ou MULTIPLE. Indiquez la valeur SINGLE pour interdire les applications d'isolement et pour configurer le serveur d'applications afin d'utiliser un seul chargeur de classes d'applications pour charger tous les modules EJB, les bibliothèques partagées et les fichiers d'archives Java (JAR) de dépendance sur le système. Indiquez la valeur MULTIPLE pour isoler les applications et associer à chacune d'elle son propre chargeur de classes afin de charger des modules EJB, des bibliothèques partagées et des fichiers JAR de dépendance. |
mode | Indique le mode du chargeur de classes, qui prend la valeur PARENT_FIRST ou APPLICATION_FIRST. L'option PARENT_FIRST pousse le chargeur de classes à déléguer le chargement des classes à son chargeur de classes parent avant toute tentative de chargement de cette classe depuis le chemin local d'accès aux classes. L'option APPLICATION_FIRST pousse le chargeur de classes à tenter le chargement des classes depuis le chemin local d'accès aux classes avant de déléguer le chargement de classe à son parent. Grâce à cette règle, un chargeur de classe d'application peut remplacer une classe d'application existante dans le chargeur de classe parent et fournir sa propre version de la classe. |
libraryName | Indique le nom de la bibliothèque partagée qui vous intéresse. |
Syntaxe
AdminServerManagement.configureApplicationServerClassloader(nodeName, serverName,
policy, mode, libraryName)
Exemple de syntaxe
AdminServerManagement.configureApplicationServerClassloader("myNode", "myServer", "MULTIPLE", "PARENT_FIRST",
"myLibraryReference")
configureDynamicCache
Ce script configure le service de cache dynamique dans votre configuration de serveur. Le service de cache dynamique fonctionne au sein d'une JVM de serveur d'applications, interceptant les appels émis vers les objets susceptibles d'être mis en cache. Par exemple, le service de cache dynamique intercepte les appels via une méthode de service de servlet ou une méthode d'exécution de commande, et stocke la sortie de l'objet dans le cache ou prend en charge le contenu de l'objet depuis le cache dynamique.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
defaultPriority | Indique la priorité par défaut des entrées de mémoire cache, déterminant le délai de conservation d'une entrée dans un cache entier. Indiquez un entier compris entre 1 et 255. |
cacheSize | Indique un entier positif spécifiant le nombre maximal d'entrées que peut contenir la cache. Dans cette zone, entrez une valeur comprise entre 100 et 200 000 pour la taille du cache. |
externalCacheGroupName | Le nom du groupe de cache externe doit correspondre à indiqué pour la propriété ExternalCache, comme indiqué dans le servlet ou dans le fichier JSP (JavaServer Pages) cachespec.xml. Lorsque la mise en cache externe est activée, les pages sont mises en correspondance avec son URI (Universal Resource Identifier) et celles qui concordent sont poussées vers le cache externe. Les entrées peuvent alors être servies à partir du cache externe plutôt qu'à partir du serveur d'applications. |
externalCacheGroupType | Indique le type du groupe de caches externes. |
otherAttributeList | Indique, de manière facultative, des options de configuration supplémentaires pour le service de cache dynamique au format suivant : [["cacheProvider", "myProvider"], ["diskCacheCleanupFrequency", 2], ["flushToDiskOnStop", "true"]] |
Syntaxe
AdminServerManagement.configureDynamicCache(nodeName, serverName, defaultPriority,
cacheSize, externalCacheGroupName, externalCacheGroupType,
otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configureDynamicCache("myNode", "myServer", 2, 5000, "EsiInvalidator",
"SHARED", [["cacheProvider", "myProvider"], ["diskCacheCleanupFrequency", 2], ["flushToDiskOnStop","true"]])
configureEJBContainer
Ce script configure un conteneur (EJB) Enterprise JavaBeans dans votre configuration de serveur. Un conteneur EJB offre un environnement d'exécution pour les beans enterprise sur un serveur d'applications. Le conteneur gère tous les aspects du fonctionnement des beans enterprise sur le serveur d'application et fait office d'intermédiaire entre la logique métier utilisateur dans le bean et le reste de l'environnement du serveur d'application.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
passivationDirectory | Indique le répertoire dans lequel le conteneur enregistre l'état persistant des beans session à l'état passif. Ce répertoire doit déjà exister. Il n'est pas créé automatiquement. |
defaultDatasourceJNDIName | Indique le nom JNDI d'une source de données à utiliser si aucune source de données n'est spécifiée lors du déploiement d'une application. Ce paramètre ne s'applique pas aux beans à persistance gérée par conteneur compatibles avec EJB 2.x. |
Syntaxe
AdminServerManagement.configureEJBContainer(nodeName, serverName,
passivationDir, defaultDatasourceJNDIName)
Exemple de syntaxe
![[Windows]](../images/windows.gif)
AdminServerManagement.configureEJBContainer(myNode, myServer, C:\temp\myDir, jndi1)
![[AIX]](../images/aixlogo.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminServerManagement.configureEJBContainer(myNode, myServer, /temp/myDir, jndi1)
configureFileTransferService
Ce script configure le service de transfert de fichiers pour le serveur d'applications. Le service de transfert de fichiers transfère des fichiers depuis le gestionnaire de déploiement vers les noeuds distants individuels.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
retriesCount | Indique le nombre de fois que le service de transfert de fichiers doit tenter d'envoyer ou de recevoir un fichier après un échec de communication. La valeur par défaut est 3. |
retryWaitTime | Spécifie le nombre de secondes pendant lesquelles le service de transfert de fichiers attend avant de retenter le transfert d'un fichier qui a échoué. La valeur par défaut est 10. |
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant : [["enable", "true"]] |
Syntaxe
AdminServerManagement.configureFileTransferService(nodeName, serverName, retriesCount, retryWaitTime, otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configureFileTransferService(myNode, myServer, 5, 600, [["enable", "true"]])
configureListenerPortForMessageListenerService
Ce script configure le port du programme d'écoute pour le service du programme d'écoute des messages dans votre configuration de serveur. Le service de programme d'écoute des messages est une extension des fonctions JMS (Java Messaging Service) du fournisseur JMS. Il fournit un gestionnaire de programmes d'écoute qui contrôle et surveille un ou plusieurs programmes d'écoute JMS, chacun de ces programmes surveillant une destination JMS pour le compte d'un bean géré par message déployé.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
listenerPortName | le nom par lequel le port d'écoute est connu pour utilisation administrative. |
connectionFactoryJNDIName | Le Nom JNDI de la fabrique de connexions JMS à utiliser par le port d'écoute ; par exemple, jms/connFactory1. |
destinationJNDIName | Nom JNDI de la destination que le port du programme d'écoute doit utiliser ; par exemple, jms/destn1 |
maxMessages | Nombre maximal de messages pouvant être traités par le module d'écoute dans une seule transaction. Si la file d'attente est vide, le module d'écoute traite chaque message à son arrivée. Chaque message est traité dans le cadre d'une transaction distincte. |
maxRetries | Le nombre maximum de tentatives de livraison du message par le programme d'écoute avant l'arrêt de ce programme, selon une plage de 0 à 2147483647. Le nombre maximum de tentatives de livraison d'un message par le programme d'écoute à une instance de bean géré par message avant l'arrêt de ce programme d'écoute. |
maxSession | Spécifie le nombre maximal de sessions simultanées admises par un module d'écoute lorsque le serveur JMS traite les messages. Chaque session correspond à une unité d'exécution distincte du module d'écoute et contrôle donc le nombre de messages traités simultanément. Optimisez ce paramètre si le serveur n'utilise pas complètement la capacité disponible de la machine et s'il n'est pas nécessaire que les messages soient traités dans un ordre spécifique. |
Syntaxe
AdminServerManagement.configureListenerPortForMessageListener(nodeName, serverName,
listenerPortName, connectionFactoryJNDIName,
destinationJNDIName, maxMessages, maxRetries, maxSession)
Exemple de syntaxe
AdminServerManagement.configureListenerPortForMessageListener("myNode", "myServer", myListenerPort,
connJNDI, "destJNDI", 5, 2, 3)
configureMessageListenerService
Ce script configure le service du programme d'écoute des messages dans votre configuration de serveur. Le service de programme d'écoute des messages est une extension des fonctions JMS (Java Messaging Service) du fournisseur JMS. Il fournit un gestionnaire de programmes d'écoute qui contrôle et surveille un ou plusieurs programmes d'écoute JMS, chacun de ces programmes surveillant une destination JMS pour le compte d'un bean géré par message déployé.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
maxListenerRetry | Indique le nombre maximum de reprises après échec autorisées pour un port de programme d'écoute géré par ce service avant abandon et arrêt des tentatives. Une fois arrêté, le port d'écoute associé passe à l'état Arrêt. |
listenerRecoveryInterval | Indique la durée, en secondes, entre les nouvelles tentatives de reprise après échec d'un port de programme d'écoute. |
poolingThreshold | Indique le nombre maximum de connexions non utilisées dans le pool. La valeur par défaut est 10. |
poolingTimeout | Indique le nombre de millisecondes après lequel une connexion du pool est détruite si elle n'a pas été utilisée. Un MQSimpleConnectionManager alloue des connexions utilisées le plus récemment et détruit les connexions les moins utilisées récemment. Par défaut, une connexion est détruite si elle n'a pas été utilisée pendant cinq minutes. |
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant : [["description", "test message listener"], ["isGrowable", "true"], ["maximumSize", 100], ["minimumSize", 5]] |
Syntaxe
AdminServerManagement.configureMessageListenerService(nodeName, serverName,
maxListenerRetry, listenerRecoveryInterval,
poolingThreshold, poolingTimeout, otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configureMessageListenerService(myNode, myServer, 5, 120,
20, 600000, myProp, myValue,
[["description", "test message listener"], ["isGrowable", "true"], ["maximumSize", 100], ["minimumSize", 5]])
configureStateManageable
Ce script configure l'état initial du serveur d'applications. L'état initial fait référence à l'état souhaité du composant lors du démarrage du processus serveur.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
parentType | Indique le type de composant à modifier. |
initialState | Indique l'état du composant lors du démarrage du processus serveur. Les valeurs valides sont START et STOP. |
Syntaxe
AdminServerManagement.configureStateManageable(nodeName, serverName,
parentType, initialState)
Exemple de syntaxe
AdminServerManagement.configureStateManageable(myNode, myServer, "Server", "START")
configureCustomProperty
Ce script configure les propriétés personnalisées de votre serveur d'applications. Vous pouvez utiliser des propriétés personnalisées pour la configuration des propriétés système internes utilisées par certains composants pour transmettre des informations à un conteneur Web, par exemple.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
parentType | Indique le type de composant à configurer. |
propertyName | Indique la propriété personnalisée à configurer. |
propertyValue | Indique la valeur de la propriété personnalisée à configurer. |
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant : [["commTraceEnabled", "true"], ["enable", "true"]] |
Syntaxe
AdminServerManagement.configureCustomProperty(nodeName, serverName, parentType, propertyName, propertyValue, otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configureCustomProperty("myNode", "myServer", "ThreadPool", "myProp1", "myPropValue",
[["description", "my property test"], ["required", "false"]])
configureCustomService
Ce script configure un service personnalisé de votre serveur d'applications. Chaque service personnalisé définit une classe qui est chargée et initialisée dès que le serveur démarre et s'arrête. Chacune de ces classes doit implémenter l'interface com.ibm.websphere.runtime.CustomService. Une fois que vous aurez créé un service personnalisé, utilisez la console pour le configurer pour votre serveur d'applications.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
classname | Indique le nom de classe de l'implémentation du service. Cette classe doit implémenter l'interface du service personnalisé. |
displayname | Indique le nom du service. |
classpath | Indique le chemin d'accès aux classes permettant de situer les classes et les fichiers JAR pour ce service. |
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant : [["description", "test custom service"], ["enable", "true"]] |
Syntaxe
AdminServerManagement.configureCustomService(nodeName, serverName, classname, displayname, classpath, otherAttributeList)
Exemple de syntaxe
![[Windows]](../images/windows.gif)
AdminServerManagement.configureCustomService("myNode", "myServer", "myClass", "myName", "C:\temp\boo.jar",
[["description", "test custom service"], ["enable", "true"]])
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminServerManagement.configureCustomService("myNode", "myServer", "myClass", "myName", "/temp/boo.jar",
[["description", "test custom service"], ["enable", "true"]])
configureEndPointsHost
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
hostName | Indique le nom de l'hôte qui vous intéresse. |
Syntaxe
AdminServerManagement.configureEndPointsHost(nodeName, serverName, hostName)
Exemple de syntaxe
AdminServerManagement.configureEndPointsHost(myNode, AppServer01, myHostname)
configureJavaVirtualMachine
Ce script configure une machine virtuelle Java (JVM). Le serveur d'applications, qui est un processus Java, requiert une machine virtuelle Java pour fonctionner et pour prendre en charge les applications Java qui s'exécutent sur le serveur.
Argument | Description |
---|---|
IDConfigJVM | Indique l'ID configuration de la JVM (machine virtuelle Java) que vous souhaitez modifier. |
debugMode | Indique si la JVM doit être exécutée en mode débogage. Par défaut, le support du mode de débogage n'est pas activé. Si vous paramétrez l'argument debugMode sur true, alors vous devez indiquer les arguments de débogage. |
debugArgs | Indique les arguments de débogage à transmettre au code de la JVM qui démarre le processus serveur d'applications. Si vous activez le débogage sur plusieurs serveurs d'applications situés sur le même noeud, assurez-vous que les serveurs utilisent des arguments d'adresse différents, qui définissent le port associé au débogage. Par exemple, si vous activez le débogage sur deux serveurs et que vous conservez pour chacun d'eux la valeur par défaut address=7777, ils risquent de ne pas démarrer correctement. |
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant de paires nom/valeur : [["internalClassAccessMode", "RESTRICT"], ["disableJIT", "false"], ["verboseModeJNI", "false"]] |
Syntaxe
AdminServerManagement.configureJavaVirtualMachine(javaVirtualMachineConfigID,
debugMode, debugArgs, otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configureJavaVirtualMachine
("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaVirtualMachine_1208188803955)", "true",
mydebug, [["internalClassAccessMode", "RESTRICT"], ["disableJIT", "false"], ["verboseModeJNI", "false"]])
configureORBService
Ce script configure un service ORB (Object Request Broker) dans votre configuration de serveur. Un ORB gère l'interaction entre les clients et les serveurs à l'aide du protocole IIOP (Internet InterORB Protocol). Dans un environnement réseau réparti, il permet aux clients d'adresser des demandes aux serveurs et de recevoir des réponses de ces serveurs.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
requestTimeout | Indique le nombre de secondes à l'issue desquelles un message de demande arrive à expiration. |
|
|
|
|
|
|
|
|
locateRequestTimeout | Indique le nombre de secondes à l'issue desquelles un message de demande de localisation arrive à expiration. Cette zone est ignorée sur la plateforme z/OS. |
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant : [["commTraceEnabled", "true"], ["enable", "true"]] |
Syntaxe
AdminServerManagement.configureORBService(nodeName, serverName, requestTimeout, requestRetriesCount, requestRetriesDelay,
connectionCacheMax, connectionCacheMin, locateRequestTimeout, otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configureMessageListenerService(myNode, myServer, 5, 120, 20, 600000, 20, 300,
[["commTraceEnabled", "true"], ["enable", "true"]])
configureProcessDefinition
Ce script configure la définition du processus serveur. Améliorez le fonctionnement d'un serveur d'applications en définissant des informations de ligne de commande pour démarrer ou initialiser le processus du serveur d'applications. Les paramètres de définition de processus définissent des propriétés d'exécution comme le programme à exécuter, les arguments permettant d'exécuter le programme et le répertoire de travail.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
otherParamList | Définit des paramètres supplémentaires pour la configuration de la définition de processus, au format suivant : [["executableName", "value1"], ["executableArguments", "value2"], ["workingDirectory", "value3"]] |
Syntaxe
AdminServerManagement.configureProcessDefintion(nodeName, serverName, otherParamList)
Exemple de syntaxe
AdminServerManagement.configureProcessDefinition(myNode, myServer,
[[executableName, "value1"],["executableArguments"."value2"],["workingDirectory","value3"]])
configureRuntimeTransactionService
Ce script configure le service de transactions pour votre configuration de serveur. Le service de transaction est un composant d'exécution de serveur qui coordonne les mises à jour à de multiples gestionnaires de ressources afin de garantir les mises à jour atomiques des données. Les transactions sont lancées et arrêtées par les applications ou le conteneur dans lequel les applications sont déployées.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
totalTranLifetimeTimeout | Définit la durée maximum autorisée par défaut, en secondes, d'une transaction démarrée sur ce serveur avant que le service de transactions initialise l'exécution de l'expiration. Toutes les transactions qui ne lancent le processus d'arrêt avant ce délai d'attente sont annulées. |
clientInactivityTimeout | Indique la durée maximale, en secondes, entre deux demandes transactionnelles d'un client distant. Toute période d'inactivité du client qui dépasse cette expiration entraîne l'annulation de cette transaction sur ce serveur d'applications. Si ce paramètre a pour valeur 0, aucun délai ne s'applique. |
Syntaxe
AdminServerManagement.configureRuntimeTransactionService(nodeName, serverName,
totalTranLifetimeTimeout, clientInactivityTimeout)
Exemple de syntaxe
AdminServerManagement.configureRuntimeTransactionService(myNode, myServer, "600", "600")
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
configureThreadPool
Ce script configure des pools d'unités d'exécution dans votre configuration de serveur. Un pool d'unités d'exécution permet à des composants du serveur de réutiliser des unités d'exécution afin de ne pas avoir à recréer d'autres unités lors de l'exécution. La création d'unités d'exécution contribue à augmenter les délais et les ressources.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
parentType | Indique le type de composant à configurer. |
threadPoolName | Indique le nom du pool d'unités d'exécution qui vous intéresse. |
maximumSize | Indique le nombre maximal d'unités d'exécution à gérer dans le pool d'unités d'exécution par défaut. Si la valeur du taux d'utilisation maximal dans Tivoli Performance Viewer comporte deux chiffres en permanence, il est recommandé d'augmenter la taille maximale. Ce pourcentage indique la durée d'utilisation des unités d'exécution. |
minimumSize | Indique le nombre minimal d'unités d'exécution autorisées dans le groupe. Lorsqu'un serveur d'applications démarre, aucune unité d'exécution n'est attribuée au pool d'unités d'exécution. Les unités d'exécution sont ajoutées au pool au fur et à mesure des besoins de la charge de travail affectée au serveur d'applications, jusqu'à ce que le nombre d'unités d'exécution du pool atteigne la valeur indiquée dans la zone Taille minimale. Dès lors, des unités d'exécution supplémentaires sont ajoutées et supprimées selon les modifications de la charge de travail. Toutefois, le nombre d'unités d'exécution du pool ne descend jamais en deçà de la valeur indiquée dans la zone Taille minimale, même si certaines unités d'exécution sont inactives. |
inactivityTimeout | Indique le nombre de millisecondes d'inactivité à l'issue desquelles une unité d'exécution est récupérée. La valeur 0 indique de ne pas attendre et une valeur négative (inférieure à 0) est synonyme d'attente permanente. |
otherAttributeList | Indique des attributs de configuration supplémentaires au format suivant : [["description", "testing thread pool"], ["isGrowable", "true"], ["name", "myThreadPool"]] |
Syntaxe
AdminServerManagement.configureThreadPool(nodeName, serverName,
parentType, threadPoolName, maximumSize,
minimumSize, inactivityTimeout, otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configureThreadPool
("acmeNode2", "server1", "ThreadPoolManager", "WebContainer", 15, 25, 60)
configureTransactionService
Ce script configure le service de transactions pour votre serveur d'applications. Vous pouvez utiliser les transactions avec vos applications pour coordonner plusieurs mises à jour de ressources en tant qu'unités atomiques (unités indivisibles de travail), de sorte que toutes ces mises à jour ou aucune d'elle soient permanentes.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom serveur du serveur qui vous intéresse. |
totalTranLifetimeTimeout | Définit la durée maximum autorisée par défaut, en secondes, d'une transaction démarrée sur ce serveur avant que le service de transactions initialise l'exécution de l'expiration. Toutes les transactions qui ne lancent le processus d'arrêt avant ce délai d'attente sont annulées. Ce délai d'expiration des transactions est utilisé uniquement si le composant d'application ne définit pas lui-même le sien. Seul le délai de la durée de vie totale de la transaction et le délai d'expiration maximal de la transaction possèdent des périodes de grâce. Vous pouvez désactiver les périodes de grâce à l'aide de la propriété personnalisée DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD. |
clientInactivityTimeout | Indique la durée maximale, en secondes, entre deux demandes transactionnelles d'un client distant. Toute période d'inactivité du client qui dépasse cette expiration entraîne l'annulation de cette transaction sur ce serveur d'applications. Si ce paramètre a pour valeur 0, aucun délai ne s'applique. |
maximumTransactionTimeout | Indique la limite supérieure du délai de transaction, en secondes, des transactions qui s'exécutent sur ce serveur. Cette valeur doit être supérieure ou égale à l'expiration de transaction totale. Ce délai contraint la limite supérieure de tous les délais d'expiration des transactions. |
heuristicRetryLimit | Indique le nombre de fois que le serveur d'applications tente de renvoyer un signal d'achèvement, comme la validation ou l'annulation. Les nouvelles tentatives ont lieu après une exception temporaire émise par un gestionnaire de ressources ou d'un partenaire distant, ou si le délai de réponse asynchrone configuré expire avant la réponse de tous les partenaires WS-AT. |
heuristicRetryWait | Indique le nombre de secondes que le serveur d'applications attend avant de tenter à nouveau un signal d'exécution (une validation ou une annulation, par exemple) après une exception temporaire émise par un gestionnaire de ressources ou un partenaire distant. |
propogatedOrBMTTranLifetimeTimeout | Indique le nombre de secondes pendant lequel une transaction reste inactive avant d'être annulée. |
asyncResponseTimeout | Indique le temps d'attente en secondes dont dispose le serveur pour répondre au protocole WS-AT entrant avant de renvoyer le message du protocole WS-AT précédent. |
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant : [["LPSHeuristicCompletion", "ROLLBACK"], ["WSTransactionSpecificationLevel", "WSTX_10"], ["enable", "true"]] |
Syntaxe
AdminServerManagement.configureTransactionService(nodeName, serverName,
totalTranLifetimeTimeout, clientInactivityTimeout,
maximumTransactionTimeout, heuristicRetryLimit, heuristicRetryWait,
propogatedOrBMTTranLifetimeTimeout, asyncResponseTimeout, otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configureTransactionService(myNode, myServer,
120, 60, 5, 2, 5, 300, 30,
[["LPSHeuristicCompletion", "ROLLBACK"], ["WSTransactionSpecificationLevel", "WSTX_10"], ["enable", "true"]])
setJVMProperties
Ce script définit des propriétés supplémentaires pour la configuration de votre JVM.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
classPath | Indique, de manière facultative, le chemin standard d'accès aux classes auquel le code de la machine virtuelle Java recherche les classes. |
bootClasspath | Indique, de manière facultative, les classes et les ressources d'amorçage pour le code de la JVM. Cette option est disponible uniquement pour les instructions JVM qui prennent en charge les ressources et les classes d'amorçage. |
initialHeapSize | Indique, de manière facultative, la taille de la pile initialement disponible pour le code de la JVM, en mégaoctets. L'augmentation de la taille de pile minimale peut améliorer les performances au démarrage. Le nombre d'occurrences de récupération de place diminue et les performances augmentent de 10%. L'augmentation de la taille de la pile Java améliore généralement le rendement jusqu'à ce que la pile ne réside plus en mémoire physique. Une fois la permutation de la pile vers le disque commencée, les performances Java sont énormément dégradées. |
maxHeapSize | Indique, de manière facultative, la taille maximum de la pile disponible pour le code de la JVM, en mégaoctets. L'augmentation de la taille du segment (pile) peut améliorer les performances au démarrage. En augmentant la taille du segment, vous pouvez réduire le nombre d'occurrences de récupération de place et accroître les performances de 10 %. |
debugMode | Définit, de manière facultative, si la JVM doit être exécutée en mode débogage. Par défaut, le support du mode de débogage n'est pas activé. Si vous paramétrez l'argument debugMode sur true, alors vous devez indiquer les arguments de débogage. |
debugArgs | Indique, de manière facultative, les arguments de débogage à transmettre au code de la JVM qui démarre le processus serveur d'applications. Si vous activez le débogage sur plusieurs serveurs d'applications situés sur le même noeud, assurez-vous que les serveurs utilisent des arguments d'adresse différents, qui définissent le port associé au débogage. Par exemple, si vous activez le débogage sur deux serveurs et que vous conservez pour chacun d'eux la valeur par défaut address=7777, ils risquent de ne pas démarrer correctement. |
Syntaxe
AdminServerManagement.setJVMProperties(nodeName, serverName,
classPath, bootClasspath, initialHeapSize,
maxHeapSize, debugMode, debugArgs)
Exemple de syntaxe
![[Windows]](../images/windows.gif)
AdminServerManagement.setJVMProperties(myNode, myServer, "c:\a.jar", "", "”, "", "", "")
![[Linux]](../images/linux.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
![[IBM i]](../images/iseries.gif)
AdminServerManagement.setJVMProperties(myNode, myServer, "/a.jar", "", "”, "", "", "")
setTraceSpecification
Ce script définit la spécification de trace pour votre configuration.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
traceSpecification | Indique, de manière facultative, les arguments de débogage à transmettre au code de la JVM qui démarre le processus serveur d'applications. Si vous activez le débogage sur plusieurs serveurs d'applications situés sur le même noeud, assurez-vous que les serveurs utilisent des arguments d'adresse différents, qui définissent le port associé au débogage. Par exemple, si vous activez le débogage sur deux serveurs et que vous conservez pour chacun d'eux la valeur par défaut address=7777, ils risquent de ne pas démarrer correctement. |
Syntaxe
AdminServerManagement.setJVMProperties(nodeName, serverName, traceSpecification)
Exemple de syntaxe
AdminServerManagement.setTraceSpecification(myNode, myServer, "com.ibm.ws.management.*=all")
configureCookieForServer
Ce script configure les cookies de votre serveur d'applications. Configurez des cookies pour assurer le suivi des sessions.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
cookieName | Nom unique du cookie de gestion de session. La spécification de servlet doit porter le nom JSESSIONID. Cette valeur peut cependant être configurée pour offrir plus de flexibilité. |
domain | Indique le nom de domaine d'un cookie de suivi de session. Cette valeur contrôle si un navigateur envoie ou non un cookie à des serveurs particuliers. Par exemple, si vous indiquez un domaine particulier, les cookies de session sont envoyés vers les hôtes de ce domaine. Le domaine par défaut est le serveur. |
maximumAge | Spécifie la durée de vie du cookie sur le navigateur client. Indiquez que le cookie ne dure aussi longtemps que la session en cours du navigateur ou spécifiez un âge maximal. Si vous choisissez l'âge maximal, spécifiez-le en secondes. Cette valeur correspond à la valeur TTL (Time to Live) décrite dans la spécification de cookie. La durée de vie par défaut correspond à la durée de la session de navigateur en cours, ce qui équivaut à définir cette valeur sur -1. |
secure | Indique que les cookies de session incluent la zone "secure". Lorsque cette option est activée, l'échange des cookies se limite uniquement aux sessions HTTPS. |
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant : [["path", "C:/temp/mycookie"]] |
Syntaxe
AdminServerManagement.configureCookieForServer(nodeName, serverName, cookieName, domain, maximumAge, secure, otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configureCookieForServer(myNode, myServer, myCookie, "uk.kingdom.com", -1, "true", [["path", "C:/temp/mycookie"]])
configureHTTPTransportForWebContainer
Ce script configure les transports HTTP pour un conteneur Web. Les transports fournissent des files d'attente de demandes entre les plug-in du serveur d'applications pour les serveurs Web et les conteneurs Web dans lesquels les modules Web des applications résident. Lorsque vous appelez une application dans un navigateurweb, la demande est transmise au serveur Web, puis via le transport au conteneur Web.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
adjustPort | Indique si le port doit être automatiquement ajusté pour le conteneur Web qui vous intéresse. |
external | Indique si le transport HTTP pour le conteneur Web est défini sur externe. |
sslConfig | Indique le type de paramètres SSL (Secure Sockets Layer) pour les connexions entre le plug-in WebSphere Application Server et le serveur d'applications. Les options incluent un ou plusieurs paramètres SSL définis dans le Centre de sécurité. Par exemple, Paramètres SSL par défaut, Paramètres SSL de l'ORB ou Paramètres SSL LDAP. |
sslEnabled | Indique si les connexions entre le plug-in WebSphere Application Server et le serveur d'applications doivent être protégées via protocole SSL (Secure Sockets Layer). Par défaut, le protocole SSL n'est pas utilisé. |
Syntaxe
AdminServerManagement.configureHTTPTransportForWebContainer(nodeName, serverName,
adjustPort, external, sslConfig, sslEnabled)
Exemple de syntaxe
AdminServerManagement.configureHTTPTransportForWebContainer(myNode, myServer, "true", "true", "mySSLConfig", "true")
configureSessionManagerForServer
Ce script configure le gestionnaire de session pour le serveur d'applications. Les sessions permettent aux applications s'exécutant dans un conteneur Web de conserver la trace des différents utilisateurs.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
sessionPersistenceMode | Indique le mode de persistance de session. Les valeurs admises sont DATABASE, DATA_REPLICATION, et NONE. |
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant : [["accessSessionOnTimeout", "true"], ["enabled", "true"]] |
Syntaxe
AdminServerManagement.configureSessionManagerForServer(nodeName, serverName,
sessionPersistenceMode, otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configureSessionManagerForServer(myNode, myServer, "DATABASE",
[["accessSessionOnTimeout", "true"], ["enabled", "true"]])
configureWebContainer
Ce script configure les conteneurs Web sur votre serveur d'applications. Un conteneur Web prend en charge les demandes des servlets, des fichiers JSP (JavaServer Pages) ou d'autres types de fichiers contiennent le code serveur. l crée des instances de servlets, les charge et les décharge, crée et gère les objets demande et réponse et accomplit d'autres tâches de gestion en rapport avec les servlets.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
webContainerName | Spécifie le nom du conteneur Web qui vous intéresse. |
defaultVirtualHostName | Indique un hôte virtuel qui permet à une seule machine hôte de se comporter comme plusieurs machines hôtes. Les
ressources associées à un hôte virtuel ne peuvent pas partager les données avec les
ressources associées à un autre hôte virtuel, même si les hôtes virtuels partagent la
même machine physique. Les valeurs admises sont les suivantes :
|
enableServletCaching | Lorsqu'un servlet est appelé et génère une sortie destinée à être enregistrée en mémoire cache, l'entrée créée en mémoire cache contient non seulement la sortie mais aussi des éléments découlant de l'appel. Ces effets secondaires peuvent comprendre des appels à d'autres servlets ou fichiers JSP (JavaServer Pages) et des métadonnées relatives à l'entrée, telles que des informations concernant les délais et la priorité des entrées. La mise en cache du fragment de portlet nécessite que la mise en cache du servlet soit activée. Par conséquent, l'activation de la mise en cache du fragment de portlet active automatiquement le mise en cache du servlet. La désactivation de la mise en cache du servlet désactive automatiquement la mise en cache du fragment de portlet. |
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant : [["allowAsyncRequestDispatching", "true"], ["disablePooling", "true"], ["sessionAffinityTimeout", 20]] |
Syntaxe
AdminServerManagement.configureWebContainer(nodeName, serverName,
defaultVirtualHostName, enableServletCaching, otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configureWebContainer(myNode, myServer, myVH.uk.kingdom.com,
"true",
[["allowAsyncRequestDispatching", "true"], ["disablePooling", "true"], ["sessionAffinityTimeout", 20]])
configureJavaProcessLogs
Ce script configure les journaux de processus Java pour le serveur d'applications. Le système crée les journaux de la JVM en redirigeant les flux System.out et System.err de la JVM vers des fichiers journaux indépendants.
Argument | Description |
---|---|
IDConfigDefProcessusJava | Indique l'ID configuration de la définition de processus Java qui vous intéresse. |
processLogRoot | Indique le répertoire racine des journaux de processus. |
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant de paires nom/valeur : [["stdinFilename", "/temp/mystdin.log"]] |
Syntaxe
AdminServerManagement.configureJavaProcessLogs(javaProcessDefConfigID, processLogRoot,
otherAttributeList)
Exemple de syntaxe
![[Windows]](../images/windows.gif)
AdminServerManagement.configureJavaProcessLogs
("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaProcessDef_1184194176408)",
C:\temp\myJavaLog, [[stdinFilename, c:\temp\mystdin.log]])
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminServerManagement.configureJavaProcessLogs
("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaProcessDef_1184194176408)",
/temp/myJavaLog, [[stdinFilename, /temp/mystdin.log]])
configurePerformanceMonitoringService
Ce script configure l'infrastructure de surveillance des performances (PMI). La PMI permet au serveur de collecter des données de performances à partir de différents composants produit. La PMI fournit des informations sur les statistiques d'utilisation moyenne des ressources système, sans corrélation entre les données de différents composants.
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
enable | Indique si le serveur tente de lancer l'infrastructure Performance Monitoring Infrastructure (PMI). Si un serveur d'applications est démarré lorsque l'infrastructure PMI est désactivée, vous devez redémarrer le serveur afin de l'activer. |
initialSpecLevel | Indique un jeu prédéfini de statistiques PMI (Performance Monitoring Infrastructure) pour tous les composants du serveur.
|
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant de paires nom/valeur : [["statisticSet", "test statistic set"], ["synchronizedUpdate", "true"]] |
Syntaxe
AdminServerManagement.configurePerformanceMonitoringService(nodeName, serverName,
enable, initialSpecLevel, otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configurePerformanceMonitoringService(myNode, myServer, "true", "Basic",
[["statisticSet", "test statistic set"], ["synchronizedUpdate", "true"]])
configurePMIRequestMetrics
Argument | Description |
---|---|
enable | Indique si la fonctionnalité relative aux mesures des demandes doit ou non être activée. Si cette option est désactivée, la fonction Request Metrics l'est également. |
traceLevel | Spécifie la quantité de données de trace à accumuler pour une transaction spécifique. Vous remarquerez que le niveau de trace et les composants à instrumentaliser fonctionnent conjointement, de façon à contrôler si une demande sera instrumentalisée.
|
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant de paires nom/valeur : [["armType", "TIVOLI_ARM"], ["enableARM", "true"]] |
Syntaxe
AdminServerManagement.configurePMIRequestMetrics(enable, traceLevel, otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configurePMIRequestMetrics("true", "DEBUG",
[["armType", "TIVOLI_ARM"], ["enableARM", "true"]])
![[z/OS]](../images/ngzos.gif)
configureRASLoggingService
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
serviceLogRoot | Indique le répertoire racine des journaux du service de journalisation RAS. |
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant de paires nom/valeur : [["enabled", "true"], ["size", "500"]] |
Syntaxe
AdminServerManagement.configureRASLoggingService(nodeName, serverName,
serviceLogRoot, otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configureRASLoggingService(myNode, myServer, /temp/myRASLog,
[["enabled", "true"], ["size", "500"]])
configureServerLogs
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
serverLogRoot | Indique le répertoire racine des journaux du serveur. |
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires au format suivant de paires nom/valeur : [["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]] |
Syntaxe
AdminServerManagement.configureServerLogs(nodeName, serverName,
serverLogRoot, otherAttributeList)
Exemple de syntaxe
![[Windows]](../images/windows.gif)
AdminServerManagement.configureServerLogs(myNode, myServer, C:\temp\mylog,
[["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]])
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
AdminServerManagement.configureServerLogs(myNode, myServer, /temp/mylog,
[["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]])
configureTraceService
Argument | Description |
---|---|
nodeName | Indique le nom du noeud qui vous intéresse. |
serverName | Indique le nom du serveur qui vous intéresse. |
startupTraceSpecification | Indique la spécification de trace à activer pour le composant qui vous intéresse. Par exemple, la spécification com.ibm.ws.webservices.trace.MessageTrace=all trace les contenus d'un message SOAP, y compris les données de pièces jointes binaires. |
traceOutputType | Indique l'emplacement où la sortie de trace doit être enregistrée. La sortie de trace peut être écrite directement dans un fichier de sortie ou stockée en mémoire. |
otherAttributeList | Indique, de manière facultative, des attributs supplémentaires pour le service de trace au format suivant de paires nom/valeur : [["enable", "true"], ["traceFormat", "LOG_ANALYZER"]] |
Syntaxe
AdminServerManagement.configureTraceService(nodeName, serverName,
traceString, outputType, otherAttributeList)
Exemple de syntaxe
AdminServerManagement.configureTraceService(myNode, myServer, "com.ibm.ws.management.*=all=enabled",
SPECIFIED_FILE, [["enable", "true"], ["traceFormat", "LOG_ANALYZER"]])