Comando endptEnabler

O comando endptEnabler é usado para ativar um conjunto de serviços da Web em um arquivo archive corporativo (EAR). O comando endptEnabler deve ser executado nos arquivos EAR contendo módulos do Enterprise JavaBeans (EJB) que são ativados para os serviços da Web.

Cada módulo do roteador fornece um terminal de serviço da Web para um transporte particular. Por exemplo, é possível incluir um módulo do roteador HTTP para que o serviço da Web possa receber solicitações sobre o transporte HTTP. Ou é possível incluir um módulo do roteador Java™ Message Service (JMS) para que o serviço da Web possa receber solicitações de uma fila ou tópico JMS.

No seu modo interativo, o comando endptEnabler o guiará pelas etapas requeridas para ativar um ou mais serviços em um aplicativo. O comando endptEnabler faz uma cópia de backup de seu arquivo EAR original caso seja necessário remover ou incluir serviços posteriormente. Se seu arquivo EAR contiver um arquivo Java archive (JAR) enterprise bean que esteja ativado para os serviços da Web, deverá executar o comando endptEnabler antes que o arquivo EAR seja implementado. Caso contrário, não é necessário executar o comando.

Evitar Problemas Evitar Problemas: No shell script endptEnabler.sh, o script termina com EXIT 0. Não use este código de retorno para determinar o resultado de execução do script.gotcha

Sintaxe de Uso do endptEnabler

Chame o comando endptEnabler pelo diretório binário do WebSphere Application Server. A sintaxe do comando é apresentada no seguinte exemplo:
endptEnabler
    [-verbose|-v]
    [-quiet|-q]
    [-help|-h|-?]
    [-properties|-p properties-filename]
    [-transport|-t default-transports]
    [-enableHttpRouterSecurity]
    [-enableClientCertSecurity]
    [ear-filename]
    [-classpath|-cp]
Todos os parâmetros são opcionais e descritos na lista a seguir:
-verbose, -v
Esse parâmetro detalha e exibe as mensagens de progresso à medida que a ferramenta endptEnabler processa o arquivo EAR. Essa opção da linha de comandos é mapeada para a propriedade global verbose.
-quiet, -q
Esse parâmetro verifica se não há nenhuma exibição das mensagens de progresso por módulo à medida que a ferramenta endptEnabler processa o arquivo EAR. Essa opção da linha de comandos é mapeada para a propriedade global quiet.
-help, -h, -?
Esse parâmetro exibe uma breve mensagem de ajuda que explica as várias opções.
-properties, -p <properties-filename>
Esse parâmetro lê as propriedades a partir das propriedades properties-filename e controla o comportamento da ferramenta endptEnabler.
-transport, -t <default-transports>
Esse parâmetro especifica a lista padrão de transportes para os quais os módulos do roteador são criados para cada arquivo JAR de enterprise bean contido no arquivo EAR. Esta opção da linha de comandos é mapeada para a propriedade global defaultTransports. Estes são exemplos desse parâmetro:
-transport http (o padrão)
-transport jms
-t http,jms
-enableHttpRouterSecurity
Esse parâmetro permite incluir uma política de segurança para todos os usuários autenticados para proteger o módulo roteador HTTP se todos os módulos EJB estiverem seguros no arquivo JAR do enterprise bean. Esta opção da linha de comandos é mapeada para a propriedade global http.enableRouterSecurity.
-enableClientCertSecurity
Este parâmetro permite incluir a sub-rotina login-config a seguir no arquivo web.xml para autenticação de certificado, em vez de basic-auth ou form-login. Esta opção da linha de comandos é mapeada para a propriedade global http.enableClientCertSecurity.
<login-config>
  <auth-method>CLIENT-CERT</auth-method>
</login-config>
Boas Práticas Boas Práticas: Use o parâmetro -enableClientCertSecurity com o parâmetro -enableHttpRouterSecurity.bprac
<ear-filename>
Esse parâmetro especifica o nome do arquivo EAR a ser processado.

Se o parâmetro ear-filename não for inserido na linha de comandos, o modo interativo será utilizado. No modo interativo, é solicitado que você forneça o nome do arquivo EAR, os nomes dos módulos roteadores e outros valores importantes à medida que o processamento ocorre. O diálogo a seguir é um exemplo do modo interativo endptEnabler.

