Référence de l'utilitaire xsadmin

Vous pouvez passer des arguments à l'utilitaire xsadmin selon deux méthodes différentes : avec un argument de ligne de commande ou avec un fichier de propriétés.

Arguments de xsadmin

Vous pouvez définir un fichier de propriétés pour l'utilitaire xsadmin avec version 7.1 Correctif 1 ou ultérieur. En créant un fichier de propriétés, vous pouvez enregistrer certains des arguments fréquemment utilisés, tels que le nom d'utilisateur. Les propriétés que vous pouvez ajouter à un fichier de propriétés se trouvent dans le tableau suivant. Si vous spécifiez une propriété à la fois dans un fichier de propriétés et dans l'argument de ligne de commande équivalent, la valeur de l'argument de ligne de commande remplace la valeur du fichier de propriétés.

Pour plus d'informations sur la définition d'un fichier de propriétés pour l'utilitaire xsadmin, voir Création d'un profil de configuration pour l'utilitaire xsadmin.

Tableau 1. Arguments de l'utilitaire xsadmin
Arguments de ligne de commande Nom de la propriété équivalente dans le fichier de propriétés Description et valeurs valides
-bp n/a

Indique le port d'écoute.

Valeur par défaut :2809

-ch n/a

Indique le nom d'hôte JMX pour le serveur de catalogue.

Valeur par défaut :localhost

-clear n/a

Efface la mappe définie.

Permet d'utiliser les filtres suivants : -fm

-containers n/a Pour chaque grille de données et chaque mappe définies, affiche une liste des serveurs de conteneurs.

>Permet d'utiliser les filtres suivants : -fnp

-continuous n/a Spécifiez cet indicateur si vous voulez des résultats de taille de mappe en continu pour surveiller la grille de données. Lorsque vous exécutez cette commande avec l'argument -mapsizes , la taille de la mappe s'affiche toutes les 20 secondes.
-coregroups n/a Affiche tous les groupes centraux pour le serveur de catalogue. Cet argument est utilisé pour des diagnostics avancés.
-dismissLink <domaine_service_catalogue> n/a

Supprime un lien entre 2 domaine de services de catalogue. Spécifiez le nom du domaine de services de catalogue étranger auquel vous vous êtes connecté antérieurement avec l'argument -establishLink.

-dmgr n/a

Indique si vous êtes connecté à un service de catalogue hébergé par WebSphere Application Server.

Par défaut :false

-empties n/a Spécifiez cet indicateur si vous voulez afficher les conteneurs vides dans les résultats.
-establishLink <nom_domaine_étranger> <hôte1:port1,hôte2:port2...> n/a

Connecte le domaine de services de catalogue à un domaine de services de catalogue étranger. Utilisez le format suivant : -establishLink <nom_domaine_étranger> <hôte1:port1,hôte2:port2...>. nom_domaine_étranger est le nom du domaine de services de catalogue étranger et hôte1:port1,hôte2:port2... est une liste séparée par des virgules de noms d'hôte de serveur de catalogue et de ports ORB (Object Request Broker) qui s'exécutent dans ce domaine de services de catalogue.

-fc n/a Filtre pour ce conteneur uniquement.
Si vous effectuez le filtrage des serveurs de conteneurs dans un environnement WebSphere Application Server Network Deployment, utilisez la syntaxe suivante :
<cell_name>/<node_name>/<serverName_containerSuffix>

Utilisez les arguments suivants : -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec

-fh n/a Filtre pour cet hôte uniquement.

Utilisez les arguments suivants : -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec,-routetable

-fm n/a Filtre uniquement cette mappe.

Utilisez les arguments suivants : -clear, -mapsizes

-fnp n/a Filtre les serveurs qui n'ont pas de fragments principaux.

Utilisez les arguments suivants : -containers

-fp n/a Filtre pour cette partition uniquement.

Utilisez les arguments suivants : -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec,-routetable

-fs n/a Filtre pour ce serveur uniquement.
Si vous effectuez le filtrage des serveurs d'applications dans un environnement WebSphere Application Server Network Deployment , utilisez la syntaxe suivante :
<cell_name>/<node_name>/<server_name>

Utilisez les arguments suivants : -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec

-fst n/a Filtre pour ce type de fragment uniquement. Spécifiez P pour les fragments principaux uniquement, A pour les fragments de réplique asynchrone uniquement et S pour les fragments de réplique synchrone uniquement.

Utilisez les arguments suivants : -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec

-fz n/a Filtre pour cette zone uniquement.

Utilisez les arguments suivants : -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec,-routetable

