startServer (mandato)

El mandato startServer lee el archivo de configuración para el proceso de servidor especificado e inicia el proceso de servidor.

Use el mandato startServer para:
  • 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.
Nota: En este tema se hace referencia a uno o más de los archivos de registro del servidor de aplicaciones. Como alternativa recomendada, puede configurar el servidor para utilizar la infraestructura de registro y rastreo HPEL en lugar de utilizar los archivos SystemOut.log , SystemErr.log, trace.log y activity.log en sistemas distribuidos y de IBM i. Puede también utilizar HPEL junto con sus recursos de registro nativos de z/OS. Si utiliza HPEL, puede acceder a toda la información de registro y rastreo utilizando la herramienta de línea de mandatos LogViewer desde el directorio bin de perfil de servidor. Consulte la información sobre la utilización de HPEL para resolver problemas de aplicaciones para obtener más información sobre la utilización de HPEL.

[Windows]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.

Avoid trouble Avoid trouble: Puede utilizar la consola administrativa para cambiar el valor de la variable CLASSPATH de la JVM (Java™ Virtual Machine) o los valores de las entradas de entorno para un servidor. No obstante, antes de hacer estos cambios, debería saber bien las consecuencias siguientes al realizar estos cambios:
  • 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
gotcha

Para obtener más información acerca de este mandato, consulte el tema Utilización de la herramienta de línea de mandatos.

Sintaxis

La sintaxis del mandato es una de las siguientes:
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.

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

[IBM i]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.
[IBM i]-curlib <biblioteca_producto>
[IBM i]Especifica la biblioteca actual que se ha de utilizar para el mandato CL SBMJOB (Submit Job) subyacente.
[IBM i]-cpyenvvar
[IBM i]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.
[IBM i]-inllibl <lista_biblioteca>
[IBM i]Especifica la lista de bibliotecas inicial que se ha de utilizar para el mandato CL SBMJOB (Submit Job) subyacente.
[IBM i]-inlaspgrp <grupo_ASP>
[IBM i]Especifica el grupo ASP inicial para el mandato CL SBMJOB (Submit Job) subyacente.
[AIX Solaris HP-UX Linux Windows][z/OS]-J <opción_java>
[AIX Solaris HP-UX Linux Windows][z/OS]Especifica las opciones que se van a pasar a través del intérprete Java.
[IBM i]-jobd <biblioteca_producto/descripción_trabajo>
[IBM i]Especifica la descripción del trabajo para el mandato CL SBMJOB (Submit Job) subyacente.
[IBM i]-jobq <biblioteca_producto/cola_trabajo>
[IBM i]Especifica la cola de trabajo para el mandato CL SBMJOB (Submit Job) subyacente.
[AIX Solaris HP-UX Linux Windows][z/OS]-logfile <nombre_archivo>
[AIX Solaris HP-UX Linux Windows][z/OS]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.
[AIX Solaris HP-UX Linux Windows][IBM i]-nowait
[AIX Solaris HP-UX Linux Windows][IBM i]Indica al mandato startServer que no espere a que la inicialización del proceso servidor ejecutado sea satisfactoria.
[IBM i]-outq <biblioteca_producto/cola_salida>
[IBM i]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.
[AIX Solaris HP-UX Linux Windows][z/OS]-quiet
[AIX Solaris HP-UX Linux Windows][z/OS]Suprime la información sobre el progreso que el mandato startServer imprime en modalidad normal.
[AIX Solaris HP-UX Linux Windows][z/OS]-replacelog
[AIX Solaris HP-UX Linux Windows][z/OS]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.

[z/OS]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
[IBM i]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:
CWNATV03I: El servidor de aplicaciones xxxxxx del perfil xxxxxx ha completado la recuperación. El servidor se ha detenido.
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.
[IBM i]-sbs <biblioteca_producto/descripción_subsistema>
[IBM i]Especifica el subsistema que se ha de utilizar para el mandato CL SBMJOB (Submit Job) subyacente.
[AIX Solaris HP-UX Linux Windows][z/OS]-statusport <númeropuerto>
[AIX Solaris HP-UX Linux Windows][z/OS]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.
[AIX Solaris HP-UX Linux Windows][z/OS]-script [<nombrearchivo script>] -background
[AIX Solaris HP-UX Linux Windows][z/OS]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
[AIX Solaris HP-UX Linux Windows][z/OS]Genera información de rastreo en el archivo de registros cronológicos para depuración.
[IBM i]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.
[IBM i]-usejobd
[IBM i]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]
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]
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]
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.

El siguiente ejemplo es un script que ejecuta y captura el código de retorno para server1:
#!/bin/sh
exitCode=`./startServer.sh server1`
El valor exitCode se puede comparar con la lista siguiente de códigos de retorno para determinar los resultados del mandato:
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

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_startserver
File name: rxml_startserver.html