Sie können IBM®
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 IBM
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.
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-Serverfactory steuern, werden in
der CqServerFactoryMBean-Serverfactory gespeichert.
- cqFulltextSearchCacheSize[R,W] - Die Anzahl der gefundenen Datensätze, die
in ClearQuest Core für eine Volltextsuche
gespeichert werden. Dieser Wert wird verwendet, um das von
ClearQuest Core angenommene
Standardverzeichnis 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.
- 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
Standardverzeichnis 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
von 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 beeinflussen das Gesamtverhalten
von ClearQuest nicht, wie das einige
ClearQuest-spezifische Attribute in "TeamServerMBean" tun. 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.
- cqrpcAbandonedProcessCleanupEnabled[R,W] - Gibt an, ob der
ClearQuest Web-Server die
Bereinigungsprozedur starten wird, die alle abgebrochenen
ClearQuest-RPC-Prozesse beendet.
Der Standardwert ist "TRUE".
- cqrpcAbandonedProcessCleanupInterval[R,W] - Der Zeitraum in Minuten des
regelmäßigen Intervalls in dem der ClearQuest
Web-Server Bereinigungsprozeduren startet, um alle abgebrochenen
ClearQuest-RPC-Prozesse zu beenden. Der
Standardwert ist 30 Minuten. Der Wert muss größer-gleich 0 sein. Das Intervall ist die nächstgelegene Zweierpotenz. Der Wert "0" gibt somit an, dass das
Intervall auf 2 eingestellt ist.
- 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 repräsentierten 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.