Show Menu
SUJETS×

Contrôle des ressources de serveur à l’aide de la console JMX

La console JMX permet de surveiller et de gérer des services sur le serveur CRX. Les sections suivantes résument les attributs et les opérations exposés par le biais de la structure JMX.
Pour plus d’informations sur l’utilisation des commandes de la console, voir Utilisation de la console JMX . For background information about JMX, see the Java Management Extensions (JMX) Technology page on the Oracle website.
Pour plus d’informations sur la création de beans gérés (MBeans) pour gérer ces services à l’aide de la console JMX, voir Intégration des services à la console JMX (en anglais).

Maintenance des workflow

Opérations d’administration des instances de flux de travail en cours d’exécution, terminées, obsolètes et en échec.
  • Domaine : com.adobe.granite.workflow
  • Type : maintenance
Pour plus d’informations sur les outils d’administration des workflows et une description des statuts possibles des instances de workflows, voir Console Workflow .

Opérations

listRunningWorkflowsPerModel Répertorie le nombre d’instances de processus en cours d’exécution pour chaque modèle de processus.
  • Arguments : aucun
  • Valeur renvoyée : données présentées sous forme de tableau, qui contient les colonnes Nombre et ID de modèle.
listCompletedWorkflowsPerModel Répertorie le nombre d’instances de processus terminées pour chaque modèle de processus.
  • Arguments : aucun
  • Valeur renvoyée : données présentées sous forme de tableau, qui contient les colonnes Nombre et ID de modèle.
returnWorkflowQueueInfo Répertorie les informations sur les éléments de processus qui ont été traités et qui sont placés en file d'attente pour traitement.
  • Arguments : aucun
  • Valeur renvoyée : données présentées sous forme de tableau, qui contient les colonnes suivantes :
    • Tâches
    • Nom de la file d’attente
    • Tâches actives
    • Temps de traitement moyen
    • Temps d’attente moyen
    • Tâches annulées
    • Tâches en échec
    • Tâches terminées
    • Tâches traitées
    • Tâches en file d’attente
returnWorkflowJobTopicInfo Répertorie les informations de traitement pour les tâches de processus, organisées par rubrique.
  • Arguments : aucun
  • Valeur renvoyée : données présentées sous forme de tableau, qui contient les colonnes suivantes :
    • Nom de la rubrique
    • Temps de traitement moyen
    • Temps d’attente moyen
    • Tâches annulées
    • Tâches en échec
    • Tâches terminées
    • Tâches traitées
returnFailedWorkflowCount Affiche le nombre d'instances de processus qui ont échoué. Vous pouvez spécifier un modèle de workflow pour interroger ou extraire les informations pour tous les modèles de workflow.
  • Arguments :
    • Modèle : ID du modèle à interroger. Pour afficher le nombre d’instances de workflows ayant échoué pour tous les modèles de workflows, ne spécifiez aucune valeur. L’ID correspond au chemin d’accès au noeud de modèle, par exemple :
      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
  • Valeur renvoyée : nombre d’instances de workflow ayant échoué.
returnFailedWorkflowCountPerModel Affiche le nombre d'instances de processus qui ont échoué pour chaque modèle de processus.
  • Arguments : aucun.
  • Valeur renvoyée : données présentées sous forme de tableau, qui contient les colonnes Nombre et ID de modèle.
TerminerFailedInstances Arrêter les instances de processus qui ont échoué. Vous pouvez interrompre toutes les instances ayant échoué ou uniquement les instances ayant échoué pour un modèle spécifique. Vous avez la possibilité de redémarrer les instances après les avoir interrompues. Vous pouvez également tester l’opération pour afficher les résultats sans effectuer réellement l’opération.
  • Arguments :
    • Redémarrez l’instance : (facultatif) spécifiez la valeur true pour redémarrer les instances après les avoir interrompues. La valeur par défaut false n’entraîne pas le redémarrage des instances de workflow interrompues.
    • Exécution d’essai : (facultatif) spécifiez la valeur true pour afficher les résultats de l’opération sans effectuer réellement l’opération. La valeur par défaut false entraîne l’exécution de l’opération.
    • Modèle : (facultatif) ID du modèle auquel l’opération est appliquée. Ne spécifiez aucun modèle pour appliquer l’opération aux instances ayant échoué de tous les modèles de workflows. L’ID correspond au chemin d’accès au noeud de modèle, par exemple :
      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
  • Valeur renvoyée : données sur les instances interrompues présentées sous forme de tableau, qui contient les colonnes suivantes :
    • Initiateur
    • ID d’instance
    • ID de modèle
    • Charge utile
    • Commentaire de début
    • Titre du workflow
