Überwachen von Serverressourcen mit der JMX-Konsole

Mit der JMX-Konsole können Sie Dienste auf dem CRX-Server überwachen und verwalten. In den folgenden Abschnitten werden die Attribute und Vorgänge zusammengefasst, die über das JMX-Framework verfügbar sind.

Weitere Informationen zur Nutzung der Konsolensteuerung finden Sie unter Verwenden der JMX-Konsole. Hintergrundinformationen zu JMX finden Sie auf der Seite zu Java Management Extensions (JMX)-Technologie auf der Website von Oracle.

Weitere Informationen zur Erstellung von MBeans für die Verwaltung Ihrer Dienste über die JMX-Konsole finden Sie unter Integrieren von Diensten mit der JMX-Konsole.

Workflow-Wartung

Vorgänge für die Verwaltung von laufenden, abgeschlossenen, veralteten und fehlgeschlagenen Workflow-Instanzen.

• Domain: com.adobe.granite.workflow
• Typ: Wartung

Betrieb

listRunningWorkflowsPerModel: Führt die Anzahl an Workflow-Instanzen auf, die für jedes Workflow-Modell ausgeführt werden.

• Argumente: keine
• Zurückgegebener Wert: Tabellendaten mit Count- und ModelId-Spalten.

listCompletedWorkflowsPerModel: Führt die Anzahl an abgeschlossenen Workflow-Instanzen für jedes Workflow-Modell auf.

• Argumente: keine
• Zurückgegebener Wert: Tabellendaten mit Count- und ModelId-Spalten.

returnWorkflowQueueInfo: Zeigt Informationen zu Workflow-Elementen an, die bearbeitet wurden und sich in der Warteschlange für die Verarbeitung befinden.

• Argumente: keine

• Zurückgegebener Wert: Tabellendaten mit den folgenden Spalten:

  • Aufträge
  • Queue Name
  • Active Jobs
  • Average Processing Time
  • Average Waiting Time
  • Cancelled Jobs
  • Failed Jobs
  • Finished Jobs
  • Processed Jobs
  • Queued Jobs

returnWorkflowJobTopicInfo: Zeigt Verarbeitungsinformationen für Workflow-Aufträge nach Themen geordnet an.

• Argumente: keine

• Zurückgegebener Wert: Tabellendaten mit den folgenden Spalten:

  • Topic Name
  • Durchschnittliche Verarbeitungszeit
  • Durchschnittliche Wartezeit
  • Abgebrochene Aufträge
  • Fehlgeschlagene Aufträge
  • Abgeschlossene Aufträge
  • Verarbeitete Aufträge

returnFailedWorkflowCount: Führt die Anzahl an fehlgeschlagenen Workflow-Instanzen auf. Sie können ein Workflow-Modell für die Abfrage angeben oder Informationen für alle Workflow-Modelle abrufen.

• Argumente:

  • model: Die ID des Modells für die Abfrage. Um die Anzahl an fehlgeschlagenen Workflow-Instanzen für alle Workflow-Modelle anzuzeigen, legen Sie keinen Wert fest. Die ID ist der Pfad zum Modellknoten, z. B.:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

• Zurückgegebener Wert: die Anzahl an fehlgeschlagenen Workflow-Instanzen.

returnFailedWorkflowCountPerModel: Führt die Anzahl an Workflow-Instanzen auf, die für jedes Workflow-Modell fehlgeschlagen sind.

• Argumente: keine
• Zurückgegebener Wert: Tabellendaten mit Count- und ModelId-Spalten.

terminateFailedInstances: Beendet Workflows, die fehlgeschlagen sind. Sie können alle fehlgeschlagenen Instanzen beenden oder nur die fehlgeschlagenen Instanzen für ein bestimmtes Modell. Optional können Sie die Instanzen neu starten, nachdem sie beendet wurden. Sie können den Vorgang auch testen, um die Ergebnisse zu sehen, ohne den Vorgang tatsächlich durchzuführen.

• Argumente:

  • Restart the instance: (optional) Legen Sie den Wert true fest, um die Instanzen neu zu starten, nachdem sie beendet wurden. Beim Standardwert false werden beendete Workflow-Instanzen nicht neu gestartet.

  • Dry Run: (optional) Legen Sie den Wert true fest, um die Ergebnisse des Vorgangs zu sehen, ohne den Vorgang tatsächlich durchzuführen. Beim Standardwert false wird der Vorgang durchgeführt.

  • Model: (optional) Die ID des Modells, auf das der Vorgang angewendet wird. Um den Vorgang auf die fehlgeschlagenen Instanzen aller Workflow-Modelle anzuwenden, legen Sie kein Modell fest. Die ID ist der Pfad zum Modellknoten, z. B.:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

• Zurückgegebener Wert: Tabellendaten zu den beendeten Instanzen mit den folgenden Spalten:

  • Initiator
  • InstanceId
  • ModelId
  • Payload
  • StartComment
  • WorkflowTitle

retryFailedWorkItems: Versucht, fehlgeschlagene Arbeitselementschritte auszuführen. Sie können alle fehlgeschlagenen Arbeitselemente erneut ausführen lassen oder nur die fehlgeschlagenen Arbeitselemente für ein bestimmtes Workflow-Modell. Optional können Sie den Vorgang testen, um die Ergebnisse zu sehen, ohne den Vorgang tatsächlich durchzuführen.

• Argumente:

  • Dry Run: (optional) Legen Sie den Wert true fest, um die Ergebnisse des Vorgangs zu sehen, ohne den Vorgang tatsächlich durchzuführen. Beim Standardwert false wird der Vorgang durchgeführt.

  • Model: (optional) Die ID des Modells, auf das der Vorgang angewendet wird. Um den Vorgang auf die fehlgeschlagenen Arbeitselemente aller Workflow-Modelle anzuwenden, legen Sie kein Modell fest. Die ID ist der Pfad zum Modellknoten, z. B.:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

• Zurückgegebener Wert: Tabellendaten zu den fehlgeschlagenen Arbeitselementen, die erneut ausgeführt werden sollen, mit den folgenden Spalten:

  • Initiator
  • InstanceId
  • ModelId
  • Nutzlast
  • StartComment
  • WorkflowTitle

