opciones del mandato server

El mandato server permite iniciar, detener, crear, empaquetar y volcar un servidor de perfiles Liberty. En este tema se describen todas las opciones disponibles y los 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]

donde el valor de acción representa la operación que puede realizar en un servidor de perfiles Liberty. Consulte las operaciones de administración disponibles para el perfil Liberty desde el indicador de mandatos.

Nota: Si no se especifica un servidor en la línea de mandatos, la acción se realiza en la instancia de servidor predeterminada, defaultServer, si existe.

Opciones

Están disponibles las opciones siguientes para el mandato server:
--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 del perfil 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.

Para plataformas distribuidasPara plataformas i de IBMSi especifica una extensión .jar para el nombre de archivo de archivado, el mandato server crea un nuevo archivo de archivado autoextraíble desde el que el servidor de perfiles Liberty se puede instalar mediante el mandato java; para obtener más información, consulte Instalación del perfil Liberty mediante la extracción de un archivo de archivado Java. El recurso de extensión .jar no está disponible en la plataforma z/OS.

--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 cuando proporciona 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 del perfil 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 se va a admitir, añada como prefijo un signo de menos ("-"). Para obtener una lista de valores de sistema operativo, consulte el sitio web de iniciativa de Open Service Gateway en el URL siguiente: http://www.osgi.org/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.

Proceso de servidor

El proceso de servidor se crea utilizando las variables de entorno que se especifican en el archivo server.env. De forma predeterminada, se añaden las opciones de JVM siguientes:
  • La opción -javaagent:wlp/bin/tools/ws-javaagent.jar es necesaria para el rastreo, la supervisión y otras prestaciones del 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 las máquinas virtuales HotSpot antes de la versión 8 de Java. Puede definir la variable de entorno WLP_SKIP_MAXPERMSIZE en true para evitar esta opción predeterminada, con lo que evita avisos tales 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

Puede utilizar el archivo jvm.options para alterar temporalmente estas opciones de JVM predeterminadas o añadir opciones de JVM adicionales. Para obtener más información sobre el archivo server.env y jvm.options, consulte Personalización del entorno del perfil Liberty.

Para plataformas UNIXPara plataformas i de IBM[8.5.5.1 o posterior] De forma predeterminada, el mandato server define el valor umask para denegar todos los permisos a "Otros" usuarios antes de ejecutar la acción. Sin embargo, puede definir la variable de entorno WLP_SKIP_UMASK en true para evitar definir el valor umask.

El directorio de trabajo actual del proceso de servidor se establece en el directorio de salida del servidor.

Para plataformas UNIXPara plataformas i de IBMEl 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 anotaciones cronológicas 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 Inicio de sesión 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

Los siguientes códigos de salida están disponibles para el mandato server y el archivo JAR ejecutable equivalente ws-server.jar:
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 invoca la acción de vuelco.
5
Estado del servidor desconocido. Por ejemplo, falta el directorio workarea o la API Attach no funciona.
>=20
Los códigos de retorno 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=heap,system

Icono que indica el tipo de tema Tema de referencia

Términos y condiciones para centros de información | Comentarios


Icono de indicación de fecha y hora Última actualización: 15 de junio de 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_command_server
Nombre de archivo:rwlp_command_server.html