retryFailedWorkItems Tente d'exécuter les étapes d'une tâche qui ont échoué. Vous pouvez réessayer toutes les tâches ayant échoué ou uniquement les tâches ayant échoué pour un modèle de flux de travail spécifique. Vous avez la possibilité de tester l’opération pour afficher les résultats sans effectuer réellement l’opération.
  • Arguments :
    • Exécution d’essai : (facultatif) spécifiez la valeur true pour afficher les résultats de l’opération sans effectuer réellement l’opération. La valeur par défaut false entraîne l’exécution de l’opération.
    • Modèle : (facultatif) ID du modèle auquel l’opération est appliquée. Ne spécifiez aucun modèle pour appliquer l’opération aux tâches ayant échoué pour tous les modèles de workflows. L’ID correspond au chemin d’accès au noeud de modèle, par exemple :
      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
  • Valeur renvoyée : données sur les tâches ayant échoué qui ont été retentées, présentées sous forme de tableau, qui contient les colonnes suivantes :
    • Initiateur
    • ID d’instance
    • ID de modèle
    • Charge utile
    • Commentaire de début
    • Titre du workflow
PurgeActive Supprime les instances de flux de travail actives d’un âge spécifique. Vous pouvez purger des instances actives pour tous les modèles ou pour un modèle spécifique seulement. Vous avez la possibilité de tester l’opération pour afficher les résultats sans effectuer réellement l’opération.
  • Arguments :
    • Modèle : (facultatif) ID du modèle auquel l’opération est appliquée. Ne spécifiez aucun modèle pour appliquer l’opération aux instances de workflows de tous les modèles de workflows. L’ID correspond au chemin d’accès au noeud de modèle, par exemple :
      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
    • Nombre de jours écoulés depuis le début du workflow : ancienneté des instances de workflows à purger, exprimée en jours.
    • Exécution d’essai : (facultatif) spécifiez la valeur true pour afficher les résultats de l’opération sans effectuer réellement l’opération. La valeur par défaut false entraîne l’exécution de l’opération.
  • Valeur renvoyée : données sur les instances de workflows actives purgées, présentées sous forme de tableau, qui contient les colonnes suivantes :
    • Initiateur
    • ID d’instance
    • ID de modèle
    • Charge utile
    • Commentaire de début
    • Titre du workflow
countStaleWorkflows Renvoie le nombre d’instances de processus obsolètes. Vous pouvez extraire le nombre d’instances obsolètes pour tous les modèles de workflows ou pour un modèle spécifique.
  • Arguments :
    • Modèle : (facultatif) ID du modèle auquel l’opération est appliquée. Ne spécifiez aucun modèle pour appliquer l’opération aux instances de workflows de tous les modèles de workflows. L’ID correspond au chemin d’accès au noeud de modèle, par exemple :
      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
  • Valeur renvoyée : nombre d’instances de workflows obsolètes.
RestaleStaleWorkflows Redémarre les instances de workflow obsolètes. Vous pouvez redémarrer toutes les instances obsolètes ou seulement les instances obsolètes pour un modèle spécifique. Vous pouvez également tester l’opération pour afficher les résultats sans effectuer réellement l’opération.
  • Arguments :
    • Modèle : (facultatif) ID du modèle auquel l’opération est appliquée. Ne spécifiez aucun modèle pour appliquer l’opération aux instances obsolètes de tous les modèles de workflows. L’ID correspond au chemin d’accès au noeud de modèle, par exemple :
      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
    • Exécution d’essai : (facultatif) spécifiez la valeur true pour afficher les résultats de l’opération sans effectuer réellement l’opération. La valeur par défaut false entraîne l’exécution de l’opération.
  • Valeur renvoyée : une liste d’instances de workflows redémarrées.
fetchModelList Répertorie tous les modèles de processus.
  • Arguments : aucun
  • Valeur renvoyée : données identifiant les modèles de workflows, présentées sous forme de tableau, qui contient les colonnes ID de modèle et Nom du modèle.
countRunningWorkflows Renvoie le nombre d’instances de processus en cours d’exécution. Vous pouvez extraire le nombre d’instances en cours d’exécution pour tous les modèles de workflows ou pour un modèle spécifique.
  • Arguments :
    • Modèle : (Facultatif) ID du modèle pour lequel le nombre d’instances en cours d’exécution est renvoyé. Ne spécifiez aucun modèle pour renvoyer le nombre d’instances exécutées pour tous les modèles de workflows. L’ID correspond au chemin d’accès au noeud de modèle, par exemple :
      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
  • Valeur renvoyée : nombre d’instances de workflows exécutées.
countCompletedWorkflows Renvoie le nombre d’instances de processus terminées. Vous pouvez extraire le nombre d’instances terminées pour tous les modèles de workflows ou pour un modèle spécifique.
  • Arguments :
    • Modèle : (Facultatif) ID du modèle pour lequel le nombre d’instances terminées est renvoyé. Ne spécifiez aucun modèle pour renvoyer le nombre d’instances terminées pour tous les modèles de workflows. L’ID correspond au chemin d’accès au noeud de modèle, par exemple :
      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
  • Valeur renvoyée : nombre d’instances de workflows terminées.