PurgeActive: Entfernt aktive Workflow-Instanzen eines bestimmten Alters. Sie können aktive Instanzen für alle Modelle bereinigen oder nur die Instanzen für ein bestimmtes Modell. Optional können Sie den Vorgang testen, um die Ergebnisse zu sehen, ohne den Vorgang tatsächlich durchzuführen.

• Argumente:

  • Model: (optional) Die ID des Modells, auf das der Vorgang angewendet wird. Um den Vorgang auf die Workflow-Instanzen aller Workflow-Modelle anzuwenden, legen Sie kein Modell fest. Die ID ist der Pfad zum Modellknoten, z. B.:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • Number of days since workflow started: das Alter der zu bereinigenden Workflow-Instanzen in Tagen.

  • Dry Run: (optional) Legen Sie den Wert true fest, um die Ergebnisse des Vorgangs zu sehen, ohne den Vorgang tatsächlich durchzuführen. Beim Standardwert false wird der Vorgang durchgeführt.

• Zurückgegebener Wert: Tabellendaten zu den aktiven Workflow-Instanzen, die bereinigt werden, mit den folgenden Spalten:

  • Initiator
  • InstanceId
  • ModelId
  • Nutzlast
  • StartComment
  • WorkflowTitle

countStaleWorkflows: Gibt die Anzahl an veralteten Workflow-Instanzen zurück. Sie können die Anzahl an veralteten Instanzen für alle Workflow-Modelle oder für ein bestimmtes Modell abrufen.

• Argumente:

  • Model: (optional) Die ID des Modells, auf das der Vorgang angewendet wird. Um den Vorgang auf die Workflow-Instanzen aller Workflow-Modelle anzuwenden, legen Sie kein Modell fest. Die ID ist der Pfad zum Modellknoten, z. B.:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

• Zurückgegebener Wert: die Anzahl an veralteten Workflow-Instanzen.

restartStaleWorkflows: Startet veraltete Workflow-Instanzen neu. Sie können alle veralteten Instanzen neu starten oder nur die veralteten Instanzen für ein bestimmtes Modell. Sie können den Vorgang auch testen, um die Ergebnisse zu sehen, ohne den Vorgang tatsächlich durchzuführen.

• Argumente:

  • Model: (optional) Die ID des Modells, auf das der Vorgang angewendet wird. Um den Vorgang auf die veralteten Instanzen aller Workflow-Modelle anzuwenden, legen Sie kein Modell fest. Die ID ist der Pfad zum Modellknoten, z. B.:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • Dry Run: (optional) Legen Sie den Wert true fest, um die Ergebnisse des Vorgangs zu sehen, ohne den Vorgang tatsächlich durchzuführen. Beim Standardwert false wird der Vorgang durchgeführt.

• Zurückgegebener Wert: eine Liste der Workflow-Instanzen, die neu gestartet werden.

fetchModelList: Führt alle Workflow-Modelle auf.

• Argumente: keine
• Zurückgegebener Wert: Tabellendaten, die die Workflow-Modelle identifizieren, mit den ModelId- und ModelName-Spalten.

countRunningWorkflows: Gibt die Anzahl an laufenden Workflow-Instanzen zurück. Sie können die Anzahl an laufenden Instanzen für alle Workflow-Modelle oder für ein bestimmtes Modell abrufen.

• Argumente:

  • Model: (optional) die ID des Modells, für das die Anzahl an laufenden Instanzen zurückgegeben wird. Um die Anzahl an laufenden Instanzen für alle Workflow-Modelle zurückzugeben, legen Sie kein Modell fest. Die ID ist der Pfad zum Modellknoten, z. B.:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

• Zurückgegebener Wert: die Anzahl an laufenden Workflow-Instanzen.

countCompletedWorkflows: Gibt die Anzahl an abgeschlossenen Workflow-Instanzen zurück. Sie können die Anzahl an abgeschlossenen Instanzen für alle Workflow-Modelle oder für ein bestimmtes Modell abrufen.

• Argumente:

  • Model: (optional) die ID des Modells, für das die Anzahl an abgeschlossenen Instanzen zurückgegeben wird. Um die Anzahl an abgeschlossenen Instanzen für alle Workflow-Modelle zurückzugeben, legen Sie kein Modell fest. Die ID ist der Pfad zum Modellknoten, z. B.:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

• Zurückgegebener Wert: die Anzahl an abgeschlossenen Workflow-Instanzen.

purgeCompleted: Entfernt Datensätze von abgeschlossenen Workflows eines bestimmten Alters aus dem Repository. Wenn Sie häufig Workflows verwenden, verringern Sie mit diesem Vorgang regelmäßig die Größe des Repositorys. Sie können abgeschlossene Instanzen für alle Modelle bereinigen oder nur die Instanzen für ein bestimmtes Modell. Optional können Sie den Vorgang testen, um die Ergebnisse zu sehen, ohne den Vorgang tatsächlich durchzuführen.

• Argumente:

  • Model: (optional) Die ID des Modells, auf das der Vorgang angewendet wird. Um den Vorgang auf die Workflow-Instanzen aller Workflow-Modelle anzuwenden, legen Sie kein Modell fest. Die ID ist der Pfad zum Modellknoten, z. B.:

    /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model

  • Number of days since workflow has been completed: die Anzahl an Tagen, seit denen sich die Workflow-Instanzen im abgeschlossenen Status befinden.

  • Dry Run: (optional) Legen Sie den Wert true fest, um die Ergebnisse des Vorgangs zu sehen, ohne den Vorgang tatsächlich durchzuführen. Beim Standardwert false wird der Vorgang durchgeführt.

• Zurückgegebener Wert: Tabellendaten zu den abgeschlossenen Workflow-Instanzen, die bereinigt werden, mit den folgenden Spalten:

  • Initiator
  • InstanceId
  • ModelId
  • Nutzlast
  • StartComment
  • WorkflowTitle

Repository

Informationen zum CRX-Repository

