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 !