Herramienta launchClient

Puede utilizar la sintaxis de la línea de mandatos de Java™ Platform, Enterprise Edition (Java EE) para la herramienta launchClient de WebSphere Application Server.

Puede utilizar el mandato launchClient desde un nodo que pertenezca a un entorno de WebSphere Application Server, Network Deployment. No obstante, no intente utilizar el mandato launchClient desde el gestor de despliegue.

Importante: Todos los usuarios que ejecutan mandatos desde un perfil específico deben tener autorización para modificar archivos creados por otros usuarios que utilizan el mismo perfil. En caso contrario, es posible que aparezca un error en los archivos de registro que indique que se ha denegado el permiso. Para evitar este problema, considere una de las siguientes políticas:
  • [AIX Solaris HP-UX Linux Windows][IBM i]Utilice perfiles específicos para autorizaciones de usuario distintas.
  • [z/OS]Utilice una instalación distinta para autorizaciones de usuario distintas.
  • Utilice siempre el mismo usuario para todos los mandatos que se ejecutan en un perfil determinado.
  • Asegurarse de que todos los usuarios de un perfil concreto pertenecen al mismo grupo. Además, asegúrese de que cada usuario del grupo tiene autorización de lectura y grabación para los archivos creados por otros miembros del mismo perfil.

El ejemplo siguiente ilustra la sintaxis de invocación de línea de mandatos para la herramienta launchClient:

launchClient [-profileName nombre_perfil | -JVMOptions opciones | -help | -?] aplicación_usuario [-CCnombre=valor] [args de aplic]
donde
  • aplicación_usuario es la vía de acceso y el nombre del archivo EAR que contiene el cliente de aplicaciones.
  • -CCname=value es el parámetro del par nombre-valor del nombre de contenedor cliente. Consulte el apartado de parámetros del contenedor cliente, para obtener los argumentos de los pares nombre-valor admitidos.
  • args de aplic son los argumentos que se pasan al cliente de aplicación.
  • -profileName define el perfil del proceso del servidor de aplicaciones en una instalación de varios perfiles. La opción -profileName no se necesita para realizar la ejecución en un entorno de perfil único o en una instalación de clientes de aplicaciones.

    [AIX Solaris HP-UX Linux Windows][z/OS]El valor predeterminado es default_profile.

  • -JVMOptions es una serie de opción Java válida estándar o no estándar, excepto -cp o -classpath. Encierre la serie entre comillas.
  • -help, -? imprime la información de uso.

El primer parámetro debe ser -help, -? o ningún parámetro. Las opciones -profileName pName y -JVMOptions son parámetros opcionales. Si se utilizan, deben aparecer antes del parámetro <aplicación_usuario>. El resto de parámetros son opcionales y se pueden poner en cualquier orden después del parámetro aplicación_usuario. La ejecución del cliente de aplicación Java EE ignora cualquier parámetro opcional que no comience por el prefijo -CC y los pasa al cliente de aplicación.

Parámetros del contenedor cliente

Los argumentos soportados son los siguientes:

-CCadminConnectorHost
Especifica el nombre de host del servidor desde el que se recupera la información de configuración.

[AIX Solaris HP-UX Linux Windows][z/OS]El valor predeterminado es el valor del parámetro -CCBootstrapHost o el valor, localhost, si no se especifica el parámetro -CCBootstrapHost.

[IBM i]El valor predeterminado es el valor del parámetro -CCBootstrapHost o el valor su.nombre.servidor si no se especifica el parámetro -CCBootstrapHost.

-CCadminConnectorPort
Indica el número de puerto que debe utilizar la función del cliente administrativo. El valor predeterminado es 8880 para las conexiones SOAP y 2809 para las conexiones RMI (Remote Method Invocations).
-CCadminConnectorType
Especifica cómo se conecta al servidor el cliente administrativo. Especifique RMI para utilizar el tipo de conexión RMI, o especifique SOAP para utilizar el tipo de conexión SOAP. El valor predeterminado es SOAP.
-CCadminConnectorUser
Los clientes administrativos utilizan este nombre de usuario cuando se tiene que autenticar un servidor. Si el tipo de conexión es SOAP y la seguridad está habilitada en el servidor, este parámetro es necesario.
-CCadminConnectorPassword
La contraseña del nombre de usuario que especifica el parámetro -CCadminConnectorUser.
-CCaltDD
El nombre de un archivo de descriptor de despliegue alternativo. Este parámetro se utiliza con el parámetro -CCjar para especificar el descriptor de despliegue que se ha de utilizar. Utilice este argumento cuando se configure el archivo JAR del cliente con más de un descriptor de despliegue. Establezca el valor en null para utilizar el descriptor de despliegue estándar del archivo JAR.
-CCBootstrapHost
El nombre del servidor de host con el que desea conectarse inicialmente. El formato es: el_servidor_elegido.com
-CCBootstrapPort
El número de puerto del servidor. Si no especifica este argumento, se utiliza el valor predeterminado de WebSphere Application Server.
-CCclassLoaderMode
Especifica la modalidad de cargador de clases. Si se especifica PARENT_LAST, el cargador de clase carga clases de la vía de acceso de clases local antes de delegar la carga de clases a su padre. Las clases cargadas para los fines siguientes se ven afectadas:
  • Clases definidas para el cliente de aplicación Java EE
  • Recursos definidos en la aplicación Java EE
  • Clases especificadas en el manifiesto del archivo JAR cliente Java EE
  • Clases especificadas mediante la opción -CCclasspath
