Exemple : utilitaire xsadmin

Avec l'utilitaire xsadmin, vous pouvez formater et afficher des informations textuelles relatives à votre topologie WebSphere eXtreme Scale. Il fournit une méthode pour effectuer l'analyse syntaxique et la détection des données de déploiement actuelles et peut servir de base pour l'écriture d'utilitaires personnalisés.

Avant de commencer

Pourquoi et quand exécuter cette tâche

L'exemple d'utilitaire xsadmin utilise une implémentation de beans gérés (MBeans). Cet exemple d'application de surveillance active rapidement les fonctions de surveillance intégrées que vous pouvez étendre en utilisant les interfaces dans le package com.ibm.websphere.objectgrid.management. Vous pouvez analyser le code source de l'exemple d'application xsadmin dans le fichier rép_base_wxs/samples/xsadmin.jar dans une application autonome ou dans le fichier rép_base_wxs/xsadmin.jar dans une installation WebSphere Application Server.

Vous pouvez utiliser l'exemple d'utilitaire xsadmin pour afficher la structure et l'état de la grille de données (par exemple, le contenu de la grille). Dans cet exemple, la structure de la grille de données dans cette tâche est constituée d'une seule grille de données ObjectGridA avec une mappe MapA qui appartient au groupe de mappes MapSetA. Cet exemple montre comment afficher tous les conteneurs actifs dans une grille de données et imprimer les mesures filtrées relatives à la taille de la mappe MapA. Pour afficher toutes les options de la commande, exécutez l'utilitaire xsadmin sans arguments ou avec l'option -help.

