Ferramenta launchClient
É possível usar a sintaxe da linha de comandos do Java™ Platform, Enterprise Edition (Java EE) para a ferramenta launchClient para o WebSphere Application Server.
É possível usar o comando launchClient a partir de um nó dentro de um ambiente do WebSphere Application Server, Network Deployment. No entanto, não tente usar o comando launchClient a partir do Gerenciador de Implementação.
Use perfis específicos para autoridades distintas de usuário
Utilize uma instalação separada para autoridades de usuário distintas
- Sempre use o mesmo usuário para todos os comandos executados em um determinado perfil
- Certifique-se de que todos os usuários de um perfil específico pertencem ao mesmo grupo. Além disso, certifique-se de que cada usuário de um grupo tenha autoridade de leitura e gravação para os arquivos criados por outros membros no mesmo perfil.
O exemplo a seguir ilustra a sintaxe de chamada da linha de comandos para a ferramenta launchClient:
launchClient [-profileName pName | -JVMOptions options | -help | -?] userapp [-CCnome=valor] [app args]
- userapp é o caminho e o nome do arquivo EAR que contém o cliente aplicativo.
- -CCname=value é o parâmetro de par nome-valor do contêiner do cliente. Consulte a seção de parâmetros do contêiner do cliente, para obter argumentos suportados do par nome-valor.
- app args são argumentos que são transmitidos ao cliente aplicativo.
- -profileName define o perfil do processo do Servidor de Aplicativos
em uma instalação com vários perfis. A opção -profileName não é requerida para execução
em um único ambiente de perfil ou na instalação de Application Clients.
O padrão é default_profile.
- O -JVMOptions é uma cadeia de opções padrão ou não padrãoJava, exceto -cp ou -classpath. Insira as aspas ao redor da cadeia.
- -help, -? imprime informações de uso.
O primeiro parâmetro deve ser -help, -? ou não conter nenhum parâmetro. As opções -profileName pName e -JVMOptions são parâmetros opcionais. Se utilizados, eles devem aparecer antes do parâmetro <aplicativo_do_usuário>. Todos os outros parâmetros são opcionais e podem aparecer em qualquer ordem após o parâmetro aplicativo_do_usuário. O tempo de execução do cliente Java EE Application ignora qualquer parâmetro opcional que não comece com um prefixo -CC e transmite esses parâmetros para o aplicativo cliente.
Parâmetros do Contêiner do Cliente
Os argumentos suportados incluem:
- -CCadminConnectorHost
- Especifica o nome do host
do servidor do qual as informações de configuração são recuperadas.
O padrão é o valor do parâmetro -CCBootstrapHost ou o valor localhost, se o parâmetro -CCBootstrapHost não estiver especificado.
O padrão é o valor do parâmetro -CCBootstrapHost ou o valor your.server.name, se o parâmetro -CCBootstrapHost não for especificado.
- -CCadminConnectorPort
- Indica o número da porta para uso da função do cliente administrativo. O valor padrão é 8880 para conexões SOAP e 2809 para conexões RMI (Remote Method Invocation).
- -CCadminConnectorType
- Especifica como o cliente administrativo se conecta ao servidor. Especifique RMI para usar o tipo de conexão RMI ou SOAP para usar o tipo de conexão SOAP. O valor padrão é SOAP.
- -CCadminConnectorUser
- Os clientes administrativos utilizam este nome de usuário quando um servidor requer autenticação. Se o tipo de conexão for SOAP e a segurança estiver ativada no servidor, este parâmetro será exigido.
- -CCadminConnectorPassword
- A senha para o nome do usuário especificado pelo parâmetro -CCadminConnectorUser.
- -CCaltDD
- O nome de um arquivo descritor de implementação alternativo. Este parâmetro é utilizado com o parâmetro -CCjar para especificar o descritor de implementação a ser utilizado. Utilize este argumento quando um arquivo JAR de cliente estiver configurado com mais de um descritor de implementação. Defina o valor como null para utilizar o descritor de implementação padrão do arquivo JAR do cliente.
- -CCBootstrapHost
- O nome do servidor host ao qual você deseja se conectar inicialmente. O formato é: your_server_of_choice.com
- -CCBootstrapPort
- O número da porta do servidor. Se você não especificar esse argumento, o valor padrão do WebSphere Application Server será usado.
- -CCclassLoaderMode
- Especifica o modo do carregador de classes. Se PARENT_LAST
for especificado, o carregador de classes carregará as classes do caminho
de classe local antes de delegar o carregamento de classe a seu pai. As
classes carregadas para o seguinte são afetadas:
- Classes definidas para o aplicativo cliente Java EE
- Recursos definidos no aplicativo Java EE
- Classes especificadas no manifesto do arquivo JAR do cliente Java EE
- Classes especificadas utilizando a opção -CCclasspath
- -CCclasspath
- Um valor de caminho de classe. Quando um aplicativo é ativado, o caminho de classe do sistema é utilizado. Se você quiser acessar classes que não estão no arquivo EAR ou parte dos caminhos de classes do sistema, especifique o caminho de classe apropriado aqui. Vários caminhos podem ser concatenados.
- -CCD
- Use essa opção para que o WebSphere Application Server defina a propriedade do sistema especificada durante a inicialização. Não utilize o caractere igual (=) após o -CCD. Por exemplo: -CCDcom.ibm.test.property=testvalue. É possível especificar vários parâmetros -CCD. O formato geral deste parâmetro é -CCD<property key>=<property value>. Por exemplo, -CCDI18NService.enable=true.
- -CCdumpJavaNameSpace
- Controla a geração de um dump do java: espaço de nomes para o aplicativo que é ativado, que pode ser utilizado para depurar propostas. Um valor true gera um dump no formato abreviado e inclui o nome e o tipo de objeto para cada ligação. Um valor longo gera um dump para um formato longo e inclui informações adicionais para cada ligação no formato curto, como o tipo de objeto local e a representação de cadeia do objeto local. O valor padrão é false, e não gera um dump.
- -CCexitVM
- Use essa opção para que o WebSphere Application Server chame o método System.exit() após o aplicativo cliente ser concluído. O padrão é false.
- -CCinitonly
- Utilize esta opção para inicializar o tempo de execução do cliente aplicativo para clientes aplicativos ActiveX sem ativar o aplicativo cliente. O padrão é false.
- -CCjar
- O nome do arquivo JAR (Java Archive) cliente que reside dentro do arquivo EAR para o aplicativo que você deseja ativar. Utilize este argumento quando tiver vários arquivos JAR de cliente no arquivo EAR.
- -CCpropfile
- Indica o nome de um arquivo de propriedades que contém propriedades de launchClient. Especifique as propriedades sem o prefixo -CC no arquivo, com exceção das propriedades securityManager, securityMgrClass e securityMgrPolicy. Veja o seguinte exemplo: verbose=true.
- -CCproviderURL
- Fornece informações sobre o servidor de
bootstrap que a fábrica de contexto inicial pode usar para obter um contexto
inicial. O factory de contexto inicial do WebSphere Application Server pode usar uma URL do objeto
Common Object Request Broker Architecture (CORBA) ou uma URL do Internet Inter-ORB Protocol (IIOP). Os URLs de objeto CORBA são mais flexíveis que os URLs de IIOP e são o formato de URL
recomendado paro uso. Este valor pode conter
mais de um endereço de servidor de bootstrap. Esse recurso pode ser utilizado ao tentar
obter um contexto inicial de um cluster de servidores. É possível especificar na URL endereços de servidores de
bootstrap para todos os servidores no cluster. A operação obterá êxito se pelo menos um dos servidores estiver em execução,
eliminando um ponto único de falha. A lista de endereços não é processada em uma ordem determinada. Para operações de nomes, este valor substitui os parâmetros -CCBootstrapHost e -CCBootstrapPort.
Um URL de objeto CORBA especificando vários sistemas é ilustrado no seguinte exemplo:
Este valor é mapeado para a propriedade do sistema java.naming.provider.url.-CCproviderURL=corbaloc:iiop:myserver.mycompany.com:9810,:mybackupserver.mycompany.com:2809
- -CCsecurityManager
- Ativa e executa o WebSphere Application Server com um gerenciador de segurança. O padrão é disable.
- -CCsecurityMgrClass
- Indica o nome completo de uma classe que implementa um gerenciador de segurança. Utilize esse argumento apenas se o parâmetro -CCsecurityManager estiver definido como enable. O padrão é java.lang.SecurityManager.
- -CCsecurityMgrPolicy
- O nome de um arquivo de política do gerenciador de segurança. Utilize esse argumento apenas se o parâmetro -CCsecurityManager estiver definido como enable. Quando este parâmetro é ativado, a propriedade do sistema java.security.policy é definida. O padrão é app_server_root/properties/client.policy.
- -CCsoapConnectorPort
- A porta do conector SOAP (Simple Object Access Protocol). Se você não especificar esse argumento, o valor padrão do WebSphere Application Server será usado.
- -CCtrace
- Utilize esta opção para depurar informações de rastreio. Talvez você precise dessas informações ao relatar um problema ao suporte ao clienteIBM®. O padrão é false. Para obter informações adicionais, consulte o tópico Ativando rastreio.
- -CCtracefile
- Indica o nome do arquivo para o qual as informações sobre rastreio são gravadas. O padrão é gravar a saída para o console.
- -CCtraceMode
- Especifica o formato de rastreio a ser utilizado. Se o valor válido,
basic, não for especificado, o padrão é avançado. O formato
de rastreio básico é uma forma de rastreio mais compacta.
Para obter informações adicionais sobre a formatação de rastreio básico e avançado, consulte o tópico Interpretando a Saída de Rastreio.
- -CCverbose
- Esta opção exibe mensagens com informações adicionais. O padrão é falso.
Se você estiver utilizando um aplicativo cliente EJB com a segurança ativada, edite o arquivo sas.client.props, que está localizado no diretório profile_root/properties. Dentro do arquivo, altere o valor com.ibm.CORBA.loginSource para none.
Para obter mais informações sobre o utilitário sas.client.props, consulte os tópicos Codificando manualmente as senhas nos arquivos de propriedades e o comando PropFilePasswordEncoder.
- Conexão RMI com segurança. Utilizada com o aplicativo cliente EJB e administrativo.
- Utilizando Jacl:
wsadmin -conntype RMI -port rmiportnumber -user userid -password password
wsadmin.sh -conntype RMI -port rmiportnumber -user userid -password password
Utilizando Jython:
wsadmin -lang jython -conntype RMI -port rmiportnumber -user userid -password password
wsadmin.sh -lang jython -conntype RMI -port rmiportnumber -user userid -password password
O rmiportnumber para sua conexão é exibido no console administrativo como BOOTSTRAP_ADDRESS.
Atenção: Nos sistemas operacionais AIX, HP-UX, Linux, IBM i, Solaris e z/OS, o uso da opção -password pode resultar na exposição de segurança como as informações de senha tornarem-se visíveis para o programa de status do sistema, como um comando ps, que pode ser chamado por outros usuários para exibir todos os processos em execução. Não utilize essa opção, se a exposição da segurança for um problema. Em vez disso, especifique as informações de usuário e senha no arquivo soap.client.props para o conector SOAP ou no arquivo sas.client.props para o conector RMI. Os arquivos soap.client.props e sas.client.props estão localizados no diretório de propriedades do seu perfil do WebSphere Application Server.Se o Kerberos (KRB5) for ativado para autenticação administrativa, o destino de autenticação suportará BasicAuth e KRB5. Para utilizar o KRB5, atualize os arquivos sas.client.props, soap.client.props e ipc.client.props, de acordo com o tipo de conector.
Atenção: Ao utilizar a autenticação do Kerberos, a senha de usuário não flui pela transmissão. Um hash unidirecional da senha é utilizado para identificar o cliente.
Os exemplos a seguir demonstram a sintaxe correta.
![[Windows]](../images/windows.gif)
launchClient c:\earfiles\myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2
![[AIX HP-UX Solaris]](../images/unix.gif)
![[z/OS]](../images/ngzos.gif)
./launchClient.sh /usr/earfiles/myapp.ear -CCBootstrapHost=myWASServer
-CCverbose=true app_parm1 app_parm2
![[IBM i]](../images/iseries.gif)
/QIBM/ProdData/WebSphere/AppServer/V61/Base/bin/launchClient /home/earfiles/myapp.ear
-profileName myprofile -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2