La biblioteca de scripts proporciona procedimientos de script Jython para ayudar en la automatización
del entorno. Utilice los scripts de gestión de aplicaciones para instalar, desinstalar,
exportar, iniciar, detener y gestionar aplicaciones de nivel empresarial del entorno.
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 aplicación de nivel empresarial de la
biblioteca de scripts se ubican en el subdirectorio
raíz_servidor_aplic/scriptLibraries/application/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, cree un nuevo subdirectorio y guarde los scripts de automatización
existentes en el 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 AdminBLA.py para realizar varias combinaciones de funciones de
administración. Consulte la documentación de los scripts de configuración de aplicaciones de nivel empresarial para ver las descripciones de los argumentos y los ejemplos de sintaxis.
Utilice los siguientes pasos y la biblioteca de scripts para crear una aplicación de nivel empresarial vacía, añadir activos como unidades de composición e iniciar la aplicación de nivel empresarial.
Procedimiento
- 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 para ejecutar los scripts.
Cuando se inicia la herramienta wsadmin, el sistema carga todos los scripts
de la biblioteca de scripts.
- Importe los activos a la configuración.
Los activos representan
los binarios de aplicación que contienen la lógica empresarial que se ejecuta en el
entorno de ejecución de destino y sirve las solicitudes de cliente. Un activo
puede contener un archivo, un archivado de archivos como, por ejemplo, un archivo ZIP o un
archivado de archivos
Java™
(JAR), o un archivado de archivos de archivado como, por ejemplo, un archivo EAR Java EE
(Java
Platform, Enterprise Edition). Otros ejemplos de activos son los archivos JAR EJB
(Enterprise JavaBeans), los archivos EAR, los paquetes OSGi, los archivos JAR de mediación, los archivos
JAR de biblioteca compartida y los contenidos no Java EE como, por ejemplo, las
aplicaciones PHP.
Ejecute el script importAsset desde la biblioteca de scripts
AdminBLA para importar activos al repositorio de configuración del servidor de
aplicaciones, tal como aparece en el siguiente ejemplo:
bin>wsadmin -lang jython -c "AdminBLA.importAsset("asset.zip", "true", "true")"
También puede utilizar
la modalidad interactiva para ejecutar el procedimiento de script, tal como se muestra en el ejemplo siguiente:
wsadmin>AdminBLA.importAsset("asset.zip", "true", "true")
- Cree una aplicación de nivel empresarial vacía.
Ejecute el
script createEmptyBLA desde la biblioteca de scripts AdminBLA para crear una nueva
aplicación de nivel empresarial, tal como aparece en el siguiente ejemplo:
bin>wsadmin -lang jython -c "AdminBLA.createEmptyBLA("miBla", "bla para controlar transacciones")"
También puede utilizar
la modalidad interactiva para ejecutar el procedimiento de script, tal como se muestra en el ejemplo siguiente:
wsadmin>AdminBLA.createEmptyBLA("miBla", "bla para controlar transacciones")
- Añada los activos, como unidades de composición, a la aplicación de nivel
empresarial.
Las unidades de composición pueden representar activos desplegados, otras aplicaciones de nivel empresarial o artefactos
externos que se despliegan en entornos de ejecución que no son de
WebSphere Application Server sin activos de respaldo. Las aplicaciones de nivel empresarial contienen cero o más
unidades de composición. No puede añadir la misma unidad de composición a más de una
aplicación de nivel empresarial, pero puede utilizar un activo para crear más de una
unidad de composición.
Ejecute el script addCompUnit desde la biblioteca de
scripts AdminBLA para añadir asset.zip a miBla como unidad de composición, tal como aparece en el siguiente ejemplo:
bin>wsadmin -lang jython -c "AdminBLA.addCompUnit("myBLA", "asset.zip", "default",
"myCompositionUnit", "cu description", "1", "server1", "specname=actplan1")"
También puede utilizar
la modalidad interactiva para ejecutar el procedimiento de script, tal como se muestra en el ejemplo siguiente:
wsadmin>AdminBLA.addCompUnit("myBLA", "asset.zip", "default", "myCompositionUnit",
"cu description", "1", "server1", "specname=actplan1")
- Guarde los cambios de configuración.
Utilice el siguiente ejemplo de mandatos para guardar
los cambios de configuración:
AdminConfig.save()
- Sincronice el nodo.
Utilice el script
syncActiveNodes de la biblioteca de scripts AdminNodeManagement para sincronizar cada uno
de los nodos activos del entorno, tal como aparece en el siguiente ejemplo:
wsadmin>AdminNodeManagement.syncActiveNodes()
- Inicie la aplicación a nivel de empresa.
Utilice el script
startBLA de la biblioteca de scripts AdminBLA para iniciar cada unidad de composición de
la aplicación de nivel empresarial en los destinos de despliegue para los que se
configuran las unidades de composición, tal como aparece en el siguiente ejemplo:
wsadmin>AdminBLA.startBLA("miBLA")
Resultados
La aplicación de nivel empresarial se ha configurado e iniciado en el
destino de despliegue de interés.
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
Utilice los scripts de configuración de aplicación de nivel empresarial para
crear scripts personalizados para automatizar el entorno. Guarde los scripts
personalizados en un nuevo subdirectorio del directorio
raíz_servidor_aplic/scriptLibraries.