purgeCompleted supprime du référentiel les enregistrements des processus terminés d’un âge spécifique. Utilisez régulièrement cette opération pour réduire la taille du référentiel lorsque vous utilisez intensivement des workflows. Vous pouvez purger les instances terminées pour tous les modèles ou pour un modèle spécifique seulement. Vous avez la possibilité de tester l’opération pour afficher les résultats sans effectuer réellement l’opération.
  • Arguments :
    • Modèle : (facultatif) ID du modèle auquel l’opération est appliquée. Ne spécifiez aucun modèle pour appliquer l’opération aux instances de workflows de tous les modèles de workflows. L’ID correspond au chemin d’accès au noeud de modèle, par exemple :
      /conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
    • Nombre de jours écoulés depuis la fin du workflow : nombre de jours pendant lesquels les instances de workflows ont eu l’état Terminé.
    • Exécution d’essai : (facultatif) spécifiez la valeur true pour afficher les résultats de l’opération sans effectuer réellement l’opération. La valeur par défaut false entraîne l’exécution de l’opération.
  • Valeur renvoyée : données sur les instances de workflows terminées purgées, présentées sous forme de tableau, qui contient les colonnes suivantes :
    • Initiateur
    • ID d’instance
    • ID de modèle
    • Charge utile
    • Commentaire de début
    • Titre du workflow

Référentiel

Informations sur le référentiel CRX
  • Domaine : com.adobe.granite
  • Type : référentiel

Attributs

Nom Nom de la mise en oeuvre du référentiel JCR. Lecture seule.
Version Version de la mise en oeuvre du référentiel. Lecture seule.
HomeDir Répertoire dans lequel se trouve le référentiel. L’emplacement par défaut est <QuickStart_Jar_Location>/crx-quickstart/repository. Lecture seule.
NomDuClient Nom du client auquel la licence logicielle est délivrée. Lecture seule.
LicenseKey Clé de licence unique pour cette installation du référentiel. Lecture seule.
AvailableDiskSpace Espace disque disponible pour cette instance du référentiel, en Mo. Lecture seule.
MaximumNumberOfOpenFiles Nombre de fichiers pouvant être ouverts simultanément. Lecture seule.
SessionTracker Valeur de la variable système crx.debug.sessions. true indique une session de débogage. false indique une session normale. Lecture/écriture.
Descripteurs Ensemble de paires clé-valeur qui représentent les propriétés du référentiel. Toutes les propriétés sont en lecture seule.
Clé Valeur
option.node.and.property.with.same.name.supported Indique si un nœud et une propriété du nœud peuvent porter le même nom. La valeur true indique qu’il est possible de leur attribuer le même nom, la valeur false, que cela ne l’est pas.
identifier.stability Indique la stabilité des identifiants de nœud non référençables. Les valeurs possibles sont les suivantes :
  • identifier.stability.indefinite.duration : les identifiants ne changent pas.
  • identifier.stability.method.duration : les identifiants peuvent changer entre les appels de la méthode.
  • identifier.stability.save.duration : les identifiants ne changent pas au cours d’un cycle d’enregistrement/actualisation.
  • identifier.stability.session.duration : les identifiants ne changent pas au cours d’une session.