• Domain: com.adobe.granite
• Typ: Repository

Attribute

Name: Der Name der JCR-Repository-Implementierung. Schreibgeschützt.

Version: Die Repository-Implementierungsversion. Schreibgeschützt.

HomeDir: Das Verzeichnis, in dem sich das Repository befindet. Der standardmäßige Speicherort ist <QuickStart_Jar_Location>/crx-quickstart/repository. Schreibgeschützt.

CustomerName: Der Name der Kundschaft, für die die Softwarelizenz ausgegeben wurde. Schreibgeschützt.

LicenseKey: Der eindeutige Lizenzschlüssel für diese Installation des Repositorys. Schreibgeschützt.

AvailableDiskSpace: Der Festplatten-Speicherplatz, der für diese Instanz des Repositorys verfügbar ist, in MB. Schreibgeschützt.

MaximumNumberOfOpenFiles: Die Anzahl an Dateien, die gleichzeitig geöffnet werden können. Schreibgeschützt.

SessionTracker: Der Wert der Systemvariablen „crx.debug.sessions“. Der Wert „true“ steht für eine Debugging-Sitzung. Der Wert „false“ steht für eine normale Sitzung. Lese- und Schreibzugriff.

Descriptors: Ein Satz an Schlüsselwertpaaren, die für Repository-Eigenschaften stehen. Alle Eigenschaften sind schreibgeschützt.

