Websphere : Sous Linux comment changer un paramètre personnalisé de la JVM

Quand vous avez une JVM, ou encore 2 ou 3, vous pouvez modifier manuellement un paramètre de la JVM sans problème via la console d’admin. Par contre si vous avez des trentaines voire plus de JVM à modifier, autant utiliser un script jython. C’est ce que je cherchais, un moyen d’automatiser et de sécuriser cette modification. En effet, via l’interface graphique de la console d’admin, une JVM est vite oubliée.

J’ai trouvé un script sur le site d’IBM DeveloperWorks, il suffit de lui passer quelques paramètres et le tour est joué.

Procédure :

  1. Vous déposez le script sur le serveur qui héberge le DMGR, la console d’admin.
  2. Vous lancez le script en indiquant bien le login et le mot de passe pour se connecter à la console wsadmin (en ligne de commande)
    • Paramètre possible : all => modifier toutes les JVMs websphere
    • Paramètre myNode:myServer => modifier une JVM d’un noeud précis
    • Paramètre myServer => modifier une JVM précise
  3. Vous vérifiez sur votre console d’admin graphique que la modification a bien été réalisée

Bien sûr vous pouvez englober le script dans un script shell global avec une boucle for ou juste une liste précise des JVMs à modifier.

Source : 

Script addJVMProperty.py sur IBM developerWorks

Récupérer la mémoire utilisée par une JVM sous Websphere 8.5.5 avec wsadmin

Scripting en jython

Si vous avez suivi mes dernières aventures, vous savez que je travaille énormément sur Websphere en ce moment et plus particulièrement sur la partie wsadmin de websphere, à savoir la partie scripting. Mes anciens articles sur websphere.

Coeur du script : la récupération de la valeur de la mémoire utilisée par notre JVM. Pensez à remplacer xxServer par le nom de votre JVM.

perfName = AdminControl.completeObjectName ('type=Perf,process=xxServer,*')
perfOName = AdminControl.makeObjectName (perfName)
sigs = ['javax.management.ObjectName', 'java.lang.Boolean']
jvmName = AdminControl.completeObjectName ('type=JVM,process=xxServer,*')
params = [AdminControl.makeObjectName (jvmName), java.lang.Boolean ('false')]
jvmStats=AdminControl.invoke_jmx (perfOName, 'getStatsObject', params, sigs)
UsedMemory=jvmStats.getStatistic( 'UsedMemory').getCount()
print UsedMemory

Comment appeler ce bout de script ? Il faut appeler le script wsadmin.sh de websphere qui lui, déroulera le script ci-dessus. Les paramètres de wsadmin sont détaillés dans cet article.

#!/bin/bash

"$WAS_ROOT/bin/wsadmin.sh" $ADMIN_OPT -lang jython -f `dirname $0`/usedMemory.py

Ensuite on peut faire une boucle pour afficher la valeur de la mémoire utilisée toutes les 5 secondes, avec en prime la date :

import sys
import time
import re

count=3
while count > 0 :
## MAIN
 perfName = AdminControl.completeObjectName ('type=Perf,process=xxServer,*')
 perfOName = AdminControl.makeObjectName (perfName)
 sigs = ['javax.management.ObjectName', 'java.lang.Boolean']
 jvmName = AdminControl.completeObjectName ('type=JVM,process=xxServer,*')
 params = [AdminControl.makeObjectName (jvmName), java.lang.Boolean ('false')]
 jvmStats=AdminControl.invoke_jmx (perfOName, 'getStatsObject', params, sigs)
 UsedMemory=jvmStats.getStatistic( 'UsedMemory').getCount()
 now = time.localtime(time.time())
 print time.strftime("%d/%m/%y %H:%M:%S", now),";",UsedMemory
 time.sleep(5)

Sources : 

Python : Date et parsing de texte

Programmation en python

Pour les besoins d’un script en python, j’ai besoin de petits bouts de code. En effet, suite à mon article sur websphere, j’ai besoin de parser des résultats et de les stocker dans un fichier texte. On va voir ensemble comment procéder.

Récupération de la date du jour :

import time
# Obtenir l'heure et la date locale
now = time.localtime(time.time())

print time.strftime("%y/%m/%d %H:%M", now)
date en python

ça affiche :

16/09/09 09:07

Ensuite, ce que je veux faire, c’est parser la ligne ci-dessous et récupérer uniquement la valeur de UsedMemory :

jvmRuntimeModule | HeapSize=524288;;;; FreeMemory=205940;;;; UsedMemory=318347;;;; UpTime=1356524;;;; ProcessCpuUsage=0;;;;

Je vous rappelle comme j’avais fait en ksh pour parser :

cat resultat | grep UsedMemory | awk -F"=" ' { print $4 }' | awk -F";" ' { print $1 }'
Parsing en ksh

On va décomposer étape par étape, je vais commencer par utiliser la commande split et lui indiquer divers séparateurs. Je l’avais déjà utilisé lors d’un précédent article, mais bon, ça fait déjà 4 ans et demi !

import re

example = "jvmRuntimeModule | HeapSize=524288;;;; FreeMemory=205940;;;; UsedMemory=318347;;;; UpTime=1356524;;;; ProcessCpuUsage=0;;;;"