query.xpath.pos.index Indique si le langage de requête XPath JCR 1.0 est pris en charge. La valeur true indique que ce langage est pris en charge, la valeur false indique qu’il ne l’est pas.
crx.repository.systemid Identifiant système figurant dans le fichier system.id.
option.query.sql.supported Indique si le langage de requête XPath JCR 1.0 est pris en charge. La valeur true indique que ce langage est pris en charge, la valeur false indique qu’il ne l’est pas.
jcr.repository.version Version de la mise en œuvre du référentiel.
option.update.primary.node.type.supported Indique si le type de nœud principal d’un nœud peut être modifié. La valeur true indique que vous pouvez modifier le type de nœud principal, la valeur false indique que cela n’est pas possible.
option.node.type.management.supported Indique si la gestion du type de nœud est prise en charge. La valeur true indique que la gestion est prise en charge, la valeur false, qu’elle ne l’est pas.
node.type.management.overrides.supported Indique si vous pouvez remplacer la propriété héritée ou la définition de nœud enfant d’un type de nœud. La valeur true indique que les remplacements sont pris en charge, la valeur false qu’ils ne le sont pas.
option.observation.supported La valeur true indique que l’observation asynchrone des modifications apportées au référentiel est prise en charge. La prise en charge de l’observation asynchrone permet aux applications de recevoir et de répondre aux notifications concernant chaque modification au fur et à mesure de leur apparition.
query.jcrscore
true indique que la pseudo-propriété jcr:score est disponible dans les requêtes XPath et SQL qui incluent une fonction jcrfn:contains (dans XPath) ou CONTAINS (dans SQL) pour effectuer une recherche de texte intégral.
option.simple.versioning.supported La valeur true indique que le référentiel prend en charge le contrôle de version simple. Avec le contrôle de version simple, le référentiel conserve une série séquentielle des versions d’un nœud.
option.workspace.management.supported La valeur true indique que le référentiel prend en charge la création et la suppression des espaces de travail à l’aide d’API.
option.update.mixin.node.types.supported La valeur true indique que le référentiel prend en charge l’ajout et la suppression des types de nœuds Mixin d’un nœud existant.
node.type.management.primary.item.name.supported La valeur true indique que le référentiel permet aux définitions de nœud de contenir un élément principal en tant qu’enfant. Un élément principal est accessible à l’aide de l’API sans connaître le nom de l’élément.
level.2.supported La valeur true indique que LEVEL_1_SUPPORTED et OPTION_XML_IMPORT_SUPPORTED sont définis sur true.
write.supported La valeur true indique que le référentiel fournit un accès en écriture à l’aide de l’API. La valeur false indique un accès en lecture seule.
node.type.management.update.in.us e.supported La valeur true indique que vous pouvez modifier les définitions de nœud utilisées par les nœuds existants.
jcr.specification.version Version de la spécification JCR mise en œuvre par le référentiel.
option.journaled.observation.supported La valeur true indique que les applications peuvent effectuer une observation journalisée du référentiel. Avec l’observation journalisée, un ensemble de notifications de modification peut être obtenu pour une période spécifiée.
query.languages Langages de requête pris en charge par le référentiel. Si aucune valeur n’est définie, les requêtes ne sont pas prises en charge.
option.xml.export.supported La valeur true indique que le référentiel prend en charge l’exportation des nœuds sous forme de code XML.
node.type.management.multiple.binary.properties.supported La valeur true indique que le référentiel prend en charge l’enregistrement des types de nœuds comportant plusieurs propriétés de fichier binaire. La valeur false indique qu’une seule propriété binaire est prise en charge pour un type de nœud.
option.access.control.supported La valeur true indique que le référentiel prend en charge le contrôle d’accès pour définir et déterminer les droits d’utilisateur pour l’accès au nœud.
option.baselines.supported La valeur true indique que le référentiel prend en charge les configurations et les lignes de base.
option.shareable.nodes.supported La valeur true indique que le référentiel prend en charge la création de nœuds partageables.
crx.cluster.id Identifiant du cluster du référentiel.
query.stored.queries.supported La valeur true indique que le référentiel prend en charge les requêtes enregistrées.
query.full.text.search.supported La valeur true indique que le référentiel prend en charge la recherche de texte intégral.
node.type.management.inheritance
Indique le niveau de prise en charge du référentiel pour l’héritage du type de nœud. Les valeurs possibles sont les suivantes :
node.type.management.inheritance.minimal : l’enregistrement des types de nœuds principaux se limite aux types qui contiennent uniquement le supertype nt:base. L’enregistrement des types de nœuds Mixin se limite aux types ne comportant pas de supertype.
node.type.management.héritage.single: L'enregistrement des types de noeud principal est limité à ceux avec un supertype. L’enregistrement des types de nœuds Mixin se limite aux types comportant un supertype au maximum.
node.type.management.héritage.multiple : Les types de noeud principaux peuvent être enregistrés avec un ou plusieurs supertypes. Les types de nœuds Mixin peuvent être enregistrés sans supertype ou avec un ou plusieurs supertypes.
crx.cluster.preferredMaster La valeur true indique que ce nœud de cluster est le maître préféré du cluster.
option.transactions.supported La valeur true indique que le référentiel prend en charge les transactions.
jcr.repository.vendor.url Adresse URL du fournisseur de référentiel.
node.type.management.value.constraints.supported La valeur true indique que le référentiel prend en charge les contraintes de valeur des propriétés de nœud.
node.type.management.property.types tableau de constantes javax.jcr.PropertyType représentant les types de propriétés qu’un type de noeud enregistré peut spécifier. Un tableau dont la longueur est égale à zéro indique que les types de nœuds enregistrés ne peuvent pas spécifier de définitions de propriétés. Les types de propriétés sont CHAÎNE, URI, BOOLÉEN, LONG, DOUBLE, DECIMAL, BINARY, DATE, NAME, PATH, WEAKREFERENCE, REFERENCE et UNDEFINED (s’il est pris en charge).
node.type.management.orderable.child.nodes.supported La valeur true indique que le référentiel prend en charge la conservation de l’ordre des nœuds enfants.
jcr.repository.vendor Nom du fournisseur de référentiel.
query.joins
Niveau de prise en charge des jointures dans les requêtes. Les valeurs possibles sont les suivantes :
  • query.joins.none : jointures non prises en charge. Les requêtes peuvent utiliser un sélecteur.
  • query.joins.inner : prise en charge des jointures internes.
  • query.joins.inner.outer : prise en charge des jointures internes et externes.