Schlüssel	Wert
option.node.and.property.with.same.name.supported	Gibt an, ob ein Knoten und eine Eigenschaft des Knotens denselben Namen haben dürfen. Dabei bedeutet „true“, dass derselbe Name zulässig ist, und „false“, dass derselbe Name nicht zulässig ist.
identifier.stability	Gibt die Stabilität von nicht-referenzierbaren Knoten-IDs an. Die folgenden Werte sind möglich: identifier.stability.indefinite.duration: Die IDs ändern sich nicht. identifier.stability.method.duration: Die IDs können sich zwischen Methodenaufrufen ändern. identifier.stability.save.duration: Die IDs ändern sich innerhalb eines Speicher-/Aktualisierungszyklus nicht. identifier.stability.session.duration: Die IDs ändern sich während einer Sitzung nicht.
query.xpath.pos.index	Gibt an, ob die JCR 1.0 XPath-Abfragesprache unterstützt wird. Dabei bedeutet „true“, dass sie unterstützt wird, und „false“, dass sie nicht unterstützt wird.
crx.repository.systemid	Die System-ID, wie sie in der Datei system.id festgelegt ist
option.query.sql.supported	Gibt an, ob die JCR 1.0 XPath-Abfragesprache unterstützt wird. Dabei bedeutet „true“, dass sie unterstützt wird, und „false“, dass sie nicht unterstützt wird.
jcr.repository.version	Die Version der Repository-Implementierung
option.update.primary.node.type.supported	Gibt an, ob der primäre Knotentyp eines Knotens geändert werden kann. Dabei bedeutet „true“, dass Sie den primären Knotentyp ändern können, und „false“, dass die Änderung nicht unterstützt wird.
option.node.type.management.supported	Gibt an, ob die Knotentyp-Verwaltung unterstützt wird. Dabei bedeutet „true“, dass sie unterstützt wird, und „false“, dass sie nicht unterstützt wird.
node.type.management.overrides.supported	Gibt an, ob Sie die vererbte Eigenschaft oder die Definition des untergeordneten Knotens eines Knotentyps überschreiben können. Dabei bedeutet „true“, dass eine Überschreibung möglich ist, und „false“, dass die Überschreibung nicht unterstützt wird.
option.observation.supported	Der Wert „true“ bedeutet, dass die asynchrone Überwachung von Repository-Änderungen unterstützt wird. Bei unterstützter asynchroner Überwachung können Anwendungen Benachrichtigungen zu jeder Änderung sofort erhalten und darauf reagieren.
query.jcrscore	Der Wert „true“ bedeutet, dass die Pseudoeigenschaft „jcr:score“ in XPath verfügbar ist und mit SQL-Abfragen, die „jcrfn:contains“ (in XPath) oder „CONTAINS“ (in SQL) enthalten, Volltextsuchen durchgeführt werden können.
option.simple.versioning.supported	Der Wert „true“ bedeutet, dass das Repository die einfache Versionierung unterstützt. Bei der einfachen Versionierung bewahrt das Repository eine sequenzielle Serie an Versionen eines Knotens auf.
option.workspace.management.supported	Der Wert „true“ bedeutet, dass das Repository das Erstellen und Löschen von Workspaces mit APIs unterstützt.
option.update.mixin.node.types.supported	Der Wert „true“ bedeutet, dass das Repository das Hinzufügen und Entfernen von Mixin-Knotentypen eines vorhandenen Knotens unterstützt.
node.type.management.primary.item.name.supported	Der Wert „true“ bedeutet, dass das Repository zulässt, dass Knotendefinitionen ein primäres Element als untergeordnetes Element enthalten. Über die API kann auf das primäre Element zugegriffen werden, ohne den Namen des Elements zu kennen.
level.2.supported	Der Wert „true“ bedeutet, dass sowohl LEVEL_1_SUPPORTED als auch OPTION_XML_IMPORT_SUPPORTED wahr sind.
write.supported	Der Wert „true“ bedeutet, dass das Repository über die API Schreibzugriff bietet. Der Wert „false“ bedeutet, dass nur schreibgeschützter Zugriff möglich ist.
node.type.management.update.in.use.supported	Der Wert „true“ bedeutet, dass Sie die Knotendefinitionen ändern können, die von vorhandenen Knoten genutzt werden.
jcr.specification.version	Die Version der JCR-Spezifikation, die das Repository implementiert
option.journaled.observation.supported	Der Wert „true“ bedeutet, dass Anwendungen die Journaling-Überwachung des Repositorys vornehmen dürfen. Bei der Journaling-Überwachung können Änderungsbenachrichtigungen für einen bestimmten Zeitraum abgerufen werden.
query.languages	Die vom Repository unterstützten Abfragesprachen. Kein Wert bedeutet, dass keine Abfragen unterstützt werden.
option.xml.export.supported	Der Wert „true“ bedeutet, dass das Repository das Exportieren von Knoten als XML-Code unterstützt.
node.type.management.multiple.binary.properties.supported	Der Wert „true“ bedeutet, dass das Repository das Registrieren von Knotentypen unterstützt, die mehrere binäre Eigenschaften aufweisen. Der Wert „false“ bedeutet, dass eine einzige binäre Eigenschaft für einen Knotentyp unterstützt wird.
option.access.control.supported	Der Wert „true“ bedeutet, dass das Repository die Zugangssteuerung unterstützt, mit der Sie die Benutzerrechte für den Zugriff auf den Knoten einrichten und festlegen können.
option.baselines.supported	Der Wert „true“ bedeutet, dass das Repository sowohl Konfigurationen als auch Baselines unterstützt.
option.shareable.nodes.supported	Der Wert „true“ bedeutet, dass das Repository das Erstellen von gemeinsam nutzbaren Knoten unterstützt.
crx.cluster.id	Die ID des Repository-Clusters
query.stored.queries.supported	Der Wert „true“ bedeutet, dass das Repository gespeicherte Abfragen unterstützt.
query.full.text.search.supported	Der Wert „true“ bedeutet, dass das Repository die Volltextsuche unterstützt.
node.type.management.inheritance	Gibt den Grad der Unterstützung von Knotentypen-Vererbung durch das Repository an. Die folgenden Werte sind möglich: node.type.management.inheritance.minimal: Es können nur die primären Knotentypen registriert werden, die nur nt:base als Supertyp aufweisen. Die Registrierung von Mixin-Knotentypen ist auf die ohne Supertyp beschränkt. node.type.management.inheritance.single: Es können nur die primären Knotentypen mit einem Supertyp registriert werden. Die Registrierung von Mixin-Knotentypen ist auf die mit höchstens einem Supertyp beschränkt. node.type.management.inheritance.multiple: Es können primäre Knotentypen mit einem Supertyp oder mehreren Supertypen registriert werden. Es können Mixin-Knotentypen mit null oder mehr Supertypen registriert werden.
crx.cluster.preferredMaster	Der Wert „true“ bedeutet, dass dieser Cluster-Knoten der bevorzugte Master des Clusters ist.
option.transactions.supported	Der Wert „true“ bedeutet, dass das Repository Transaktionen unterstützt.
jcr.repository.vendor.url	Die URL des Repository-Anbieters
node.type.management.value.constraints.supported	Der Wert „true“ bedeutet, dass das Repository Wertebeschränkungen für Knoteneigenschaften unterstützt.
node.type.management.property.types	Ein Array von javax.jcr.PropertyType-Konstanten, die für die Eigenschaftstypen stehen, die ein registrierter Knotentyp festlegen kann. Ein Array der Länge null gibt an, dass registrierte Knotentypen keine Eigenschaftsdefinitionen festlegen können. Eigenschaftstypen sind: STRING, URI, BOOLEAN, LONG, DOUBLE, DECIMAL, BINARY, DATE, NAME, PATH, WEAKREFERENCE, REFERENCE und UNDEFINED (falls unterstützt)
node.type.management.orderable.child.nodes.supported	Der Wert „true“ bedeutet, dass das Repository die Beibehaltung der Reihenfolge der untergeordneten Knoten unterstützt.
jcr.repository.vendor	Der Name des Repository-Anbieters
query.joins	Der Grad an Unterstützung von Joins bei Abfragen. Die folgenden Werte sind möglich: query.joins.none: Keine Unterstützung von Joins. Abfragen können einen Selektor verwenden. query.joins.inner: Unterstützung von Inner Joins. query.joins.inner.outer: Unterstützung von Inner Joins und Outer Joins.
org.apache.jackrabbit.spi.commons.AdditionalEventInfo
query.xpath.doc.order	Der Wert „true“ bedeutet, dass das Repository die XPath 1.0-Abfragesprache unterstützt.
query.jcrpath
option.xml.import.supported	Der Wert „true“ bedeutet, dass das Repository das Importieren von XML-Code als Inhalt unterstützt.
node.type.management.same.name.siblings.supported	Der Wert „true“ bedeutet, dass das Repository Geschwisterknoten (Knoten mit demselben übergeordneten Element) mit demselben Namen unterstützt.
node.type.management.residual.definitions.supported	Der Wert „true“ bedeutet, dass das Repository Namenseigenschaften mit Restdefinitionen unterstützt. Wenn dies unterstützt wird, kann das Namensattribut einer Elementdefinition ein Asterisk (*) sein.
node.type.management.autocreated.definitions.supported	Der Wert „true“ bedeutet, dass das Repository die automatische Erstellung von untergeordneten Elementen (Knoten oder Eigenschaften) eines Knotens bei der Knotenerstellung unterstützt.
crx.cluster.master	Der Wert „true“ bedeutet, dass dieser Repository-Knoten der Master-Knoten des Clusters ist.
level.1.supported	Der Wert „true“ bedeutet, dass option.xml.export.support wahr ist und query.languages die Länge null aufweist.
option.unfiled.content.supported	Der Wert „true“ bedeutet, dass das Repository nicht geordnete Inhalte unterstützt. Nicht erfasste Knoten gehören nicht zur Hierarchie des Repositorys.
jcr.specification.name	Der Name der JCR-Spezifikation, die das Repository implementiert
option.versioning.supported	Der Wert „true“ bedeutet, dass das Repository die volle Versionierung unterstützt.
jcr.repository.name	Der Name des Repositorys
option.locking.supported	Der Wert „true“ bedeutet, dass das Repository das Sperren von Knoten unterstützt. Mit der Sperrung kann ein Benutzer temporär verhindern, dass ein anderer Benutzer Änderungen vornimmt.
jcr.repository.version.display
option.activities.supported	Der Wert „true“ bedeutet, dass das Repository Aktivitäten unterstützt. Aktivitäten sind eine Reihe von Änderungen, die in einem Workspace ausgeführt und in einem anderen Workspace zusammengeführt werden.
node.type.management.multivalued.properties.supported	Der Wert „true“ bedeutet, dass das Repository Knoteneigenschaften mit null oder mehr Werten unterstützt.
option.retention.supported	Der Wert „true“ bedeutet, dass das Repository die Nutzung von externen Anwendungen für das Aufbewahrungsmanagement unterstützt, um Aufbewahrungsrichtlinien für Inhalte anzuwenden, und das Halten und Freigeben unterstützt.
option.lifecycle.supported	Der Wert „true“ bedeutet, dass das Repository die Lebenszyklusverwaltung unterstützt.

