La biblioteca de scripts proporciona procedimientos de script Jython para ayudar en la automatización
del entorno. Utilice los scripts de gestión de recursos para configurar y gestionar las
configuraciones de Java™ Database Connectivity (JDBC).
Acerca de esta tarea
La biblioteca de scripts proporciona un conjunto de procedimientos para automatizar
las funciones de administración más comunes del servidor de aplicaciones.
Hay tres formas
de utilizar la biblioteca de scripts de Jython.
- Ejecute scripts de la biblioteca de scripts de Jython en modalidad interactiva con la
herramienta wsadmin. Puede lanzar la herramienta wsadmin, y ejecutar scripts individuales
incluidos en la biblioteca de scripts utilizando la sintaxis siguiente:
wsadmin>AdminServerManagement.createApplicationServer("myNode", "myServer", "default")
- Utilice un editor de textos para combinar varios scripts de la biblioteca de scripts de Jython
como muestra el ejemplo siguiente:
#
# My script Jython personalizado - archivo.py
#
AdminServerManagement.createApplicationServer("miNodo", "Servidor1", "default")
AdminServerManagement.createApplicationServer("miNodo", "Servidor2", "default")
# Utilice uno de ellos como primer miembro de un clúster
AdminClusterManagement.createClusterWithFirstMember("miClúster", "APPLICATION_SERVER",
"miNodo", "Servidor1")
# Añadir un segundo miembro al clúster
AdminClusterManagement.createClusterMember("miClúster", "miNodo", "Servidor3")
# Instalar una aplicación
AdminApplication.installAppWithClusterOption("AplicaciónPredet",
"..\installableApps\DefaultApplication.ear", "miClúster")
# Iniciar todos los servidores y aplicaciones del nodo
AdminServerManagement.startAllServers("myNode")
Guarde el script personalizado y ejecútelo desde la línea de mandatos,
según muestra la sintaxis siguiente:bin>wsadmin -language jython -f path/to/your/jython/file.py
- Utilice el código de la biblioteca de scripts de Jython como sintaxis de ejemplo para escribir
scripts personalizados. Cada ejemplo de script de la biblioteca de scripts muestra los métodos recomendados
para escribir scripts wsadmin. El código de la biblioteca de scripts se halla en el directorio
raíz_servidor_aplic/scriptLibraries.
En este directorio, los scripts se organizan en subdirectorios según la funcionalidad. Por ejemplo, el subdirectorio
raíz_servidor_aplicaciones/scriptLibraries/application/V70
contiene procedimientos que realizan tareas de gestión de aplicaciones que son
aplicables a la versión 7.0 y posterior del producto. El subdirectorio V70 que figura en las vías de acceso de la biblioteca de scripts no significa que los scripts de este subdirectorio sean de la versión 7.0.
Los procedimientos de gestión de recursos de acceso
a datos se ubican en el subdirectorio
raíz_servidor_aplicaciones/scriptLibraries/resources/JDBC/V70.
Al iniciar la herramienta wsadmin se cargan automáticamente todos los scripts del directorio. Para cargar automáticamente sus propios scripts Jython (
*.py) cuando se inicia la
herramienta wsadmin, guarde los scripts de automatización en un nuevo subdirectorio del
directorio
raíz_servidor_aplic/scriptLibraries.
Best practice: Para crear scripts personalizados con procedimientos de la biblioteca de scripts,
guarde los scripts modificados en un nuevo subdirectorio para impedir que se sobrescriba la biblioteca. No edite los procedimientos de script de la biblioteca de scripts.
bprac
Puede
utilizar los scripts para realizar muchas combinaciones de funciones de administración. Utilice la siguiente combinación de procedimientos de ejemplo para configurar un proveedor JDBC y un origen de datos.
Procedimiento
- Compruebe que todos los archivos necesarios del controlador JDBC estén instalados en el gestor de nodos. Si opta por configurar un proveedor JDBC definido por el usuario, compruebe la documentación de la base de datos para obtener información sobre los archivos de controlador.
- Opcional: Inicie la herramienta wsadmin.
Utilice este paso para iniciar la herramienta wsadmin y conectar con un servidor, o ejecute la herramienta
en modalidad local. Si inicia la herramienta wsadmin, utilice los ejemplos de modalidad interactiva de
este tema para ejecutar los scripts.
Cuando se inicia la herramienta wsadmin, el sistema carga todos los scripts
de la biblioteca de scripts.
- Configure un proveedor de JDBC.
Ejecute el procedimiento createJDBCProvider desde la biblioteca de scripts
y especifique los argumentos necesarios. Para ejecutar el script, especifique el
nombre de nodo, el nombre de servidor, el nombre que se va a asignar al nuevo proveedor
de JDBC y el nombre de clase de implementación. Puede especificar de manera opcional
atributos adicionales en el formato siguiente: [["atributo1", "valor1"], ["atributo2",
"valor2"]].
Las propiedades personalizadas para los controladores JDBC de proveedores
específicos deben establecerse en el origen de datos del servidor de aplicaciones. Consulte la documentación de la base de datos para obtener información sobre las propiedades personalizadas disponibles.
En el ejemplo siguiente se crea un proveedor de JDBC en la configuración:
bin>wsadmin -lang jython -c "AdminJDBC.createJDBCProvider("myNode", "myServer", "myJDBCProvider",
"myImplementationClass", [["description", "testing"], ["xa", "false"], ["providerType", "provType"]])"
También puede utilizar la modalidad interactiva para ejecutar el procedimiento de script,
tal como se muestra en el ejemplo siguiente:
wsadmin>AdminJDBC.createJDBCProvider("myNode", "myServer", "myJDBCProvider", "myImplementationClass",
[["description", "testing"], ["xa", "false"], ["providerType", "provType"]])
El script devuelve
el ID de configuración del proveedor JDBC nuevo.
- Utilice una plantilla para configurar un origen de datos.
Ejecute el procedimiento createDataSourceUsingTemplate desde la biblioteca de scripts y especifique
los argumentos necesarios. Para ejecutar el script, especifique el nombre de nodo, el nombre de servidor, el nombre del proveedor de JDBC, el ID de configuración de la plantilla que se va a utilizar y el nombre que se va a asignar al nuevo origen de datos. Puede especificar de manera opcional
atributos adicionales en el formato siguiente: [["atributo1", "valor1"], ["atributo2",
"valor2"]].
En el ejemplo siguiente se utiliza una plantilla para crear un origen de datos en la configuración:
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"]])"
También puede utilizar la modalidad interactiva para ejecutar el procedimiento de script,
tal como se muestra en el ejemplo siguiente:
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"]])
El script
devuelve el ID de configuración del origen de datos nuevo.
Resultados
Las bibliotecas de scripts wsadmin devuelven la misma salida que los mandatos
wsadmin asociados. Por ejemplo, el script AdminServerManagement.listServers() devuelve
una lista de servidores disponibles. El script
AdminClusterManagement.checkIfClusterExists() devuelve un valor true si el
clúster existe o false si el clúster no existe. Si el mandato no devuelve la
salida esperada, las bibliotecas de scripts devuelven un valor 1 cuando el script se
ejecuta satisfactoriamente. Si el script falla, las bibliotecas de scripts devuelven un
valor -1 y un mensaje de error con la excepción.
De forma predeterminada, el
sistema inhabilita la opción failonerror. Para habilitar esta opción, especifique
true como el último argumento del procedimiento de script, tal como se muestra en el ejemplo siguiente:
wsadmin>AdminApplication.startApplicationOnCluster("myApplication","myCluster","true")
Qué hacer a continuación
Cree scripts personalizados para automatizar el entorno combinando los
procedimientos de script desde la biblioteca de scripts. Guarde los scripts personalizados en un nuevo subdirectorio del
directorio raíz_servidor_aplic/scriptLibraries.