org.apache.jackrabbit.spi.commons.AdditionalEventInfo
query.xpath.doc.order La valeur true indique que le référentiel prend en charge le langage de requête XPath 1.0.
query.jcrpath
option.xml.import.supported La valeur true indique que le référentiel prend en charge l’importation de code XML sous forme de contenu.
node.type.management.same.name.siblings.supported La valeur true indique que le référentiel prend en charge des nœuds apparentés (nœuds possédant le même parent) portant le même nom.
node.type.management.residual.definitions.supported La valeur true indique que le référentiel prend en charge les propriétés de nom avec des définitions résiduelles. Si cette version est prise en charge, l’attribut de nom d’une définition d’élément peut être un astérisque (« * »).
node.type.management.autocreated.definitions.supported La valeur true indique que le référentiel prend en charge la création automatique des éléments (nœuds ou propriétés) enfants d’un nœud lorsque le nœud est créé.
crx.cluster.master La valeur true indique que ce référentiel est le nœud maître du cluster.
level.1.supported La valeur true indique que option.xml.export.support est vrai et que query.languages possède une longueur non nulle.
option.unfiled.content.supported La valeur true indique que le référentiel prend en charge le contenu non classé. Les nœuds non classés ne font pas partie de la hiérarchie du référentiel.
jcr.specification.name Nom de la spécification JCR mise en œuvre par le référentiel.
option.versioning.supported La valeur true indique que le référentiel prend en charge le contrôle de version complet.
jcr.repository.name Nom du référentiel.
option.locking.supported La valeur true indique que le référentiel prend en charge le verrouillage des nœuds. Grâce au verrouillage, un utilisateur peut empêcher temporairement les autres utilisateurs d’apporter des modifications.
jcr.repository.version.display
option.activities.supported La valeur true indique que le référentiel prend en charge des activités. Les activités sont un ensemble de modifications effectuées dans un espace de travail qui est fusionné dans un autre espace de travail.
node.type.management.multivalued.properties.supported La valeur true indique que le référentiel prend en charge les propriétés de nœud qui peuvent ne comporter aucune valeur ou comporter une ou plusieurs valeurs.
option.retention.supported La valeur true indique que le référentiel prend en charge l’utilisation d’applications externes de gestion de la conservation pour appliquer des stratégies de conservation à du contenu et prend en charge la rétention et la diffusion.
option.lifecycle.supported La valeur true indique que le référentiel prend en charge la gestion du cycle de vie.
WorkspaceNames Noms des espaces de travail dans le référentiel. Lecture seule.
DataStoreGarbageCollectionDelay Durée, en millisecondes, pendant laquelle la collecte des déchets est endormie après analyse tous les dix noeuds. Lecture/écriture.
Délai de sauvegarde Durée, en millisecondes, pendant laquelle le processus de sauvegarde est en attente entre chaque étape de la sauvegarde. Lecture/écriture.
BackupInProgress La valeur true indique qu’un processus de sauvegarde est en cours d’exécution. Lecture seule.
Progression de la sauvegardePour la sauvegarde actuelle, pourcentage de tous les fichiers sauvegardés. Lecture seule.
CurrentBackupTarget Pour la sauvegarde actuelle, fichier ZIP dans lequel les fichiers de sauvegarde sont stockés. Lorsqu’une sauvegarde n’est pas en cours, aucune valeur n’apparaît. Lecture seule.
BackupWasSuccess La valeur true indique qu’aucune erreur n’est survenue pendant la sauvegarde actuelle ou qu’aucune sauvegarde n’est en cours. La valeur false indique qu’une erreur s’est produite lors de la sauvegarde actuelle. Lecture seule.
BackupResult État de la sauvegarde actuelle. Les valeurs possibles sont les suivantes :
  • Sauvegarde en cours : une sauvegarde est en cours d’exécution.
  • Sauvegarde annulée : la sauvegarde a été annulée.
  • Sauvegarde terminée avec une erreur : une erreur s’est produite lors de la sauvegarde. Le message d’erreur contient des informations sur la cause.
  • Sauvegarde terminée : la sauvegarde a réussi.
  • Aucune sauvegarde exécutée jusque-là : il n’y a pas de sauvegarde en cours.
Lecture seule.
TarOptimizationRunningSince l'heure à laquelle le processus d'optimisation de fichier TAR actuel a commencé. Lecture seule.
TarOptimizationDelay Durée en millisecondes pendant laquelle le processus d’optimisation TAR dort entre chaque étape du processus. Lecture/écriture.
ClusterProperties Ensemble de paires clé-valeur qui représentent les propriétés et les valeurs de la grappe. Chaque ligne du tableau représente une propriété du cluster. Lecture seule.
ClusterNodes Membres de la grappe de référentiel.
ClusterId Identifiant de cette grappe de référentiel. Lecture seule.
ClusterMasterId Identifiant du noeud maître de cette grappe de référentiel. Lecture seule.
ClusterNodeId Identifiant de ce noeud de la grappe de référentiel. Lecture seule.

Opérations

createWorkspace Crée un espace de travail dans ce référentiel.
  • Arguments :
    • name : valeur de chaîne, qui représente le nom du nouvel espace de travail.
  • Valeur renvoyée : aucune
runDataStoreGarbageCollection Exécute la collecte des déchets sur les noeuds du référentiel.
  • Arguments :
    • delete : Valeur booléenne indiquant si les éléments de référentiel inutilisés doivent être supprimés. La valeur true entraîne la suppression des nœuds et des propriétés inutilisés. La valeur false entraîne l’analyse de tous les nœuds, mais aucun nœud n’est supprimé.
  • Valeur renvoyée : aucune
stopDataStoreGarbageCollection Arrête une collecte de déchets de stockage de données en cours d’exécution.
  • Arguments : aucun
  • Valeur renvoyée : représentation de l’état actuel, sous forme de chaîne
startBackup Sauvegarde les données du référentiel dans un fichier ZIP.
  • Arguments :
    • target : (Facultatif) String valeur représentant le nom du fichier ou du répertoire ZIP dans lequel archiver les données du référentiel. Pour utiliser un fichier ZIP, incluez l’extension du nom de fichier ZIP. Pour utiliser un répertoire, n’incluez pas d’extension de nom de fichier.
      Pour effectuer une sauvegarde incrémentielle, spécifiez le répertoire qui a déjà été utilisé pour la sauvegarde.
      Vous pouvez spécifier un chemin d’accès absolu ou relatif. Les chemins d’accès relatifs sont relatifs par rapport au parent du répertoire crx-quickstart.
      When you specify no value, the default value of backup-currentdate.zip is used, where currentdate is in the format yyyyMMdd-HHmm .
  • Valeur renvoyée : aucune