WorkspaceNames: Die Namen der Workspaces im Repository. Schreibgeschützt.

DataStoreGarbageCollectionDelay: Die Zeitdauer in Millisekunden, wie lange die Speicherbereinigung nach dem Scannen jedes zehnten Knotens ruht. Lese- und Schreibzugriff.

BackupDelay: Die Zeitdauer in Millisekunden, wie lange der Backup-Vorgang nach jedem Backup-Schritt ruht. Lese- und Schreibzugriff.

BackupInProgress: Der Wert „true“ bedeutet, dass gerade ein Backup-Vorgang ausgeführt wird. Schreibgeschützt.

BackupProgress: Der Prozentsatz aller Dateien, die beim aktuellen Backup gesichert wurden. Schreibgeschützt.

CurrentBackupTarget: Die ZIP-Datei, in der die Backup-Dateien des aktuellen Backups gespeichert werden. Wenn gerade kein Backup durchgeführt wird, wird kein Wert angezeigt. Schreibgeschützt.

BackupWasSuccessful: Der Wert „true“ bedeutet, dass beim aktuellen Backup keine Fehler aufgetreten sind oder dass gerade kein Backup durchgeführt wird. Der Wert „false“ bedeutet, dass beim aktuellen Backup ein Fehler aufgetreten ist. Schreibgeschützt.

BackupResult: Der Status des aktuellen Backups. Die folgenden Werte sind möglich:

• Backup in progress: Gerade wird ein Backup ausgeführt.
• Backup canceled: Das Backup wurde abgebrochen.
• Backup finished with error: Beim Backup ist ein Fehler aufgetreten. Die Fehlermeldung enthält Angaben zur Ursache.
• Backup completed: Das Backup war erfolgreich.
• No backup executed so far: Es wird gerade kein Backup ausgeführt.

Schreibgeschützt.

TarOptimizationRunningSince: Die Uhrzeit, zu der der aktuelle Vorgang der Optimierung der TAR-Datei begonnen hat. Schreibgeschützt.

TarOptimizationDelay: Die Zeitdauer in Millisekunden, wie lange der Vorgang der Optimierung der TAR-Datei nach jedem Schritt ruht. Lese- und Schreibzugriff.

ClusterProperties: Ein Satz an Schlüsselwertpaaren, die für Cluster-Eigenschaften und -Werte stehen. Jede Zeile der Tabelle steht für eine Cluster-Eigenschaft. Schreibgeschützt.

ClusterNodes: Die Mitglieder des Repository-Clusters.

ClusterId: Die ID dieses Repository-Clusters. Schreibgeschützt.

ClusterMasterId: Die ID des Master-Knotens dieses Repository-Clusters. Schreibgeschützt.

ClusterNodeId: Die ID dieses Knotens des Repository-Clusters. Schreibgeschützt.

Betrieb

createWorkspace: Legt einen Workspace in diesem Repository an.

• Argumente:

  • name: ein Zeichenfolgenwert, der den Namen des neuen Workspaces darstellt.

• Zurückgegebener Wert: keiner

runDataStoreGarbageCollection: Führt die Speicherbereinigung auf den Repository-Knoten durch.

• Argumente:

  • delete: Ein boolescher Wert, der angibt, ob nicht genutzte Repository-Elemente gelöscht werden sollen. Der Wert „true“ bedeutet, dass nicht genutzte Knoten und Eigenschaften gelöscht werden. Der Wert „false“ bedeutet, dass alle Knoten gescannt, aber nicht gelöscht werden.

• Zurückgegebener Wert: keiner

stopDataStoreGarbageCollection: Hält eine gerade ausgeführte Datenspeicherbereinigung an.

• Argumente: keine
• Zurückgegebener Wert: Darstellung des aktuellen Status in einer Zeichenfolge

startBackup: Sichert Repository-Daten in einer ZIP-Datei.

• Argumente:

  • target: (optional) Ein String-Wert, der für den Namen der ZIP-Datei oder des Verzeichnisses steht, in der bzw. dem die Repository-Daten gespeichert werden sollen. Um eine ZIP-Datei zu verwenden, fügen Sie die ZIP-Dateinamen-Erweiterung ein. Um ein Verzeichnis zu verwenden, fügen Sie keine Dateinamen-Erweiterung ein.

    Um ein inkrementelles Backup durchzuführen, geben Sie das Verzeichnis an, das zuletzt für das Backup genutzt wurde.

    Sie können einen absoluten oder einen relativen Pfad festlegen. Relative Pfade sind relativ zum übergeordneten Element des CRX-Schnellstartverzeichnisses.

    Wenn Sie keinen Wert festlegen, wird der Standardwert backup-currentdate.zip genutzt, bei dem der Wert für das aktuelle Datum, currentdate, im Format yyyyMMdd-HHmm angegeben wird.

• Zurückgegebener Wert: keiner

cancelBackup: Hält den aktuellen Backup-Vorgang an und löscht das temporäre Archiv, das der Vorgang für die Archivierung der Daten erstellt hatte.

• Argumente: keine
• Zurückgegebener Wert: keiner

blockRepositoryWrites: Blockiert Änderungen an den Repository-Daten. Alle Backup-Listener des Repositorys werden über die Blockierung informiert.

• Argumente: keine
• Zurückgegebener Wert: keiner

unblockRepositoryWrites: Hebt die Blockierung des Repositorys auf. Alle Backup-Listener des Repositorys werden über die Aufhebung der Blockierung informiert.