-force n/a Force l'action qui est dans la commande, en désactivant toutes les invites préalables. Cet argument est utile pour exécuter des commandes par lot.
-g n/a Spécifie le nom d'ObjectGrid.
-getstatsspec n/a Affiche la spécification de statistique actuelle. Vous pouvez définir la spécification de statistique avec l'argument -setstatsspec.

Permet d'utiliser les filtres suivants : -fst -fc -fz -fs -fh -fp

-getTraceSpec n/a Affiche la spécification de trace actuelle. Vous pouvez définir la spécification de trace avec l'argument -settracespec.

Permet d'utiliser les filtres suivants : -fst -fc -fz -fs -fh -fp

-h n/a Affiche l'aide de l'utilitaire xsadmin qui inclut une liste d'arguments.
-hosts n/a Affiche tous les hôtes de la configuration.
-jmxUrl XSADMIN_JMX_URL Spécifie l'adresse d'un serveur de connecteur d'API JMX au format suivant : service:jmx:protocole:sap. Les définitions des variables protocole et sap sont les suivantes :
protocole
Spécifie le protocole de transport à utiliser pour la connexion au serveur de connecteur.
sap
Spécifie l'adresse à laquelle le serveur de connecteur se trouve.
Pour plus d'informations sur le format de l'URL du service JMX, voir Classe JMXServiceURL (Java 2 Platform SE 5.0).
-l n/a Affiche toutes les grilles de données et groupes de mappes connues.
-m n/a Spécifie le nom du groupe de mappes.
-mapsizes n/a Affiche la taille de chaque mappe sur le serveur de catalogue pour vérifier que la distribution des clés est uniforme sur les fragments.

Permet d'utiliser les filtres suivants : -fm -fst -fc -fz -fs -fh -fp

-mbeanservers n/a Affiche une liste de tous les noeuds finals de serveur de bean géré.
-overridequorum n/a

Remplace le paramètre de quorum de sorte que les événements du serveur de conteneur ne sont pas ignorés lors d'un scénario d'échec du centre de données.

-password XSADMIN_PASSWORD Spécifie le mot de passe pour se connecter à l'utilitaire xsadmin. Ne spécifiez pas le mot de passe dans votre fichier de propriétés si vous voulez que ce mot de passe reste sécurisé.
-p n/a

Indique le port JMX pour l'hôte du serveur de catalogue.

Valeur par défaut: 1099 ou 9809 pour un hôte WebSphere Application Server, 1099 pour les configurations autonomes.

-placementStatus

n/a Affiche le placement configuré et le placement de l'environnement d'exécution de votre configuration. Vous pouvez définir la portée de la sortie à une combinaison de grilles de données et de groupes de mappes, ou à la configuration entière :
  • Configuration entière :
    -placementStatus
  • Pour une grille de données spécifique :
    -placementStatus -g ma_grille
  • Pour un groupe de mappes spécifique :
    -placementStatus -m mon_groupe_de_mappes
  • Pour une grille de données et un groupe de mappes spécifiques :
    -placementStatus  -g ma_grille 
    -m mon_groupe_de_mappes
-primaries n/a Affiche une liste des fragments principaux.
-profile n/a Spécifie un chemin complet au fichier de propriétés pour l'utilitaire xsadmin.
-quorumstatus n/a

Affiche le statut du quorum pour le service de catalogue.

-releaseShard <nom_serveur_conteneur> <nom_objectgrid> <nom_groupe_mappes> <nom_partition> n/a Utilisé en association avec l'argument -reserveShard. L'argument -releaseShard doit être appelé après qu'un fragment a été réservé et placé . L'argument -releaseShard appelle la méthode ContainerMBean.release().
-reserved n/a Utilisé avec l'argument -containers pour afficher uniquement les fragments qui ont été réservés avec l'argument -reserveShard.
-reserveShard <nom_serveur_conteneur> <nom_objectgrid> <nom_groupe_mappes> <nom_partition> n/a Transfère un fragment primaire vers le serveur de conteneur défini. La méthode ContainerMBean.reserve() est appelée par cet argument.

-resumeBalancing <objectgrid_name> <map_set_name>

n/a Tente d'équilibrer les requêtes. Autorise les tentatives de rééquilibrage futur dans l'ObjectGrid et le groupe de mappes spécifiés.
-revisions n/a Affiche les identificateurs des révisions d'un domaine de services de catalogue avec chaque grille de données, le numéro de partition, le type de partition (principale ou réplique), le domaine de services de catalogue, l'ID de durée de vie et le nombre de révisions des données de chaque fragment. Vous pouvez utiliser cet argument pour déterminer si une réplique asynchrone ou un domaine lié sont interceptés. Cet argument appelle la méthode ObjectGridMBean.getKnownRevisions().