Nesse diálogo, a entrada do usuário está na fonte de largura fixa e a saída do endptEnabler está em negrito.

endptEnabler<enter>   
WSWS2004I: IBM WebSphere Application Server Release 5 
WSWS2005I: Ferramenta de Ativador de Nó de Extremidade do Web Services Enterprise Archive. 
WSWS2007I: (C) COPYRIGHT International Business Machines Corp. 1997, 2003 
WSWS2006I: Digite o nome do arquivo EAR: AddressBook.ear<enter>   

WSWS2003I: Fazendo backup do arquivo EAR para: AddressBook.ear~   

WSWS2016I: Carregando o arquivo EAR: AddressBook.ear 
WSWS2017I: Módulo da Web localizado: AddressBookEJB.jar

WSWS2029I: Insira o nome do roteador http para o Módulo EJB AddressBookEJB 
[AddressBookEJB_HTTPRouter.war]:<enter>
WSWS2030I: Digite a raiz de contexto http para o Módulo EJB AddressBookEJB 
[/AddressBookEJB]:<enter>
WSWS2024I: Incluindo o roteador http para o Módulo EJB AddressBookEJB.jar. 
WSWS2036I: Salvando o arquivo EAR AddressBook.ear... 
WSWS2037I: Concluído o salvamento do arquivo EAR. 
WSWS2018I: Concluído o processamento do arquivo EAR AddressBook.ear.

Se o parâmetro ear-filename for inserido na linha de comandos, o modo não-interativo será utilizado. No modo não-interativo, os nomes de módulos roteadores e outros valores importantes são determinados a partir de propriedades especificadas pelo usuário ou valores padrão.

-classpath, -cp
Este parâmetro permite especificar arquivos JAR separados no caminho da classe para o comando endptEnabler. Use este parâmetro se o arquivo EJB fizer referência a tipos Java em arquivos JAR separados, que não existem no arquivo EAR. Podem ser especificados vários valores para este parâmetro. Por exemplo:
endptEnabler -classpath C:\MyWork\Utility.jar;D:\SharedFiles\Hello.zip;HelloWorld.jar

Quando você não especificar este parâmetro, poderá encontrar um erro semelhante à seguinte mensagem:

WSWS2021I: Skipping the enterprise bean module module_name 
because it contains no web services.

Propriedades endptEnabler

Com o comando endptEnabler é possível controlar seu comportamento de tempo de execução especificando um conjunto de propriedades com a opção da linha de comandos -properties. Essas propriedades são organizadas de uma das duas formas a seguir: global e por módulo. As propriedades globais afetam o comportamento geral da ferramenta à medida que processa diversos módulos JAR de enterprise bean no arquivo EAR. As propriedades por módulo afetam o processamento de um módulo JAR de enterprise bean específico.

Tabela 1. Propriedades Globais para o Comando endptEnabler. Use essas propriedades globais do comando endptEnabler quando ativar um conjunto de serviços da Web em um arquivo archive corporativo (EAR).
Nome da propriedade Descrição Valor Padrão
detalhado Exibe mensagens de progresso detalhadas. Falso
quiet Exibe breves mensagens de progresso. Falso
http.enableRouterSecurity Permite incluir uma política de segurança para todos os usuários autenticados para proteger o módulo roteador HTTP se todos os módulos EJB estiverem seguros no arquivo JAR do enterprise bean. Falso
http.enableClientCertSecurity Permite incluir a sub-rotina login-config a seguir no arquivo web.xml para autenticação de certificado, em vez de basic-auth ou form-login:
<login-config>
  <auth-method>CLIENT-CERT</auth-method>
</login-config>
Falso
http.routerModuleNameSuffix Especifica o sufixo utilizado para construir nomes de módulos roteadores HTTP padrão. A extensão .war é incluída pelo comando endptEnabler. _HTTPRouter
jms.routerModuleNameSuffix Especifica o sufixo utilizado para construir nomes de módulos roteadores JMS padrão. A extensão .jar é incluída pelo comando endptEnabler. _JMSRouter
jms.defaultDestinationType Especifica o tipo de destino padrão a ser utilizado para todos os módulos de roteadores JMS incluídos no arquivo EAR. Este tipo é fila ou tópico. fila
defaultTransports Especifica a lista de transportes padrão para a qual os módulos roteadores são criados. A lista pode conter os valores http e jms. Diversos valores são separados por vírgulas. Por exemplo: http, jms e http,jms. http