cancelBackup Arrête le processus de sauvegarde actuel et supprime l'archive temporaire créée pour l'archivage des données.
  • Arguments : aucun
  • Valeur renvoyée : aucune
blockRepositoryWrites Bloque les modifications apportées aux données du référentiel. Tous les programmes d’écoute de la sauvegarde du référentiel sont informés du blocage.
  • Arguments : aucun
  • Valeur renvoyée : aucune
unblockRepositoryWrites Supprime le bloc du référentiel. Tous les programmes d’écoute de la sauvegarde du référentiel sont informés de la levée du blocage.
  • Arguments : aucun
  • Valeur renvoyée : aucune
startTarOptimization Démarre le processus d’optimisation de fichier TAR à l’aide de la valeur par défaut de tarOptimizationDelay.
  • Arguments : aucun
  • Valeur renvoyée : aucune
stopTarOptimization arrête l’optimisation des fichiers TAR.
  • Arguments : aucun
  • Valeur renvoyée : aucune
tarIndexMerge Fusionne les fichiers d’index supérieurs de tous les jeux TAR. Les fichiers d’index supérieurs sont des fichiers avec différentes versions majeures. Par exemple, les fichiers suivants sont fusionnés dans le fichier index_3_1.tar : index_1_1.tar, index_2_0.tar, index_3_0.tar. Les fichiers qui ont été fusionnés sont supprimés (dans l’exemple précédent, index_1_1.tar, index_2_0.tar et index_3_0.tar sont supprimés).
  • Arguments :
    • background  : valeur booléenne, qui indique si l’opération doit être exécutée en arrière-plan afin que la console web soit utilisable lors de l’exécution. La valeur true exécute l’opération en arrière-plan.
  • Valeur renvoyée : aucune
getClusterMaster Définit ce noeud de référentiel comme noeud maître de la grappe. S’il n’est pas déjà le nœud principal, cette commande arrête le programme d’écoute de l’instance principale actuelle et démarre un programme d’écoute sur le nœud actuel. Ce nœud est alors défini comme nœud maître et redémarre, ce qui entraîne la connexion de tous les nœuds esclaves à cette instance.
  • Arguments : aucun
  • Valeur renvoyée : aucune
joinCluster Ajoute ce référentiel à une grappe en tant que noeud esclave. Vous devez fournir un nom d’utilisateur et un mot de passe pour l’authentification. La connexion utilise l’authentification de base. Les informations de connexion de sécurité sont codées en base 64 avant d’être envoyées au serveur.
  • Arguments :
    • master  : valeur de chaîne, qui représente l’adresse IP ou le nom de l’ordinateur qui exécute le nœud de référentiel maître.
    • username  : nom à utiliser pour l’authentification au niveau du cluster.
    • password  : mot de passe à utiliser pour l’authentification.
  • Valeur renvoyée : aucune
traversalCheck Effectue une transition et corrige éventuellement les incohérences dans une sous-arborescence commençant à un noeud spécifique. Cet aspect est abordé en détail dans la documentation sur les gestionnaires de persistance.
constanceVérifier les contrôles et éventuellement corriger la cohérence dans la banque de données. Cet aspect est abordé en détail dans la documentation sur l’entrepôt de données.

Statistiques du référentiel (TimeSeries)

Valeur du champ TimeSeries pour chaque type de statistiques défini par org.apache.jackrabbit.api.stats.RepositoryStatistics .
  • Domaine: com.adobe.granite
  • Type: TimeSeries
  • Name: One of the following values from the org.apache.jackrabbit.api.stats.RepositoryStatistics.Type Enum class:
    • 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

Attributs

Les attributs ci-dessous sont fournis pour chaque type de statistique faisant l’objet d’un compte-rendu :
  • ValuePerSecond : valeur mesurée par seconde au cours de la dernière minute. Lecture seule.
  • ValuePerMinute : valeur mesurée par minute au cours de la dernière heure. Lecture seule.
  • ValuePerHour : Valeur mesurée par heure au cours de la dernière semaine. Lecture seule.
  • ValuePerWeek : Valeur mesurée par semaine au cours des trois dernières années. Lecture seule.

Statistiques des requêtes dans le référentiel

Informations statistiques sur les requêtes dans le référentiel.
  • Domaine : com.adobe.granite
  • Type : QueryStat

Attributs

SlowQueries Informations sur les requêtes du référentiel dont l’exécution a pris le plus de temps. Lecture seule.
SlowQueriesQueueSize Nombre maximal de requêtes à inclure dans la liste SlowQueries. Lecture-écriture.
Requêtes populaires Informations sur les requêtes du référentiel qui se sont produites le plus. Lecture seule.
PopularQueriesQueueSize Nombre maximal de requêtes dans la liste PopularQueries. Lecture-écriture.

