Vous pouvez personnaliser le serveur IBM® Rational ClearQuest Web en définissant les attributs MBean disponibles.
Avertissement : Ne modifiez pas les attributs MBean à moins qu'ils ne soient mentionnés comme modifiables avec la notation [W] pour écriture, ou que le service de support IBM 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 avec les commandes Jacl en utilisant l'utilitaire de ligne de commande wsadmin du serveur IBM WebSphere Application Server. 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 en utilisant la boîte de dialogue Configuration du site.
Vous pouvez apporter des changements aux 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 démarrage 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à démarrés. 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, chargé du démarrage d'un ou de plusieurs processus de serveur dorsal ClearQuest ONC RPC à 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 ClearQuest.
Le serveur ClearQuest Web inclut les MBeans suivants.
- TeamServerMBean
Le TeamServerMBean contient les attributs relatifs au comportement global du serveur ClearQuest Web. Les attributs qui sont spécifiques au contrôle du fonctionnement de la fabrique de serveur ClearQuest 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, ce qui signifie pour le serveur ClearQuest Web que cette valeur n'est pas définie et qu'elle ne doit pas être utilisée pour remplacer le paramètre par défaut de ClearQuest Core. Une valeur positive remplacera le paramètre 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 de ClearQuest Core pour une seule de ces recherches 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, ce qui signifie que pour le serveur ClearQuest Web,
cette valeur n'est pas définie et qu'elle ne doit pas être utilisée pour remplacer le paramètre par défaut de ClearQuest Core. Une valeur positive remplacera 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 à la base de données, c'est pourquoi la définition de ce paramètre sur une valeur trop élevée peut entraîner une consommation des ressources pendant une durée plus longue 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 à zéro (0) seconde, le serveur ClearQuest Web émettra 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 Web à 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 changez pas la 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 changez pas la valeur à moins que le service de supportIBM 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 de produit du serveur ClearQuest Web, exprimé sous la 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 RP qui communiquent avec ClearQuest Core.
Les attributs de ce MBean n'affectent pas le comportement général de ClearQuest contrairement à certains des attributs spécifiques à ClearQuest contenus dans TeamServerMBean. Au contraire, les attributs de ce MBean 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.
- cqrpcAbandonedProcessCleanupEnabled[R,W] : Indique si le serveur ClearQuest Web lancera la procédure de nettoyage qui termine tout procédé ClearQuest RPC abandonné.La valeur par défaut est TRUE.
- cqrpcAbandonedProcessCleanupInterval[R,W] : Durée en minutes de l'intervalle périodique selon lequel le serveur ClearQuest Web lance la procédure de nettoyage pour terminer tout processus ClearQuest RPC abandonné. La valeur par défaut est 30 minutes. La valeur doit être supérieure ou égale à 0. L'intervalle fonctionne dans la puissance de 2 la plus proche. Une valeur de 0 indique que l'intervalle est défini sur 2.
- 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 maximum 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 le système UNIX et Linux uniquement.
Nom d'hôte d'un serveur Windows ClearQuest Web conçu 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 le système UNIX et Linux uniquement.
Numéro de port d'un serveur Windows ClearQuest Web conçu pour traiter des 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 est en cours d'exécution 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 est en cours d'exécution 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 maximum 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 le 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.