startServer (mandato)
El mandato startServer lee el archivo de configuración para el proceso de servidor especificado e inicia el proceso de servidor.
- Iniciar un servidor de aplicaciones.
- Iniciar un DMZ Secure Proxy Server for IBM® WebSphere Application Server.
- Iniciar un agente administrativo.
- Iniciar un gestor de trabajos.
Si ejecuta el producto en un sistema operativo
Windows Windows
y tiene el servidor ejecutándose como servicio del sistema operativo
Windows,
el mandato startServer iniciará el servidor y el servicio
Windows
asociado.
No es necesario utilizar un nombre de usuario y una contraseña con el mandato startServer porque este mandato inicia un proceso de servidor pero no invoca un método MBean.

- Al emitir el mandato startServer -script se crea un script con los valores estáticos. Cuando cambie los parámetros JVM desde la consola, se tendrá que generar un script nuevo para acomodar estos parámetros JVM modificados.
- Cuando se ejecuta el mandato startServer -script, se genera un script nuevo que tiene todos los valores de parámetros en el momento en que se ejecutó el mandato. Si cambia los valores de los parámetros (o añade parámetros nuevos), el script generado no tiene estos valores de parámetros nuevos. Estos valores nuevos pasan al script que se acaba de generar de una forma estática, por lo que los cambios realizados después de la creación de este script requerirán que un nuevo mandato startServer -script genere un script nuevo con estos valores actualizados.
- Si cambia el valor de la variable CLASSPATH de la JVM (Java Virtual Machine), este nuevo valor altera temporalmente el valor del parámetro Classpath en el mandato de inicio que se define, por omisión, en el script que se genera al utilizar el mandato startServer -script.
- Si añade una entrada de entorno nueva en la página de entradas de entorno o cambia el valor de una entrada existente, el valor nuevo y modificado aparecen como parámetros en el script que se genera a emitir el mandato startServer -script.
- Si una de las entradas de entorno que añade se denomina PATH, el
valor especificado para esta entrada altera temporalmente el valor
especificado para la variable PATH que, por omisión, se establece en
WAS_PATH en el archivo setUpCmdLine. Si el valor de la variable PATH
se altera temporalmente, se envía el mensaje siguiente al archivo en
el que se registran los mensajes de error:
WSVR0009E: se ha producido un error durante el inicio. com.ibm.ws.exception.RuntimeError: java.lang.NoClassDefFoundError: com/ibm/ws/process/Win32ProcessGlue
Para obtener más información acerca de este mandato, consulte el tema Utilización de la herramienta de línea de mandatos.
Sintaxis
startServer nombre_servidor [opciones]
Donde nombre_servidor es el nombre del servidor de aplicaciones o el DMZ Secure Proxy Server for IBM WebSphere Application Server que se desea iniciar.
Este argumento es necesario.
Este argumento es opcional. Si no se especifica este argumento, se asigna un servidor basándose
en el nombre de perfil. Si utiliza el perfil llamado default, el argumento <server> se establece en server1. Si el nombre del perfil no es default, el argumento <server> se establece en el nombre del perfil.
startServer <nombre_agente_admin>
Donde nombre_agente_admin es el nombre del agente administrativo que se desea iniciar.
startServer <gestor_trabajos>
donde gestor_trabajos es el nombre del gestor de trabajos que se quiere iniciar.
Parámetros
Las siguientes opciones están disponibles para el mandato startServer:
- -?
- Imprime una sentencia de uso.
-curlib <biblioteca_producto>
Especifica la biblioteca actual que se ha de utilizar para el mandato CL SBMJOB (Submit Job) subyacente.
-cpyenvvar
Indica al mandato startServer que establezca las variables de entorno definidas actualmente para el proceso del servidor. El valor predeterminado es no establecer las variables de entorno definidas actualmente.
- -help
- Imprime una sentencia de uso.
-inllibl <lista_biblioteca>
Especifica la lista de bibliotecas inicial que se ha de utilizar para el mandato CL SBMJOB (Submit Job) subyacente.
-inlaspgrp <grupo_ASP>
Especifica el grupo ASP inicial para el mandato CL SBMJOB (Submit Job) subyacente.
-J <opción_java>
Especifica las opciones que se van a pasar a través del intérprete Java.
-jobd <biblioteca_producto/descripción_trabajo>
Especifica la descripción del trabajo para el mandato CL SBMJOB (Submit Job) subyacente.
-jobq <biblioteca_producto/cola_trabajo>
Especifica la cola de trabajo para el mandato CL SBMJOB (Submit Job) subyacente.
-logfile <nombre_archivo>
Especifica la ubicación del archivo de registro en el que se escribe la información de rastreo. De manera predeterminada, el archivo de registros cronológicos se denomina startServer.log y se crea en el directorio logs.
-nowait
Indica al mandato startServer que no espere a que la inicialización del proceso servidor ejecutado sea satisfactoria.
-outq <biblioteca_producto/cola_salida>
Especifica la cola de salida para el mandato CL SBMJOB (Submit Job) subyacente.
- -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.
-quiet
Suprime la información sobre el progreso que el mandato startServer imprime en modalidad normal.
-replacelog
Sustituye el archivo de registro en lugar de anexarlo al archivo de registro actual.
- -recovery
- Especifica que el servidor se iniciará en modalidad de recuperación, efectuará una recuperación transaccional y concluirá. El servidor no aceptará ninguna transacción nueva mientras esté en modalidad de recuperación. Cuando vuelva a iniciar el servidor, estarán disponibles los recursos que no estaban disponibles debido a transacciones cuestionables.
Utilice esta opción si falla un servidor y no desea aceptar nuevas transacciones durante el proceso de recuperación.
transition: Si va a migrar desde una versión anterior del producto, asegúrese de que el parámetro ENV incluido en la sentencia del procedimiento JCL para el controlador incluya el elemento REC=N o REC=Y. Si el parámetro ENV no incluye el elemento REC=N o REC=Y, el servidor no se reiniciará en modalidad de recuperación ni siquiera si especifica la opción -recovery.Si el parámetro ENV incluye el elemento REC=N, el valor se modifica automáticamente a REC=Y, si especifica -recovery cuando se reinicia el servidor. El elemento REC=N se incluye automáticamente en el parámetro ENV, si no migró desde una versión anterior del producto. A continuación, aparece un ejemplo del aspecto que podría tener una sentencia PROC actualizada:
//BBO6ACR PROC ENV=,PARMS=' ',REC=N,Z=BBO6ACRZ
Cuando se invoca el mandato startServer con el parámetro -recovery y el proceso de recuperación no es satisfactorio, aparece el siguiente mensaje de error en los archivos SystemErr.log y SystemOut.log:
El mensaje no indica que el proceso de recuperación no fue satisfactorio. Si utiliza el parámetro -recovery, compruebe los archivos SystemErr.log y SystemOut.log correspondientes al servidor que está iniciando para determinar si el proceso de recuperación ha sido satisfactorio.CWNATV03I: El servidor de aplicaciones xxxxxx del perfil xxxxxx ha completado la recuperación. El servidor se ha detenido.
-sbs <biblioteca_producto/descripción_subsistema>
Especifica el subsistema que se ha de utilizar para el mandato CL SBMJOB (Submit Job) subyacente.
-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 del servidor que indica que el servidor se ha iniciado. Si este parámetro no se establece, se asigna automáticamente un puerto no utilizado.
-script [<nombrearchivo script>] -background
Genera un script de ejecución con el mandato startServer en lugar de ejecutar el proceso servidor directamente. El nombre del script de ejecución es un argumento opcional. Si no especifica el nombre del script de inicio, el nombre de archivo de script predeterminado es start_servidor, que se basa en el nombre de servidor que se pasa como primer argumento para el mandato startServer. El parámetro -background es opcional y especifica que el script generado se ejecutará en segundo plano cuando lo ejecute.
- -trace
Genera información de rastreo en el archivo de registros cronológicos para depuración.
Habilita el rastreo del código de proceso nativo que inicia el servidor. La salida de rastreo se escribe en el archivo was_nombre_trabajo-usuario_trabajo-número_trabajo.log que se encuentra en el directorio raíz_perfil/logs.
- -timeout <segundos>
- Especifica el tiempo de espera antes de que se exceda el tiempo de inicialización del servidor y se devuelva un error.
-usejobd
Especifica que se ha de utilizar la descripción de trabajo del proceso SBMJOB (Submit Job) para el servidor cuando se cambia el ID de usuario Run-As.
Nota: Este mandato no afecta al campo USER de la descripción de trabajo actual.
Ejemplo de uso
Los siguientes ejemplos muestran la sintaxis correcta. La información entre paréntesis es una descripción de la salida que se crea si se ejecuta el mandato precedente.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
startServer server1
startServer server1 -script (produce los archivos start_server1.sh o .bat)
startServer server1 -trace (produce el archivo startserver.log)
startServer adminagent
startServer.sh server1 -trace -username MyUserName -password MyUserPassword
-profileName MyProfileName (inicia el servidor server1 mediante el
perfil MyProfileName. El servidor se ejecuta bajo el nombre de usuario MyUserName,
y produce archivos de rastreo en el directorio raíz_perfil/logs)
startServer jobmgr
startServer proxy1 (para el perfil de proxy seguro)
![[z/OS]](../images/ngzos.gif)
startServer server1
startServer server1 -script (produce el archivo start_server1.sh)
startServer server1 -trace (produce el archivo startserver.log)
startServer adminagent
startServer jobmgr
startServer proxy1 (para el perfil de proxy seguro)
startServer.sh server1 -trace -username MyUserName -password MyUserPassword
-profileName MyProfileName (inicia el servidor server1 mediante el
perfil MyProfileName. El servidor se ejecuta bajo el nombre de usuario MyUserName,
y produce archivos de rastreo en el directorio raíz_perfil/logs)
![[IBM i]](../images/iseries.gif)
startServer server1 (inicia el servidor server1 para el perfil predeterminado)
startServer server1 -trace (inicia el servidor server1 para
el perfil predeterminado y produce archivos de rastreo en el
directorio raíz_perfil/logs)
startServer -profileName mytest (inicia el servidor mytest
configurado bajo el perfil mytest)
startServer AdminAgent01
startServer JobMgr01
startServer proxy1 (nombre de servidor predeterminado para el perfil SecureProxySrv01)
startServer.sh server1 -trace -username MyUserName -password MyUserPassword
-profileName MyProfileName (inicia el servidor server1 mediante el
perfil MyProfileName. El servidor se ejecuta bajo el nombre de usuario MyUserName,
y produce archivos de rastreo en el directorio raíz_perfil/logs)
Códigos de salida
¿Cómo captura el código de retorno de startServer y stopServer para determinar si se ha realizado correctamente o no? Esta tabla muestra los códigos de retornos para un servidor especificado un mandato start o stop.
#!/bin/sh
exitCode=`./startServer.sh server1`
Estado del servidor | Código de retorno |
---|---|
Ha fallado la inicialización del servidor | -1 |
Ha excedido el tiempo de espera del servidor | -2 |
Inicio del servidor en curso | 1 |
El servidor está inicializando las aplicaciones que están presentes | 2 |
La inicialización del servidor se ha completado (correcto) | 0 |
Ha fallado la parada del servidor | -10 |
Ha excedido el tiempo de espera de la parada del servidor | -11 |
Se ha iniciado la operación de parada del servidor | 1000 |
El servidor se ha parado correctamente | 0 |