Scripts d’administration WebSphere Application Server utiles



Exploration des Scripts Utiles de WebSphere Application Server

Lors de l’installation d’IBM WebSphere Application Server (WAS), vous trouverez une collection impressionnante de plus de 125 scripts shell.

Bien que tous ne soient pas indispensables, il est fort probable que vous ignoriez l’existence de certains scripts essentiels qui peuvent s’avérer extrêmement précieux dans vos tâches quotidiennes, surtout si vous débutez.

Afin de simplifier votre travail d’administrateur WebSphere, j’ai compilé une liste des scripts les plus pratiques et efficaces.

Les scripts présentés ci-dessous ont été testés dans un environnement IBM WAS ND 8.5.5. Cependant, il n’y a aucune raison de supposer qu’ils ne fonctionneraient pas dans d’autres configurations.

Gestion du Déploiement et des JVM

stopManager.sh

Ce script vous permet d’arrêter le gestionnaire de déploiement.

    [[email protected] bin]# ./stopManager.sh
    ADMU0116I: Les informations de l'outil sont enregistrées dans le fichier
               /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/logs/dmgr/stopServer.log
    ADMU0128I: Démarrage de l'outil avec le profil Dmgr01
    ADMU3100I: Lecture de la configuration du serveur : dmgr
    ADMU3201I: Requête d'arrêt du serveur envoyée. En attente du statut d'arrêt.
    ADMU4000I: L'arrêt du serveur dmgr est terminé.
    [[email protected] bin]#

Note : Ce script doit être exécuté depuis le répertoire du profil DMGR.

startManager.sh

Ce script sert à démarrer le gestionnaire de déploiement.

    [[email protected] bin]# ./startManager.sh
    ADMU0116I: Les informations de l'outil sont enregistrées dans le fichier
               /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/logs/dmgr/startServer.log
    ADMU0128I: Démarrage de l'outil avec le profil Dmgr01
    ADMU3100I: Lecture de la configuration du serveur : dmgr
    ADMU3200I: Le serveur est lancé. En attente du statut d'initialisation.
    ADMU3000I: Le serveur dmgr est ouvert pour les affaires électroniques ; l'identifiant du processus est 9183
    [[email protected] bin]#

Note : Il doit également être lancé depuis le répertoire du profil DMGR.

startServer.sh

Pour activer une JVM, utilisez startServer.sh avec le nom du serveur, comme indiqué ci-dessous.

    [[email protected] bin]# ./startServer.sh server1
    ADMU0116I: Les informations de l'outil sont enregistrées dans le fichier
               /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/server1/startServer.log
    ADMU0128I: Démarrage de l'outil avec le profil AppSrv01
    ADMU3100I: Lecture de la configuration du serveur : server1
    ADMU3200I: Le serveur est lancé. En attente du statut d'initialisation.
    ADMU3000I: Le serveur server1 est ouvert pour les affaires électroniques ; l'identifiant du processus est 10633
    [[email protected] bin]#

Note : L’agent de nœud doit être opérationnel avant de démarrer la JVM.

stopServer.sh

Ce script permet d’arrêter une JVM. Il faut préciser le nom de la JVM lors de l’exécution.

    [[email protected] bin]# ./stopServer.sh server1
    ADMU0116I: Les informations de l'outil sont enregistrées dans le fichier
               /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/server1/stopServer.log
    ADMU0128I: Démarrage de l'outil avec le profil AppSrv01
    ADMU3100I: Lecture de la configuration du serveur : server1
    ADMU3201I: Requête d'arrêt du serveur envoyée. En attente du statut d'arrêt.
    ADMU4000I: L'arrêt du serveur server1 est terminé.
    [[email protected] bin]#

stopNode.sh

Pour interrompre un agent de nœud spécifique, accédez au profil concerné et lancez stopNode.sh.

    [[email protected] bin]# ./stopNode.sh
    ADMU0116I: Les informations de l'outil sont enregistrées dans le fichier
               /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/nodeagent/stopServer.log
    ADMU0128I: Démarrage de l'outil avec le profil AppSrv01
    ADMU3100I: Lecture de la configuration du serveur : nodeagent
    ADMU3201I: Requête d'arrêt du serveur envoyée. En attente du statut d'arrêt.
    ADMU4000I: L'arrêt du serveur nodeagent est terminé.
    [[email protected] bin]#

startNode.sh

