Para plataformas z/OS

Administración de Liberty en z/OS

En la plataforma z/OS, inicie, detenga o modifique Liberty mediante el uso de mandatos de operador de MVS.

Antes de empezar

Asegúrese de que los siguientes perfiles de seguridad se han configurado como se describe en Habilitación de servicios autorizados z/OS en Liberty para z/OS.
  • Perfiles STARTED para el proceso de servidor y el proceso de ángel
  • Perfiles SERVER para permitir el acceso a los servicios autorizados de z/OS
Atención: Cada LPAR tiene un proceso ángel. Un ángel iniciado en el nivel de servicio 8.5.5.2 o posterior puede coexistir con otros servidores de Liberty para z/OS que también utilicen un ángel en el nivel de servicio 8.5.5.2 o posterior. Para varios servidores de Liberty para z/OS que se ejecutan en la misma LPAR con niveles de servicio anteriores y posteriores a la versión 8.5.5.2 que requieren un proceso ángel, será necesario iniciar primero un ángel en 8.5.5.2 o posterior para garantizar el funcionamiento correcto del proceso de ángel.

Acerca de esta tarea

En este tema se describe cómo iniciar, modificar, y detener Liberty utilizando la consola de MVS. También puede iniciar y detener el servidor desde un shell o utilizar un shell para iniciar el servidor como una tarea iniciada, consulte Inicio y detención de un servidor desde la línea de mandatos.

Una tarea iniciada es JCL que se ejecuta inmediatamente en respuesta a un mandato START del operador. Existen dos plantillas de procedimiento JCL (PROCs) disponibles en el directorio wlp/templates/zos/procs. Una plantilla es para el proceso del servidor y la otra para el proceso de ángel:
  • bbgzsrv para Liberty.
  • bbgzangl para el proceso de ángel que se necesita para controlar el acceso a servicios autorizados del sistema en la plataforma z/OS.
Los administradores pueden copiar las plantillas en una ubicación de usuario y personalizarlas para iniciar los servidores de Liberty desde la consola de MVS.
Nota: Es posible que se modifiquen los archivos de los directorios /templates cuando se apliquen actualizaciones de productos.
La sección de ejemplos proporciona más información sobre las dos plantillas PROC.

El destino de un mandato STOP de operador es un trabajo o una tarea iniciada.

Después de personalizar las plantillas de procedimiento JCL, deben colocarse en la concatenación de bibliotecas de procedimientos del sistema. El nombre del miembro de procedimiento se convierte en el argumento para el mandato START.

Procedimiento

Ejemplo

El siguiente ejemplo muestra la plantilla de procedimiento para el proceso de servidor (bbgzsrv). Este PROC se encuentra en un conjunto de datos de la concatenación proclib de z/OS.