Opérations

clearSlowQueriesQueue Supprime toutes les requêtes de la liste SlowQueries.
  • Arguments : aucun
  • Valeur renvoyée : aucune
clearPopularQueriesQueue Supprime toutes les requêtes de la liste PopularQueries.
  • Arguments : aucun
  • Valeur renvoyée : aucune

Agents de réplication

Surveillez les services pour chaque agent de réplication. Lorsque vous créez un agent de réplication, le service s’affiche automatiquement dans la console JMX.
  • ​Domaine : com.adobe.granite.Replication
  • ​Type : agent
  • ​Nom : aucune valeur
  • ​Propriétés : , où Name est la valeur de la propriété Agent Name.

Attributs

Id Valeur de chaîne qui représente l'identifiant de la configuration de l'agent de réplication. Plusieurs agents peuvent utiliser la même configuration. Lecture seule.
Valeur booléenne valide qui indique si l’agent est configuré correctement :
  • true : Configuration valide.
  • false : La configuration contient des erreurs.
Lecture seule.
Activé Valeur booléenne qui indique si l’agent est activé :
  • true : Activé.
  • false : Désactivé.
QueueBlock Valeur booléenne qui indique si la file d'attente existe et est bloquée :
  • true : Bloquée. Une nouvelle tentative automatique est en attente.
  • false  : non bloquée ou inexistante.
Lecture seule.
QueuePaused Valeur booléenne qui indique si la file d'attente de travaux est mise en pause :
  • true : Suspendu (suspendu)
  • false  : non suspendue ou inexistante.
Lecture-écriture.
QueueNumEntries Valeur int qui représente le nombre de tâches dans la file d'attente de l'agent. Lecture seule.
QueueStatusTime Valeur Date qui indique l'heure sur le serveur à laquelle les valeurs d'état affichées ont été obtenues. La valeur correspond au délai de chargement de la page. Lecture seule.
QueueNextRetryTime Pour les files d’attente bloquées, valeur de date qui indique le moment où la prochaine tentative automatique a lieu. Lorsque aucun délai ne s’affiche, la file d’attente n’est pas bloquée. Lecture seule.
QueueProcessingSince Valeur de date qui indique quand le traitement a commencé pour la tâche en cours. Lorsque aucun délai ne s’affiche, la file d’attente est bloquée ou inactive. Lecture seule.
QueueLastProcessTime Valeur de date qui indique la date de fin de la tâche précédente. Lecture seule.

Opérations

queueForceRetry Pour les files d’attente bloquées, envoie la commande retry à la file d’attente.
  • Arguments : aucun
  • Valeur renvoyée : aucune
queueClear Supprime toutes les tâches de la file d’attente.
  • Arguments : aucun
  • Valeur renvoyée : aucune

Moteur Sling

Fournit des statistiques sur les demandes HTTP afin de pouvoir surveiller les performances du service SlingRequestProcessor.
  • Domaine : org.apache.sling
  • Type : moteur
  • Propriétés :

Attributs

DemandesCount Nombre de demandes qui se sont produites depuis la dernière réinitialisation des statistiques.
MinRequestDurationMsec Durée la plus courte (en millisecondes) requise pour traiter une requête depuis la dernière réinitialisation des statistiques.
MaxRequestDuratioMsec Durée la plus longue (en millisecondes) requise pour traiter une requête depuis la dernière réinitialisation des statistiques.
StandardDeviationDurationMsec Écart type du temps requis pour traiter les demandes. L’écart-type est calculé à l’aide de toutes les demandes depuis que les statistiques ont été réinitialisées pour la dernière fois.
MeanRequestDurationMsec Durée moyenne requise pour traiter une requête. La moyenne est calculée à l’aide de toutes les demandes depuis que les statistiques ont été réinitialisées pour la dernière fois.

Opérations

resetStatistics Définit toutes les statistiques sur zéro. Réinitialisez les statistiques lorsque vous devez analyser les performances de traitement des demandes pendant une période spécifique.
  • Arguments : aucun
  • Valeur renvoyée : aucune

le gestionnaire de modules

Informations sur tous les packages que contient le gestionnaire de modules.
  • Domaine : com.adobe.granite.packaging
  • Type : gestionnaire

Lanceur de Quickstart

Informations sur le processus de démarrage et le lanceur de Quickstart.
  • Domaine : com.adobe.granite.quickstart
  • Type : lanceur

Opérations

Journal
Affiche un message dans la fenêtre QuickStart.
Arguments :
  • p1: A String value that represents the message to display. L’illustration suivante montre le résultat d’un appel log avec une valeur p1 de this is a log message .
  • Valeur renvoyée : aucune
startupFinished
Appelle la méthode startupFinished du lanceur du serveur. La méthode tente d’ouvrir la page d’accueil dans un navigateur web.
  • Arguments : aucun
  • Valeur renvoyée : aucune
startupProgress
Définit la valeur de fin du processus de démarrage du serveur. La barre de progression dans la fenêtre QuickStart représente la valeur de fin.
  • Arguments :
    • p1 : valeur flottante représentant la quantité du processus de démarrage terminée, sous forme de fraction. La valeur doit être comprise entre zéro et un. Par exemple, 0,3 indique que le processus est terminé à 30 %.
  • Valeur renvoyée : aucune.