Pour démarrer un agent de nœud, rendez-vous dans le profil correspondant et exécutez startNode.sh.

    [[email protected] bin]# ./startNode.sh
    ADMU0116I: Les informations de l'outil sont enregistrées dans le fichier
               /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/nodeagent/startServer.log
    ADMU0128I: Démarrage de l'outil avec le profil AppSrv01
    ADMU3100I: Lecture de la configuration du serveur : nodeagent
    ADMU3200I: Le serveur est lancé. En attente du statut d'initialisation.
    ADMU3000I: Le serveur nodeagent est ouvert pour les affaires électroniques ; l'identifiant du processus est 11363
    [[email protected] bin]#

serverStatus.sh

Pour connaître l’état d’une JVM, utilisez ce script avec l’argument -all.

Ce script doit être lancé depuis le niveau du profil approprié. Si exécuté au niveau du profil DMGR, il n’affichera que l’état de DMGR.

    [[email protected] bin]# ./serverStatus.sh -all
    ADMU0116I: Les informations de l'outil sont enregistrées dans le fichier
               /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/serverStatus.log
    ADMU0128I: Démarrage de l'outil avec le profil AppSrv01
    ADMU0503I: Récupération du statut du serveur pour tous les serveurs
    ADMU0505I: Serveurs trouvés dans la configuration :
    ADMU0506I: Nom du serveur : nodeagent
    ADMU0506I: Nom du serveur : server1
    ADMU0508I: L'agent de nœud « nodeagent » est DÉMARRÉ
    ADMU0508I: Le serveur d'applications « server1 » est DÉMARRÉ
    [[email protected] bin]#

Sauvegarde et Restauration de la Configuration

backupConfig.sh

La sauvegarde est une pratique fondamentale dans l’administration système, surtout en environnement de production. Ce script vous permet de sauvegarder la configuration de votre environnement WebSphere.

Pour plus de sécurité, l’argument -nostop permet d’effectuer la sauvegarde sans arrêter le gestionnaire de déploiement.

    [[email protected] bin]# ./backupConfig.sh -nostop
    ADMU0116I: Les informations de l'outil sont enregistrées dans le fichier
               /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/backupConfig.log
    ADMU0128I: Démarrage de l'outil avec le profil AppSrv01
    ADMU5001I: Sauvegarde du répertoire de configuration
               /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config dans le fichier
               /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin/WebSphereConfig_2015-04-12.zip
    ....................................................................................................................................................................................................................................................................
    ADMU5002I: 933 fichiers ont été sauvegardés avec succès
    [[email protected] bin]#

restoreConfig.sh

Si après des changements de configuration, les résultats ne sont pas ceux attendus, vous pouvez utiliser une sauvegarde pour rétablir la situation.

    [[email protected] bin]# ./restoreConfig.sh WebSphereConfig_2015-04-12.zip -nostop
    ADMU0116I: Les informations de l'outil sont enregistrées dans le fichier
               /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/restoreConfig.log
    ADMU0128I: Démarrage de l'outil avec le profil AppSrv01
    ADMU5502I: Le répertoire /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config
               existe déjà ; il est renommé en
               /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config.old
    ADMU5504I: L'emplacement de la restauration a été renommé avec succès
    ADMU5505I: Restauration du fichier WebSphereConfig_2015-04-12.zip à l'emplacement
               /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config
    .........................................................................................................................................................................
    ADMU5506I: 933 fichiers ont été restaurés avec succès
    ADMU6001I: Début de la préparation de l'application -
    ADMU6009I: Traitement terminé.
    ADMU6002I: Début de la préparation des actifs -
    ADMU6009I: Traitement terminé.
    [[email protected] bin]#

Envie de continuer? Descendez pour plus de fonctionnalités !

Informations sur la Version et les Correctifs

versionInfo.sh

Ce script vous donne des informations détaillées sur la version de WAS, le niveau de construction, le package, l’architecture et les fonctionnalités installées sur votre serveur.

    [[email protected] bin]# ./versionInfo.sh
    WVER0010I: Copyright (c) IBM Corporation 2002, 2012 ; Tous droits réservés.
    WVER0012I: VersionInfo reporter version 1.15.1.48, datée du 08/02/12
    --------------------------------------------------------------------------------
    Rapport sur l'état de l'installation du produit IBM WebSphere
    --------------------------------------------------------------------------------
    Rapport à la date et à l'heure 12 avril 2015 03 :18 :41 PDT
    Installation
    --------------------------------------------------------------------------------
    Répertoire du produit       /opt/IBM/WebSphere/AppServer
    Répertoire de la version       /opt/IBM/WebSphere/AppServer/properties/version
    Répertoire DTD           /opt/IBM/WebSphere/AppServer/properties/version/dtd
    Répertoire des journaux           /var/ibm/InstallationManager/logs
    Liste des produits
    --------------------------------------------------------------------------------
    NDTRIAL                 installé
    Produit installé
    --------------------------------------------------------------------------------
    Nom                 IBM WebSphere Application Server Network Deployment
    Version               8.5.5.0
    ID                   NDTRIAL
    Niveau de build           gm1319.01
    Date de build           14/05/13
    Package               com.ibm.websphere.NDTRIAL.v85_8.5.5000.20130514_1044
    Architecture         x86-64 (64 bits)
    Fonctionnalités installées   IBM 64-bit WebSphere SDK pour Java
                         Profil complet WebSphere Application Server
                         Outil EJBDeploy pour les modules pré-EJB 3.0
                         Conteneur EJB intégrable
                         Clients légers autonomes et adaptateurs de ressource
    --------------------------------------------------------------------------------
    Fin du rapport sur l'état de l'installation
    --------------------------------------------------------------------------------
    [[email protected] bin]#

