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.

Importante: Todos os usuários que executam comandos a partir de um perfil específico devem ter autoridade para modificar arquivos que são criados por outros usuários que usam o mesmo perfil. Caso contrário, um erro de permissão negada será exibido nos arquivos de log. Para evitar este problema, considere uma das seguintes políticas:
  • [AIX Solaris HP-UX Linux Windows][IBM i]Use perfis específicos para autoridades distintas de usuário
  • [z/OS]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]
em que
  • 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.

    [AIX Solaris HP-UX Linux Windows][z/OS]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.

[AIX Solaris HP-UX Linux Windows][z/OS]O padrão é o valor do parâmetro -CCBootstrapHost ou o valor localhost, se o parâmetro -CCBootstrapHost não estiver especificado.

[IBM i]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
Se PARENT_LAST não for especificado, então o modo padrão, PARENT_FIRST, fará com que o carregador de classes delegue o carregamento de classes para seu carregador de classes pai antes de tentar carregar a classe de seu caminho de classe local.
-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:
-CCproviderURL=corbaloc:iiop:myserver.mycompany.com:9810,:mybackupserver.mycompany.com:2809
Este valor é mapeado para a propriedade do sistema java.naming.provider.url.
-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.

[AIX Solaris HP-UX Linux Windows][IBM i]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:
[AIX Solaris HP-UX Linux Windows][IBM i]
wsadmin -conntype RMI -port  rmiportnumber -user userid 
-password password
[z/OS]
wsadmin.sh -conntype RMI -port  rmiportnumber -user userid 
-password password

Utilizando Jython:

[AIX Solaris HP-UX Linux Windows][IBM i]
wsadmin -lang jython -conntype RMI -port  rmiportnumber -user userid 
-password password
[z/OS]
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]
launchClient c:\earfiles\myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2
[AIX HP-UX Solaris][z/OS]
./launchClient.sh /usr/earfiles/myapp.ear -CCBootstrapHost=myWASServer
-CCverbose=true app_parm1 app_parm2
[IBM i]
/QIBM/ProdData/WebSphere/AppServer/V61/Base/bin/launchClient /home/earfiles/myapp.ear
   -profileName myprofile -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rcli_javacmd
Nome do arquivo: rcli_javacmd.html