Le serveur ClearQuest Web doit être en cours d'exécution lorsque vous utilisez l'outil wsadmin.
Les attributs MBean sont classés par le MBean qui les contient. Vous pouvez récupérer tous les paramètres signalés par un [R] qui signifie lecture. Les paramètres modifiables sont signalés par un [W] pour write (écriture). Vous pouvez accéder aux attributs en utilisant l'outil wsadmin d'IBM WebSphere Application Server dotés de commandes Jacl (Java Application Control Language). Le fichier teamAdminUtils.jacl fournit des exemples de commande Jacl, de syntaxe et de fonctions. Vous pouvez également modifier certains attributs MBean du serveur ClearQuest Web en utilisant la fenêtre Configuration du site.
Vous ne pouvez modifier les paramètres MBean modifiables que tant que le serveur ClearQuest Web est en cours d'exécution. Les changements prennent effet immédiatement, sans avoir à redémarrer le processus serveur. Les changements apportés aux attributs MBean qui régissent le démarrage des processus du serveur dorsal Open Network Computing Remote Procedure Call (ONC RPC) n'ont aucune incidence sur les processus du serveur dorsal ONC RPC en cours d'exécution. Seuls les nouveaux processus du serveur dorsal ONC RPC utilisent les nouveaux paramètres.
Deux Mbeans sont créés lorsque le serveur ClearQuest Web démarre : TeamServerMBean, qui contient les attributs de configuration du serveur ClearQuest Web et CqServerFactoryMBean, qui contient les attributs de la fabrique de connexions gérées par ClearQuest.
La fabrique de connexions gérées par ClearQuest est le composant du serveur ClearQuest Web en charge du démarrage d'un ou de plusieurs processus de serveur dorsal ONC RPC ClearQuest à unités d'exécutions multiples. Etant donné que chaque processus RPC ClearQuest est à unités d'exécutions multiples, il peut traiter des requêtes provenant de nombreuses données d'identification différentes. La fabrique de connexions gérées par ClearQuest gère automatiquement le cycle de vie de chaque processus RPC ClearQuest.
Attribut MBean | Contrôle d'accès | Description |
---|---|---|
attachmentTempLocation | [R,W] | Indique un répertoire pour le stockage des pièces jointes. Par défaut, les pièces jointes sont stockées dans la structure de répertoire de profil WAS. Toutefois, Windows limite la longueur des chemins d'accès à environ 250 octets. Si le nom de fichier de la pièce jointe dépasse 150 octets environ, ClearQuest peut échouer à stocker la pièce jointe car son chemin d'accès complet dans l'emplacement de stockage par défaut dépassera les 250 octets. |
cqFulltextSearchCacheSize | [R,W] | Nombre d'occurrences d'enregistrements sauvegardées dans la mémoire système ClearQuest pour une seule recherche en texte intégral. La valeur par défaut est 0 (non défini). Une valeur positive remplace le paramètre par défaut de la mémoire système ClearQuest. |
cqFulltextSearchRecordHitLimit | [R,W] | Nombre maximal d'occurrences d'enregistrements renvoyés dans un seul appel du service Web de recherche en texte intégral. Ce nombre représente également le nombre d'occurrences pouvant être mis en cache dans le serveur d'applications. La valeur par défaut est 100. |
cqLoginSessionTimeout | [R,W] | Durée de conservation en secondes d'une session de connexion Rational ClearQuest avant qu'elle n'expire. La valeur par défaut est 1800 secondes (30 minutes). Chaque session ClearQuest utilise une connexion à une base de données. Si la définition de cette valeur est trop élevée, vous risquez d'utiliser les ressources sur une durée plus longue que nécessaire. La valeur par défaut ne doit pas être modifiée. |
cqLoginSessionWaitTimeout | [R,W] | Durée en secondes pendant laquelle une unité d'exécution peut attendre avant d'obtenir une session de connexion Rational ClearQuest. La valeur par défaut est de 300 secondes. |
cqServerFactory | [R] | nom d'objet du MBean de la fabrique de connexions J2EE Connector de ClearQuest. |
cqUserDBListSecureAccess | [R,W] | Indique si les utilisateurs peuvent afficher la liste des bases de données lors d'une tentative de connexion à ClearQuest Web avec des données d'identification non valides. La valeur par défaut est FALSE. Elle indique que les utilisateurs ne peuvent pas voir la liste de bases de données s'ils tentent de se connecter avec des informations d'identification non valides. Si cette valeur est définie sur TRUE, l'authentification des utilisateurs est activée, empêchant les utilisateurs non autorisés de voir la liste des bases de données. |
ejbBufferLimit | [R,W] | Nombre maximal d'objets renvoyés par un appel EJB. La valeur par défaut est 100. |
keepAliveInterval | [R,W] | Si cet attribut est défini sur une valeur supérieure à 0 seconde, le serveur ClearQuest Web émet un message d'état actif entre le client et les composants du serveur dorsal à des intervalles périodiques spécifiés. Cet attribut permet d'assurer que les requêtes ClearQuest à exécution longue peuvent se terminer sans avoir à supprimer les sockets sous-jacents. Cette valeur doit être inférieure d'au moins 10 secondes aux délais d'attente des sockets. La valeur par défaut est de 300 secondes (5 minutes). |
largeReadSocketTimeoutMultiplier | [R,W] | Multiplicateur à appliquer à la valeur du délai d'attente de lecture sur le socket entre la plateforme médiane et le composant du serveur dorsal pour certaines opérations très longues. La valeur par défaut, 4, signifie que la valeur du délai d'attente du connecteur de lecture est égale à quatre fois la valeur par défaut du délai d'attente du socket de lecture de la fabrique du serveur dorsal. Ce multiplicateur est appliqué uniquement à certaines opérations. Ne modifiez pas cette valeur à moins que le support IBM ne vous demande de le faire. |
maxCqSessionsPerUser | [R,W] | Nombre maximal de sessions ClearQuest créées pour chaque utilisateur au cours d'une session. La valeur par défaut est 2 ; la valeur minimale est 1. |
maxProcureServerAttempts | [R,W] | Nombre maximal de tentatives autorisées pour l'obtention d'un serveur dorsal ONC RPC avant qu'une exception ne soit renvoyée au pool de connexions gérées. La valeur par défaut est 6 ; cette valeur doit être supérieure ou égale à 2. |
mediumReadSocketTimeoutMultiplier | [R,W] | Multiplicateur à appliquer à la valeur d'expiration de lecture sur le connecteur entre le niveau intermédiare et le composant du serveur dorsal pour certaines opérations très longues. La valeur par défaut 2 indique que la valeur d'expiration de lecture sur le connecteur est deux fois plus grande que la valeur par défaut d'expiration de lecture sur le connecteur de fabrique de serveur dorsal. Ce multiplicateur est appliqué uniquement à certaines opérations. Ne changez pas la valeur à moins que le support IBM ne vous demande de le faire. |
numberOfActiveSessions | [R] | Nombre de sessions actives actuellement gérées par le serveur. |
numberOfHttpSessionsCreated | [R] | Nombre de sessions gérées par ce serveur. |
oncrpcBufferLimit | [R,W] | Nombre maximal d'objets renvoyés dans un seul appel ONC RPC. La valeur par défaut est 100. |
oncrpcInterruptLimit | [R,W] | Nombre maximal d'objets renvoyés pour une demande d'utilisateur. La valeur par défaut est 1 000. |
oncrpcServers | [R] | Noms des objets des MBean du serveur ONC RPC en cours d'exécution. |
procureServerInterval | [R,W] | Durée en secondes pendant laquelle une unité d'exécution de demande peut attendre pour obtenir un serveur avant de renvoyer une exception au pool de connexions gérées. la valeur par défaut est 60 secondes. |
sessionObjectDefaultTimeout | [R,W] | Durée par défaut, en secondes, pendant laquelle un objet est conservé dans une session. La valeur par défaut est 1800 secondes (30 minutes). Cette valeur soit être supérieure ou égale à 0. |
sessionQueryObjectTimeout | [R,W] | Durée pendant laquelle une session de connexion ClearQuest est conservée avant d'arriver à expiration si une requête nouvelle ou modifiée n'est pas distribuée. Cette valeur ne peut être inférieure à cqLoginSessionTimeout. La valeur par défaut est 1800 secondes (30 minutes). Cette valeur remplace la valeur définie par sessionObjectDefaultTimeout. |
sessionRecordObjectTimeout | [R,W] | Durée pendant laquelle une session de connexion ClearQuest est conservée avant d'arriver à expiration si un enregistrement nouveau ou modifié n'est pas distribué. Cette valeur ne peut être inférieure à cqLoginSessionTimeout. La valeur par défaut est 10 800 secondes (3 heures). Cette valeur remplace la valeur définie par sessionObjectDefaultTimeout. |
sessionReaperThreadDelay | [R,W] | Temporisation de l'unité d'exécution du moissonneur de sessions. La valeur par défaut est de 900 secondes (soit 15 minutes). Les valeurs admises vont de 300 à 1800 secondes. Vous pouvez diminuer cette valeur si la mémoire virtuelle est très sollicitée ou l'augmenter si l'unité centrale est trop utilisée. |
totalNumberOfOncrpcServers | [R] | Nombre de serveurs dorsaux RPC en cours d'exécution dans toutes les instances de fabrique de connexion Rational ClearQuest. |
totalOncrpcCallCount | [R] | Nombre d'appels ONC RPC effectués depuis le démarrage du serveur. |
totalWebServiceCallCount | [R] | Nombre d'appels de services Web effectués depuis le démarrage du serveur. |
versionNumber | [R] | Numéro de version du serveur ClearQuest Web exprimé sous forme d'une valeur de chaîne séparée par des points. Par exemple 7.1.2.1. |
Attribut MBean | Contrôle d'accès | Description |
---|---|---|
activeHttpSessionThreshold | [R,W] | Nombre de sessions HTTP actives sur un serveur dorsal ONC RPC ClearQuest actif. Si ce nombre est dépassé, la fabrique de connexions gérées risque de démarrer un autre serveur ONC RPC ClearQuest dorsal. La valeur par défaut est de 30. |
cqrpcAbandonedProcessCleanupEnabled | [R,W] | Indique si le serveur ClearQuest Web démarre la procédure de nettoyage qui termine les processus RPC ClearQuest abandonnés. La valeur par défaut est TRUE. |
cqrpcAbandonedProcessCleanupInterval | [R,W] | Intervalle périodique en minutes que le serveur ClearQuest Web utilise pour démarrer la procédure de nettoyage visant à terminer les processus RPC ClearQuest abandonnés. La valeur par défaut est 30 minutes. Cette valeur doit être supérieure ou égale à 0. Cet intervalle fonctionne dans la puissance de 2 la plus proche. Une valeur de 0 signifie que l'intervalle est défini sur 2. |
maximumActiveServers | [R,W] | Nombre maximal de serveurs dorsaux ONC RPC ClearQuest actifs autorisés par cette fabrique de connexions gérées. La valeur par défaut est 10. |
recycleServerHttpSessionLimi | [R,W] | Nombre de sessions HTTP sessions qu'un serveur dorsal ONC RPC ClearQuest traite avant d'être recyclé par la fabrique de connexions gérées. La valeur par défaut est 200. Une valeur de zéro signifie que cette limite n'est pas vérifiée. |
recycleServerLifetimeLimit | [R,W] | Durée de vie maximale en secondes pendant laquelle un serveur dorsal ONC RPC ClearQuest peut fonctionner avant d'être recyclé par la fabrique de connexions gérées. La valeur par défaut est 86 400 secondes (24 heures). Une valeur de zéro signifie que cette limite n'est pas vérifiée. |
recycleServerOncrpcCallLimit | [R,W] | Nombre maximal de demandes ONC RPC qu'un serveur dorsal ONC RPC ClearQuest traite avant d'être recyclé par la fabrique de connexions gérées. La valeur par défaut est 100 000. Une valeur de zéro signifie que cette limite n'est pas vérifiée. |
recyclingPeriod | [R,W] | Durée en secondes qu'un serveur dorsal ONC RPC ClearQuest en cours de recyclage s'accorde pour mettre fin aux tâches de session avant d'être arrêté par la fabrique de connexions gérées. L'état d'un serveur dorsal ONC RPC ClearQuest est 2 (STOPPING). La valeur par défaut est 1 800 secondes (30 minutes). Cette valeur soit être supérieure à 0. |
remoteChartReportServerHostName | [R,W] | ![]() ![]() |
remoteChartReportServerPort | [R,W] | ![]() ![]() |
serverWorkerThreadCount | [R,W] | Nombre d'unités d'exécution qu'un serveur dorsal ONC RPC ClearQuest utilise pour gérer les demandes entrantes. La valeur par défaut est 30. |
Attribut MBean | Contrôle d'accès | Description |
---|---|---|
hostname | [R] | Nom de l'hôte sur lequel le serveur dorsal ONC RPC s'exécute. |
oncrpcCalls | [R] | Nombre total d'appels ONC RPC gérés par le serveur dorsal ONC RPC. |
port | [R] | Numéro (entier) du port d'écoute du serveur dorsal ONC RPC. |
serverId | [R] | ID unique du serveur dorsal ONC RPC. |
serverStartTime | [R] | Horodatage du démarrage du serveur dorsal ONC RPC. Cette valeur correspond à la durée en millisecondes depuis le 1er janvier 1970 à 00:00:00 GMT. |
serverState | [R] | Etat en cours du serveur dorsal ONC RPC, représenté par un nombre entier (0=STOPPED, 1=RUNNING, 2=STOPPING, 3=DEAD). |
serverStoppingTime | [R] | Horodatage signalant le passage du serveur dorsal ONC RPC à l'état STOPPING (2). Cette valeur correspond à une durée en millisecondes depuis le 1er janvier 1970 à 00:00:00 GMT. |
serverStopTime | [R] | Horodatage signalant le passage du serveur dorsal ONC RPC à l'état STOPPED (0) ou DEAD (3). Cette valeur correspond à une durée en millisecondes depuis le 1er janvier 1970 à 00:00:00 GMT. |
serverType | [R] | Type du serveur dorsal ONC RPC : Rational ClearQuest. |
Le processus CqOncrpcServerMBean est une extension du processus OncrpcServerMBean. Chaque processus CqOncrpcServerMBean contient toutes les valeurs définies par le processus OncrpcServerMBean et les attributs qui sont décrits dans la Table 4.
Attribut MBean | Contrôle d'accès | Description |
---|---|---|
activeHttpSessions | [R] | Nombre de sessions HTTP actives en cours de traitement par le serveur dorsal ONC RPC ClearQuest. |
activeStatefulHttpSessions | [R] | Nombre de sessions HTTP avec état en cours de traitement par le serveur dorsal ONC RPC ClearQuest. |
recycleReasonCode | [R] | Code raison indiquant la raison pour laquelle le serveur dorsal ONC RPC ClearQuest
est en cours de recyclage. Cet attribut correspond à une valeur entière.
|
recycleServerHttpSessionLimit | [R,W] | Nombre maximal de sessions que peut gérer le serveur dorsal ONC RPC ClearQuest avant d'être recyclé. Sa valeur par défaut est définie à l'aide de la valeur de l'attribut recycleServerHttpSessionLimit dans CqServerFactoryMBean. Cette valeur ne peut être définie que dans un serveur dorsal ONC RPC ClearQuest en cours d'exécution. Tous les processus serveur dorsaux ONC RPC sont volatils. La définition de cette valeur dans un serveur ONC RPC ClearQuest en cours d'exécution risque d'échouer si le serveur est arrêté par la fabrique de connexions gérées ClearQuest. |
totalHttpSessions | [R] | Nombre de sessions HTTP que le serveur dorsal ONC RPC ClearQuest peut prendre en charge. |
workerThreadCount | [R] | Nombre d'unités d'exécution qu'un serveur dorsal ONC RPC ClearQuest utilise pour traiter les demandes. |
Utilisation de l'outil wsadmin afin de récupérer et de définir les attributs MBean
Cet exemple présente les commandes Jacl permettant de démarrer et d'utiliser l'outil wsadmin.
// Cette section fournit des exemples de commandes permettant de démarrer et d'utiliser l'outil wsadmin.
// A des fins d'illustration, une invite de commande du système d'exploitation est désignée par le
// caractère dièse "#" et l'invite de commande wsadmin est désignée par "wsadmin>".
//
// Il existe des scripts pour l'outil wsadmin du serveur ClearQuest Web qui fournissent diverses
// méthodes et fonctions de simplification. Par défaut, ces scripts se trouvent dans le répertoire
// suivant :
// Sous Windows :
// "C:\Program Files\IBM\RationalSDLC\common\CM\scripts"
// Sous UNIX ou Linux :
// "/opt/rational/common/CM/scripts" sous UNIX ou Linux.
//
// Ouvrez une invite de commande et définissez votre répertoire par défaut sur l'emplacement
// des scripts pour l'outil wsadmin du serveur ClearQuest Web. Par exemple :
//
// Sous Windows :
# cd "C:\Program Files\IBM\RationalSDLC\common\CM\scripts"
//
// Sous UNIX ou Linux :
# cd /opt/rational/common/CM/scripts
//
// Définissez la variable d'environnement WAS_BIN sur l'emplacement de l'outil wsadmin
// avec la syntaxe appropriée à l'interpréteur de commandes que vous préférez. Par exemple :
//
// Sous Windows :
# set WAS_BIN="C:\Program Files\IBM\RationalSDLC\common\eWAS\bin"
// Sous UNIX ou Linux :
# WAS_BIN=/opt/rational/common/eWAS/bin
// Démarrez l'utilitaire wsadmin en indiquant le nom de profil du serveur ClearQuest Web.
// Le nom de profil du serveur ClearQuest Web par défaut est 'cmprofile'. Par exemple :
//
// Sous Windows :
# %WAS_BIN%\wsadmin -profileName cmprofile
// Sous UNIX ou Linux :
# $WAS_BIN/wsadmin.sh -profileName cmprofile
// La commande wsadmin suivante charge les fonctions de simplification de l'outil wsadmin du serveur ClearQuest Web :
wsadmin> source teamAdminUtils.jacl
// La commande suivante montre comment afficher des commandes du serveur ClearQuest Web qui peuvent être utiles.
// La fonction getTeamServer sert à créer un pointeur vers le TeamServerMBean
// de niveau supérieur et permet d'obtenir et de définir les différents attributs TeamServerMBean.
//
wsadmin> info proc *Team*
startTeamEAR stopTeamEAR getTeamServer
// La commande suivante affiche les commandes de "vidage" disponibles, qui permettent de
// visualiser rapidement et facilement les valeurs MBean :
wsadmin> info proc dump*
dumpAllServers dumpAll dumpTeamServer dumpCcServers dumpCqServerFactory
dumpCcServerFactory dumpCqServers
// La commande suivante utilise la commande de simplification "getTeamServer" pour définir la
// variable "t", qui peut ensuite servir à accéder aux attributs TeamServerMBean :
wsadmin> set t [getTeamServer]
// Cette commande récupère les valeurs des attributs TeamServerMBean à l'aide de la variable "t" :
wsadmin> $AdminControl getAttributes $t
{cqServerFactory WebSphere:cell=testhost2Node01Cell,version=6.1.0.0,spec=1.0,name=CqServerFactoryMBeanId,
mbeanIdentifier=CqServerFactoryMBeanId,type=stp.management.CqServerFactoryMBean,node=testhost2Node01,
process=server1}
{oncrpcBufferLimit 100}
{cqLoginSessionWaitTimeout 300}
{oncrpcInterruptLimit 1000}
{sessionReaperThreadDelay 900}
{sessionQueryObjectTimeout 1800}
{oncrpcServers {
{cqLoginSessionTimeout 1800}
{cqFulltextSearchRecordHitLimit 100}
{ejbBufferLimit 100}
{sessionRecordObjectTimeout 10800}
{cqFulltextSearchPageSize 25}
{numberOfActiveSessions 0}
{sessionObjectDefaultTimeout 1800}
{maxProcureServerAttempts 6}
{cqFulltextSearchCacheSize 1000}
{maxCqSessionsPerUser 2}
{totalNumberOfOncrpcServers 0}
{numberOfHttpSessionsCreated 0}
{procureServerInterval 60}
// Voici une manière plus pratique pour extraire tous les attributs TeamServerMBean :
wsadmin> dumpTeamServer
Attributs TeamServerMBean :
====================
{cqServerFactory WebSphere:cell=testhost2Node01Cell,version=6.1.0.0,spec=1.0,name=CqServerFactoryMBeanId,
mbeanIdentifier=CqServerFactoryMBeanId,type=stp.management.CqServerFactoryMBean,node=testhost2Node01,
process=server1}
// Autres commandes "get" de simplification très utiles : getCqServerFactory, getTeamServer
// et getOncrpcServers.
// La commande suivante définit la variable "cq" permettant d'accéder à CqServerFactoryMBean.
// Notez que la variable "t" définie dans une commande antérieure sert à
// obtenir un pointeur désignant la valeur de l'attribut cqServerFactory du TeamServerMBean ;
// la variable "cq" peut alors être utilisée pour accéder aux attributs contenus dans le CqServerFactoryMBean :
wsadmin> set cq [$AdminControl getAttribute $t cqServerFactory]
// Voici une manière plus pratique de configurer la variable 'cq' :
wsadmin>set cq [getCqServerFactory]
// La commande suivante extrait les valeurs de l'attribut CqServerFactoryMBean à l'aide de
// la variable "cq" défini plus haut :
wsadmin> $AdminControl getAttributes $cq
. . .
// La commande suivante définit la variable "os" permettant d'accéder à la liste
// des MBeans du serveur ONCRPC, chacun représentant un serveur dorsal ONCRPC spécifique.
// La commande utilise une des méthodes de simplification définies dans le script teamAdminUtils.jacl
// qui a été 'dérivé' au début de cette session :
wsadmin> set os [$AdminControl invoke $t getOncrpcServers]
. . .
// Une liste de serveurs dorsaux oncrpc s'affiche. Le premier
// est indexé avec la valeur 0 (zéro), le deuxième avec la valeur 1 et ainsi de suite.
// La commande suivante définit la variable "o" permettant d'accéder au premier MBean du serveur oncrpc
// affiché en sortie de la commande précédente. Ce niveau d'accès à l'attribut MBean
// (c'est-à-dire aux MBeans spécifiques au serveur oncrp) est délicat, car les processus dorsaux du serveur oncrpc sont
// transitoires et pourraient disparaître avant que vous ne puissiez y accéder.
wsadmin> set o [getOnc 0] // "0" représente le numéro d'index du premier serveur dorsal
// indiqué en sortie de la commande précédente.
// La commande suivante extrait les valeurs de l'attribut MBean pour le serveur oncrpc CQ
// défini par la variable 'o' :
wsadmin> $AdminControl getAttributes $o
{workerThreadCount 16}
{serverState 1}
{activeStatefulHttpSessions 0}
{port 3431}
{oncrpcCalls 7}
{recycleServerHttpSessionLimit 500}
{serverId {ClearQuest - 0
{serverType ClearQuest}
{hostname testhost2}
{activeHttpSessions 0}
{totalHttpSessions 1}
// Les commandes suivantes définissent puis récupèrent l'attribut recycleServerHttpSessionLimit
// du serveur oncrpc CQ défini précédemment par la variable "o" :
wsadmin> $AdminControl setAttribute $o recycleServerHttpSessionLimit 501
wsadmin> $AdminControl getAttribute $o recycleServerHttpSessionLimit
501
// Les commandes restantes indiquent divers moyens supplémentaires d'accéder aux MBeans des serveurs oncrpc et de les afficher.
// N'oubliez pas que la liste des serveurs ONCRPC est transitoire ; les commandes de vidage telles que
// dumpCqServers ou dumpAllServers peuvent s'avérer bien plus utiles :
wsadmin> listOnc
"WebSphere:cell=testhost2Node02Cell,version=6.1.0.0,spec=1.0,
name=ClearQuest - 11,mbeanIdentifier=ClearQuest - 11,
type=stp.management.CqOncrpcServerMBean,node=testhost2Node02,
process=server1"
// Voici quelques exemples d'informations affichées suite au lancement des commandes dump de simplification :
wsadmin> dumpAllServers
Serveur ONCRPC : ClearQuest - 0
============
{workerThreadCount 10}
{serverState 1}
{activeStatefulHttpSessions 0}
{port 3693}
{oncrpcCalls 1}
{recycleServerHttpSessionLimit 500}
{serverStartTime 1215633895763}
{serverId {ClearQuest - 0
{recycleReasonCode 0}
{serverType ClearQuest}
{hostname testhost2}
{activeHttpSessions 0}
{totalHttpSessions 0}
wsadmin> dumpCqServers
Serveur CQRPC : ClearQuest - 0
===========
{workerThreadCount 10}
{serverState 1}
{activeStatefulHttpSessions 0}
{port 3693}
{oncrpcCalls 1}
{recycleServerHttpSessionLimit 500}
{serverStartTime 1215633895763}
{serverId {ClearQuest - 0
{recycleReasonCode 0}
{serverType ClearQuest}
{hostname duke2}
{activeHttpSessions 0}
{totalHttpSessions 0}
wsadmin> dumpCqServerFactory
Attributs CqServerFactoryMBean :
==========================
{serverWorkerThreadCount 10}
{recycleServerLifetimeLimit 14400}
{recyclingPeriod 3600}
{recycleServerOncrpcCallLimit 500000}
{recycleServerHttpSessionLimit 500}
{maximumActiveServers 4}
{activeHttpSessionThreshold 40}
wsadmin> dumpAll
// Cette commande permet d'afficher en sortie l'ensemble des valeurs des attributs du MBean, y compris
// ceux des processus dorsaux du serveur ONCRPC en cours d'exécution.
Utilisation de l'outil wsadmin afin d'importer et d'exporter les attributs MBean
Utilisez l'outil wsadmin avec les commandes de simplification import et export du serveur ClearQuest Web afin de respectivement importer et exporter des attributs MBean. Ces commandes permettent de récupérer et de mettre à jour les valeurs d'attributs MBean, ainsi que de fournir une méthode de capture de configurations spécifiques simple. Si le serveur ClearQuest Web ne fonctionne pas correctement, vous pouvez importer en temps réel une bonne configuration connue préalablement capturée.
Vous pouvez éditer les fichiers de propriétés à l'aide d'un éditeur de texte, puis importer et exporter ces fichiers en temps réel. Vous pouvez mettre en commentaire les entrées des fichiers de propriétés que vous n'avez pas besoin d'importer. Veillez à respecter les conventions de dénomination pour les noms et les noms d'attribut MBean. Pour effacer une valeur de chaîne lorsque vous utilisez la commande importFile, indiquez "" ou la zone de valeur vide dans le fichier de propriétés que vous importez. Ne laissez aucune valeur numérique vide.
// Cette commande wsadmin charge l'ensemble des commandes et des méthodes de simplification,
// y compris les commandes importFile et exportToFile. Ces commandes
// permettent de récupérer et de mettre à jour les valeurs d'attributs MBean et fournissent une méthode
// de capture de configurations spécifiques simple. Si le serveur Web If the ClearQuest
// (appelé dans les éditions précédentes CM Server) ne fonctionne pas
// correctement, alors vous pouvez importer une configuration capturée au préalable
// en temps réel.
wsadmin> source teamAdminUtils.jacl
// Utilisez la commande exportToFile si vous souhaitez capturer un instantané des
// MBean TeamServerMBean et CqServerFactoryMBean. Spécifiez
// le chemin d'accès complet où stocker le fichier. Vous pouvez modifier le fichier de propriétés résultant
// à l'aide d'un éditeur de texte, puis importer le fichier en utilisant
// la commande importFile.
// Important : vous devez utiliser des barres obliques dans le nom de chemin pour ces commandes.
wsadmin> exportToFile C:/temp/CmServer.properties
Le fichier "C:/temp/CmServer.properties" n'existe pas, exportation en cours...
Récupération des MBeans...
Exportation de TeamServerMBean.sessionReaperThreadDelay...
Exportation de TeamServerMBean.cqLoginSessionTimeout...
Exportation de TeamServerMBean.cqLoginSessionWaitTimeout...
Exportation de TeamServerMBean.sessionObjectDefaultTimeout...
Exportation de TeamServerMBean.sessionQueryObjectTimeout...
Exportation de TeamServerMBean.sessionRecordObjectTimeout...
Exportation de TeamServerMBean.oncrpcBufferLimit...
Exportation de TeamServerMBean.oncrpcInterruptLimit...
Exportation de TeamServerMBean.ejbBufferLimit...
Exportation de TeamServerMBean.cqFulltextSearchPageSize...
Exportation de TeamServerMBean.cqFulltextSearchCacheSize...
Exportation de TeamServerMBean.cqFulltextSearchRecordHitLimit...
Exportation de TeamServerMBean.procureServerInterval...
Exportation de TeamServerMBean.maxProcureServerAttempts...
Exportation de TeamServerMBean.maxCqSessionsPerUser...
Exportation de CqServerFactoryMBean.serverWorkerThreadCount...
Exportation de CqServerFactoryMBean.activeHttpSessionThreshold...
Exportation de CqServerFactoryMBean.maximumActiveServers...
Exportation de CqServerFactoryMBean.recycleServerHttpSessionLimit...
Exportation de CqServerFactoryMBean.recycleServerLifetimeLimit...
Exportation de CqServerFactoryMBean.recycleServerOncrpcCallLimit...
Exportation de CqServerFactoryMBean.recyclingPeriod...
wsadmin> importFile C:/temp/CmServer.properties
Fichier "C:/temp/CmServer.properties" trouvé, importation en cours...
Importation de la valeur "900" dans la propriété sessionReaperThreadDelay du TeamServerMBean MBean
Ancienne valeur = 900
Nouvelle valeur = 900
Importation de la valeur "1803" dans la propriété cqLoginSessionTimeout du TeamServerMBean MBean
Ancienne valeur = 1803
Nouvelle valeur = 1803
Importation de la valeur "300" dans la propriété cqLoginSessionWaitTimeout du TeamServerMBean MBean
Ancienne valeur = 300
Nouvelle valeur = 300
Importation de la valeur "1800" dans la propriété sessionObjectDefaultTimeout du TeamServerMBean MBean
Ancienne valeur = 1800
Nouvelle valeur = 1800
. . .
// Si vous tentez d'exporter des données vers un fichier qui existe déjà, un horodatage est ajouté au
// nom de fichier que vous indiquez dans la commande :
wsadmin> exportToFile C:/temp/CmServer.properties
Le fichier "C:/temp/CmServer.properties" existe déjà ; date ajoutée au nom de fichier.
exportFilePath s'appelle désormais : C:/temp/CmServer.properties_2008-07-09_16-27-11
Récupération des MBeans...
Exportation de TeamServerMBean.sessionReaperThreadDelay...
// Voici comment se présente habituellement un fichier exporté :
C:\> type c:\temp\CmServer.properties
# Exportation des attributs MBean du serveur ClearQuest Web, date de création : 2008-07-09_16-22-29
#
#
# Attributs inscriptibles TeamServerMBean
#
TeamServerMBean.sessionReaperThreadDelay=900
TeamServerMBean.cqLoginSessionTimeout=1803
TeamServerMBean.cqLoginSessionWaitTimeout=300
TeamServerMBean.sessionObjectDefaultTimeout=1800
TeamServerMBean.sessionQueryObjectTimeout=1803
TeamServerMBean.sessionRecordObjectTimeout=10800
TeamServerMBean.oncrpcBufferLimit=100
TeamServerMBean.oncrpcInterruptLimit=1000
TeamServerMBean.ejbBufferLimit=100
TeamServerMBean.cqFulltextSearchPageSize=25
TeamServerMBean.cqFulltextSearchCacheSize=1000
TeamServerMBean.cqFulltextSearchRecordHitLimit=100
TeamServerMBean.procureServerInterval=60
TeamServerMBean.maxProcureServerAttempts=6
TeamServerMBean.maxCqSessionsPerUser=2
#
# Attributs inscriptibles CqServerFactoryMBean
#
CqServerFactoryMBean.serverWorkerThreadCount=10
CqServerFactoryMBean.activeHttpSessionThreshold=40
CqServerFactoryMBean.maximumActiveServers=4
CqServerFactoryMBean.recycleServerHttpSessionLimit=500
CqServerFactoryMBean.recycleServerLifetimeLimit=14400
CqServerFactoryMBean.recycleServerOncrpcCallLimit=500000
CqServerFactoryMBean.recyclingPeriod=3600