Überwachen von Serverressourcen mit der JMX-Konsole

Mit der JMX-Konsole können Sie Dienste auf dem CRX-Server überwachen und verwalten. Die folgenden Abschnitte fassen die Attribute und Vorgänge zusammen, die über das JMX-Framework verfügbar gemacht werden.

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

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.

• Domäne: com.adobe.granite.workflow
• Typ: Wartung

Betrieb

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

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

listCompletedWorkflowsPerModel Listet die Anzahl der abgeschlossenen Workflow-Instanzen für jedes Workflow-Modell auf.

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

returnWorkflowQueueInfo Listet Informationen zu Workflow-Elementen auf, die verarbeitet wurden und zur Verarbeitung in die Warteschlange gestellt werden.

• 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 Listet Verarbeitungsinformationen für Workflow-Aufträge nach Thema auf.

• 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 Zeigt die Anzahl der fehlgeschlagenen Workflow-Instanzen an. 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 Zeigt die Anzahl der Workflow-Instanzen an, die für jedes Workflow-Modell fehlgeschlagen sind.

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

terminateFailedInstances Beenden Sie fehlgeschlagene Workflow-Instanzen. 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
  • Nutzlast
  • StartComment
  • WorkflowTitle

retryFailedWorkItems Versuche, 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 einer bestimmten Seite. 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 veralteter 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 alte 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 Listet 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 der ausgeführten 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:

  • Modell: (Optional) Die ID des Modells, für das die Anzahl der ausgeführten 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 der 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:

  • Modell: (Optional) Die ID des Modells, für das die Anzahl abgeschlossener 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 abgeschlossener Workflows einer bestimmten Seite 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

• Domäne: 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 des Kunden, dem die Softwarelizenz erteilt wird. Schreibgeschützt.

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

AvailableDiskSpace Der für diese Instanz des Repositorys verfügbare Speicherplatz in MB. Schreibgeschützt.

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

SessionTracker Der Wert der Systemvariablen crx.debug.sessions . "true"bedeutet eine Debug-Sitzung. false zeigt eine normale Sitzung an. Lese- und Schreibzugriff.

Deskriptoren Ein Satz von Schlüssel-Wert-Paaren, die Repository-Eigenschaften darstellen. 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"zeigt an, dass die pseudo-Eigenschaft jcr:score in XPath- und SQL-Abfragen verfügbar ist, die eine Funktion jcrfn:contains (in XPath) oder CONTAINS (in SQL) enthalten, um eine Volltextsuche durchzuführen.
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: Die Registrierung primärer Knotentypen ist auf die Typen mit einem Supertyp beschränkt. Die Registrierung von Mixin-Knotentypen ist auf die mit höchstens einem Supertyp beschränkt. node.type.management.inheritance.multiple: Primäre Knotentypen können mit einem 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 die Eigenschaftstypen darstellen, die ein registrierter Knotentyp angeben 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 Arbeitsbereich vorgenommen werden und in einem anderen Arbeitsbereich 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 Arbeitsbereiche im Repository. Schreibgeschützt.

DataStoreGarbageCollectionDelay Die Zeitdauer in Millisekunden, die die Speicherbereinigung nach dem Scannen jedes zehnten Knotens schläft. Lese- und Schreibzugriff.

BackupDelay Die Zeit in Millisekunden, die der Backup-Prozess zwischen jedem Schritt des Backups ruht. Lese- und Schreibzugriff.

BackupInProgress Der Wert true zeigt an, dass ein Sicherungsprozess ausgeführt wird. Schreibgeschützt.

BackupProgress Für die aktuelle Sicherung ist der Prozentsatz aller gesicherten Dateien. Schreibgeschützt.

CurrentBackupTarget Für die aktuelle Sicherung die ZIP-Datei, in der Sicherungsdateien gespeichert werden. Wenn gerade kein Backup durchgeführt wird, wird kein Wert angezeigt. Schreibgeschützt.

BackupWarSuccessful Der Wert true zeigt an, dass während der aktuellen Sicherung keine Fehler aufgetreten sind oder keine Sicherung ausgefü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 Der Zeitpunkt, zu dem der aktuelle TAR-Dateioptimierungsprozess begann. Schreibgeschützt.

TarOptimizationDelay Die Zeitdauer in Millisekunden, die der TAR-Optimierungsprozess zwischen jedem Schritt des Prozesses schläft. Lese- und Schreibzugriff.

ClusterProperties Ein Satz von Schlüssel-Wert-Paaren, die Clustereigenschaften und -werte darstellen. Jede Zeile der Tabelle steht für eine Cluster-Eigenschaft. Schreibgeschützt.

ClusterNodes Die Mitglieder des Repository-Clusters.

ClusterId Die Kennung dieses Repository-Clusters. Schreibgeschützt.

ClusterMasterId Die Kennung des Übergeordneten Knotens dieses Repository-Clusters. Schreibgeschützt.

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

Betrieb

createWorkspace Erstellt einen Arbeitsbereich in diesem Repository.

• Argumente:

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

• Zurückgegebener Wert: keiner

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

• Argumente:

  • Löschen: Ein boolescher Wert, der anzeigt, ob nicht verwendete 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 Stoppt eine laufende Datenspeicherbereinigung.

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

startBackup Sichert Repository-Daten in einer ZIP-Datei.

