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.
- 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]
- 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.
El valor predeterminado es el valor del parámetro -CCBootstrapHost o el valor, localhost, si no se especifica el parámetro -CCBootstrapHost .
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
- -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:
Este valor se correlaciona con eljava.naming.provider.urlPropiedad del sistema.-CCproviderURL=corbaloc:iiop:myserver.mycompany.com:9810,:mybackupserver.mycompany.com:2809
- -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.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