• Argumente: keine
• Zurückgegebener Wert: keiner

startTarOptimization: Startet den Vorgang zur Optimierung der TAR-Datei mit dem Standardwert für tarOptimizationDelay.

• Argumente: keine
• Zurückgegebener Wert: keiner

stopTarOptimization: Hält die Optimierung der TAR-Datei an.

• Argumente: keine
• Zurückgegebener Wert: keiner

tarIndexMerge: Führt die höchsten Indexdateien aller TAR-Sets zusammen. Die höchsten Indexdateien sind Dateien mit unterschiedlichen Hauptversionen. Beispielsweise werden die folgenden Dateien in der Datei index_3_1.tar zusammengeführt: index_1_1.tar, index_2_0.tar, index_3_0.tar. Die zusammengeführten Dateien werden gelöscht (im vorherigen Beispiel sind das die Dateien index_1_1.tar, index_2_0.tar und index_3_0.tar).

• Argumente:

  • background: Ein boolescher Wert, der angibt, ob der Vorgang im Hintergrund ausgeführt werden soll, damit die Web-Konsole währenddessen verwendet werden kann. Der Wert „true“ bedeutet, dass der Vorgang im Hintergrund ausgeführt wird.

• Zurückgegebener Wert: keiner

becomeClusterMaster: Legt diesen Repository-Knoten als Master-Knoten des Clusters fest. Wenn er nicht bereits Master ist, hält dieser Befehl den Listener der aktuellen Master-Instanz an und startet einen Master-Listener auf dem aktuellen Knoten. Dieser Knoten wird dann als Master-Knoten festgelegt und neu gestartet, wodurch alle anderen Knoten im Cluster (d. h. die vom Master-Knoten gesteuerten Knoten) eine Verbindung zu dieser Instanz herstellen.

• Argumente: keine
• Zurückgegebener Wert: keiner

joinCluster Fügt dieses Repository einem Cluster als Knoten hinzu, der vom Cluster-Master gesteuert wird. Sie müssen für die Authentifizierung einen Benutzernamen und ein Kennwort eingeben. Die Verbindung nutzt die grundlegende Authentifizierung. Die Sicherheitsanmeldedaten werden mit Base64 verschlüsselt, bevor sie an den Server übermittelt werden.

• Argumente:

  • master: Ein Zeichenfolgenwert, der für die IP-Adresse oder den Computernamen des Computers steht, auf dem der Master-Repository-Knoten ausgeführt wird.
  • username: Der Benutzername, der für die Authentifizierung beim Cluster genutzt werden soll.
  • password: Das Kennwort, dass für die Authentifizierung genutzt werden soll.

• Zurückgegebener Wert: keiner

traversalCheck: Durchläuft und behebt ggf. Inkonsistenzen in einer Unterstruktur, beginnend bei einem bestimmten Knoten. Ausführliche Informationen hierzu finden Sie in der Dokumentation zu Persistenz-Managern.

consistencyCheck: Überprüft und behebt ggf. Inkonsistenzen im Datenspeicher. Ausführliche Informationen hierzu finden Sie in der Dokumentation zum Datenspeicher.

Repository-Statistiken (TimeSeries)

Der Wert des TimeSeries-Feldes für jeden Statistiktyp, den org.apache.jackrabbit.api.stats.RepositoryStatistics definiert.

• Domain: com.adobe.granite

• Typ: TimeSeries

• Name: einer der folgenden Werte aus der Enum-Klasse von org.apache.jackrabbit.api.stats.RepositoryStatistics.Type:

  • BUNDLE_CACHE_ACCESS_COUNTER
  • BUNDLE_CACHE_MISS_AVERAGE
  • BUNDLE_CACHE_MISS_COUNTER
  • BUNDLE_CACHE_MISS_DURATION
  • BUNDLE_CACHE_SIZE_COUNTER
  • BUNDLE_COUNTER
  • BUNDLE_READ_COUNTER
  • BUNDLE_WRITE_AVERAGE
  • BUNDLE_WRITE_COUNTER
  • BUNDLE_WRITE_DURATION
  • BUNDLE_WS_SIZE_COUNTER
  • QUERY_AVERAGE
  • QUERY_COUNT
  • QUERY_DURATION
  • SESSION_COUNT
  • SESSION_LOGIN_COUNTER
  • SESSION_READ_AVERAGE
  • SESSION_READ_COUNTER
  • SESSION_READ_DURATION
  • SESSION_WRITE_AVERAGE
  • SESSION_WRITE_COUNTER
  • SESSION_WRITE_DURATION

Attribute

Die folgenden Attribute werden für jeden Statistiktyp bereitgestellt, der gemeldet wird:

• ValuePerSecond: Der gemessene Wert pro Sekunde während der letzten Minute. Schreibgeschützt.
• ValuePerMinute: Der gemessene Wert pro Minute während der letzten Stunde. Schreibgeschützt.
• ValuePerHour: Der gemessene Wert pro Stunde während der letzten Woche. Schreibgeschützt.
• ValuePerWeek: Der gemessene Wert pro Woche während der letzten drei Jahre. Schreibgeschützt.

Repository-Abfragestatistiken

Statistische Informationen zu Repository-Abfragen.

• Domäne: com.adobe.granite
• Typ: QueryStat

Attribute

SlowQueries: Informationen zu den Repository-Abfragen, deren Abschluss am längsten gedauert hat. Schreibgeschützt.

SlowQueriesQueueSize: Die maximale Anzahl an Abfragen, die in der SlowQueries-Liste enthalten sein sollen. Lese- und Schreibzugriff.

PopularQueries: Informationen zu den Repository-Abfragen, die am häufigsten durchgeführt wurden. Schreibgeschützt.

PopularQueriesQueueSize: Die Höchstzahl an Abfragen in der PopularQueries-Liste. Lese- und Schreibzugriff.

Betrieb

clearSlowQueriesQueue: Entfernt alle Abfragen aus der SlowQueries-Liste.

• Argumente: keine
• Zurückgegebener Wert: keiner

