Opciones de mandato de servidor
El mandato server permite iniciar, detener, crear, empaquetar y volcar un servidor de Liberty. Este tema describe todas las opciones disponibles y códigos de salida que puede utilizar con el mandato server y el archivo JAR ejecutable equivalente ws-server.jar.
Sintaxis
La sintaxis del mandato es la siguiente:
server acción serverName [opciones]
El valor de action representa la operación que puede realizar en un servidor Liberty. Consulte las operaciones de administración disponibles para Liberty desde el indicador de mandatos.
Opciones
- --archive="vía_acceso_archivo_archivado_destino"
Especifica un archivo de destino para la operación de package o dump. Esta vía de acceso puede ser una vía de acceso relativa, que es relativa al directorio raíz de instalación de Liberty o una vía de acceso absoluta. El destino de archivado predeterminado es un archivo comprimido con el nombre de servidor, que se almacena en el directorio raíz de la instalación. Utilice comillas si el valor contiene espacios. Puede utilizar esta opción para las operaciones de package y dump.
- --clean
- Limpia toda la información de caché permanente relacionada con la
instancia de servidor especificada, que incluye metadatos del programa de resolución OSGi y datos del
paquete OSGi persistente. Si utiliza esta opción, se requerirá que el servidor vuelva a calcular
los datos de la memoria caché en el inicio siguiente, que podría llevar más tiempo que un reinicio
que reutilice los datos de la memoria caché.Nota: Esta opción no es necesaria para el funcionamiento normal. El servicio de IBM® puede requerir que utilice esta opción al proporcionar un arreglo temporal o si se sospecha que hay un problema con los datos de la memoria caché. Esta opción puede ser también necesaria si desarrolla una extensión del producto y está actualizando manifiestos de OSGi o planifica borrar los datos del paquete OSGi persistente.
- --include=opción_paquete
- Especifica los archivos que desea empaquetar, donde opción_paquete puede tener uno de los valores siguientes:
- all especifica que se empaquetan todos los archivos en el directorio de instalación de Liberty. Si ${WLP_USER_DIR} y ${WLP_OUTPUT_DIR} están definidas en el archivo server.env, se empaquetarán los archivos situados bajo los mismos. Este valor sólo se aplica a la operación de package.
- usr especifica que se empaquetan los archivos en el directorio ${WLP_USER_DIR}. Este valor sólo se aplica a la operación de package.
- minify especifica que se empaqueten los componentes del entorno de ejecución y los archivos del directorio ${WLP_USER_DIR}, que son necesarios para que se ejecute el servidor, lo que minimiza el tamaño del archivo resultante. Este valor sólo se aplica a la operación de package.
- --include=opción_diagnóstico,opción_diagnóstico,...
- Especifica el tipo de información de diagnóstico que se va a capturar. El valor
de --include es una lista delimitada por comas,
que puede contener cualquiera de los valores siguientes:
- heap se utiliza para ayudar a diagnosticar el consumo de memoria excesivo y las fugas de memoria, y muestra los objetos activos en la memoria y las referencias entre ellos. En las máquinas virtuales IBM J9, el archivo resultante se denomina heapdump.fecha.hora.ID_proceso.número_secuencia.phd. En las máquinas virtuales HotSpot, el archivo resultante se denomina java.fecha.hora.ID_proceso.número_secuencia.hprof. Este valor se aplica a las operaciones de vuelco y vuelco_java.
- system también se utiliza para ayudar a diagnosticar el consumo de memoria excesivo y fugas de memoria, pero también es útiles para encontrar defectos en la máquina virtual. Estos vuelcos solo están soportados en máquinas virtuales de IBM J9. El archivo resultante se denomina core.fecha.hora.ID_proceso.número_secuencia.dmp. Este valor se aplica a las operaciones de vuelco y vuelco_java.
- thread se utiliza para ayudar a diagnosticar las hebras colgadas y los puntos muertos, y a veces puede utilizarse para diagnosticar problemas de exceso de CPU. Estos vuelcos siempre se crean con el mandato server javadump. En las máquinas virtuales IBM J9, el archivo resultante se denomina javacore.fecha.hora.ID_proceso.número_secuencia.txt.
En las máquinas virtuales HotSpot, el archivo resultante se denomina javadump.fecha.hora.ID_proceso.número_secuencia.txt.
Este valor también puede aplicarse a la operación de vuelco.Nota: El tipo de vuelco de hebras se admite solo cuando el servidor se ejecuta en el SDK de Java™. Si el servidor se inicia con un JRE, se notifica un error que indica que el servidor no da soporte al tipo de vuelco. Esta restricción sólo se aplica a las máquinas virtuales HotSpot; el tipo de vuelco Java de hebra está soportado en cualquier JVM de IBM (JRE o SDK).
- --os=valor_sistema_operativo,valor_sistema_operativo,...
- Especifica los sistemas operativos que desea que admita el servidor
empaquetado. Proporcione una lista separada por comas. El valor predeterminado es any,
que indica que el servidor se va a desplegar en cualquier sistema operativo
admitido por el origen.
Para especificar que un sistema operativo no está soportado, añádale como prefijo un signo menos (-). Para obtener una lista de valores de sistema operativo, consulte el sitio web de OSGi Alliance en el URL siguiente: https://www.osgi.org/developer/specifications/reference/#os.
Esta opción se aplica solo a la operación package y se puede utilizar solo con la opción --include=minify. Si excluye un sistema operativo, no podrá incluirlo posteriormente si repite la operación minify en el archivado.
--target=pausable_component,pausable_component,...
Especifica una lista delimitada por comas de los componentes específicos que se pueden poner en pausa. Si especifica la opción de destino, solo se ponen en pausa o reanudan los componentes que figuran en la lista. Para obtener una lista de los valores de destino de ejemplo, consulte Poner en pausa y reanudar un servidor Liberty desde la línea de mandatos.
Proceso de servidor
- La opción -javaagent:wlp/bin/tools/ws-javaagent.jar es necesaria para el rastreo, supervisión, publicación incremental de aplicaciones y otras prestaciones de servidor.
- -Xshareclasses y las opciones relacionadas permiten la memoria caché de clase compartida en las máquinas virtuales IBM J9 admitidas. El directorio de memoria caché se establece en DIR_SALIDA_WLP/.classCache.
- La opción -XX:MaxPermSize aumenta el tamaño de la generación permanente para máquinas virtuales HotSpot anteriores a Java 8. Puede establecer la variable de entorno WLP_SKIP_MAXPERMSIZE en true para evitar esta opción predeterminada, que evita avisos como:
Aviso de la VM del cliente Java HotSpot(TM): se ignora la opción MaxPermSize=256m; se ha suprimido el soporte en la versión 8.0
- La opción -Djava.awt.headless=true evita java.awt.HeadlessException en todas las plataformas y se centra en problemas de robo en Mac OS X.
Puede utilizar el archivo jvm.options para alterar temporalmente estas opciones de JVM predeterminadas o para añadir más opciones de JVM. Para obtener más información sobre el archivo server.env y jvm.options, consulte Personalizar el entorno Liberty.
- Utilice el archivo server.env.
- De forma alternativa, si inicia el servidor con un procedimiento de z/OS, puede especificar la propiedad con la entrada STDENDV DD.
El directorio de trabajo actual del proceso de servidor se establece en el directorio de salida del servidor.
El mandato server crea un archivo de ID de proceso (PID) cuando se inicia el servidor y suprime el archivo PID cuando se detiene el servidor. De forma predeterminada, el archivo PID se establece en WLP_OUTPUT_DIR/.pid/serverName.pid. La vía de acceso absoluta del archivo PID se puede cambiar estableciendo la variable de entorno PID_FILE, o puede cambiarse la vía de acceso absoluta del directorio PID estableciendo la variable de entorno PID_DIR.
La salida y los errores estándar del proceso del servidor se generan en la consola en primer plano cuando se utilizan las acciones run y debug y se redirigen al archivo DIR_SALIDA_WLP/serverName/logs/console.log de forma predeterminada cuando se utiliza la acción start. El nombre de registro se puede cambiar estableciendo la variable de entorno LOG_FILE y el directorio de registro cronológico se puede cambiar estableciendo la variable de entorno LOG_DIR. Para obtener más información sobre la configuración del registro cronológico, consulte la sección Registro y rastreo.
La acción stop impide la entrada de nuevas solicitudes de aplicaciones en el servidor, lo que proporciona un tiempo para que se completen las solicitudes existentes. Transcurrido ese periodo de tiempo, se detienen los componentes del servidor restantes y se sale del proceso del servidor. Las solicitudes de aplicaciones que no se completan durante el periodo de tiempo permitido fallarán, pero su comportamiento exacto depende de la actividad que realizaban en el momento en que se han detenido los componentes del servidor.
Códigos de salida
- 0
- Correcto. 0 indica la finalización satisfactoria de la operación solicitada. Para el estado del servidor, 0 indica que el servidor se está ejecutando.
- 1
- Para el estado del servidor, 1 indica que el servidor no se está ejecutando. Para otras operaciones, indica la invocación de una operación redundante. Por ejemplo, el inicio de un servidor iniciado o la detención de un servidor detenido. JVM también puede devolver este código si se utilizan opciones Java no válidas.
- 2
- El servidor no existe.
- 3
- Se ha invocado una acción no soportada en un servidor en ejecución. Por ejemplo, el servidor se está ejecutando cuando se invoca la acción del paquete.
- 4
- Se ha invocado una acción no soportada en un servidor detenido. Por ejemplo, el servidor no se está ejecutando cuando se llamada a la acción de volcado.
- 5
- Estado del servidor desconocido. Por ejemplo, falta el directorio workarea o la API Attach no funciona.
- >=20
- Los códigos de retornos mayores o iguales que 20 indican que se ha producido un error al realizar la solicitud. En los archivos de registro se graban y capturan mensajes que contienen más información acerca del error.
Uso
Los ejemplos siguientes muestran la sintaxis correcta:
server run
server start myserver --clean
server package myserver --archive="archivefile.zip" --include=all
server dump myserver --archive="c:\mybackup\myserver.zip" --include=thread
server javadump myserver
server javadump myserver --include=thread,system