Procédure

  1. Accédez au répertoire bin.
    cd rép_base_wxs/bin
  2. Exécutez l'utilitaire xsadmin.
    • Pour afficher l'aide en ligne, exécutez la commande suivante :
      [Unix]
      xsadmin.sh
      [Windows]
      xsadmin.bat

      Vous devez envoyer une seule des options listées pour que l'utilitaire fonctionne. Si aucune option -g ou -m n'est spécifiée, l'utilitaire xsadmin affiche les informations pour chaque grille de la topologie.

    • Pour activer les statistiques pour tous les serveurs, exécutez la commande suivante :
      [Unix]
      xsadmin.sh -g ObjectGridA -setstatsspec ALL=enabled
      [Windows]
      xsadmin.bat -g ObjectGridA -setstatsspec ALL=enabled
    • Pour afficher tous les conteneurs en ligne d'une grille, exécutez la commande suivante :
      [Unix]
      xsadmin.sh -g ObjectGridA -m MapSetA -containers
      [Windows]
      xsadmin.bat -g ObjectGridA -m MapSetA -containers

      Toutes les informations sur les conteneurs s'affichent. Ci-après, un exemple de sortie :

      Connecting to Catalog service at localhost:1099
      
      
      *** Show all online containers for grid - ObjectGridA & mapset - MapSetA
      
      Host: 192.168.0.186
      Container: server1_C-0, Server:server1, Zone:DefaultZone
      Partition Shard Type
              0 Primary
      
      Num containers matching = 1
      Total known containers = 1
      Total known hosts = 1
      Avertissement : Pour obtenir ces informations lorsque le protocole TLS/SSL (Transport Layer Security/Secure Sockets Layer) est activé, vous devez démarrer les serveurs de catalogue et de conteneur avec l'ensemble de ports de service JMX. Pour définir le port de service JMX, vous pouvez utiliser l'option -JMXServicePort dans le script startOgServer ou appeler la méthode setJMXServicePort dans l'interface ServerProperties.
    • Pour vous connecter au service de catalogue et afficher les informations sur la mappe MapA, exécutez la commande suivante :
      [Unix]
      xsadmin.sh -g ObjectGridA -m MapSetA -mapsizes -fm MapA
      [Windows]
      xsadmin.bat -g ObjectGridA -m MapSetA -mapsizes -fm MapA

      La taille de la mappe spécifiée s'affiche. Ci-après, un exemple de sortie :

      Connecting to Catalog service at localhost:1099
      
      ****Displaying Results for Grid - ObjectGridA, MapSet - MapSetA*****
      
      
      *** Listing Maps for server1 ***
       Map Name Partition Map Size Used Bytes (B) Shard Type
       MapA     0         0        0              Primary
    • Pour vous connecter au service de catalogue à l'aide d'un port JMX spécifique et afficher des informations sur la mappe MapA, exécutez la commande suivante :
      [Unix]
      xsadmin.sh -g ObjectGridA -m MapSetA -mapsizes -fm MapA 
      		-ch CatalogMachine -p 6645

      [Windows]
      xsadmin.bat -g ObjectGridA -m MapSetA -mapsizes -fm MapA 
      		-ch CatalogMachine -p 6645

      L'exemple d'utilitaire xsadmin se connecte au serveur MBean qui s'exécute dans un serveur de catalogue. Un serveur de catalogue peut s'exécuter comme processus autonome, processus WebSphere Application Server ou être intégré dans un processus d'application personnalisé. Utilisez l'option -ch pour spécifier le nom d'hôte du service de catalogue et l'option -p pour spécifier son port de désignation.

      La taille de la mappe spécifiée s'affiche. Ci-après, un exemple de sortie :

      Connecting to Catalog service at CatalogMachine:6645
      
      *****Displaying Results for Grid - ObjectGridA, MapSet - MapSetA*****
      
      
      *** Listing Maps for server1 ***
      Map Name: MapA  Partition #: 0  Map Size: 0  Shard Type: Primary
      Server Total: 0
    • Pour vous connecter à un service de catalogue hébergé dans un processus WebSphere Application Server, procédez comme suit :

      L'option -dmgr est obligatoire lorsque vous vous connectez à un service de catalogue hébergé par tout processus ou cluster de processus WebSphere Application Server. Utilisez l'option -ch pour spécifier le nom d'hôte, s'il n'est pas localhost, et l'option -p pour substituer le port d'amorce du service de catalogue, qui utilise le processus BOOTSTRAP_ADDRESS. L'option -p est nécessaire uniquement si BOOTSTRAP_ADDRESS n' pas la valeur 9809.

      Remarque : La version autonome de WebSphere eXtreme Scale ne peut pas être utilisée pour vous connecter à un service de catalogue hébergé par un processus WebSphere Application Server. Utilisez l'utilitaire xsadmin dont le script est inclus dans le répertoire racine_was/bin qui est disponible lorsque vous installez WebSphere eXtreme Scale sur WebSphere Application Server or WebSphere Application Server Network Deployment.
      1. Accédez au répertoire bin de WebSphere Application Server :
        cd racine_was/bin
      2. Lancez l'utilitaire xsadmin avec la commande suivante :
        [Unix]
         xsadmin.sh -g ObjectGridA -m MapSetA -mapsizes -fm MapA -dmgr
        [Windows]
        xsadmin.bat -g ObjectGridA -m MapSetA -mapsizes -fm MapA -dmgr

      La taille de la mappe spécifiée s'affiche.

      Connecting to Catalog service at localhost:9809
      
      ****Displaying Results for Grid - ObjectGridA, MapSet - MapSetA*****
      
      
      *** Listing Maps for server1 ***
      Map Name: MapA  Partition #: 0  Map Size: 0  Shard Type: Primary
      Server Total: 0
    • Pour afficher le placement configuré et d'exécution de votre configuration, exécutez la commande suivante :
      xsadmin -placementStatus
      xsadmin -placementStatus -g myOG -m myMapSet
      xsadmin -placementStatus -m myMapSet
      xsadmin -placementStatus -g myOG
      Vous pouvez définir la portée de la commande pour afficher les informations de placement de l'intégralité de la configuration, une grille de données unique, un groupe de mappes unique ou une combinaison de grille de données et de groupe de mappes. Ci-après, un exemple de sortie :
      ***********Printing Placement Status for Grid - Grid, MapSet - mapSet**************
      
      <objectGrid name="Grid" mapSetName="mapSet">
        <configuration>
          <attribute name="placementStrategy" value="FIXED_PARTITIONS"/>
          <attribute name="numInitialContainers" value="3"/>
          <attribute name="minSyncReplicas" value="0"/>
          <attribute name="developmentMode" value="true"/>
        </configuration>
        <runtime>
          <attribute name="numContainers" value="3"/>
          <attribute name="numMachines" value="1"/>
          <attribute name="numOutstandingWorkItems" value="0"/>
        </runtime>
      </objectGrid>