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 los servicios autorizados de 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
[16.0.0.4 and later]Atención:

Cada LPAR tiene un proceso ángel predeterminado. Puede asignar un nombre a un ángel si se ha iniciado en la versión 16.0.0.4 o posterior. Este ángel puede convertirse en un proceso ángel adicional en la LPAR. Para obtener más información acerca de ángeles y LPAR, consulte Ángel con nombre. Siempre que sea posible, asegúrese de que el proceso ángel predeterminado esté ejecutándose en el nivel más reciente de Liberty instalado en LPAR. Si una instancia de servidor de Liberty se conecta con un proceso ángel que se ejecuta en un nivel de servicio anterior, es posible que algunas características del servidor no estén disponibles.

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.  The
//*           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 soporte Language Environment, pero el formato debe ser compatible con lo que se espera. Por ejemplo, Extended Binary Coded Decimal Interchange Code (EBCDIC), clave=valor simple sin 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 utiliza la vía de acceso asociada como WLP_USER_DIR.
    • Si no está definido WLPUDIR, pero WLP_USER_DIR está establecido en el entorno inicial (en STDENV), se utiliza.
    • Si no está definido WLPUDIR y WLP_USER_DIR no está establecido en el entorno inicial, se utiliza el valor predeterminado de $WLP_INSTALL_DIR/usr.
  • El entorno se determina mediante la siguiente lógica:
    • Si define STDENV DD, el Language Environment lee la entrada como el entorno inicial.
    • 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 con un símbolo de almohadilla (#) 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 que se haya especificado en este archivo altera 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 está establecido en el entorno, se utiliza su ubicación como JAVA_HOME.
    • Si JAVA_HOME no está establecido en el entorno, pero existe $WLP_INSTALL_DIR/../java64, $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, $WLP_INSTALL_DIR/../java se utiliza 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 con un símbolo de almohadilla (#) y van 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 cualquier 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 se inicia un servidor Liberty con un procedimiento z/OS, puede personalizar el valor umask utilizado por el proceso del servidor. Para personalizar el valor umask, defina las variables de entorno WLP_SKIP_UMASK y _BPX_BATCH_UMASK de una de las formas siguientes:
    • Especifique la variable de entorno WLP_SKIP_UMASK. Puede especificar esta variable en el archivo server.env o, si inicia el servidor con un procedimiento z/OS, puede especificar la variable bajo la entrada STDENDV DD. En el procedimiento z/OS, especifique la variable _BPX_BATCH_UMASK bajo la entrada STDENV DD. No puede especificar la variable _BPX_BATCH_UMASK en el archivo server.env. El ejemplo siguiente muestra una personalización del valor umask de ejemplo.
      //STDENV DD *      
      _BPX_BATCH_UMASK=XXXX
      WLP_SKIP_UMASK=TRUE
      /*
    • Especifique ambos, _BPX_BATCH_UMASK=XXXX y WLP_SKIP_UMASK=TRUE, en un archivo z/OS UNIX con codificación EBCDIC. Defina la vía de acceso bajo la entrada STDENV DD en el procedimiento z/OS. El ejemplo siguiente muestra una personalización del valor umask de ejemplo.
      //STDENV DD PATH='u/path/to/env/ebcdic/file',PATHOPTS=ORDONLY
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): [16.0.0.4 and later]
//BBGZANGL PROC PARMS='',COLD=N,NAME=''
//*------------------------------------------------------------------
//  SET ROOT='/u/MSTONE1/wlp'
//*------------------------------------------------------------------
//* Start the Liberty angel process
//*------------------------------------------------------------------
//SSEP1   EXEC PGM=BPXBATA2,REGION=0M,TIME=NOLIMIT,
//      PARM='PGM &ROOT./lib/native/zos/s390x/bbgzangl COLD=&COLD NAME=X
//             &NAME &PARMS'
//STDOUT    DD SYSOUT=*
//STDERR    DD SYSOUT=*

Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_admin_zos.html