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 !