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.
Vous pouvez définir un fichier de propriétés pour l'utilitaire xsadmin avec WebSphere eXtreme Scale Client 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.
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 | Cet argument de ligne de commande ne s'applique pas pour les configurations WebSphere DataPower XC10 Appliance. |
-dmgr | n/a | Cet argument de ligne de commande ne s'applique pas pour les configurations WebSphere DataPower XC10 Appliance. |
-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 | Cet argument de ligne de commande ne s'applique pas pour les configurations WebSphere DataPower XC10 Appliance. |
-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 :
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 :
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 :
|
-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 | Cet argument de ligne de commande ne s'applique pas pour les configurations WebSphere DataPower XC10 Appliance. |
-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 | Cet argument de ligne de commande ne s'applique pas pour les configurations WebSphere DataPower XC10 Appliance. |
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 :
|
|
-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 | Cet argument de ligne de commande ne s'applique pas pour les configurations WebSphere DataPower XC10 Appliance. |
-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 demandes. Permet des tentatives de rééquilibrage futurs sur l'ObjectGrid et le groupe de mappes définis. |
-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 | Cet argument de ligne de commande ne s'applique pas pour les configurations WebSphere DataPower XC10 Appliance. Voir Utilisation des fichiers journaux de WebSphere DataPower XC10 Appliance pour plus d'informations sur la configuration de la trace sur le dispositif. 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.
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 | Permet d'utiliser les filtres suivants : -fst -fc -fz -fs -fh -fp
Cet argument de ligne de commande ne s'applique pas pour les configurations WebSphere DataPower XC10 Appliance. |
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. |
-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. |