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.

Utilisez les procédures de script suivantes pour configurer les conteneurs Web pour votre serveur d'applications :
Utilisez les procédures de script suivantes pour configurer les journaux et les performances de surveillance pour votre serveur d'applications :

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.

Tableau 1. Description des arguments de configureAdminService. Exécutez le script à l'aide du nom du noeud, du nom du serveur, du protocole de connexion local et du protocole de connexion à distance.
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.

Tableau 2. Description des arguments de configureApplicationServerClassloader. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur, aux règles, au mode et au nom de bibliothèque.
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.

Tableau 3. Description des arguments de configureDynamicCache. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur, à la priorité par défaut, à la taille du cache, au nom du groupe de cache externe et au type du groupe de cache externe.
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.

Tableau 4. Description des arguments de configureEJBContainer. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur, au répertoire de passivation et au nom JNDI (Java Naming and Directory Interface) de source de données par défaut.
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]
AdminServerManagement.configureEJBContainer(myNode, myServer, C:\temp\myDir, jndi1)
[AIX][Solaris][Linux][HP-UX][IBM i][z/OS]
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.

Tableau 5. Description des arguments de configureFileTransferService. Exécutez le script à l'aide du nom de noeud, du nom de serveur, du nombre de nouvelles tentatives de transfert du fichier et du délai d'attente entre chaque nouvelle tentative de transfert de fichier.
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é.

Tableau 6. Description des arguments de configureListenerPortForMessageListenerService. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur, au nom du port du programme d'écoute, au nom JNDI de la fabrique de connexions, au nom JNDI de destination, au nombre maximum de messages, au nombre maximum de nouvelles tentatives et au nombre maximum de sessions.
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é.

Tableau 7. Description des arguments de configureMessageListenerService. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur, au nombre maximum de nouvelles tentatives du programme d'écoute des messages, à l'intervalle de reprise du programme d'écoute, au seuil de mise en pool et au délai d'expiration de mise en pool.
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.

Tableau 8. Description des arguments de configureStateManageable. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur, au type de parent et à l'état initial.
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.

Tableau 9. Description des arguments de configureCustomProperty. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur, au type de parent, au nom de propriété et à la valeur de propriété.
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.

Tableau 10. Description des arguments de configureCustomService. Exécutez le script à l'aide du nom de noeud, du nom de serveur et du type de connecteur préféré.
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]
AdminServerManagement.configureCustomService("myNode", "myServer", "myClass", "myName", "C:\temp\boo.jar",
     [["description", "test custom service"], ["enable", "true"]])
[AIX][HP-UX][Linux][Solaris][IBM i][z/OS]
AdminServerManagement.configureCustomService("myNode", "myServer", "myClass", "myName", "/temp/boo.jar",
     [["description", "test custom service"], ["enable", "true"]])

configureEndPointsHost

Tableau 11. Description des arguments de configureEndPointsHost. Exécutez ce script pour configurer le nom d'hôte des terminaux de serveur. Indiquez le nom de noeud, le nom de serveur et le nom d'hôte.
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.

Tableau 12. Description des arguments de configureJavaVirtualMachine. Exécutez le script à l'aide des arguments correspondant à l'ID configuration de la machine JVM qui vous intéresse, à l'activation ou non du mode débogage et aux arguments de débogage supplémentaires.
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.

Tableau 13. Description des arguments de configureORBService. Exécutez le script en indiquant les arguments nom de noeud, nom de serveur, expiration de demande, nombre de nouvelles tentatives de demande, délai entres les tentatives de demande, taille maximale du cache de connexion, taille minimale du cache de connexion et expiration de demande de localisation.
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.

[AIX Solaris HP-UX Linux Windows][IBM i]requestRetriesCount

[AIX Solaris HP-UX Linux Windows][IBM i]Indique le nombre de fois que l'ORB tente d'envoyer une demande en cas d'échec d'un serveur. Les tentatives permettent parfois de restaurer le système en cas d'échec temporaire du réseau. Cette zone est ignorée sur la plateforme z/OS.

[AIX Solaris HP-UX Linux Windows][IBM i]requestRetriesDelay

