Herramienta launchClient

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

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:

Utilizar perfiles específicos para distintas autorizaciones de usuario
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 pName | -JVMOptions options | -help | -?] userapp [-CCname=value] [app args]

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 es necesaria para la ejecución en un entorno de perfil único o en una instalación de clientes de aplicaciones.
El valor predeterminado es default_profile.
-JVMOptions es una serie de opción estándar o no estándar de Java válida, excepto -cp o -classpath. Encierre la serie entre comillas.
-help,-? imprime la información de uso.

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

Parámetros del contenedor de 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] 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, your.server.name, 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.

Característica en desuso: convierta los conectores RMI en conectores JSR160RMI porque el soporte para el conector RMI está en desuso.

-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 siguiente: your_server_of_choice.com

-CCBootstrapPort

El número de puerto del servidor. Si no especifica este argumento, el valor predeterminado de WebSphere Application Server es used.

-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 aplicaciones Java EE
Recursos definidos en la aplicación Java EE
Clases especificadas en el manifiesto del archivo JAR del 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

Utilice esta opción para que WebSphere Application Server establezca la propiedad del sistema especificada durante la inicialización. No utilice el carácter igual (=) después del-CCD. Por ejemplo:-CCDcom.ibm.test.property=testvalue. Puede especificar varios-CCDparámetros. El formato general de este parámetro es-CCD<property key>=<property value>. 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

Utilice esta opción para que WebSphere Application Server llame alSystem.exit()después de que se complete la aplicación cliente. El valor predeterminado esfalse.

-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 predeterminado esfalse.

-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 sin el-CCen el archivo, con la excepción de las propiedades de política securityManager, securityMgrClass y securityMgr. Consulte 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 IIOP (Internet Inter-ORB Protocol) URL. 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 denominación, este valor altera temporalmente el-CCBootstrapHosty-CCBootstrapPortparámetros. 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 eljava.naming.provider.urlPropiedad del sistema.

-CCsecurityManager

Habilita y ejecuta WebSphere Application Server con un gestor de seguridad. El valor predeterminado esdisable.

-CCsecurityMgrClass

Indica el nombre totalmente calificado de una clase que implementa un gestor de seguridad. Utilice sólo este argumento si el-CCsecurityManagerel parámetro está establecido enenable. El valor predeterminado esjava.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 habilite este parámetro, eljava.security.policyla propiedad del sistema está establecida. El valor predeterminado es raí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 al informar de un problema al servicio de soporte al cliente de IBM® . El valor predeterminado esfalse. Para obtener más información, consulte el tema Habilitación del 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, basic, el valor predeterminado es 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 básico y avanzado, consulte el tema Interpretación de la salida de rastreo.

-CCverbose: Esta opción muestra mensajes informativos adicionales. El valor predeterminado es false.

Si está utilizando una aplicación cliente EJB con la seguridad habilitada, edite el archivo sas.client.props , que se encuentra en el directorio profile_root/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.

Uso de Jacl:

wsadmin -conntype RMI -port  rmiportnumber -user userid 
-password password

En Jython:

wsadmin -lang jython -conntype RMI -port  rmiportnumber -user userid 
-password password

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® , el uso de la opción de contraseña puede dar lugar a una exposición de seguridad a medida que la información de contraseña se vuelve visible para el programa de estado del sistema, como por ejemplo el mandato ps, que pueden invocar otros usuarios para visualizar todos los procesos en ejecución. 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 se encuentran en el directorio de propiedades 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: Cuando se utiliza la autenticación Kerberos , la contraseña de usuario no fluye a través de la conexión. Se utiliza un total de control unidireccional de contraseña para identificar el cliente.

Los siguientes ejemplos muestran la sintaxis correcta.

launchClient c:\earfiles\myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2

./launchClient.sh /usr/earfiles/myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2

/QIBM/ProdData/WebSphere/AppServer/V61/Base/bin/launchClient /home/earfiles/myapp.ear
   -profileName myprofile -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2