Vous pouvez personnaliser le serveur Rational ClearQuest Web en définissant
les attributs MBean disponibles.
Avertissement : Ne modifiez pas des attributs MBean, sauf s'ils sont documentés comme pouvant
l'être avec la notation [W] ou qu'IBM Support ne vous demande de le faire. La modification
d'attributs MBean en lecture seule [R] ou non documentés peut avoir un impact sur les performances
du système.
Les attributs sont catégorisés par le MBean dans lequel ils résident.
Vous pouvez récupérer tous les paramètres signalés par un [R] pour read (lecture). Les paramètres modifiables sont signalés
par un [W] pour write (écriture). Vous pouvez accéder aux attributs à l'aide de l'utilitaire de ligne de commande
WebSphere Application
Server wsadmin. Le fichier teamAdminUtils.jacl
fournit des exemples de commande Jacl, de syntaxe et de fonctions. Vous pouvez également modifier
certains des attributs MBean du serveur ClearQuest Web à l'aide de la
boîte de dialogue Configuration du site.
Vous pouvez changer les paramètres MBean modifiables uniquement lorsque
le serveur ClearQuest Web est en cours d'exécution. Les changements prennent effet immédiatement, sans redémarrage du serveur. Les changements apportés aux attributs MBean qui régissent le lancement des processus du serveur dorsal Open Network Computing Remote Procedure
Call (ONC RPC) n'ont aucune incidence sur les processus ONC RPC dorsaux
déjà lancés. Seuls les nouveaux processus du serveur dorsal ONC RPC
utilisent les nouveaux paramètres.
Deux MBeans sont créés lors du démarrage du serveur ClearQuest Web :
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 ClearQuest.
La fabrique de connexions gérées ClearQuest est le composant du serveur ClearQuest Web chargé de lancer un ou plusieurs processus de serveur dorsal ClearQuest ONC RPC à unités d'exécutions multiples. Dans la mesure où chaque processus ClearQuest
RPC 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 ClearQuest gère automatiquement
le cycle de vie de chaque processus ClearQuest RPC.
Le serveur ClearQuest Web inclut les MBeans suivants :
- TeamServerMBean
Le TeamServerMBean contient les attributs relatifs au comportement global du serveur ClearQuest Web. Les attributs
spécifiques au contrôle de la manière dont la fabrique de serveur ClearQuest
fonctionne sont stockés dans la fabrique de serveur CqServerFactoryMBean.
- cqFulltextSearchCacheSize[R,W] : Nombre d'enregistrements obtenus sauvegardés dans ClearQuest
Core pour une seule recherche en texte intégral. Cette valeur est utilisée pour remplacer le comportement par défaut de ClearQuest Core. La valeur par défaut de cet attribut est "0". Pour le serveur
ClearQuest Web, cela signifie qu'elle n'est pas définie et qu'elle ne doit pas être utilisée pour remplacer le paramétrage par défaut de ClearQuest Core. Une valeur positive remplace le paramétrage par défaut de ClearQuest Core.
- cqFulltextSearchPageSize[R,W] : Nombre d'enregistrements répertoriés dans une page de
résultats de recherche en texte intégral dans ClearQuest Core, pour une seule de ces recherches. Cette valeur est utilisée pour remplacer le comportement par défaut de ClearQuest Core. La valeur par défaut de cet attribut est "0". Pour le serveur
ClearQuest Web, cela signifie qu'elle n'est pas définie et qu'elle ne doit pas être utilisée pour remplacer le paramétrage par défaut de ClearQuest Core. Une valeur positive remplace le paramètre par défaut de
ClearQuest Core.
- cqFulltextSearchRecordHitLimit[R,W] : Nombre maximal d'enregistrements obtenus renvoyés
dans un seul appel de service Web pour une seule recherche en texte intégral. Désigne également le nombre maximal
d'enregistrements obtenus pouvant être mis en cache dans un serveur d'applications. La valeur par défaut est de 100.
- cqLoginSessionTimeout - Délai, en secondes, au terme duquel une session de connexion ClearQuest arrive à expiration. La valeur par défaut est de 1800 secondes
(soit 30 minutes). Chaque session ClearQuest utilise une connexion sur la base de données, c'est pourquoi il est conseillé de définir ce paramètre avec une valeur relativement basse, afin de ne pas utiliser plus de ressources que nécessaire. La valeur par défaut ne doit pas être modifiée.
- cqLoginSessionWaitTimeout[R,W] - Délai d'attente, en secondes, d'une unité d'exécution
avant l'obtention de la session de connexion Rational ClearQuest. La valeur par défaut est de 300 secondes.
- cqServerFactory[R] : Nom d'objet du MBean de fabrique de connexions J2C
ClearQuest.
- cqUserDBListSecureAccess[R,W] : Indique si les utilisateurs peuvent afficher la liste des bases de
données lors de la tentative de connexion à ClearQuest Web avec des données d'identification
non valides. La valeur par défaut est false, indiquant que les utilisateurs peuvent afficher la liste de bases de
données s'ils tentent de se connecter avec des données d'identification non valides. Si la valeur est true,
l'authentification d'utilisateur est activée afin d'empêcher les utilisateurs d'afficher la liste de bases
de données s'ils tentent de se connecter avec des données d'identification non valides.
- ejbBufferLimit[R,W] : Nombre maximal d'objets qui seront renvoyés
par un appel EJB. La valeur par défaut est de 100.
- keepAliveInterval[R,W] : Si ce paramètre est défini sur une valeur supérieure à "0" (zéro) secondes,
le serveur ClearQuest Web générera des messages de rapport actif
entre le client et les composants du serveur dorsal aux
intervalles périodiques spécifiés si aucun trafic n'a été envoyé pendant cet intervalle.
Cela permet de s'assurer que les requêtes ClearQuest à long terme peuvent être terminées sans que
l'infrastructure ne supprime les sockets sous-jacents.
Cette valeur doit être inférieure de plus de 10 secondes au délai d'attente du connecteur. La valeur par défaut est de 300 secondes
(soit cinq minutes).
- largeReadSocketTimeoutMultiplier[R,W] : Multiplicateur à appliquer à la valeur du délai d'attente de lecture sur le connecteur entre la plateforme médiane et le composant du serveur dorsal pour certaines opérations très longues. La valeur par défaut, 4, indique 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 connecteur de lecture de la fabrique de serveur dorsal. Ce multiplicateur est appliqué uniquement à certaines opérations.
Ne modifiez pas cette valeur à moins que le service de 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é 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 de 6 ;
elle doit être supérieure ou égale à 2.
- mediumReadSocketTimeoutMultiplier[R,W] : Multiplicateur à appliquer à la valeur du délai d'attente de lecture sur le connecteur entre la plateforme médiane et le composant du serveur dorsal pour certaines opérations très longues. La valeur par défaut, 2, indique que la valeur du délai d'attente du connecteur de lecture est égale à deux fois la valeur par défaut du délai d'attente du connecteur de lecture de la fabrique de serveur dorsal. Ce multiplicateur est appliqué uniquement à certaines opérations. Ne modifiez pas cette valeur à moins que le service de support IBM ne vous demande de le faire.
- numberOfActiveSessions[R] : Nombre de sessions actives actuellement
gérées par le serveur.
- numberOfHttpSessionsCreated[R] : Nombre total de sessions ayant été gérées
par le serveur.
- oncrpcBufferLimit[R,W] : Nombre maximal d'objets qui seront renvoyés
dans un seul appel ONCRPC. La valeur par défaut est de 100.
- oncrpcInterruptLimit[R,W] : Nombre maximal d'objets qui seront renvoyés
pour une requête utilisateur. La valeur par défaut est de 1000.
- oncrpcServers[R] : Noms d'objets des MBeans du serveur
ONC RPC en cours d'exécution.
- procureServerInterval[R,W] : Délai d'attente total autorisé (en secondes) pour une unité d'exécution de demande lors d'une tentative d'obtention d'un serveur
avant qu'une exception ne soit renvoyée au pool de connexions gérées.
La valeur par défaut est de 60 secondes.
- sessionObjectDefaultTimeout[R,W] : Délai par défaut, en secondes,
pendant lequel un objet est conservé dans une session. La valeur par défaut est de 1800 secondes
(soit 30 minutes). Elle doit être supérieure ou égale à 0.
- sessionQueryObjectTimeout[R,W] : Délai au terme duquel une session de connexion ClearQuest
arrive à expiration si une requête ou un dossier de requêtes nouveaux ou modifiés
n'ont pas été mis à disposition. Cette valeur ne peut être inférieure à cqLoginSessionTimeout.
La valeur par défaut est de 1800 secondes
(soit 30 minutes). Cette valeur remplace la valeur définie par sessionObjectDefaultTimeout.
- sessionRecordObjectTimeout[R,W] : Délai au terme duquel une session de connexion ClearQuest
arrive à expiration si un enregistrement nouveau ou modifié
n'a pas été mis à disposition. Cette valeur ne peut être inférieure à cqLoginSessionTimeout.
La valeur par défaut est de 10800 secondes
(soit 3 heures). Cette valeur remplace la valeur définie par sessionObjectDefaultTimeout.
- sessionReaperThreadDelay[R,W] : Retard, en secondes, de l'unité d'exécution
du collecteur. La valeur par défaut est de 900 secondes (soit 15 minutes).
Les valeurs admises vont de
300 à 1800 secondes. Vous avez la possibilité de diminuer cette valeur si les besoins en mémoire virtuelle sont importants. Vous pouvez également l'augmenter si les ressources CPU sont insuffisantes.
- totalNumberOfOncrpcServers[R] : Nombre de serveurs dorsaux RPC en cours d'exécution dans toutes les instances de fabrique de connexions Rational ClearQuest.
- totalOncrpcCallCount[R] : Nombre total d'appels oncrpc effectués
depuis le démarrage du serveur.
- totalWebServiceCallCount[R] : Nombre total 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.0.1.
- CqServerFactoryMBean
Ce MBean contient les attributs de configuration
relatifs à la fabrique de connexions gérées ClearQuest. La fabrique de connexions gérées ClearQuest
démarre et gère les processus dorsaux ClearQuest ONC RPC
qui communiquent avec ClearQuest Core. Contrairement à certains attributs spécifiques à ClearQuest contenus dans TeamServerMBean, les attributs de ce MBean n'affectent en rien le comportement général de ClearQuest. Au contraire,
ils contrôlent le comportement de la fabrique et gèrent les processus dorsaux ClearQuest ONC RPC qu'elle lance. Les changements apportés à ce MBean sont immédiatement pris en compte pour les nouveaux processus dorsaux lancés (les processus dorsaux existants ne sont pas affectés).
Il est inutile de redémarrer le serveur.
- activeHttpSessionThreshold[R,W] : Nombre maximal de sessions HTTP actives
sur un serveur dorsal actif ClearQuest ONC
RPC. Lorsque ce nombre est dépassé, cette fabrique de connexions
gérées peut démarrer un autre serveur dorsal ClearQuest ONC RPC. La valeur par défaut est de 30.
- maximumActiveServers[R,W] : Nombre maximal de serveurs dorsaux actifs ONC RPC
ClearQuest autorisés par cette fabrique de connexions gérées. La valeur par défaut est de 10.
- recycleServerHttpSessionLimit[R,W] : Nombre de sessions HTTP
qu'un serveur dorsal ClearQuest ONC RPC
traitera avant d'être recyclé par cette
fabrique de connexions gérées.
La valeur par défaut est de 200. Une valeur nulle indique que cette limite ne sera pas prise en compte.
- recycleServerLifetimeLimit[R,W] : Durée de vie maximale, en secondes, pendant laquelle un serveur dorsal ClearQuest ONC RPC
peut être exécuté avant d'être recyclé par cette
fabrique de connexions gérées.
La valeur par défaut est de 86400 secondes (soit 24 heures). Une valeur de zéro indique que cette limite ne sera pas vérifiée.
- recycleServerOncrpcCallLimit[R,W] : Nombre maximal de requêtes
ONC RPC qu'un serveur dorsal ClearQuest ONC
RPC traitera avant d'être recyclé par cette fabrique de connexions gérées. La valeur par défaut est de 100000. Une valeur de zéro indique que cette limite ne sera pas vérifiée.
- recyclingPeriod[R,W] : Délai (en seconde), pendant lequel un serveur dorsal
ClearQuest ONC RPC en cours de recyclage peut mettre fin aux tâches de session en attente avant
d'être arrêté par cette fabrique de connexions gérées. Lorsqu'il est en cours de recyclage, un serveur dorsal ClearQuest ONC RPC
est à l'état 2 (STOPPING). La valeur par défaut est de 1800 secondes
(soit 30 minutes). Elle doit être supérieure à 0.
- remoteChartReportServerHostName[R,W] - Pour les systèmes UNIX et
Linux uniquement. Nom d'hôte d'un serveur Windows ClearQuest Web désigné
pour traiter les demandes de graphiques et de rapports. La valeur par défaut est ""
(chaîne vide/non définie).
- remoteChartReportServerPort[R,W] : Pour les systèmes UNIX et
Linux uniquement. Numéro de port d'un serveur Windows ClearQuest Web désigné
pour traiter les demandes de graphiques et de rapports. La valeur par défaut est
0.
- serverWorkerThreadCount[R,W] : Nombre d'unités d'exécution qu'un serveur dorsal ClearQuest ONC RPC
utilisera pour gérer les requêtes
entrantes. La valeur par défaut est de 30.
- OncrpcServerMBean:
Pour chaque processus dorsal ONC RPC
lancé par la fabrique de connexions gérées ClearQuest, une
instance de CqOncrpcServerMBean est créée. Chaque MBean contient les valeurs définies dans la base OncrpcServerMBean
(notez que la base OncrpcServerMBean n'est jamais instanciée). Chaque MBean du processus serveur
n'existe que si le processus qu'il représente s'exécute
sur le système de serveur ClearQuest Web. Le MBean prend fin en même temps
que le processus.Voici les attributs de base qui
se trouvent dans tous les MBeans du processus serveur :
- hostname[R] : Nom de l'hôte qui exécute le serveur dorsal
ONC RPC.
- oncrpcCalls[R] : Nombre total d'appels ONC RPC ayant été géré
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. La valeur de ce temps est comptabilisée en nombre de millisecondes par rapport au 1er janvier 1970 à minuit
GMT.
- serverState[R] : Etat en cours du serveur dorsal ONC RPC,
représenté par
un entier (0=STOPPED, 1=RUNNING, 2=STOPPING,
3=DEAD).
- serverStoppingTime[R] : Horodatage signalant le passage à l'état STOPPING (2)
du serveur dorsal ONC RPC. La valeur de ce temps est comptabilisée en nombre de millisecondes par rapport au 1er janvier 1970 à minuit
GMT.
- serverStopTime[R] : Horodatage signalant le passage à l'état STOPPED (0) ou DEAD (3) du serveur dorsal ONC
RPC. La valeur de ce temps est comptabilisée en nombre de millisecondes par rapport au 1er janvier 1970 à minuit
GMT.
- serverType[R] : Type du serveur dorsal
(Rational ClearCase) ONC RPC.
- CqOncrpcServerMBean
Pour chaque processus dorsal ClearQuest ONC RPC
lancé par la fabrique de connexions gérées ClearQuest, une
instance de CqOncrpcServerMBean est créée. Cette instance n'existe que si
le processus dorsal ClearQuest ONC RPC qu'elle représente s'exécute sur
le système de serveur ClearQuest Web. Le MBean prend fin en même temps que le processus.
CqOncrpcServerMBean est une extension
de OncrpcServerMBean. Chaque CqOncrpcServerMBean contient l'ensemble des valeurs
définies par OncrpcServerMBean, auxquelles s'ajoutent les valeurs définies ici :
- activeHttpSessions[R] : Nombre en cours de sessions HTTP
actives gérées
par le serveur dorsal ClearQuest ONC RPC.
- activeStatefulHttpSessions[R] : Nombre en cours de sessions HTTP avec état gérées
par le serveur dorsal ClearQuest ONC
RPC.
- recycleReasonCode[R] : Code raison (représenté par un entier) du recyclage du serveur dorsal
ONC RPC ClearQuest.
- 1=RECYCLE_TIME_LIMIT_EXCEEDED
- 2=ONCRPC_CALL_LIMIT_EXCEEDED
- 3=SESSION_LIMIT_EXCEEDED
- recycleServerHttpSessionLimit[R,W] : Nombre maximal de sessions que le serveur dorsal
ClearQuest ONC RPC traitera avant d'être recyclé. La valeur par défaut initiale prend la valeur de l'attribut recycleServerHttpSessionLimit contenu dans le CqServerFactoryMBean. Ce paramètre ne peut être défini que sur un serveur dorsal ClearQuest ONC RPC en cours d'exécution. Notez bien que tous les processus du serveur dorsal ONC RPC sont volatils. Définir la valeur sur un serveur ClearQuest
ONC RPC en cours d'exécution peut échouer si ce serveur est arrêté par la fabrique de connexions gérées ClearQuest
pendant la tentative de changement de la valeur.
- totalHttpSessions[R] : Nombre total de sessions HTTP
gérées
par le serveur dorsal ClearQuest ONC RPC.
- workerThreadCount[R] : Nombre d'unités d'exécution actuellement utilisées
par le serveur dorsal ClearQuest ONC RPC pour traiter les requêtes.