[AIX Solaris HP-UX Linux Windows][IBM i]Indique le nombre de millisecondes séparant deux tentatives. Cette zone est ignorée sur la plateforme z/OS.

[AIX Solaris HP-UX Linux Windows][IBM i]connectionCacheMax

[AIX Solaris HP-UX Linux Windows][IBM i]Indique le nombre maximal d'entrées pouvant figurer dans la cache des connexions ORB avant que l'ORB ne commence à supprimer les connexions inactives de la cache. Cette zone est ignorée sur la plateforme z/OS. Il est possible que le nombre de connexions actives figurant dans la cache dépasse temporairement ce seuil. Si nécessaire, l'ORB continue d'ajouter des connexions tant que des ressources sont disponibles.

[AIX Solaris HP-UX Linux Windows][IBM i]connectionCacheMin

[AIX Solaris HP-UX Linux Windows][IBM i]Indique le nombre minimal d'entrées pouvant figurer dans la cache des connexions ORB. Cette zone est ignorée sur la plateforme z/OS. L'ORB ne supprime par les connexions inactives lorsque le nombre d'entrées est inférieur à cette valeur.

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.

Pour exécuter le script, indiquez les arguments nom de noeud et nom de serveur, comme indiqué dans le tableau suivant :
Tableau 14. Description des arguments de configureProcessDefinition. Exécutez le script à l'aide du nom de noeud, du nom de serveur et, le cas échéant, d'autres paramètres.
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.

Tableau 15. Description des arguments de configureRuntimeTransactionService. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur, au délai d'expiration de la durée de vie totale des transactions et au délai d'inactivité du client.
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][IBM i]

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.

Tableau 16. Description des arguments de configureThreadPool. Exécutez le script à l'aide du nom de noeud, du nom de serveur, du type de parent, du nom du pool d'unités d'exécution, de sa taille maximale, de sa taille minimale et du délai avant expiration.
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.

Tableau 17. Description des arguments de configureTransactionService. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur, au délai d'expiration de la durée de vie totale des transactions, au délai d'inactivité du client, au délai d'expiration de transaction maximum, au nombre maximal de tentatives heuristiques, au délai d'attente entre les tentatives heuristiques, au délai d'expiration de la durée de vie des transactions gérées par bean (BMT) ou propagées et au délai d'expiration de réponse asynchrone.
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.