Permet d'utiliser les filtres suivants : -fst -fc -fz -fs -fh -fp

-routetable n/a Affiche l'état actuel de la grille de données à partir d'une perspective serveur client. La table de routage est l'information qu'un serveur client ObjectGrid utilise pour communiquer avec la grille de données. Utilisez la table de routage sous la forme d'une aide au diagnostic lorsque vous tentez d'identifier les problèmes de connexion ou les exceptions TargetNotAvailable.

Arguments requis : Dans un environnement autonome, vous devez spécifier les paramètres -bp et -p les avec cet argument si vous n'utilisez pas les valeurs par défaut pour le port d'écoute d'amorçage et le port JMX pour l'hôte du serveur de catalogue.

Permet d'utiliser les filtres suivants : -fz -fh -fp

-settracespec <chaîne_trace> n/a
Active la trace sur les serveurs pendant l'exécution. Reportez-vous à l'exemple suivant :
-setTraceSpec "ObjectGridReplication=all=enabled"
Voir Collecte de trace et Options de trace pour plus d'informations sur les chaînes de trace que vous pouvez spécifier.

Permet d'utiliser les filtres suivants : -fst -fc -fz -fs -fh -fp

-swapShardWithPrimary <container_server_name> <objectgrid_name> <map_set_name> <partition_name>

n/a Permute le fragment de réplique défini du serveur de conteneur indiqué et le fragment primaire. Cette commande permet d'équilibrer manuellement les fragments primaires lorsque cela est nécessaire.
-setstatsspec <spécification_stats> n/a Active la collecte des statistiques. Cet argument appelle les méthodes DynamicServerMBean.setStatsSpec et DynamicServerMBean.getStatsSpec. Pour plus d'informations, voir Activation des statistiques.

Permet d'utiliser les filtres suivants : -fm -fst -fc -fz -fs -fh -fp

-suspendBalancing <objectgrid_name> <map_set_name>

n/a Empêche les tentatives d'équilibrage de l'ObjectGrid et du groupe de mappes définis.
-ssl n/a Indique que SSL (Secure Sockets Layer) est activé.
-teardown n/a

Arrête une liste ou un groupe de serveurs de catalogue et de conteneur.

Permet d'utiliser les filtres suivants : -fst -fc -fz -fs -fh -fp

Format pour spécifier une liste de serveurs :
nom_serveur_1,nom_serveur_2 ...
Pour arrêter tous les serveurs dans une zone, incluez l'argument -fz :
–fz <nom_zone>
Pour arrêter tous les serveurs sur un hôte, incluez l'argument -fh :
–fh <nom_hôte>
-triggerPlacement n/a Force le placement de fragment à s'exécuter, en ignorant la valeur numInitialContainers définie dans le fichier de déploiement XML. Vous pouvez utiliser cet argument lorsque vous effectuez des opérations de maintenance pour pouvoir continuer à placer les fragments, même si la valeur numInitialContainers est inférieure à la valeur définie.
-trustPass XSADMIN_TRUST_PASS Spécifie le mot de passe pour le fichier de clés certifiées spécifié.
-trustPath XSADMIN_TRUST_PATH Spécifie un chemin vers le fichier de clés certifiées.

Exemple : etc/test/security/server.public

-trustType XSADMIN_TRUST_TYPE Spécifie le type de fichier de clés certifiées.

Les valeurs valides sont : JKS, JCEK, PKCS12, etc.

-unassigned n/a Affiche une liste de fragments qui ne peuvent pas être placés sur la grille de données. Les fragments ne peuvent pas être placés lorsque le service de placement a une contrainte qui empêche le placement.
-username XSADMIN_USERNAME Spécifie le nom d'utilisateur pour se connecter à l'utilitaire xsadmin.
-v n/a Active l'action de ligne de commande prolixe. Utilisez cet indicateur si vous utilisez des variables d'environnement, un fichier de propriétés, ou les deux pour spécifier certains arguments de ligne de commande, et si vous voulez afficher leur valeur. Pour plus d'informations, voir Option prolixe de l'utilitaire xsadmin.
-xml n/a Affiche la sortie filtrée à partir de la méthode PlacementServiceMBean.listObjectGridPlacement(). Les autres arguments xsadmin filtrent la sortie de cette méthode et organisent les données dans un format plus exploitable.