clearPopularQueriesQueue: Entfernt alle Abfragen aus der PopularQueries-Liste.

• Argumente: keine
• Zurückgegebener Wert: keiner

Replikationsagenten

Überwachen Sie die Dienste für jeden Replikationsagenten. Wenn Sie einen Replikationsagenten erstellen, wird der Dienst automatisch in der JMX-Konsole angezeigt.

• Domain: com.adobe.granite.replication
• Typ: agent
• Name: kein Wert
• Eigenschaften: {id="Name"}, wobei Name der Wert der Eigenschaft für den Agentennamen ist.

Attribute

Id: Ein Zeichenfolgenwert, der für die ID der Konfiguration des Replikationsagenten steht. Mehrere Agenten können dieselbe Konfiguration nutzen. Schreibgeschützt.

Valid: Ein boolescher Wert, der angibt, ob der Agent korrekt konfiguriert ist:

• true: Gültige Konfiguration.
• false : Die Konfiguration enthält Fehler.

Schreibgeschützt.

Enabled: Ein boolescher Wert, der angibt, ob der Agent aktiviert ist:

• true: Aktiviert.
• false: Deaktiviert.

QueueBlocked: Ein boolescher Wert, der angibt, ob die Warteschlange vorhanden und blockiert ist:

• true: Blockiert. Ein automatischer erneuter Versuch steht aus.
• false: nicht blockiert oder nicht vorhanden

Schreibgeschützt.

QueuePaused: Ein boolescher Wert, der angibt, ob die Auftragswarteschlange angehalten wurde:

• true: angehalten (ausgesetzt)
• false: nicht angehalten oder nicht vorhanden.

Lese- und Schreibzugriff.

QueueNumEntries: Ein int-Wert, der für die Anzahl an Aufträgen in der Agentenwarteschlange steht. Schreibgeschützt.

QueueStatusTime: Ein Date-Wert, der die Zeit auf dem Server angibt, zu der die angezeigten Statuswerte abgerufen wurden. Der Wert entspricht dem Zeitpunkt, zu dem die Seite geladen wurde. Schreibgeschützt.

QueueNextRetryTime: Ein Date-Wert, der für blockierte Warteschlangen angibt, wann der nächste automatische erneute Versuch stattfindet. Wenn keine Zeit angegeben ist, ist die Warteschlange nicht blockiert. Schreibgeschützt.

QueueProcessingSince: Ein Date-Wert, der angibt, wann die Verarbeitung für den aktuellen Auftrag begonnen hat. Wenn keine Zeit angegeben ist, ist die Warteschlange entweder blockiert oder inaktiv. Schreibgeschützt.

QueueLastProcessTime: Ein Date-Wert, der angibt, wann der vorhergehende Auftrag abgeschlossen wurde. Schreibgeschützt.

Betrieb

queueForceRetry: Gibt bei blockierten Warteschlangen den Befehl zum erneuten Versuch an die Warteschlange aus.

• Argumente: keine
• Zurückgegebener Wert: keiner

queueClear: Entfernt alle Aufträge aus der Warteschlange.

• Argumente: keine
• Zurückgegebener Wert: keiner

Sling Engine

Stellt Statistiken zu HTTP-Abfragen bereit, damit Sie die Leistung des SlingRequestProcessor-Dienstes überwachen können.

• Domain: org.apache.sling
• Typ: Engine
• Eigenschaften:

Attribute

RequestsCount: Die Anzahl an Abfragen, die seit dem letzten Zurücksetzen der Statistiken erfolgt sind.

MinRequestDurationMsec: Die kürzeste Zeitdauer (in Millisekunden), die für die Verarbeitung einer Abfrage seit dem letzten Zurücksetzen der Statistiken erforderlich war.

MaxRequestDuratioMsec: Die längste Zeitdauer (in Millisekunden), die für die Verarbeitung einer Abfrage seit dem letzten Zurücksetzen der Statistiken erforderlich war.

StandardDeviationDurationMsec: Die Standardabweichung von der Zeitdauer, die für die Verarbeitung von Abfragen erforderlich war. Diese Standardabweichung wird basierend auf allen Abfragen seit dem letzten Zurücksetzen der Statistiken ermittelt.

MeanRequestDurationMsec: Die Standardabweichung von der Zeitdauer, die für die Verarbeitung von Abfragen erforderlich war. Dieser Durchschnitt wird basierend auf allen Abfragen seit dem letzten Zurücksetzen der Statistiken ermittelt.

Betrieb

resetStatistics: Setzt alle Statistiken auf null zurück. Setzen Sie die Statistiken zurück, wenn Sie die Abfragen-Verarbeitungsleistung innerhalb eines bestimmten Zeitrahmens analysieren müssen.

• Argumente: keine
• Zurückgegebener Wert: keiner

Package Manager

Informationen zu allen Paketen, die der Package Manager enthält.

• Domäne: com.adobe.granite.packaging
• Typ: Manager

Quickstart-Starter

Informationen zum Startvorgang und zum Quickstart-Starter.

• Domain: com.adobe.granite.quickstart
• Typ: Starter

Betrieb

log

Zeigt eine Meldung im QuickStart-Fenster an.

Argumente:

• p1: Ein String-Wert, der die anzuzeigende Meldung enthält. Die folgende Abbildung zeigt das Ergebnis des Aufrufs log mit einem p1-Wert von this is a log message.

• Zurückgegebener Wert: keiner

startupFinished

Ruft die startupFinished-Methode des Server-Starters auf. Die Methode versucht, die Willkommensseite in einem Webbrowser zu öffnen.

• Argumente: keine
• Zurückgegebener Wert: keiner

startupProgress

Legt den Abschlusswert des Server-Startvorgangs fest. Die Statusleiste im QuickStart-Fenster zeigt den Abschlusswert an.

• Argumente:

  • p1: Ein Gleitkommawert, der als Bruch angibt, wie groß der bereits abgeschlossene Anteil des Startvorgangs ist. Der Wert sollte zwischen null und eins liegen. Beispielsweise steht „0,3“ für „30 % abgeschlossen“.