Si no se especifica PARENT_LAST, la modalidad predeterminada, PARENT_FIRST, hace que el cargador de clase delegue la carga de clases a su cargador de clase padre antes de intentar cargar la clase de su vía de acceso de clases local.
-CCclasspath
Un valor de classpath. Cuando se inicia la aplicación, se utiliza la variable classpath del sistema. Si desea acceder a las clases que no forman parte del archivo EAR ni forman parte de las variables classpath del sistema, especifique aquí la variable classpath adecuada. Se pueden concatenar varias vías de acceso.
-CCD
Esta opción se utiliza para que WebSphere Application Server establezca la propiedad del sistema especificada durante la inicialización. No se debe utilizar el carácter igual (=) después de -CCD. Por ejemplo: -CCDcom.ibm.test.property=ValorDePrueba. Se pueden especificar múltiples parámetros -CCD. El formato general de este parámetro es -CCD<clave de propiedad>=<valor de propiedad> Por ejemplo, -CCDI18NService.enable=true.
-CCdumpJavaNameSpace
Controla la generación de un volcado del espacio de nombres java: para la aplicación que se inicia, que puede utilizarse para fines de depuración. Un valor de true genera un volcado en formato corto e incluye el nombre y el tipo de objeto para cada enlace. Un valor de long genera un volcado en formato largo e incluye información adicional para cada enlace sobre formato corto, como el tipo de objeto local y representación de serie del objeto local. El valor predeterminado es false y no genera un volcado.
-CCexitVM
Esta opción se utiliza para que WebSphere Application Server invoque el método System.exit() una vez completada la aplicación cliente. El valor por omisión es false.
-CCinitonly
Utilice esta opción para inicializar el tiempo de ejecución del cliente de aplicación para los clientes de aplicaciones ActiveX sin iniciar la aplicación del cliente. El valor por omisión es false.
-CCjar
El nombre del archivo JAR (Java Archive) del cliente que reside en el archivo EAR para la aplicación que desea iniciar. Utilice este argumento cuando tenga varios archivos JAR de cliente en el archivo EAR.
-CCpropfile
Indica el nombre de un archivo de propiedades que contiene las propiedades de launchClient. Especifique las propiedades en el archivo sin el prefijo -CC, a excepción de las propiedades securityManager, securityMgrClass y securityMgrPolicy. Consideremos el ejemplo siguiente: verbose=true.
-CCproviderURL
Proporciona información acerca del servidor de rutina de carga que la fábrica de contexto inicial puede utilizar para obtener un contexto inicial. La fábrica de contexto inicial de WebSphere Application Server puede utilizar un URL de objeto CORBA (Common Object Request Broker Architecture) o un URL de IIOP (Internet Inter-ORB Protocol). Los URL de objeto CORBA son más flexibles que los URL de IIOP y son el formato de URL que se recomienda utilizar. Este valor puede contener más de una dirección de servidor de rutina de carga. Esta característica se puede utilizar cuando se intente obtener un contexto inicial desde un clúster de servidores. En el URL puede especificar direcciones de servidor de rutina de carga para todos los servidores del clúster. La operación se ejecutará correctamente si como mínimo uno de los servidores está ejecutándose, lo que elimina un punto de anomalía individual. La lista de direcciones no se procesa en ningún orden concreto. Para las operaciones de nombres, este valor sobrescribe los parámetros -CCBootstrapHost y -CCBootstrapPort. El siguiente ejemplo ilustra un URL de objeto CORBA que especifica varios sistemas:
-CCproviderURL=corbaloc:iiop:myserver.mycompany.com:9810,:mybackupserver.mycompany.com:2809
Este valor se correlaciona con la propiedad de sistema java.naming.provider.url.
-CCsecurityManager
Habilita y ejecuta WebSphere Application Server con un gestor de seguridad. El valor predeterminado es disable.
-CCsecurityMgrClass
Indica el nombre totalmente calificado de una clase que implementa un gestor de seguridad. Utilice solamente este argumento si el parámetro -CCsecurityManager se establece en enable. El valor predeterminado es java.lang.SecurityManager.
-CCsecurityMgrPolicy
Indica el nombre de un archivo de políticas del gestor de seguridad. Utilice solamente este argumento si el parámetro -CCsecurityManager se establece en enable. Cuando se habilita este parámetro, se establece la propiedad del sistemajava.security.policy. El valor predeterminado esraíz_servidor_aplicaciones/properties/client.policy.
-CCsoapConnectorPort
El puerto de conector SOAP (Simple Object Access Protocol). Si no especifica este argumento, se utiliza el valor predeterminado de WebSphere Application Server.
-CCtrace
Utilice esta opción para obtener información de rastreo de depuración. Es posible que necesite esta información cuando tenga que informar al centro de soporte de IBM® acerca de un problema. El valor predeterminado es false. Para obtener más información, consulte el tema Habilitar rastreo.
-CCtracefile
Indica el nombre del archivo en el que se escribe la información de rastreo. El valor predeterminado es escribir la salida en la consola.
-CCtraceMode
Especifica el formato de rastreo que se utiliza en el rastreo. Si no se especifica el valor válido, básico, el valor predeterminado es el avanzado. El formato de rastreo básico es una forma más compacta de rastreo.

