La biblioteca de scripts proporciona procedimientos de script Jython para ayudar en la automatización
del entorno. Utilice los scripts de gestión de servidor para configurar servidores, el
entorno de ejecución del servidor, los contenedores web, la supervisión de
rendimiento y los registros. También puede utilizar los scripts para administrar los servidores.
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 AdminServerManagement de la biblioteca de
scripts se ubican en el subdirectorio
raíz_servidor_aplic/scriptLibraries/servers/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 AdminServerManagement.py para realizar varias combinaciones de
funciones de administración. Utilice los pasos siguientes para crear un servidor de aplicaciones, conectar el servidor
de aplicaciones a la interfaz AdminService, configurar los valores JVM
(Java™
Virtual Machine), añadir el servidor de aplicaciones a un clúster y propagar los cambios
al nodo.
Procedimiento
- Opcional: Inicie la herramienta wsadmin.
Utilice
este paso para iniciar la herramienta wsadmin y conectar con un perfil de servidor,
gestor de trabajos o agente administrativo, 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.
- Crear un servidor de aplicaciones.
Ejecute el procedimiento de
script createApplicationServer desde la biblioteca de scripts AdminServerManagement,
tal como se muestra en el ejemplo siguiente:
bin>wsadmin -lang jython -c "AdminServerManagement.createApplicationServer("myNode", "myServer", "default")"
También puede utilizar
la modalidad interactiva para ejecutar el procedimiento de script, tal como se muestra en el ejemplo siguiente:
wsadmin>AdminServerManagement.createApplicationServer("myNode", "myServer", "default")
- Conecte el servidor de aplicaciones de interés a la interfaz AdminService
La interfaz AdminService es la interfaz de servidor para las funciones de administración del servidor de aplicaciones. Para conectar el servidor de aplicaciones
con la interfaz AdminService, ejecute el procedimiento de script configureAdminService
desde la biblioteca de scripts AdminServerManagement, especificando el nombre de nodo, el
nombre de servidor y los argumentos del tipo de conector, tal como se demuestra en el
siguiente ejemplo:
bin>wsadmin -lang jython -c "AdminServerManagement.configureAdminService("myNode", "myServer",
"IPC", "JSR160RMI")
También puede utilizar
la modalidad interactiva para ejecutar el procedimiento de script, tal como se muestra en el ejemplo siguiente:
wsadmin>AdminServerManagement.configureAdminService("myNode", "myServer", "IPC", "JSR160RMI")
- Configure la JVM (Java virtual
machine).
Como parte de la configuración de un servidor de aplicaciones, puede definir valores que mejoran el modo en que el sistema operativo utiliza la JVM. La JVM es un dispositivo informático
interpretativo responsable de la ejecución de códigos de bytes en un programa de Java compilado. La JVM
traduce los códigos de bytes de Java a las instrucciones nativas de la máquina del host. Al ser un proceso de
Java,
el servidor de aplicaciones requiere una JVM para su ejecución y para dar soporte a
aplicaciones de Java que se ejecuten en él.
Ejecute el procedimiento de script
configureJavaVirtualMachine desde la biblioteca de scripts AdminServerManagement,
especificando el nombre de nodo, el nombre de servidor, dónde ejecutar la JVM en
modalidad de depuración y los argumentos de depuración que se deben pasar al proceso
de JVM. De manera opcional, puede especificar atributos de configuración adicionales con
una lista de atributos. Utilice el ejemplo siguiente para configurar la JVM:
bin>wsadmin -lang jython -c "AdminServerManagement.configureJavaVirtualMachine("myNode",
"myServer", "true", "mydebug", [["internalClassAccessMode", "RESTRICT"],
["disableJIT", "false"], ["verboseModeJNI", "false"]])"
También puede utilizar
la modalidad interactiva para ejecutar el procedimiento de script, tal como se muestra en el ejemplo siguiente:
wsadmin>AdminServerManagement.configureJavaVirtualMachine("myNode", "myServer", "true",
"mydebug", [["internalClassAccessMode", "RESTRICT"],
["disableJIT", "false"], ["verboseModeJNI", "false"]])
- Cree un clúster y añada el servidor de aplicaciones como miembro del clúster.
Ejecute el procedimiento de script createClusterWithFirstMember desde la
biblioteca de scripts AdminClusterManagement, tal como se muestra en el ejemplo siguiente:
bin>wsadmin -lang jython -c "AdminClusterManagement.createClusterWithFirstMember("myCluster",
"APPLICATION_SERVER", "myNode", "myServer")"
wsadmin>AdminClusterManagement.createClusterWithFirstMember("myCluster", "APPLICATION_SERVER",
"myNode", "myServer")
- Sincronice el nodo.
Para propagar los cambios de configuración al nodo, ejecute el procedimiento de script syncNode desde la biblioteca de scripts AdminNodeManagement, especificando el nodo de interés, tal como se demuestra en el siguiente ejemplo:
bin>wsadmin -lang jython -c "AdminNodeManagement.syncNode("myNode")"
También puede utilizar la modalidad interactiva para ejecutar el procedimiento de script,
tal como se muestra en el ejemplo siguiente:
wsadmin>AdminNodeManagement.syncNode("myNode")
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.