Note : Voici les arguments possibles :

  • -fixpacks : Affiche les informations sur les groupes de correctifs.
  • -long : Affiche tous les groupes de correctifs et les ifix.
  • -ifixes : Affiche les détails sur les ifix.

getHistoryReport.sh

Ce script génère un rapport HTML nommé `historyReport.html` qui liste les composants, les correctifs et les packs de rafraîchissement installés, ainsi que les dates d’installation. Il est utile pour les audits ou simplement pour un suivi. Il est créé dans le répertoire de travail actuel, souvent le dossier `bin`.

getVersionReport.sh

Ce script affiche la version de build et la date de build de l’installation de WebSphere. Il est fréquemment demandé par le support IBM pour diagnostiquer d’éventuels problèmes liés à une version particulière.

Vidage du Cache

Il est parfois nécessaire de vider le cache, par exemple après une mise à jour. Il existe deux types de cache à considérer : le cache JVM et le cache OSGi.

clearClassCache.sh

Ce script sert à vider le cache de classe de la JVM.

Note : Les JVM doivent être arrêtées avant de vider le cache de classe.

osgiCfgInit.sh

Utilisez cette commande pour vider le profil OSGi et le cache du serveur.

    [[email protected] bin]# ./osgiCfgInit.sh
    Le cache de profil OSGi a été nettoyé avec succès pour /opt/IBM/WebSphere/AppServer/profiles/Dmgr01.
    Le cache du serveur OSGi a été nettoyé avec succès pour /opt/IBM/WebSphere/AppServer/profiles/Dmgr01/servers/dmgr.
    [[email protected] bin]#

Note : N’oubliez pas de stopper les processus en cours avant de vider les caches.

Gestion des Profils

managesdk.sh

Ce script permet de basculer entre différentes versions du SDK si vous en avez plusieurs installées. Il permet également de consulter le SDK associé à un profil donné. L’exemple ci-dessous liste les SDK disponibles.

    [[email protected] bin]# ./managesdk.sh -listAvailable
    CWSDK1003I : SDK disponibles :
    CWSDK1005I : Nom du SDK : 1.6_64
    CWSDK1001I : Tâche managesdk demandée exécutée avec succès.
    [[email protected] bin]#

pmt.sh

PMT (Profile Management Tool) est un outil qui permet de créer des profils WebSphere en mode graphique. La création de profil avec PMT est simple : il suffit de sélectionner le type de profil désiré et de suivre l’assistant.

syncNode.sh

Si vous ne parvenez pas à synchroniser un nœud via la console d’administration, vous pouvez utiliser syncNode.sh depuis le niveau du profil. L’agent de nœud doit être arrêté avant d’utiliser ce script.

Vous devez fournir l’hôte du DMGR et le numéro de port SOAP en arguments.

    [[email protected] bin]# ./syncNode.sh localhost 8879
    ADMU0116I: Les informations de l'outil sont enregistrées dans le fichier
               /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs/syncNode.log
    ADMU0128I: Démarrage de l'outil avec le profil AppSrv01
    ADMU0401I: Début de l'opération syncNode pour le nœud localhostNode01 avec Déploiement
               Manager localhost : 8879
    ADMU0016I: Synchronisation de la configuration entre le nœud et la cellule.
    ADMU0402I: La configuration du nœud localhostNode01 a été synchronisée
               avec Deployment Manager localhost : 8879
    [[email protected] bin]#
  • localhost = nom d’hôte du gestionnaire de déploiement.
  • 8879 = numéro de port SOAP du DMGR.

J’espère que ces scripts s’avéreront utiles dans votre travail quotidien. Pour aller plus loin, explorez le cloud computing !