• Zurückgegebener Wert: keiner.

Dienste von Drittanbietern

Einige Drittanbieter-Serverressourcen installieren MBeans, die Attribute und Vorgänge an die JMX-Konsole übermitteln. In der folgenden Tabelle sind die Drittanbieter-Ressourcen und Links zu weiteren Informationen aufgeführt.

Domain	Typ	MBean-Klasse
JMImplementation	MBeanServerDelegate	javax.management.MBeanServerDelegate
com.sun.management	HotSpotDiagnostic	com.sun.management.HotSpotDiagnosticMXBean
java.lang	ClassLoading Compilation GarbageCollector Arbeitsspeicher MemoryManager MemoryPool OperatingSystem Runtime Threading	javax.management-Paket
java.util.logging		java.util.logging.LoggingMXBean
osgi.core	bundleState Framework packageState serviceState	org.osgi.jmx.framework-Paket

Verwenden der JMX-Konsole

Die JMX-Konsole zeigt Informationen zu mehreren Diensten an, die auf dem Server ausgeführt werden:

• Attribute: Diensteigenschaften wie Konfigurationen oder Laufzeitdaten. Attribute können schreibgeschützt oder mit Lese- und Schreibzugriff versehen sein.
• Vorgänge: Befehle, die Sie bei dem Dienst aufrufen können.

MBeans, die mit einem OSGi-Dienst bereitgestellt werden, übermitteln Dienstattribute und Vorgänge an die Konsole. Das MBean legt fest, welche Attribute und Vorgänge übermittelt werden und ob sie schreibgeschützt oder mit Lese- und Schreibzugriff versehen sind.

Die Hauptseite der JMX-Konsole enthält eine Tabelle der Dienste. Jede Zeile in der Tabelle steht für einen Dienst, der von einem MBean übermittelt wird.

1. Öffnen Sie die Web-Konsole und klicken Sie auf die JMX-Registerkarte (http://localhost:4502/system/console/jmx).
2. Klicken Sie auf einen Zellenwert für einen Dienst, um die Attribute und Vorgänge für diesen Dienst anzuzeigen.
3. Um einen Attributwert zu ändern, klicken Sie auf den Wert, geben Sie den Wert im angezeigten Dialogfeld ein und klicken Sie auf „Speichern“.
4. Um einen Dienstvorgang aufzurufen, klicken Sie auf den Vorgangsnamen, geben Sie die Argumentwerte im angezeigten Dialogfeld ein und klicken Sie auf „Aufrufen“.

Verwenden externer JMX-Anwendungen zur Überwachung

Bei CRX können externe Anwendungen über Java Management Extensions (JMX) mit Managed Beans (MBeans) interagieren. Mit allgemeinen Konsolen wie JConsole oder Domain-spezifischen Überwachungsanwendungen können Sie CRX-Konfigurationen und -Eigenschaften abrufen und festlegen sowie die Leistung und Ressourcenauslastung überwachen.

Herstellen einer Verbindung zu CRX mit JConsole

Um mit JConsole eine Verbindung zu CRX herzustellen, gehen Sie wie folgt vor:

1. Öffnen Sie ein Terminal-Fenster.

2. Geben Sie den folgenden Befehl ein:

   jconsole

JConsole wird gestartet und das JConsole-Fenster wird angezeigt.

Verbinden mit einem lokalen CRX-Prozess

JConsole zeigt eine Liste der lokalen Java Virtual Machine-Prozesse an. Die Liste enthält zwei Quickstart-Prozesse. Wählen Sie den „CHILD“-Quickstart-Prozess aus der Liste der lokalen Prozesse aus. (Das ist in der Regel der Prozess mit der höheren PID.)

Verbinden mit einem externen CRX-Prozess

Um eine Verbindung zu einem externen CRX-Prozess herzustellen, muss auf der JVM, die den externen CRX-Prozess hostet, die Annahme von externen JMX-Verbindungen aktiviert sein.

Um externe JMX-Verbindungen zu aktivieren, müssen Sie beim Starten der JVM die folgende Systemeigenschaft festlegen:

com.sun.management.jmxremote.port=portNum

In der o. g. Eigenschaft steht portNum für die Nummer des Ports, für den JMX-RMI-Verbindungen aktiviert werden sollen. Stellen Sie sicher, dass Sie eine nicht verwendete Portnummer angeben. Durch das Festlegen dieser Eigenschaft wird nicht nur ein RMI-Connector für den lokalen Zugriff veröffentlicht, sondern auch ein zusätzlicher RMI-Connector in einer privaten, schreibgeschützten Registrierung am angegebenen Port. Dabei wird ein bekannter Name verwendet, und zwar „jmxrmi“.

Wenn Sie die Remote-Überwachung für den JMX-Agenten aktivieren, wird zur Kennwortauthentifizierung die Kennwortdatei genutzt, die mit der folgenden Systemeigenschaft beim Starten der Java VM festgelegt werden muss:

com.sun.management.jmxremote.password.file=pwFilePath

Detaillierte Anweisungen zum Einrichten einer Kennwortdatei finden Sie in der relevanten JMX-Dokumentation.

Beispiel:

$ java
  -Dcom.sun.management.jmxremote.password.file=pwFilePath
  -Dcom.sun.management.jmxremote.port=8463
  -jar ./cq-quickstart.jar

Verwenden der von CRX bereitgestellten MBeans

Nach dem Herstellen der Verbindung zum Quickstart-Prozess bietet JConsole eine Reihe allgemeiner Überwachungstools für die JVM, auf der CRX ausgeführt wird.

Um auf die internen Überwachungs- und Konfigurationsoptionen von CRX zuzugreifen, wählen Sie auf der Registerkarte „MBeans“ aus dem hierarchischen Inhaltsbaum auf der linken Seite die Attribute oder Vorgänge aus, für die Sie sich interessieren, z. B. für den Abschnitt „com.adobe.granite/Repository/Operations“.

Innerhalb dieses Abschnitts wählen Sie das gewünschte Attribut oder den gewünschten Vorgang im linken Bildschirmbereich aus.