A tabela a seguir descreve as propriedades por módulo suportadas pelo comando endptEnabler. A variável ejbJarName refere-se ao nome de um módulo JAR de enterprise bean no arquivo EAR, sem a extensão .jar.

Tabela 2. Propriedades Pré-modulares para o Comando endptEnabler. Use estas propriedades do comando endptEnabler que afetam o processamento de um módulo JAR de enterprise bean específico.
Nome da propriedade Descrição Valor Padrão
<ejbJarName> .transports
Lista os transportes para os quais módulos roteadores são criados para um arquivo JAR de enterprise bean específico. A lista pode conter os valores http e jms. Diversos valores são separados por vírgulas. Por exemplo: http, jms e http,jms. http
<ejbJarName>.http.skip
Especifica o sinalizador que ignora a inclusão de um módulo roteador HTTP, mesmo que seja incluído de modo diferente com base em outras propriedades. Os valores válidos são true e false. false
<ejbJarName> 
.http.routerModuleName
Especifica o nome do módulo roteador HTTP para um determinado arquivo JAR de enterprise bean. ejbJarName_HTTPRouter
<ejbJarName> .http.contextRoot
Especifica a raiz de contexto associada ao nome do módulo roteador HTTP para um determinado arquivo JAR de enterprise bean. /ejbJarName
<ejbJarName>.jms.skip
Especifica o sinalizador que ignora a inclusão de um módulo roteador JMS mesmo que seja incluído de modo diferente com base em outras propriedades. Os valores válidos são true e false. false
<ejbJarName>.jms.
routerModuleName
Especifica o nome do módulo roteador JMS para um determinado arquivo JAR de enterprise bean. ejbJarName_JMSRouter
<ejbJarName>.jms.
activationSpecJndiName
Especifica o nome de JNDI (Java Naming and Directory Interface) da especificação de ativação configurada para o MDB (Message Driven Bean) no módulo roteador JMS. nulo
<ejbJarName>.jms.
listenerInputPortName
Especifica o nome da porta listener a ser configurada para o MDB no módulo roteador JMS. A porta listener é configurada apenas se uma propriedade activationSpecJndiName não for especificada. nulo
<ejbJarName>.jms.destinationType
Especifica o tipo de destino JMS associado ao MDB no roteador JMS. Os valores válidos são fila e tópico. fila
<ejbJarName>.<port_local_name>
.http.urlPattern=
<url_pattern_name>
Especifica o padrão de URL para portas. Se você tiver o módulo EJB com o nome indicado que tenha uma porta com o nome local indicado, poderá especificar o padrão da URL HTTP com essa propriedade. Essa propriedade só se aplica aos módulos roteadores HTTP. Ela não afeta os módulos roteadores de JMS. nulo

Exemplo de Propriedades

Suponha um arquivo EAR contendo um arquivo JAR enterprise bean chamado StockQuoteEJB.jar que contenha serviços da Web. O conjunto de propriedades a seguir pode ser usado para controlar o comportamento do tempo de execução do comando endptEnabler conforme ele processa o arquivo EAR:
StockQuoteEJB.transports=http,jms

StockQuoteEJB.http.routerModuleName=StockQuoteEJB_HTTP

StockQuoteEJB.http.contextRoot=/StockQuote

StockQuoteEJB.jms.routerModuleName=StockQuoteEJB_JMS

StockQuoteEJB.jms.destinationType=queue

Exemplos de endptEnabler

Os comandos a seguir são exemplos de como o comando endptEnabler pode ser utilizado:
endptEnabler MyApp.ear

endptEnabler -t jms,http MyApp.ear

endptEnabler -v -properties MyApp.props MyApp.ear

endptEnabler -q -t jms MyApp.ear

endptEnabler -v -t http,jms

Í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=rwbs_earenablerprompts
Nome do arquivo: rwbs_earenablerprompts.html