La bibliothèque de scripts propose des procédures de script
Jython pour vous aider à automatiser votre environnement. Utilisez les scripts de gestion du serveur pour configurer les serveurs, l'environnement d'exécution des serveurs, les conteneurs Web, la surveillance des performances et les journaux. Vous pouvez également utiliser les scripts pour administrer vos serveurs.
Pourquoi et quand exécuter cette tâche
La bibliothèque de scripts propose un ensemble de procédures
permettant d'automatiser les fonctions d'administration de serveur
d'applications les plus courantes. Vous pouvez utiliser la bibliothèque de scripts Jython de trois façons.
- Exécutez des scripts de la bibliothèque de scripts Jython en mode interactif avec le noeud wsadmin. Vous pouvez lancer l'outil wsadmin et exécuter des scripts pris séparément inclus dans la bibliothèque de scripts en utilisant la syntaxe suivante :
wsadmin>AdminServerManagement.createApplicationServer("myNode", "myServer", "default")
- Utilisez un éditeur de texte pour combiner plusieurs scripts de la bibliothèque de scripts Jython, comme le montre l'exemple suivant :
#
# My Custom Jython Script - file.py
#
AdminServerManagement.createApplicationServer("myNode", "Server1", "default")
AdminServerManagement.createApplicationServer("myNode", "Server2", "default")
# Use one of them as the first member of a cluster
AdminClusterManagement.createClusterWithFirstMember("myCluster", "APPLICATION_SERVER",
"myNode", "Server1")
# Add a second member to the cluster
AdminClusterManagement.createClusterMember("myCluster", "myNode", "Server3")
# Install an application
AdminApplication.installAppWithClusterOption("DefaultApplication",
"..\installableApps\DefaultApplication.ear", "myCluster")
# Start all servers and applications on the node
AdminServerManagement.startAllServers("myNode")
Enregistrez le script personnalisé et exécutez-le à partir de la ligne de commande, comme le montre la syntaxe suivante :bin>wsadmin -language jython -f path/to/your/jython/file.py
- Utilisez le code de la bibliothèque de scripts Jython comme exemple de syntaxe pour écrire des scripts personnalisés. Chaque exemple de script de la bibliothèque utilise les valeurs recommandées pour l'écriture des scripts wsadmin. Le code de la bibliothèque de scripts se trouve dans le répertoire
racine_serveur_app/scriptLibraries. Dans ce répertoire, les scripts sont organisés en sous-répertoires selon leur fonctionnalité. Par exemple, le sous-répertoire
racine_serveur_app/scriptLibraries/application/V70 contient des procédures de gestion d'application valables
pour la version 7.0 et les versions ultérieures du produit. Le sous-répertoire V70 dans les chemins d'accès aux bibliothèques de scripts ne contient pas forcément des scripts de version 7.0.
Les procédures AdminServerManagement
de la bibliothèque de scripts se trouvent dans le sous-répertoire
app_server_root/scriptLibraries/servers/V70. Le chargement de chaque script de ce répertoire s'effectue automatiquement
lorsque vous lancez l'outil wsadmin. Pour charger automatiquement vos scripts Jython (*.py)
lors du démarrage de l'outil wsadmin, créez un nouveau sous-répertoire et enregistrez les scripts d'automatisation existants dans le répertoire
app_server_root/scriptLibraries.
Pratiques recommandées: Pour créer des scripts personnalisés à l'aide des procédures de la
bibliothèque de scripts, sauvegardez dans le nouveau sous-répertoire les
scripts modifiés pour éviter d'écraser la bibliothèque. N'éditez pas les procédures de script dans la bibliothèque de scripts.
bprac
Vous pouvez utiliser les scripts AdminServerManagement.py pour créer de nombreuses combinaisons de fonctions d'administration. Effectuez les opérations suivantes pour créer un serveur d'applications, connecter ce serveur d'applications à l'interface AdminService, configurer les paramètres JVM(Java™ virtual machine), ajouter le serveur d'applications à un cluster et propager les modifications au noeud.
Procédure
- Facultatif : Démarrez l'outil wsadmin.
Cette étape permet de lancer l'outil wsadmin et de se connecter à un profil de serveur, de gestionnaire de travaux ou d'agent administratif, ou encore d'exécuter l'outil en mode local. Si vous lancez l'outil
wsadmin, aidez-vous des exemples de mode interactif pour exécuter les scripts.
Lors du lancement de l'outil wsadmin, le système charge tous
les scripts de la bibliothèque de scripts.
- Créez un serveur d'applications.
Exécutez la procédure de script createApplicationServer
de la bibliothèque de scripts AdminServerManagement, tel qu'illustré dans l'exemple suivant :
bin>wsadmin -lang jython -c "AdminServerManagement.createApplicationServer("monNoeud", "monServeur", "default")"
Vous pouvez aussi utiliser le mode interactif pour exécuter la procédure de script, comme dans l'exemple suivant :
wsadmin>AdminServerManagement.createApplicationServer("monNoeud", "monServeur", "default")
- Connectez le serveur d'applications visé à l'interface AdminService.
L'interface AdminService est l'interface serveur avec les fonctions d'administration du serveur d'applications. Pour connecter le serveur d'applications à l'interface AdminService, exécutez la procédure de script configureAdminService de la bibliothèque de scripts AdminServerManagement, en spécifiant le nom du noeud, le nom du serveur et les arguments du type de connecteur, tel qu'illustré dans l'exemple suivant :
bin>wsadmin -lang jython -c "AdminServerManagement.configureAdminService("myNode", "myServer",
"IPC", "JSR160RMI")
Vous pouvez aussi utiliser le mode interactif pour exécuter la procédure de script, comme dans l'exemple suivant :
wsadmin>AdminServerManagement.configureAdminService("monNoeud", "monServeur", "IPC", "JSR160RMI")
- Configurez la machine virtuelle Java (JVM).
Lors de la configuration d'un serveur d'applications, vous pouvez définir des paramètres améliorant la façon dont le système d'exploitation utilise la machine virtuelle Java (JVM). La machine virtuelle Java (JVM) est un moteur d'interprétation qui exécute le pseudo-code binaire dans un programme compilé Java. Elle convertit le pseudo-code binaire Java en instructions natives de la machine hôte. Le serveur d'applications, qui est un processus Java,
requiert une machine virtuelle Java pour fonctionner et pour prendre en charge les applications Java qui s'exécutent sur le serveur.
Exécutez
la procédure de script configureJavaVirtualMachine de la bibliothèque de scripts AdminServerManagement, en spécifiant le nom du noeud, le nom du serveur, s'il faut exécuter la machine virtuelle Java en mode débogage et tous les arguments de débogage à faire passer au processus JVM. Vous pouvez, en option, spécifier des attributs de configuration complémentaires à l'aide d'une liste d'attributs. Utilisez l'exemple suivant pour configurer la machine virtuelle Java (JVM) :
bin>wsadmin -lang jython -c "AdminServerManagement.configureJavaVirtualMachine("myNode",
"myServer", "true", "mydebug", [["internalClassAccessMode", "RESTRICT"],
["disableJIT", "false"], ["verboseModeJNI", "false"]])"
Vous pouvez aussi utiliser le mode interactif pour exécuter la procédure de script, comme dans l'exemple suivant :
wsadmin>AdminServerManagement.configureJavaVirtualMachine("myNode", "myServer", "true",
"mydebug", [["internalClassAccessMode", "RESTRICT"],
["disableJIT", "false"], ["verboseModeJNI", "false"]])
- Créez un cluster et ajoutez le serveur d'applications comme membre du cluster.
Exécutez la procédure de script createClusterWithFirstMember à partir de la bibliothèque de scripts AdminClusterManagement,
tel qu'illustré dans l'exemple suivant :
bin>wsadmin -lang jython -c "AdminClusterManagement.createClusterWithFirstMember("myCluster",
"APPLICATION_SERVER", "myNode", "myServer")"
wsadmin>AdminClusterManagement.createClusterWithFirstMember("myCluster", "APPLICATION_SERVER",
"myNode", "myServer")
- Synchronisez le noeud.
Pour propager les modifications de la configuration au noeud, exécutez la procédure de script syncNode à partir de la bibliothèque de scripts AdminNodeManagement, en spécifiant le noeud visé, tel qu'illustré dans l'exemple suivant :
bin>wsadmin -lang jython -c "AdminNodeManagement.syncNode("myNode")"
Vous pouvez également utiliser le mode interactif pour exécuter la procédure de script, comme dans l'exemple suivant :
wsadmin>AdminNodeManagement.syncNode("monNoeud")
Résultats
Les bibliothèques de scripts wsadmin renvoient la même sortie que les commandes wsadmin correspondantes. Par exemple, le script AdminServerManagement.listServers()
renvoie une liste de serveurs disponibles. Le script AdminClusterManagement.checkIfClusterExists()
renvoie la valeur true si le cluster existe et false si le cluster n'existe pas. Si la commande ne renvoie pas le résultat attendu, les bibliothèques de scripts renvoient la valeur 1 lorsque l'exécution du script aboutit. En cas d'échec du script, les bibliothèques de scripts renvoient la valeur -1 et un message d'erreur reprenant l'exception.
Par défaut, l'option failonerror est désactivée dans le système. Pour activer cette option, indiquez
true comme dernier argument de la procédure de script, comme dans l'exemple suivant :
wsadmin>AdminApplication.startApplicationOnCluster("monApplication","myCluster","true")
Que faire ensuite
Créez des scripts personnalisés pour automatiser votre
environnement en combinant des procédures de script de la bibliothèque de
scripts. Enregistrez les scripts personnalisés dans un nouveau sous-répertoire du répertoire app_server_root/scriptLibraries.