Services tiers

Plusieurs ressources de serveur tiers installent des beans gérés (MBeans), qui exposent des attributs et des opérations dans la console JMX. Le tableau ci-dessous répertorie les ressources tierces et contient des liens vers des informations supplémentaires.
Domaine Type Classe MBean
JMImplementation MBeanServerDelegate javax.management.MBeanServerDelegate
com.sun.management HotSpotDiagnostic com.sun.management.HotSpotDiagnosticMXBean
java.lang
  • ClassLoading
  • Compilation
  • GarbageCollector
  • Mémoire
  • MemoryManager
  • MemoryPool
  • OperatingSystem
  • Runtime
  • Threading
package javax.management
java.util.logging java.util.logging.LoggingMXBean
osgi.core
  • bundleState
  • framework
  • packageState
  • serviceState
org.osgi.jmx.framework package

Utilisation de la console JMX

La console JMX affiche des informations sur différents services exécutés sur le serveur :
  • Attributs : propriétés de service, comme des configurations ou des données d’exécution. Les attributs peuvent être en lecture seule ou en lecture/écriture.
  • Opérations : commandes que vous pouvez appeler dans le service.
Les MBeans déployés avec un service OSGi exposent les attributs et les opérations du service dans la console. Le MBean détermine les attributs et les opérations exposés et si les attributs sont en lecture seule ou en lecture/écriture.
La page principale de la console JMX comporte un tableau des services. Chaque ligne du tableau représente un service exposé par un MBean.
  1. Ouvrez la console web et cliquez sur l’onglet JMX. ( http://localhost:4502/system/console/jmx )
  2. Cliquez sur une valeur de cellule pour un service afin d’afficher les attributs et les opérations du service.
  3. Pour modifier une valeur d’attribut, cliquez sur la valeur, spécifiez la valeur dans la boîte de dialogue qui s’affiche, puis cliquez sur Enregistrer.
  4. Pour appeler une opération de service, cliquez sur le nom de l’opération, spécifiez les valeurs des arguments dans la boîte de dialogue qui s’affiche, puis cliquez sur Appeler.

Utilisation des applications JMX externes pour la surveillance

CRX permet aux applications externes d’interagir avec les beans gérés (MBeans) par le biais de Java Management Extensions (JMX) . L’utilisation de consoles génériques comme JConsole ou d’applications de surveillance spécifiques au domaine permet d’extraire et de définir les configurations et les propriétés de CRX, ainsi que de surveiller les performances et l’utilisation des ressources.

Utilisation de JConsole pour la connexion à CRX

Pour se connecter à CRX à l’aide de JConsole, procédez comme suit :
  1. Ouvrez une fenêtre de terminal.
  2. Exécutez la commande suivante :
    jconsole
JConsole démarre et la fenêtre JConsole s’affiche.

Connexion à un processus CRX local

JConsole affiche une liste des processus locaux de machine virtuelle Java. La liste contient deux processus QuickStart. Sélectionnez le processus « ENFANT » QuickStart dans la liste des processus locaux (il s’agit généralement du processus qui possède le PID le plus élevé).

Connexion à un processus CRX distant

Pour se connecter à un processus CRX distant, la machine virtuelle Java qui héberge le processus CRX distant doit être activée pour accepter les connexions JMX à distance.
Pour activer les connexions JMX à distance, la propriété système ci-dessous doit être définie au démarrage de la machine virtuelle Java :
com.sun.management.jmxremote.port=portNum
Dans la propriété ci-dessus, portNum correspond au numéro de port sur lequel vous souhaitez activer les connexions RMI JMX. Veillez à spécifier un numéro de port inutilisé. Outre la publication d’un connecteur RMI pour l’accès local, la définition de cette propriété publie un autre connecteur RMI dans un registre privé en lecture seule sur le port spécifié à l’aide d’un nom bien connu, « jmxrmi ».
Par défaut, lorsque vous activez l’agent JMX pour la surveillance à distance, il utilise l’authentification par mot de passe à partir d’un fichier de mot de passe qui doit être spécifié à l’aide de la propriété système ci-dessous au démarrage de la machine virtuelle Java :
com.sun.management.jmxremote.password.file=pwFilePath
Pour obtenir des instructions détaillées sur la configuration d’un fichier de mot de passe, consultez la documentation JMX correspondante .
Exemple:
$ java
  -Dcom.sun.management.jmxremote.password.file=pwFilePath
  -Dcom.sun.management.jmxremote.port=8463
  -jar ./cq-quickstart.jar

Utilisation des MBeans fournis par CRX

Après la connexion au processus QuickStart, JConsole fournit différents outils de surveillance d’ordre général pour la machine virtuelle Java sur laquelle CRX est exécuté.
Pour accéder aux options de surveillance et de configuration internes de CRX, cliquez sur l’onglet MBeans et, dans l’arborescence à gauche, sélectionnez la section Attributs ou Opérations qui vous intéresse. Par exemple, la section com.adobe.granite/Repository/Operations.
Dans cette section, sélectionnez l’attribut ou l’opération de votre choix dans le volet de gauche.