Mandato stopServer

El mandato stopServer lee el archivo de configuración para el proceso del servidor especificado. Este mandato envía un mandato JMX (Java™ Management Extensions) al servidor indicándole que se concluya.

El proceso de servidor puede ser un servidor de aplicaciones, un DMZ Secure Proxy Server for IBM® WebSphere Application Server, un servidor de agente administrativo o un servidor de gestor de trabajos.

De forma predeterminada, el mandato stopServer no devuelve el control a la línea de mandatos hasta que el servidor termina el proceso de conclusión. Hay una opción -nowait para devolver el control inmediatamente y otras opciones para controlar el comportamiento del mandato stopServer. Para obtener más información sobre cómo ejecutar este mandato, consulte el tema Cómo utilizar las herramientas de línea de mandatos.

[AIX Solaris HP-UX Linux Windows]Si ejecuta el producto en el sistema operativo Microsoft Windows y tiene el servidor ejecutándose como un servicio del sistema operativo Windows, el mandato stopServer detiene el servicio Windows responsable de iniciar el servidor.

[IBM i]Aunque el mandato stopServer devuelve el control cuando finaliza la conclusión del servidor, puede devolverlo antes de que haya terminado el proceso IBM i. En función de la cantidad de memoria que JVM (Java Virtual Machine) deba devolver a la agrupación de memoria, el proceso puede tardar varios segundos o minutos en llevarse a cabo. No debe tratar de iniciar de nuevo el servidor hasta que el proceso haya terminado. Utilice el mandato de CL WRKACTJOB SBS(subsistema) para determinar si el proceso ha terminado completamente. De forma predeterminada, el subsistema es QWAS85.

[AIX][Linux][Solaris][HP-UX]Si la seguridad está habilitada, con el mandato stopServer se debe utilizar un nombre de usuario y una contraseña porque el mandato invoca un método MBean en el servidor.

[Windows]Los parámetros de nombre de usuario y contraseña no son necesarios con el mandato stopServer. Los parámetros se pasan automáticamente al script que utiliza el servicio Windows para concluir el sistema.

Avoid trouble Avoid trouble: Si se muestra el mensaje ADMC0074E: Se interrumpirá la conexión debido a un error irrecuperable en el archivo de registros cronológicos del sistema, puede que un cliente haya intentado enviar un nombre de usuario y una contraseña a otro servidor en el que la seguridad está inhabilitada. Puede pasar por alto este mensaje porque el cliente cambiará automáticamente su valor de seguridad de modo que coincida con el valor de seguridad del servidor con el que el cliente está intentado comunicarse. Finalmente, la conexión se realizará correctamente. No obstante, la seguridad se deshabilita tanto para el cliente administrativo como para el servidor receptor.gotcha

Sintaxis

La sintaxis del mandato es una de las siguientes:

stopServer <nombre_servidor> [opciones]

donde nombre_servidor es el nombre del directorio de configuración del servidor de aplicaciones o DMZ Secure Proxy Server for IBM WebSphere Application Server que desee detener.

[AIX Solaris HP-UX Linux Windows][z/OS]Este argumento es necesario.

[IBM i]Este argumento es opcional. Si se utiliza el perfil predeterminado, el servidor utiliza por omisión el valor server1. Si el nombre de perfil no es el valor predeterminado, el servidor toma por omisión el nombre del perfil.

stopServer <nombre_agente_admin>

Donde nombre_agente_admin es el nombre del agente administrativo que se desea detener.

stopServer <gestor_trabajos>

donde gestor_trabajos es el nombre del gestor de trabajos que se quiere detener.

Parámetros

Las siguientes opciones están disponibles para el mandato stopServer:

-nowait
Indica al mandato stopServer que no espere a que la conclusión del proceso servidor sea satisfactoria.
-quiet
Suprime la información sobre el progreso que el mandato stopServer imprime en modalidad normal.
-logfile <nombre_archivo>
Especifica la ubicación del archivo de registro en el que se escribe la información de rastreo. Por omisión, el archivo de anotaciones cronológicas se denomina stopServer.log y se crea en el directorio logs.
-profileName
Define el perfil del proceso de servidor en una instalación de varios perfiles. La opción -profileName no es necesaria para la ejecución en un entorno de perfil único. El valor predeterminado de esta opción es el perfil predeterminado.
-replacelog
Sustituye el archivo de registro en lugar de anexarlo al archivo de registro actual.
-trace
Genera información de rastreo en un archivo para depuración. La salida de rastreo se escribe en el archivo stopServer.log, que se encuentra en el directorio raíz_perfil/logs/servidor.
-timeout <segundos>
Especifica el tiempo de espera para que el servidor concluya antes de que se exceda el tiempo de espera y devuelva un error.
-statusport <númeropuerto>
Un parámetro opcional que permite a un administrador establecer el número de puerto para una devolución de llamada de estado del servidor. La herramienta abre este puerto y espera la devolución de llamada del estado procedente del servidor, justo antes de que el servidor se haya detenido. Si este parámetro no se establece, se asigna automáticamente un puerto no utilizado.
-conntype <tipo>
Especifica el tipo de conector JMX que se utilizará para conectar con el gestor de despliegue. Los tipos válidos son SOAP o RMI (Remote Method Invocation).
-port <Númeropuerto>
Especifica el puerto JMX de servidor que debe utilizarse de forma explícita, de modo que no sea necesario leer los archivos de configuración para obtener la información.
-username <nombre>
Especifica el nombre de usuario para autenticación si está habilitada la seguridad en el servidor. Funciona igual que la opción -user.
-user <nombre>
Especifica el nombre de usuario para autenticación si está habilitada la seguridad en el servidor. Funciona igual que la opción -username.
-password<contraseña>
Especifica la contraseña para autenticación si está habilitada la seguridad en el servidor.
Avoid trouble Avoid trouble: Si la ejecución se realiza en un entorno seguro pero no se ha proporcionado un ID de usuario y una contraseña, aparece el siguiente mensaje de error:
ADMN0022E: Se ha denegado el acceso para la operación stop en el MBean Server debido 
a que las credenciales no son suficientes o están vacías.
Para resolver estos problemas, proporcione la información de ID de usuario y contraseña.gotcha
-help
Imprime una sentencia de uso.
-?
Imprime una sentencia de uso.

Ejemplo de uso

Los siguientes ejemplos muestran la sintaxis correcta:

[AIX Solaris HP-UX Linux Windows][z/OS]
stopServer server1
stopServer server1 -nowait 

stopServer server1 -trace (produce el archivo stopserver.log)
stopServer adminagent
stopServer jobmgr
stopServer proxy1 (for the secure proxy profile)
[IBM i]
stopServer server1   (stops the server1 server for the default profile)
 
stopServer server1 -nowait 

stopServer server1 -trace (produce el archivo stopserver.log)
stopServer -profileName mytest (detiene el servidor mytest
configurado para el perfil mytest)

stopServer AdminAgent01
stopServer JobMgr01

stopServer proxy1 (default server name for the SecureProxySrv01 profile)

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_stopserver
File name: rxml_stopserver.html