//BBGZSRV PROC PARMS='defaultServer'
//*------------------------------------------------------------------
//* INSTDIR - the path to the WebSphere Liberty install.
//*           This path is used to find the product code and is
//*           equivalent to the WLP_INSTALL_DIR environment variable
//*           in the Unix shell.
//* USERDIR - the path to the WebSphere Liberty user area.
//*           This path is used to store shared and server specific
//*           configuration information and is equivalent to the
//*           WLP_USER_DIR environment variable in the Unix shell.
//*------------------------------------------------------------------
//  SET INSTDIR='/u/MSTONE1/wlp'
//  SET USERDIR='/u/MSTONE1/wlp/usr'
//*------------------------------------------------------------------
//* Start the Liberty server
//*
//* WLPUDIR - PATH DD that points to Liberty's "user"
//*           directory. If the DD is not allocated, the user
//*           directory location defaults to the wlp/usr directory
//*           in the install tree.
//* STDOUT  - Destination for stdout (System.out)
//* STDERR  - Destination for stderr (System.err)
//* MSGLOG  - Destination for messages.log (optional)
//* STDENV  - Initial Unix environment - read by the system.  El
//*           installation default and server specific server
//*           environment files will be merged into this environment
//*           before the JVM is launched.
//*------------------------------------------------------------------
//STEP1   EXEC PGM=BPXBATSL,REGION=0M,
//  PARM='PGM &INSTDIR./lib/native/zos/s390x/bbgzsrv &PARMS' 
//WLPUDIR  DD PATH='&USERDIR.' 
//STDOUT    DD SYSOUT=* 
//STDERR    DD SYSOUT=* 
//*MSGLOG   DD SYSOUT=*
//*STDENV   DD PATH='/etc/system.env',PATHOPTS=(ORDONLY) 
//*STDOUT   DD PATH='&ROOT/std.out', 
//*            PATHOPTS=(OWRONLY,OCREAT,OTRUNC), 
//*            PATHMODE=SIRWXU 
//*STDERR   DD PATH='&ROOT/std.err', 
//*            PATHOPTS=(OWRONLY,OCREAT,OTRUNC), 
//*            PATHMODE=SIRWXU
Notas:
  • El lanzador utiliza la DD STDENV como el entorno inicial, pero esta DD es opcional. El entorno inicial para el proceso se define en el PROC. Puede apuntar a cualquier tipo de conjunto de datos que LE soporte, pero el formato debe ser compatible con el esperado. Por ejemplo, EBCDIC, clave=valor simples sin ninguna expansión.
  • Se permite una PATH DD que apunte a un directorio existente (que no sea un archivo). Si dicha DD se abre, la corriente FILE devuelta es válida para fldata, de modo que se puede utilizar la vía de acceso HFS asociada a la DD. La plantilla PROC define una WLPUDIR PATH DD que representa el equivalente de WLP_USER_DIR.
  • El WLP_USER_DIR se determina mediante la lógica siguiente:
    • Si está definido WLPUDIR DD, se asocia la vía de acceso asociada como WLP_USER_DIR
    • Si WLPUDIR no está definido, pero WLP_USER_DIR está establecido en el entorno inicial (en STDENV), se utiliza
    • Si WLPUDIR no está definido y WLP_USER_DIR no está establecido en el entono inicial, se utiliza el valor predeterminado de $WLP_INSTALL_DIR/usr
  • El entorno se determina mediante la siguiente lógica:
    • Si se ha definido STDENV DD, LE considera que es el entorno inicial. Si desea establecer la variable de entorno _BPX_BATCH_UMASK, debe establecerse aquí en STDENV DD.
    • Si $WLP_INSTALL_DIR/etc/server.env existe y es legible, su contenido clave=valor se lee y se establece en el entorno. El archivo puede estar en ASCII o EBCDIC. Los comentarios empiezan por un '#' y van hasta el final de la línea. Los valores que contienen espacios en blanco puede colocarse entre comillas dobles. Cualquier entrada de entorno especificada en este archivo alterará temporalmente las entradas del entorno inicial
    • Si $WLP_USER_DIR/servers/{serverName}/server.env existe y es legible, el contenido de clave=valor se lee y se establece en el entorno. Este archivo también puede estar en ASCII o EBCDIC y da soporte a los comentarios. Las entradas que se especifican aquí alteran temporalmente las entradas del entorno inicial y etc/server.env.
    • Independientemente del entorno de usuario especificado, se establecerán explícitamente las entradas siguientes: _BPXK_WLM_PROPAGATE=NO, JAVA_THREAD_MODEL=HEAVY y JAVA_PROPAGATE=NO. Si no está establecido _EDC_PTHREAD_YIELD, se establecerá en -2.
  • Una vez establecido el entorno, se determina JAVA_HOME mediante la lógica siguiente:
    • Si JAVA_HOME se establece en el entorno, su ubicación se utiliza como JAVA_HOME
    • Si JAVA_HOME no está establecido en el entorno, pero existe $WLP_INSTALL_DIR/../java64, se utiliza $WLP_INSTALL_DIR/ ../java64 se utiliza como JAVA_HOME
    • Si JAVA_HOME no está establecido en el entorno y $WLP_INSTALL_DIR/../java64 no existe, se utiliza $WLP_INSTALL_DIR/../java como JAVA_HOME
  • Tras determinar JAVA_HOME, se determinan las opciones de línea de mandatos de JVM mediante la lógica siguiente:
    • Si $WLP_USER_DIR/servers/{serverName}/jvm.options existe y es legible, se lee su contenido. El archivo puede estar en ASCII o EBCDIC y cada línea del archivo debe ser un solo argumento de línea de mandatos java. Los comentarios empiezan por un '#' y llegan hasta el final de la línea.
    • Si $WLP_USER_DIR/servers/{serverName}/jvm.options no existe pero $WLP_INSTALL_DIR/etc/jvm.options existe y es legible, se lee su contenido. El archivo puede estar en ASCII o EBCDIC y debe tener un argumento de línea de mandatos java por línea. Los comentarios están soportados
    • Independientemente del contenido de jvm.options, -Dfile.encoding=iso8859-1, -javaagent:$WLP_INSTALL_DIR/lib/bootstrap-agent.jar y -classpath $WLP_INSTALL_DIR/lib/server-launcher.jar están en la línea de mandatos
  • Si desea pasar argumentos a JVM, defina la sentencia JAVAOPTS DD, de modo que los argumentos de línea de mandatos Java™ se lean desde este DD. El ejemplo siguiente muestra un archivo de entrada de ejemplo:
    -Xmx512m
    -Xms256m
    -Daaa.bbb.ccc=something.forsomeone
  • Cuando un servidor de Liberty se ha iniciado desde un procedimiento, el servidor validará que no se está ejecutando con una umask de 000. Si detecta que el valor de umask es 000, lo alterará temporalmente con un valor de 022.
El ejemplo siguiente muestra el mandato que utilizaría para iniciar Liberty utilizando el procedimiento bbgzsrv de ejemplo para un "defaultServer" configurado:
start bbgzsrv,parms='defaultServer' 
El siguiente ejemplo muestra la plantilla de procedimiento para el proceso de ángel (bbgzangl):
//BBGZANGL PROC PARMS='',COLD=N
//*------------------------------------------------------------------
//  SET ROOT='/u/MSTONE1/wlp'
//*------------------------------------------------------------------
//* Start the Liberty angel process
//*------------------------------------------------------------------
//STEP1   EXEC PGM=BPXBATA2,REGION=0M,
//  PARM='PGM &ROOT./lib/native/zos/s390x/bbgzangl COLD=&COLD &PARMS' 
//STDOUT    DD SYSOUT=* 
//STDERR    DD SYSOUT=*

Icono que indica el tipo de tema Tema de tarea



Icono de indicación de fecha y hora Última actualización: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_admin_zos
Nombre de archivo:twlp_admin_zos.html