• Argumente:

  • target: (Optional) A String -Wert, der den Namen der ZIP-Datei oder des Ordners darstellt, in dem die Repository-Daten archiviert 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 angeben, wird der Standardwert von backup-currentdate.zip verwendet wird, wobei currentdate im Format yyyyMMdd-HHmm.

• Zurückgegebener Wert: keiner

cancelBackup Stoppt den aktuellen Backup-Prozess und löscht das temporäre Archiv, das der Prozess zur Archivierung von Daten erstellt hat.

• 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 Entfernt den Block aus dem Repository. Alle Backup-Listener des Repositorys werden über die Aufhebung der Blockierung informiert.

• Argumente: keine
• Zurückgegebener Wert: keiner

startTarOptimization Startet den TAR-Dateioptimierungsprozess mit dem Standardwert für tarOptimizationDelay.

• Argumente: keine
• Zurückgegebener Wert: keiner

stopTarOptimization Stoppt die Optimierung der TAR-Datei.

• Argumente: keine
• Zurückgegebener Wert: keiner

tarIndexMerge Führt die obersten Indexdateien aller TAR-Sets zusammen. Die höchsten Indexdateien sind Dateien mit unterschiedlichen Hauptversionen. Beispielsweise werden die folgenden Dateien mit 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 werden index_1_1.tar, index_2_0.tar und index_3_0.tar gelöscht).

• 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

getClusterMaster Legt diesen Repository-Knoten als Übergeordneten 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 Übergeordneter Knoten festgelegt und neu gestartet, wodurch alle anderen Knoten im Cluster (d. h. die vom Übergeordneten 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-Übergeordnet 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 optional Inkonsistenzen in einer Unterstruktur, die an einem bestimmten Knoten beginnt. Ausführliche Informationen hierzu finden Sie in der Dokumentation zu Persistenzmanagern.

consistencyCheck Prüft und behebt optional die Konsistenz 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 org.apache.jackrabbit.api.stats.RepositoryStatistics.Type Enum-Klasse:

  • 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 in der letzten Woche. Schreibgeschützt.
• ValuePerWeek: Der gemessene Wert pro Woche in den letzten drei Jahren. Schreibgeschützt.

Repository-Abfragestatistiken

Statistische Informationen zu Repository-Abfragen.

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

Attribute

SlowQueries Informationen zu den Repository-Abfragen, die am längsten ausgeführt wurden. Schreibgeschützt.

SlowQueriesQueueSize Die maximale Anzahl von Abfragen, die in die Liste SlowQueries aufgenommen werden sollen. Lese- und Schreibzugriff.

PopularQueries Informationen zu den Repository-Abfragen, die am häufigsten aufgetreten sind. Schreibgeschützt.

PopularQueriesQueueSize Die maximale Anzahl von Abfragen in der Liste PopularQueries . Lese- und Schreibzugriff.

Betrieb

clearSlowQueriesQueue Entfernt alle Abfragen aus der Liste SlowQueries .

• Argumente: keine
• Zurückgegebener Wert: keiner

clearPopularQueriesQueue Entfernt alle Abfragen aus der Liste PopularQueries .

• 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.

• Domäne: com.adobe.granite.replication
• Typ: Agent
• Name: kein Wert
• Eigenschaften: {id="Name"}, wobei Name ist der Wert der Eigenschaft "Agent Name".

Attribute

ID Ein String -Wert, der die Kennung der Konfiguration des Replikationsagenten darstellt. Mehrere Agenten können dieselbe Konfiguration nutzen. Schreibgeschützt.

Gültig Ein boolean -Wert, der anzeigt, ob der Agent ordnungsgemäß konfiguriert ist:

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

Schreibgeschützt.

Aktiviert Ein boolean -Wert, der anzeigt, ob der Agent aktiviert ist:

• true: Aktiviert.
• false: Disabled.

QueueBlocked Ein boolescher Wert, der anzeigt, 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 boolean -Wert, der anzeigt, ob die Auftragswarteschlange angehalten wurde:

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

Lese- und Schreibzugriff.

QueueNumEntries Ein int -Wert, der die Anzahl der Aufträge in der Agentenwarteschlange darstellt. 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 Bei blockierten Warteschlangen ein Datumswert, der angibt, wann der nächste automatische Neuversuch erfolgt. Wenn keine Zeit angegeben ist, ist die Warteschlange nicht blockiert. Schreibgeschützt.

QueueProcessingSince Ein Date -Wert, der anzeigt, 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 vorherige Auftrag abgeschlossen wurde. Schreibgeschützt.

Betrieb

queueForceRetry Gibt bei blockierten Warteschlangen den Befehl zum erneuten Versuch in 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.

• Domäne: org.apache.sling
• Typ: Engine
• Eigenschaften:

Attribute

RequestsCount Die Anzahl der Anfragen, die seit dem letzten Zurücksetzen der Statistiken aufgetreten sind.

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

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

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

MeanRequestDurationMsec Die durchschnittliche Zeit, die für die Verarbeitung einer Anfrage erforderlich war. Dieser Durchschnitt wird basierend auf allen Abfragen seit dem letzten Zurücksetzen der Statistiken ermittelt.

Betrieb

resetStatistics Setzt alle Statistiken auf null. 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.

• Domäne: 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 package
java.util.logging		java.util.logging.LoggingMXBean
osgi.core	bundleState Framework packageState serviceState	org.osgi.jmx.framework package

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 domänenspezifischen Ü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.