[AIX Solaris HP-UX Linux Windows][IBM i]Para obtener más información sobre el formato de rastreo avanzado, consulte el tema Interpretación de la salida del rastreo.

-CCverbose
Esta opción muestra mensajes informativos adicionales. El valor por omisión es false.

Si utiliza una aplicación de cliente EJB con la seguridad habilitada, edite el archivo sas.client.props, que se encuentra en el directorio raíz_perfil/properties. En el archivo, cambie el valor com.ibm.CORBA.loginSource por none.

Para obtener más información sobre el programa de utilidad sas.client.props, consulte los temas Codificación manual de contraseñas en los archivos de propiedades y Mandato PropFilePasswordEncoder.

Conexión de RMI con seguridad. Se utiliza con la aplicación de cliente administrativo y EJB.
En Jacl:
[AIX Solaris HP-UX Linux Windows][IBM i]
wsadmin -conntype RMI -port  númeropuertormi -user idusuario 
-password contraseña
[z/OS]
wsadmin.sh -conntype RMI -port  númeropuertormi -user idusuario
-password contraseña

En Jython:

[AIX Solaris HP-UX Linux Windows][IBM i]
wsadmin -lang jython -conntype RMI -port  númeropuertormi -user idusuario 
-password contraseña
[z/OS]
wsadmin.sh -lang jython -conntype RMI -port  númeropuertormi -user idusuario
-password contraseña

Se visualiza númeropuertormi para la conexión en la consola administrativa como BOOTSTRAP_ADDRESS.

Atención: En los sistemas operativos AIX, HP-UX, Linux, IBM i, Solaris y z/OS, si se utiliza la opción -password se puede producir un problema de seguridad ya que la información de contraseña pasará a estar visible para el programa de estado del sistema, como el mandato ps, que otros usuarios pueden invocar para mostrar todos los procesos que se ejecutan. No utilice esta opción si la visibilidad de la información de seguridad representa un problema. En su lugar, especifique la información de usuario y contraseña en el archivo soap.client.props para el conector SOAP o en el archivo sas.client.props para el conector RMI. Los archivos soap.client.props y sas.client.props están en el directorio properties del perfil de WebSphere Application Server.

Si se habilita Kerberos (KRB5) para la autenticación administrativa, el destino de la autenticación soporta BasicAuth y KRB5. Para utilizar KRB5, actualice los archivos sas.client.props, soap.client.props y ipc.client.props, según el tipo de conector.

Atención: al utilizar la autenticación Kerberos, la contraseña del usuario no fluye por la red. Se utiliza un total de control unidireccional de contraseña para identificar el cliente.

Los siguientes ejemplos muestran la sintaxis correcta.

[Windows]
launchClient c:\earfiles\myapp.ear -CCBootstrapHost=miServidorWAS -CCverbose=true app_parm1 app_parm2
[AIX HP-UX Solaris][z/OS]
./launchClient.sh /usr/earfiles/myapp.ear
-CCBootstrapHost=miServidorWAS -CCverbose=true app_parm1 app_parm2
[IBM i]
/QIBM/ProdData/WebSphere/AppServer/V61/Base/bin/launchClient
/home/earfiles/myapp.ear -profileName mi_perfil
-CCBootstrapHost=miServidorWAS
-CCverbose=true app_parm1 app_parm2

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=rcli_javacmd
File name: rcli_javacmd.html