Tableau 18. Description des arguments de setJVMProperties. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur, au chemin d'accès aux classes, au chemin d'accès aux classes d'initialisation, à la taille initiale de la pile, à la taille maximale de la pile, à l'activation ou non du mode débogage et au débogage.
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]
AdminServerManagement.setJVMProperties(myNode, myServer, "c:\a.jar", "", "”, "", "", "")
[Linux][AIX][HP-UX][Solaris][z/OS][IBM i]
AdminServerManagement.setJVMProperties(myNode, myServer, "/a.jar", "", "”, "", "", "")

setTraceSpecification

Ce script définit la spécification de trace pour votre configuration.

Tableau 19. Description des arguments de setTraceSpecification. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur et à la spécification de trace.
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.

Tableau 20. Description des arguments de configureCookieForServer. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur, au nom de cookie, au domaine, à la durée de vie maximale du cookie et à la sécurisation ou non du cookie.
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.

Tableau 21. Description des arguments de configureHTTPTransportForWebContainer. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur ; indiquez également si le port doit être ajusté, si le transport HTTP pour le conteneur est externe, la configuration SSL (Secure Socket Layer) à utiliser et si le protocole SSL doit être activé.
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.

Tableau 22. Description des arguments de configureSessionManagerForServer. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur et à la persistance de session.
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.

Tableau 23. Description des arguments de configureWebContainer. Exécutez le script à l'aide du nom de noeud, du nom de serveur et du nom d'hôte virtuel par défaut et en indiquant si le cache de servlet est activé ou non.
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 :
default_host
Le produit fournit un hôte virtuel par défaut avec certains alias courants comme l'adresse IP de la machine, le nom d'hôte abrégé et le nom d'hôte complet. L'alias constitue la première partie du chemin d'accès d'une ressource, comme un servlet. Par exemple, il s'agit de localhost:9080 dans la demande http://localhost:9080/monServlet.
admin_host
Il s'agit d'un autre nom du serveur d'applications ; également appelé serveur1 dans l'installation de base. Ce processus supporte l'utilisation de la console d'administration.
proxy_host
L'hôte virtuel appelé proxy_host comprend des définitions de port par défaut, ports 80 et 443, qui sont généralement initialisées dans le cadre de l'initialisation du serveur proxy. Utilisez cet hôte proxy comme il convient sans règles de routage associées au serveur proxy.
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.

Tableau 24. Description des arguments de configureJavaProcessLogs. Exécutez le script en indiquant la définition de processus Java qui vous intéresse et le répertoire racine des journaux de processus.
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]
AdminServerManagement.configureJavaProcessLogs
   ("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaProcessDef_1184194176408)",
   C:\temp\myJavaLog, [[stdinFilename, c:\temp\mystdin.log]])
[AIX][HP-UX][Solaris][Linux][IBM i][z/OS]
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.

Tableau 25. Description des arguments de configurePerformanceMonitoringService. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur, l'activation ou non de PMI et le niveau de spécification initial.
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.
NONE (Aucun)
Toutes les statistiques sont désactivées.
De base
Fournit un contrôle de base pour les ressources et les applications du serveur d'applications. Cela inclut notamment les composants Java Platform Enterprise Edition (Java EE), les informations relative à la session HTTP, à l'utilisation de l'UC et les 38 meilleures statistiques. Il s'agit du paramètre par défaut.
Etendu
Offre un contrôle étendu, incluant le niveau de contrôle de base, plus un moniteur de charge de travail, un assistant de performances et des modèles de ressources Tivoli. Fournit les statistiques clés étendues des composants WebSphere Application Server les plus utilisés.
Tous
Permet d'activer toutes les statistiques.
personnalisé
Offre un contrôle précis permettant d'activer ou de désactiver chaque statistique.
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

Ce script configure les mesures des requêtes PMI. Les mesures des requêtes fournissent des données relatives à chaque transaction, en effectuant une corrélation de ces informations entre les différents composants produit, ceci afin de fournir un aperçu bout à bout de la transaction.
Tableau 26. Description des arguments de configurePMIRequestMetrics. Exécutez le script et indiquez si les mesures de requêtes et le niveau de trace doivent être activés.
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.
NONE
Aucune instrumentation.
HOPS
Génère des informations d'instrumentation uniquement sur les limites du processus (par exemple, une requête de servlet venant d'un navigateur ou d'un serveur Web et une requête JDBC allant vers une base de données).
PERFORMANCE_DEBUG
Génère des données au niveau Sauts et au premier niveau de l'appel du servlet intra-processus et des EJB (Enterprise JavaBeans) (par exemple, quand un servlet entrant est réacheminé vers un servlet et un EJB entrant appelle un autre EJB). Les autres appels intra-processus comme le nommage et le bus d'intégration de services (SIB) ne sont pas activés à ce niveau.
DEBUG
Fournit des données d'instrumentation détaillées, dont les temps de réponse pour tous les appels intra-processus. Les requêtes adressées aux filtres du servlet seront uniquement instrumentées à ce niveau.
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]

configureRASLoggingService

Ce script configure la journalisation RAS de votre serveur d'applications.
Tableau 27. Description des arguments de configureRASLoggingService. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur et au répertoire racine des journaux RAS.
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

Ce script configure les journaux de serveur du serveur d'applications qui vous intéresse.
Tableau 28. Description des arguments de configureServerLogs. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur et au répertoire racine des journaux du serveur.
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]
AdminServerManagement.configureServerLogs(myNode, myServer, C:\temp\mylog, 
   [["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]])
[AIX][HP-UX][Solaris][Linux][IBM i][z/OS]
AdminServerManagement.configureServerLogs(myNode, myServer, /temp/mylog, 
   [["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]])

configureTraceService

Ce script configure les paramètres de trace pour le serveur d'applications. Configurez la trace pour obtenir des informations détaillées sur l'exécution du serveur d'applications.
Tableau 29. Description des arguments de configureTraceService. Exécutez le script à l'aide des arguments correspondant au nom de noeud, au nom de serveur, à la spécification de trace et au type de sortie.
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"]])

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7libserver
Nom du fichier : rxml_7libserver.html