parts = example.split()
print parts[4]
other = parts[4].split('=')
print other[1]
fin = other[1].split(';')
print fin[0]
parsing step by step

Voilà le résultat :

UsedMemory=318347;;;;
318347;;;;
318347

Optimisation de code

C’est un code qui fonctionne, me direz-vous, mais peut-on faire ça en deux lignes au lieu de trois ?

import re

example = "jvmRuntimeModule | HeapSize=524288;;;; FreeMemory=205940;;;; UsedMemory=318347;;;; UpTime=1356524;;;; ProcessCpuUsage=0;;;;"

partie = example.split(';')
print partie[8]
valeur = partie[8].split('=')
print valeur[1]

Résultat :

 UsedMemory=318347
318347

Il faut tout de même que je teste la présence de UsedMemory :

import re

example = "jvmRuntimeModule | HeapSize=524288;;;; FreeMemory=205940;;;; UsedMemory=318347;;;; UpTime=1356524;;;; ProcessCpuUsage=0;;;;"
if "UsedMemory" in example:
 partie = example.split(';')
 print partie[8].split('=')[1]

Si on revient à mon code initial, il faut que j’écrive sur la même ligne la date et la valeur d’UsedMemory. Pour l’instant, le code ci-dessous ne fonctionne pas !

for stat in statsList:
  if "UsedMemory" in str(stat):
   now = time.localtime(time.time())
   partie = stat.split(';')
   print time.strftime("%d/%m/%y %H:%M", now) , partie[8].split('=')[1]
   time.sleep(5)
Belle erreur python !

 

Traceback (innermost last):
  File "<string>", line 64, in ?
TypeError: string member test needs char left operand

Recherche Google

Du coup, je fais une petite recherche sur Google et je tombe sur l’excellent site stackoverflow. Je rajoute au passage un séparateur ; entre mes différents champs, ce qui me génèrera du « pseudo csv ».

for stat in statsList:
  if stat.find('UsedMemory=') >= 0:
   now = time.localtime(time.time())
   partie = stat.split(';')
   print time.strftime("%d/%m/%y %H:%M", now),";",partie[8].split('=')[1]
   time.sleep(5)

Résultat :

09/09/16 10:29 ; 383886
09/09/16 10:29 ; 383886
09/09/16 10:29 ; 385079
...
09/09/16 10:31 ; 396919
09/09/16 10:31 ; 396919
09/09/16 10:31 ; 398375
09/09/16 10:31 ; 396919

Pour la partie écriture dans un fichier de logs, pour l’instant je vais utiliser ksh :)

Sources : 

Erreur websphere : exception information: com.ibm.ws.scripting.ScriptingException: WASX7025E: Error found in String «  »; cannot create ObjectName

WASX7017E: Exception received while running file « ./monScript.jy »; exception information: com.ibm.ws.scripting.ScriptingException: WASX7025E: Error found in String «  »; cannot create ObjectName

J’ai eu cette erreur ce matin car je voulais lancer un script jython or la cible (mon serveur d’application) était arrêtée. Il vous suffit donc de redémarrer votre serveur d’application et le tour est joué.

Source :

http://stackoverflow.com/questions/20903713/error-running-jython-script-from-wsadmin

Comment lancer un script jython sous websphere ?

Le jython, c’est du python pour Java. Vous pouvez lancer des scripts python à partir de l’utilitaire wsadmin.sh. Cet utilitaire vous permet de lancer n’importe quelle tâche d’administration : stop/startNode, stop/startServer ou encore des stop/startManager…

cheminDuWebsphere/bin/wsadmin.sh optionsDeConnexionAuWebsphere -lang jython -f test.jy
ou
cheminDuWebsphere/bin/wsadmin.sh optionsDeConnexionAuWebsphere -lang jython -f test.py

Les options de connexion au websphere sont notamment le login, le mot de passe, le port de connexion SOAP. Il peut y avoir d’autres paramètres, cela dépend de votre environnement.

Pour administrer un websphere vous disposez de tout un tas d’objets et de méthodes par exemple :
– pour afficher le nom de la cellule
print AdminControl.getCell()
– pour afficher le nom d’hôte, le nom du serveur
print AdminControl.getHost()
– pour installer une application, il faut fournir toute une série de paramètres puis lancer :
AdminApp.install(cheminDeLApplication, parametres)

Cet article est un aperçu de ce que vous pouvez faire en jython, je vous invite néanmoins à regarder les liens ci-dessous.

Sources :
https://www.vincentliefooghe.net/content/arr%C3%AAt-relance-lapplication-itim-ligne-commande
http://www.ibm.com/support/knowledgecenter/fr/SSAW57_8.5.5/com.ibm.websphere.nd.doc/ae/txml_script.html
http://www.ibm.com/support/knowledgecenter/fr/SSAW57_8.5.5/com.ibm.websphere.nd.doc/ae/cxml_jython.html
http://www.ibm.com/support/knowledgecenter/SSAW57_8.0.0/com.ibm.websphere.nd.doc/info/ae/ae/rxml_admincontrol.html
http://www.ibm.com/support/knowledgecenter/SSAW57_8.5.5/com.ibm.websphere.nd.doc/ae/rxml_taskoptions.html