La bibliothèque de scripts propose des procédures de script
Jython pour vous aider à automatiser votre environnement. Les scripts de gestion des ressources peuvent être utilisés pour configurer et gérer vos configurations JDBC (Java™ Database Connectivity).
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 de gestion
des ressources d'accès aux données dans la bibliothèque de scripts se trouvent dans le sous-répertoire
racine_serveur_app/scriptLibraries/resources/JDBC/V70.
Le chargement de chaque script de ce répertoire s'effectue automatiquement
lorsque vous lancez l'outil wsadmin. Pour charger automatiquement vos propres scripts Jython (
*.py) lors du démarrage de l'outil wsadmin, enregistrez vos scripts d'automatisation dans un nouveau sous-répertoire du 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
Les scripts permettent de créer de nombreuses combinaisons de fonctions
d'administration. Utilisez l'exemple suivant de combinaison de procédures pour configurer un fournisseur JDBC et une source de données.
- Vérifiez que tous les fichiers de pilote JDBC nécessaires sont installés sur votre gestionnaire de noeud. Si vous optez pour la configuration d'un fournisseur JDBC défini par l'utilisateur, vérifiez la documentation de la base de données pour plus d'informations sur les fichiers de pilote.
- Facultatif : Démarrez l'outil wsadmin.
Cette étape permet de lancer l'outil wsadmin et de se connecter à un
serveur ou d'exécuter l'outil en mode local. Si vous lancez l'outil
wsadmin, aidez-vous des exemples de mode interactif fournis dans cette
rubrique 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.
- Configurez un fournisseur JDBC.
Exécutez la procédure createJDBCProvider de la bibliothèque de scripts
et indiquez les arguments obligatoires.
Pour exécuter le
script, indiquez le nom de noeud, le nom de serveur, le nom à attribuer au
nouveau fournisseur JDBC, ainsi que le nom de classe d'implémentation. Vous pouvez également indiquer d'autres attributs selon le format suivant : [["attr1", "valeur1"], ["attr2", "valeur2"]]. Les propriétés personnalisées des pilotes JDBC spécifiques à certains
fournisseurs doivent être définies sur la source de données du serveur
d'applications.
Pour plus d'informations sur les propriétés personnalisées disponibles, consultez la documentation de votre base de données.
L'exemple suivant crée un fournisseur JDBC dans la configuration :
bin>wsadmin -lang jython -c "AdminJDBC.createJDBCProvider("myNode", "myServer", "myJDBCProvider",
"myImplementationClass", [["description", "testing"], ["xa", "false"], ["providerType", "provType"]])"
Vous pouvez également utiliser le mode interactif pour exécuter la procédure de script, comme dans l'exemple suivant :
wsadmin>AdminJDBC.createJDBCProvider("myNode", "myServer", "myJDBCProvider", "myImplementationClass",
[["description", "testing"], ["xa", "false"], ["providerType", "provType"]])
Le script renvoie l'ID configuration du nouveau fournisseur JDBC.
- Configurez une source de données à partir d'un modèle.
Exécutez la procédure createDataSourceUsingTemplate de la bibliothèque de scripts et indiquez les arguments obligatoires. Pour exécuter le script, indiquez le nom de noeud, le nom de serveur, le
nom de fournisseur JDBC, l'ID de configuration du modèle à utiliser, ainsi
que le nom à attribuer à la nouvelle source de données. Vous pouvez également indiquer d'autres attributs selon le format suivant : [["attr1", "valeur1"], ["attr2", "valeur2"]].
L'exemple suivant crée une source de données dans votre configuration à partir d'un modèle :
bin>wsadmin -lang jython -c "AdminJDBC.createDataSourceUsingTemplate("myNode", "myServer", "myJDBCProvider",
"Derby JDBC Driver DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_derby_1)",
"myDataSource", [["authDataAlias", "myalias"], ["authMechanismPreference", "BASIC_PASSWORD"],
["description", "testing"], ["jndiName", "dsjndi1"], ["logMissingTransactionContext", "true"],
["statementCacheSize", "5"]])"
Vous pouvez également utiliser le mode interactif pour exécuter la procédure de script, comme dans l'exemple suivant :
wsadmin>AdminJDBC.createDataSourceUsingTemplate("myNode", "myServer", "myJDBCProvider", "Derby JDBC Driver
DataSource(templates/system|jdbc-resource-provider-templates.xml#DataSource_derby_1)", "myDataSource",
[["authDataAlias", "myalias"], ["authMechanismPreference", "BASIC_PASSWORD"], ["description", "testing"],
["jndiName", "dsjndi1"], ["logMissingTransactionContext", "true"], ["statementCacheSize", "5"]])
Le script renvoie l'ID de configuration de la nouvelle source de données.
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("myApplication","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. Sauvegardez les scripts personnalisés dans un nouveau
sous-répertoire sous
racine_serveur_app/scriptLibraries.