Sie können Rational ClearQuest Web-Server anpassen,
indem Sie verfügbare MBean-Attribute festlegen.
Achtung: Ändern Sie keine MBean-Attribute, es sei denn, diese
sind durch die Notation [W] für "Write" (Schreiben) als änderbar dokumentiert
oder Sie werden vom IBM Support dazu aufgefordert. Das Ändern von
MBean-Attributen, die als schreibgeschützt [R] (Read-only) markiert sind oder
nicht als änderbar dokumentiert sind, kann die Systemleistung beeinträchtigen.
Die Attribute werden von der MBean kategorisiert, in der sie sich befinden. Sie können
alle Parameter abrufen, die mit einem [R] für 'Read' (Lesen) gekennzeichnet sind. Die änderbaren Parameter sind mit
einem [W] für 'Write' (Schreiben) gekennzeichnet. Sie können auf die Attribute mit JACL-Befehlen mithilfe des
Befehlszeilendienstprogramms wsadmin von
WebSphere Application Server
zugreifen. Die Datei teamAdminUtils.jacl enthält Beispiele von JACL-Befehlen, -Syntax
und -Funktionen. Sie können auch einige der MBean-Attribute des ClearQuest Web-Servers mithilfe des Dialogfensters
Sitekonfiguration ändern.
Sie können die änderbaren MBean-Parameter nur ändern, während der ClearQuest Web-Server
aktiv ist. Die Änderungen werden sofort wirksam, ohne dass die Serverprozesse erneut gestartet
werden müssen. Änderungen an MBean-Attributen, die den Start von ONC RPC-Back-End-Serverprozessen
(ONC RPC = Open Network Computing Remote Procedure Call) steuern, haben keinen Einfluss auf
ONC RPC-Back-End-Serverprozesse, die bereits gestartet wurden. Nur neue ONC RPC-Back-End-Serverprozesse
verwenden die neuen Einstellungen.
Beim Start des ClearQuest Web-Servers werden zwei MBeans erstellt: TeamServerMBean, die
Konfigurationsattribute für den ClearQuest Web-Server enthält, und CqServerFactoryMBean,
die Attribute für die verwaltete Verbindungsfactory von ClearQuest enthält.
Die verwaltete Verbindungsfactory von ClearQuest ist die Komponente des ClearQuest Web-Servers,
die für den Start eines oder mehrerer ONC RPC-Multithread-Back-End-Serverprozesse von ClearQuest
verantwortlich ist. Da jeder ClearQuest-RPC-Prozess über mehrere Threads verfügt, kann er Anforderungen
von verschiedenen Berechtigungsnachweisen verarbeiten. Die verwaltete Verbindungsfactory von ClearQuest
führt für jeden ClearQuest-RPC-Prozess automatisch ein Life-Cycle-Management durch.
Der ClearQuest Web-Server beinhaltet die folgenden MBeans:
- TeamServerMBean
In "TeamServerMBean" sind Attribute gespeichert, die das Gesamtverhalten
des ClearQuest Web-Servers betreffen. Spezielle Attribute, die die Funktionsweise der
ClearQuest-Server-Factory steuern, werden in der CqServerFactoryMBean-Server-Factory gespeichert.
- cqFulltextSearchCacheSize[R,W] - Die Anzahl der gefundenen Datensätze, die in ClearQuest Core
für eine Volltextsuche gespeichert wurden. Dieser Wert wird verwendet, um das von ClearQuest Core angenommene
Standardverhalten zu überschreiben. Der Standardwert für dieses Attribut ist "0". Dieser Standardwert zeigt dem
ClearQuest Web-Server, dass dieser Wert nicht definiert ist und nicht zum Überschreiben
der Standardeinstellung von ClearQuest Core verwendet werden darf. Ein positiver Wert überschreibt die
Standardeinstellungen von ClearQuest Core.
- cqFulltextSearchPageSize[R,W] - Die Anzahl der gefundenen Datensätze auf einer Seite mit den
Ergebnissen einer Volltextsuche in ClearQuest Core. Dieser Wert wird verwendet, um das von ClearQuest Core
angenommene Standardverhalten zu überschreiben. Der Standardwert für dieses Attribut ist "0". Dieser Standardwert zeigt dem
ClearQuest Web-Server, dass dieser Wert nicht definiert ist und nicht zum Überschreiben
der Standardeinstellung von ClearQuest Core verwendet werden darf. Ein positiver Wert überschreibt die Standardeinstellung
von ClearQuest Core.
- cqFulltextSearchRecordHitLimit[R,W] - Die maximale Anzahl der gefundenen Datensätze, die
in einem Web-Service-Aufruf für eine einzelne Volltextsuche zurückgegeben wurden, sowie die Anzahl
der gefundenen Datensätze, die in einem Anwendungsserver zwischengespeichert werden konnten. Der Standardwert
ist "100".
- cqLoginSessionTimeout[R,W] - Der Zeitraum in Sekunden, den eine ClearQuest-Anmeldesitzung gültig ist, bevor eine Zeitlimitüberschreitung
eintritt. Der Standardwert beträgt 1800 Sekunden (30 Minuten). Jede ClearQuest-Sitzung verwendet eine Datenbankverbindung, d. h., wenn dieser Wert zu hoch eingestellt wird, werden Ressourcen länger als nötig gebunden. Ändern Sie den Standardwert nicht.
- cqLoginSessionWaitTimeout[R,W] - Der Zeitraum in Sekunden, den ein Thread warten muss, bis er eine Rational ClearQuest-Anmeldesitzung abrufen kann. Der Standardwert beträgt 300 Sekunden.
- cqServerFactory[R] - Der Objektname für die J2C-Verbindungsfactory-MBean von ClearQuest.
- cqUserDBListSecureAccess[R,W] - Gibt an, ob Benutzern die Liste der
Datenbanken angezeigt wird, wenn sie versuchen, sich mit ungültigen
Berechtigungsnachweisen bei ClearQuest Web anzumelden. Der Standardwert ist
"false"; dies gibt an, dass Benutzern die Datenbankliste angezeigt wird, wenn
sie versuchen, sich mit ungültigen Berechtigungsnachweisen anzumelden. Wird der
Wert auf "true" gesetzt, wird die Benutzerauthentifizierung aktiviert, um zu
verhindern, dass Benutzern die Datenbankliste angezeigt wird, wenn sie
versuchen, sich mit ungültigen Berechtigungsnachweisen anzumelden.
- ejbBufferLimit[R,W] - Die maximale Anzahl der Objekte, die von einem EJB-Aufruf zurückgegeben werden sollen. Der Standardwert
ist "100".
- keepAliveInterval[R,W] - Wenn dieser Wert auf einen Wert größer als null Sekunden gesetzt ist,
gibt der ClearQuest Web-Server im angegebenen Intervall Keepalive-Nachrichten zwischen dem Client und den
Back-End-Serverkomponenten aus, wenn während dieses Intervalls kein Datenverkehr stattgefunden hat.
Damit soll sichergestellt werden, dass ClearQuest-Abfragen mit langer Ausführungszeit abgeschlossen werden
können, ohne dass die Infrastruktur die zu Grunde liegenden Sockets entfernt. Dieser Wert sollte um
mindestens 10 Sekunden niedriger angesetzt sein als die Zeitlimitwerte für die Sockets. Der
Standardwert beträgt 300 Sekunden (fünf Minuten).
- largeReadSocketTimeoutMultiplier[R,W] - Der Multiplikator, der
auf den Zeitlimitwert des Sockets zwischen der Mittelschicht und der
Backend-Serverkomponente für bestimmte, sehr lange andauernde Operationen angewendet wird.
Der Standardwert von 4 gibt an, dass der Zeitlimitwert für den Lese-Socket
das Vierfache von dem werkseitig eingestellten Standardzeitlimitwert des
Backend-Servers beträgt. Dieser Multiplikator wird nur auf bestimmte Operationen
angewendet. Ändern Sie diesen Wert nicht, es sei denn, Sie werden vom IBM Support hierzu aufgefordert.
- maxCqSessionsPerUser[R,W] - Die maximale Anzahl
ClearQuest-Sitzungen, die für jeden Benutzer in einer Sitzung erstellt werden. Der Standardwert ist 2, der Mindestwert ist 1.
- maxProcureServerAttempts[R,W] - Gibt an, wie oft ein ONC RPC-Back-End-Server maximal abgerufen werden
kann, bevor eine Ausnahmebedingung an den Pool der verwalteten Verbindungen zurückgegeben wird. Der Standardwert ist 6. Der
Wert muss immer größer-gleich 2 sein.
- mediumReadSocketTimeoutMultiplier[R,W] - Der Multiplikator, der
auf den Zeitlimitwert des Sockets zwischen der Mittelschicht und der
Back-End-Serverkomponente für bestimmte lange andauernde Operationen angewendet wird.
Der Standardwert von 2 gibt an, dass der Zeitlimitwert für den Lese-Socket
das Zweifache von dem werkseitig eingestellten Standardzeitlimitwert des Back-End-Servers beträgt.
Dieser Multiplikator wird nur auf bestimmte Operationen angewendet. Ändern Sie diesen Wert nicht,
es sei denn, Sie werden vom IBM Support hierzu aufgefordert.
- numberOfActiveSessions[R] - Die Anzahl der aktiven Sitzungen, die der Server gegenwärtig ausführt.
- numberOfHttpSessionsCreated[R] - Die Gesamtanzahl der Sitzungen, die von diesem Server ausgeführt wurden.
- oncrpcBufferLimit[R,W] - Die maximale Anzahl der Objekte, die in einem einzigen ONCRPC-Aufruf zurückgegeben werden. Der Standardwert
ist "100".
- oncrpcInterruptLimit[R,W] - Die maximale Anzahl der Objekte, die für eine Benutzeranforderung zurückgegeben werden. Der Standardwert ist 1000.
- oncrpcServers[R] - Die Objektnamen für die gegenwärtig ausgeführten ONC RPC-Server-MBeans.
- procureServerInterval[R,W] - Der gesamte Zeitraum (in Sekunden), den ein Anforderungs-Thread warten darf, wenn
ein Server abgerufen wird. Nach Ablauf dieses Zeitraums wird eine Ausnahmebedingung an den Pool der verwalteten Verbindungen zurückgegeben. Der Standardwert beträgt 60 Sekunden.
- sessionObjectDefaultTimeout[R,W] - Der Standardzeitraum in Sekunden, in dem ein Objekt in einer Sitzung bleibt. Der Standardwert beträgt 1800 Sekunden (30 Minuten). Der
Wert muss größer-gleich 0 sein.
- sessionQueryObjectTimeout[R,W] - Der Zeitraum, den eine ClearQuest-Anmeldesitzung
bestehen bleibt, bevor sie ein Zeitlimit überschreitet, wenn
eine neue oder geänderte Abfrage bzw. ein neuer oder geänderter Abfrageordner nicht bereitgestellt wurde. Dieser Wert
darf nicht kleiner sein als der Wert für cqLoginSessionTimeout. Der Standardwert beträgt 1800 Sekunden (30 Minuten). Dieser Wert
überschreibt den von sessionObjectDefaultTimeout definierten Wert.
- sessionRecordObjectTimeout[R,W] - Der Zeitraum, den eine ClearQuest-Anmeldesitzung bestehen bleibt, bevor sie ein Zeitlimit überschreitet, wenn
ein neu erstellter oder geänderter Datensatz vorhanden ist, der nicht bereitgestellt wurde. Dieser Wert
darf nicht kleiner sein als der Wert für cqLoginSessionTimeout. Der Standardwert beträgt 10.800 Sekunden (3 Stunden). Dieser Wert
überschreibt den von sessionObjectDefaultTimeout definierten Wert.
- sessionReaperThreadDelay[R,W] - Die Zeitverzögerung für den Session-Reaper-Thread in Sekunden. Der Standardwert beträgt 900 Sekunden (15 Minuten). Die
Werte liegen im Bereich von 300 bis 1800 Sekunden. Sie können diesen Wert verkleinern, wenn der Bedarf an virtuellem Speicher hoch ist. Sie können diesen Wert erhöhen, wenn die Auslastung der Systemeinheit zu hoch ist.
- totalNumberOfOncrpcServers[R] - Die Anzahl der RPC-Back-End-Server, die gegenwärtig in allen
Rational
ClearQuest-Verbindungsfactory-Instanzen
ausgeführt werden.
- totalOncrpcCallCount[R] - Die Gesamtzahl der ONCRPC-Aufrufe seit dem Serverstart.
- totalWebServiceCallCount[R] - Die Gesamtzahl der Web-Service-Aufrufe seit dem Serverstart.
- versionNumber[R] - Die Produktversionsnummer für den ClearQuest Web-Server,
ausgedrückt als Zeichenfolgewert, durch Punkte voneinander abgetrennt. Beispiel: 7.1.0.1.
- CqServerFactoryMBean
Diese MBean speichert Konfigurationsattribute, die für die verwaltete
Verbindungsfactory von ClearQuest von Bedeutung sind. Die verwaltete Verbindungsfactory von ClearQuest
startet und verwaltet die ONC RPC-Back-End-Prozesse von ClearQuest, die mit ClearQuest Core kommunizieren. Die
Attribute in dieser MBean haben keinen Einfluss auf das Gesamtverhalten von ClearQuest, wie dies bei einigen
ClearQuest-spezifischen Attributen in "TeamServerMBean" der Fall ist. Stattdessen steuern die Attribute in
dieser MBean das Verhalten der Factory und die Verwaltung der ONC RPC-Back-End-Prozesse von ClearQuest, die
von der MBean gestartet werden. Änderungen, die an dieser MBean vorgenommen werden, werden für neu
gestartete Back-End-Prozesse sofort wirksam (vorhandene Back-End-Prozesse sind nicht betroffen). Die
Serverprozesse müssen nicht erneut gestartet werden.
- activeHttpSessionThreshold[R,W] - Die Anzahl aktiver HTTP-Sitzungen auf einem aktiven
ONC RPC-Back-End-Server von ClearQuest.
Wird dieser Wert überschritten, führt dies möglicherweise dazu, dass ein anderer ONC RPC-Back-End-Server von
ClearQuest
von dieser verwalteten Verbindungsfactory gestartet wird. Der Standardwert ist 30.
- maximumActiveServers[R,W] - Die maximale Anzahl der aktiven ONC RPC-Back-End-Server von
ClearQuest,
die von dieser verwalteten Verbindungsfactory zugelassen werden. Der Standardwert ist 10.
- recycleServerHttpSessionLimit[R,W] - Die Anzahl der HTTP-Sitzungen, die ein ONC RPC-Back-End-Server von
ClearQuest verarbeitet, bevor
er von dieser verwalteten Verbindungsfactory gestoppt und erneut gestartet wird. Der Standardwert ist 200. Der
Wert 0 zeigt an, dass dieser Grenzwert nicht geprüft werden soll.
- recycleServerLifetimeLimit[R,W] - Die maximale Laufzeit in Sekunden, die ein ONC RPC-Back-End-Server von
ClearQuest ausgeführt werden kann,
bevor er von dieser verwalteten Verbindungsfactory gestoppt und erneut gestartet wird. Der
Standardwert beträgt 86.400 Sekunden (24 Stunden). Der Wert 0 zeigt an, dass dieser Grenzwert nicht geprüft werden soll.
- recycleServerOncrpcCallLimit[R,W] - Die maximale Anzahl von
ONC RPC-Anforderungen, die ein ONC RPC-Back-End-Server von
ClearQuest verarbeitet,
bevor er von dieser verwalteten Verbindungsfactory gestoppt und erneut gestartet wird. Der Standardwert ist 100.000. Der
Wert 0 zeigt an, dass dieser Grenzwert nicht geprüft werden soll.
- recyclingPeriod[R,W] - Der Zeitraum (in Sekunden), der einem ONC RPC-Back-End-Server von
ClearQuest
der gestoppt und erneut gestartet wird, zur Verfügung steht, um ausstehende Sitzungsarbeit abzuschließen,
bevor er von dieser verwalteten Verbindungsfactory beendet wird. Der Status
eines erneut zu startenden ONC RPC-Back-End-Servers von
ClearQuest
ist "2" (STOPPING). Der Standardwert beträgt 1800 Sekunden (30 Minuten). Der Wert muss größer als 0 sein.
- remoteChartReportServerHostName[R,W] - Nur für das UNIX-System und Linux. Der Hostname eines Windows
ClearQuest Web-Servers, der für die Verarbeitung von Diagramm- und Berichtsanforderungen bestimmt ist. Der
Standardwert ist "" (leere Zeichenfolge/nicht gesetzt).
- remoteChartReportServerPort[R,W] - Nur für das UNIX-System und Linux. Die Portnummer eines Windows
ClearQuest Web-Servers, der für die Verarbeitung von Diagramm- und Berichtsanforderungen bestimmt ist. Der Standardwert ist 0.
- serverWorkerThreadCount[R,W] - Die Anzahl der Threads, die ein ONC RPC-Back-End-Server
von ClearQuest
verwendet, um eingehende Anforderungen zu verarbeiten. Der Standardwert ist 30.
- OncrpcServerMBean:
Für jeden ONC RPC-Back-End-Prozess, der von der verwalteten
Verbindungsfactory von ClearQuest gestartet wird, wird eine Instanz der MBean "CqOncrpcServerMBean"
erstellt. Jede MBean enthält die Werte, die in der Basis-OncrpcServerMBean definiert sind (beachten Sie,
dass die Basis-OncrpcServerMBean nie instanziert wird). Die Lebensdauer der MBean eines
Serverprozesses entspricht der Ausführungszeit des von ihr dargestellten Prozesses auf dem
ClearQuest Web-Serversystem. Wenn der Prozess beendet wird, wird auch die MBean, die den Prozess
darstellt, beendet. Nachfolgend sind die Basisattribute aufgeführt, die in allen MBeans des Serverprozesses
enthalten sind:
- hostname[R] - Der Name des Hosts, auf dem der ONC RPC-Back-End-Server ausgeführt wird.
- oncrpcCalls[R] - Die Gesamtzahl der ONC RPC-Aufrufe, die vom ONC RPC-Back-End-Server ausgeführt wurden.
- port[R] - Die Portnummer (ausgedrückt durch eine Ganzzahl), an der der ONC RPC-Back-End-Server
empfangsbereit ist.
- serverId[R] - Die eindeutige ID für den ONC RPC-Back-End-Server.
- serverStartTime[R] - Die Zeitmarke für den Start des ONC RPC-Back-End-Servers. Der
Wert gibt die Anzahl der Millisekunden seit dem 1. Januar 1970, 00:00:00 GMT an.
- serverState[R] - Der aktuelle Status des ONC RPC-Back-End-Servers, ausgedrückt
durch eine Ganzzahl (0=STOPPED, 1=RUNNING, 2=STOPPING, 3=DEAD).
- serverStoppingTime[R] - Die Zeitmarke für den Zeitpunkt, zu dem der ONC RPC-Back-End-Server
in den Status "STOPPING (2)" gewechselt hat. Der Wert gibt die Anzahl der Millisekunden seit dem 1. Januar 1970, 00:00:00 GMT an.
- serverStopTime[R] - Die Zeitmarke für den Zeitpunkt, zu dem der ONC RPC-Back-End-Server in den
Status "STOPPED (0)" oder "DEAD (3)" gewechselt hat. Der Wert gibt die Anzahl der Millisekunden seit
dem 1. Januar 1970, 00:00:00 GMT an.
- serverType[R] - Der Typ des ONC RPC-Back-End-Servers
(Rational
ClearCase).
- CqOncrpcServerMBean
Für jeden ONC RPC-Back-End-Prozess von ClearQuest, der von der
verwalteten Verbindungsfactory von ClearQuest gestartet wird, wird eine Instanz der
MBean "CqOncrpcServerMBean" erstellt. Die Lebensdauer dieser Instanz
entspricht der Ausführungszeit des von ihr dargestellten ONC RPC-Back-End-Prozesses
von ClearQuest auf dem ClearQuest Web-Serversystem. Wenn der Prozess beendet wird,
wird auch die MBean, die den Prozess darstellt, beendet.
Die MBean
"CqOncrpcServerMBean" ist eine Erweiterung der MBean "OncrpcServerMBean". Jede
MBean "CqOncrpcServerMBean" enthält alle von der MBean "OncrpcServerMBean" definierten
Werte sowie die folgenden zusätzlichen Werte:
- activeHttpSessions[R] - Die Gesamtzahl der aktiven HTTP-Sitzungen, die vom ONC RPC-Back-End-Server
von ClearQuest ausgeführt werden.
- activeStatefulHttpSessions[R] - Die Gesamtzahl der statusabhängigen HTTP-Sitzungen, die vom
ONC RPC-Back-End-Server von ClearQuest
ausgeführt werden.
- recycleReasonCode[R] - Der Ursachencode (ausgedrückt durch eine Ganzzahl), der angibt, warum
der ONC RPC-Back-End-Server von ClearQuest
gestoppt und erneut gestartet wird.
- 1=RECYCLE_TIME_LIMIT_EXCEEDED
- 2=ONCRPC_CALL_LIMIT_EXCEEDED
- 3=SESSION_LIMIT_EXCEEDED
- recycleServerHttpSessionLimit[R,W] - Die maximale Anzahl von Sitzungen, die
vom ONC RPC-Back-End-Server von ClearQuest ausgeführt werden, bevor der Server gestoppt
und erneut gestartet wird. Der Standardwert wird mit dem Wert des Attributs "recycleServerHttpSessionLimit" in der MBean
"CqServerFactoryMBean" definiert. Dieser Wert kann nur auf einem aktiven ONC RPC-Back-End-Server von
ClearQuest definiert werden. Beachten Sie, dass alle ONC RPC-Back-End-Serverprozesse flüchtig sind. Wenn Sie den Wert
auf einem aktiven ONC RPC-Server von ClearQuest definieren, kann dieser Vorgang fehlschlagen, wenn der Server während des
Versuchs, den Wert zu ändern, von der verwalteten Verbindungsfactory von ClearQuest beendet wird.
- totalHttpSessions[R] - Die Gesamtzahl der HTTP-Sitzungen, die vom ONC RPC-Back-End-Server
von ClearQuest ausgeführt wurden.
- workerThreadCount[R] - Die Anzahl der Threads, die vom ONC RPC-Back-End-Server
von ClearQuest
zur Verarbeitung von Anforderungen verwendet werden.