Administration avec l'utilitaire xscmd

Avec xscmd, vous pouvez effectuer des tâches d'administration dans l'environnement, telles qu'établir des liens de réplication multimaître, remplacer un quorum et arrêter des groupes de serveurs avec la commande teardown.

Avant de commencer

Pourquoi et quand exécuter cette tâche

L'utilitaire xscmd remplace l'exemple d'utilitaire xsadmin comme outils de surveillance et d'administration complètement pris en charge. Vous pouvez exécuter des opérations similaires avec l'outil xsadmin, mais cet outil n'est pas pris en charge. L'exemple xsadmin fournit une méthode pour effectuer l'analyse syntaxique et la détection des données de déploiement actuelles et peut servir de modèle pour l'écriture d'utilitaires personnalisés. Si vous utilisiez l'outil xsadmin pour la surveillance et l'administration, mettez à jour vos scripts pour utiliser l'utilitaire inattendue. Pour plus d'informations sur le mappage des commandes xsadmin à la nouvelle commande xscmd, voir Migration de l'outil xsadmin vers l'outil xscmd.

Procédure

  1. Facultatif : Si l'authentification de client est activée : Ouvrez une fenêtre de ligne de commande. Sur la ligne de commande, définissez les variables d'environnement appropriées.
    1. Définissez la variable d'environnement CLIENT_AUTH_LIB :
      • [Windows] set CLIENT_AUTH_LIB=<path_to_security_JAR_or_classes>
      • [Unix] set CLIENT_AUTH_LIB=<path_to_security_JAR_or_classes> export CLIENT_AUTH_LIB
  2. Accédez au répertoire rép_base_wxs/bin.

    cd rép_base_wxs/bin

  3. Affichez l'aide des différentes options xscmd.
    • Pour afficher l'aide générale, exécutez la commande suivante :
      • [Unix] ./xscmd.sh -h
      • [Windows] xscmd.bat -h
    • Pour afficher la liste de toutes les commandes, exécutez la commande suivante :
      • [Unix] ./xscmd.sh -lc
      • [Windows] xscmd.bat -lc
    • Pour afficher l'aide d'une commande, exécutez la commande suivante :
      • [Unix] ./xscmd.sh -h command_name
      • [Windows] xscmd.bat -h command_name
    • Pour afficher une liste des groupes de commandes, exécutez la commande suivante :
      • [Unix] ./xscmd.sh -lcg
      • [Windows] xscmd.bat -lcg
    • Pour afficher la liste des commandes dans un groupe de commandes, exécutez la commande suivante :
      • [Unix] ./xscmd.sh -lc command_group_name
      • [Windows] xscmd.bat -lc command_group_name
  4. Exécutez les commandes de connexion à de serveurs de catalogue spécifiques. Par défaut, xscmd se connecte au serveur de catalogue sur l'hôte local en utilisant le nom d'hôte et le port localhost:2809. Vous pouvez également fournir la liste des noms d'hôte et des ports à la commande pour que vous puissiez vous connecter aux serveurs de catalogue sur d'autres hôtes. Dans la liste, l'un des utilitaires xscmd se connecte à un hôte aléatoire. La liste des hôtes que vous fournissez doit se trouver dans le même domaine de services de catalogue.
    • Fournissez la liste des serveurs de catalogue autonomes auxquels vous voulez vous connecter :
      • [Unix] ./xscmd.sh -c <command_name> -cep hostname:port(,hostname:port)
      • [Windows] xscmd.bat -c <command_name> -cep hostname:port(,hostname:port)
      Dans les commandes précédentes, command_name est le nom de la commande que vous exécutez. La valeur hostname:port est le nom d'hôte du serveur de catalogue et le port d'écoute. La valeur de port d'écoute sur un serveur de catalogue autonome est définie lorsque vous exécutez la commande startOgServer.
    • Fournissez la liste des serveurs de catalogue WebSphere Application Server auxquels vous voulez vous connecter. Vous ne pouvez pas vous connecter aux serveurs de catalogue qui s'exécutent sur WebSphere Application Server avec la valeur localhost par défaut :
      • [Unix] ./xscmd.sh -c <command_name> -cep was_hostname:port(,hostname:port)
      • [Windows] xscmd.bat -c <command_name> -cep was_hostname:port(,hostname:port)
      Dans les commandes précédentes, command_name est le nom de la commande que vous exécutez. La valeur was_hostname est le nom d'hôte du serveur de catalogue dans la cellule WebSphere Application Server. La valeur port est le port d'écoute. La valeur de port d'écoute dans WebSphere Application Server est héritée par la configuration de port BOOTSTRAP_ADDRESS. La valeur par défaut est 9809 si le serveur de catalogue s'exécute dans le gestionnaire de déploiement. Si vous exécutez le serveur de catalogue sur un serveur d'applications, vérifiez la configuration de port BOOTSTRAP_ADDRESS du serveur d'applications pour déterminer le numéro de port.