Preparando as Configurações de Ligação de Instalação do Aplicativo

Utilize essa página para selecionar se todas as opções de instalação devem ser visualizadas e para alterar as ligações existentes para seu aplicativo ou módulo durante a instalação. É possível escolher gerar ligações padrão para todas as ligações incompletas no aplicativo ou módulo, ou escolher designar ligações específicas durante a instalação.

Esta é a segunda página Preparando a Instalação do Aplicativo.

Para visualizar essa página do console administrativo, clique em Aplicativos > Novo Aplicativo > Novo Aplicativo Corporativo, especifique o caminho para o aplicativo ou módulo a ser instalado e, em seguida, clique em Avançar.

A página do console poderá não exibir todas as opções de ligação listadas neste tópico. O conteúdo do aplicativo ou módulo que você está instalando determina quais opções são exibidas na página do console. Além disso, a opção Especificar Ligações a Serem Utilizadas é exibida apenas ao atualizar um aplicativo instalado.

Como deseja instalar o aplicativo?

Especifica se serão mostradas somente as opções de instalação que requerem o fornecimento de informações ou todas as opções de instalação.

Tabela 1. Descrições de Opções de Instalação. É possível selecionar um Atalho ou selecionar para ver todas as opções e parâmetros de instalação.
Opção Descrição
Atalho - Exibir prompt apenas quando informações adicionais forem necessárias Exibe apenas as opções que requerem sua atenção, com base no conteúdo de seu aplicativo ou módulo. Utilize o atalho para instalar seu aplicativo mais facilmente, uma vez que não é necessário examinar todas as opções de instalação disponíveis.
Detalhado - Mostrar todas as opções e os parâmetros de instalação Exibe todas as opções de instalação disponíveis.

Especificar ligações a serem utilizadas

Especifica se as ligações serão fundidas quando você atualizar os aplicativos ou se serão utilizadas ligações novas ou existentes.

Essa configuração será mostrada apenas quando você atualizar um aplicativo instalado e não quando instalar um novo aplicativo.

Tabela 2. Descrições de Opções de Ligação. É possível usar ligações mescladas, novas ou existentes.
Opção Descrição
Fundir ligações novas e existentes As informações sobre ligação do aplicativo ou dos módulos atualizados são preferidas às informações sobre ligação correspondentes da versão instalada. Se algum elemento da ligação estiver ausente na versão atualizada, o elemento correspondente da versão instalada será usado. Se ambos os aplicativos ou módulos, instalados e atualizados, não tiverem um valor de ligação, o valor-padrão será usado. O produto designará um valor-padrão apenas se você selecionar a opção Gerar ligações padrão.
Utilizar Novas Ligações As informações sobre ligação no aplicativo ou módulo atualizado são usadas. As informações sobre ligação da versão atualizada do aplicativo ou do módulo são preferidas às informações sobre ligação correspondentes na versão instalada. As informações sobre ligação da versão instalada do aplicativo ou do módulo são ignoradas.
Utilizar Ligações Existentes As informações sobre ligação da versão instalada do aplicativo ou do módulo são preferidas às informações sobre ligação correspondentes da versão atualizada. Se algum elemento das informações sobre ligação não existir na versão instalada, o elemento da versão atualizada será usado. Ou seja, as ligações da versão atualizada do aplicativo ou do módulo serão ignoradas se existir uma ligação na versão instalada. Caso contrário, as novas ligações serão aceitas e não ignoradas.

Gerar Ligações Padrão

Especifica se ligações e mapeamentos padrão devem ser gerados. Para visualizar essa configuração, expanda Escolher gerar ligações e mapeamentos padrão. Se você selecionar Gerar Ligações Padrão, o produto completará quaisquer ligações incompletas no aplicativo com valores padrão. O produto não altera as ligações existentes.

Depois de selecionar Gerar Ligações Padrão, será possível avançar diretamente para a etapa Resumo e instalar o aplicativo se nenhuma das etapas tiver um asterisco vermelho (*). Um asterisco vermelho denota que a etapa possui dados incompletos e requer um valor válido. Na página de Resumo, verifique a célula, o nó e o servidor nos quais o aplicativo está instalado.

transição: Não é necessário especificar valores Java Naming and Directory Interface (JNDI) para o bean EJB, o início local, o início remoto ou as interfaces de negócios de módulos EJB 3.0 ou posterior. O produto atribui valores padrão do contêiner durante o tempo de execução. De forma semelhante, para qualquer referência EJB em um módulo EJB 3.0, da Web 2.4 ou da Web 2.5, não é necessário especificar os valores de JNDI porque o produto resolve os destinos automaticamente durante o tempo de execução. Mesmo se selecionar Criar ligações padrão, o produto não criará valores padrão para esses valores de JNDI, mas criará valores padrão para outras ligações, como o host virtual.

Se você selecionar Gerar Ligações Padrão, o produto gerará ligações conforme a seguir:

  • Os nomes JNDI de enterprise bean (EJB) são gerados no formato prefixo/ejb-name. O prefixo padrão é ejb, mas pode ser substituído. O ejb-name é conforme o especificado na tag <ejb-name> dos descritores de implementação ou em sua anotação correspondente para módulos EJB 3.0 ou posteriores. O produto não gera valores-padrão para enterprise beans em um módulo EJB 3.0 ou posterior porque o tempo de execução fornece valores-padrão do contêiner.
  • As referências do EJB serão ligadas se um <ejb-link> for localizado. Caso contrário, se for encontrado um enterprise bean com uma interface inicial correspondente (ou início local) como o bean referido, a referência será resolvida automaticamente. O produto não gera valores-padrão para referência EJB em um módulo EJB 3.0, EJB 3.1, da Web 2.4 ou da Web 2.5 porque o tempo de execução fornece valores-padrão do contêiner ou resolve automaticamente as referências de destino.
  • As ligações de referência de recurso são derivadas da identificação <res-ref-name> ou sua anotação correspondente para os módulos Java EE 5 ou 6h. Essa ação presume que o nome java:comp/env é igual ao nome JNDI global do recurso.
  • As ligações de connection factory para arquivos JAR do EJB 2.0 e EJB 2.1 são geradas com base no nome JNDI e nas informações de autorização fornecidas. Essa ação resulta em configurações padrão de connection factory para cada arquivo JAR do EJB 2.0 e EJB 2.1 no aplicativo que está sendo instalado. Nenhuma ligação da fábrica de conexões no nível do bean será gerada.
  • As ligações de origem de dados para arquivos JAR EJB 1.1 são geradas com base no nome de JNDI, no nome de usuário da origem de dados e nas opções de senha. Essa ação resulta em configurações padrão da origem de dados para cada arquivo JAR. Nenhuma ligação da origem de dados no nível do bean será gerada.
  • Para beans acionados por mensagens EJB 2.0, ou posterior, implementados como recursos compatíveis com o JCA (Java EE Connector Architecture) 1.5, os nomes JNDI correspondentes às instâncias activationSpec são gerados no formato eis/MDB_ejb-name. As referências de destino de mensagem serão ligadas se um <message-destination-link> for localizado, em seguida, o nome JNDI será configurado como ejs/message-destination-linkNome. Caso contrário, o nome JNDI será configurado para eis/message-destination-refNome.
  • Para beans acionados por mensagens EJB 2.0, ou posterior, implementados para portas listener, as portas listener são derivadas da tag <ejb-name> do bean acionado por mensagens com a cadeia Port anexada.
  • Para arquivos .war, o host virtual é configurado como default_host, a menos que especificado de outra maneira.

A estratégia padrão será suficiente para a maioria dos aplicativos ou pelo menos para a maioria das ligações na maioria dos aplicativos. Entretanto, se você encontrar erros, execute as seguintes ações:

  • Controle os nomes JNDI globais de um ou mais arquivos EJB.
  • Controle as ligações de origem de dados para beans CMP (Container-Managed Persistence). Ou seja, você tem várias origens de dados e precisa mais de uma origem de dados global.
  • Mapeie referências de recurso para nomes JNDI do recurso global que sejam diferentes do nome java:comp/env.

Nesses casos, é possível alterar o comportamento com um documento XML, que é uma estratégia customizada. Utilize a configuração Arquivo de Ligações Específico para especificar uma estratégia customizada e ver a descrição da configuração nesse arquivo de ajusta para obter exemplos.

Substituir ligações existentes

Especifica se as ligações geradas devem substituir as ligações existentes.

O padrão é não substituir as ligações existentes. Selecione Substituir Ligações Existentes para permitir que as ligações geradas substituam as ligações existentes.

Substituir Ligações Existentes é semelhante à opção de script -defaultbinding.force.

Usar ligações padrão Java EE

Especifica se as ligações geradas devem usar a opção de recursos padrão pré-configurados para as ligações do Java Platform, Enterprise Edition (Java EE).

O padrão é não usar os recursos padrão pré-configurados para ligações Java EE. Selecione Usar ligações padrão Java EE para que as ligações geradas sejam padrões Java EE.

Usar as ligações padrão EE é semelhante à opção de script -defaultbinding.ee.defaults.

Arquivo de Ligações Específicas

Especifica um arquivo de ligações que substitui a ligação padrão.

Substituir Ligações Específicas é semelhante à opção de script -defaultbinding.strategy.file.

Altere o comportamento da ligação padrão com um documento XML, que é uma estratégia customizada. As estratégias personalizadas estendem a estratégia padrão para que você precise personalizar somente aquelas áreas onde a estratégia padrão é insuficiente. Portanto, é necessário apenas descrever como deseja alterar as ligações geradas pela estratégia padrão; não é necessário definir ligações para todo o aplicativo.

Utilize os seguintes exemplos para substituir os diversos aspectos do gerador de ligações padrão:

Controlando um nome JNDI do EJB
<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>helloEjb.jar</jar-name>
      <ejb-bindings>
        <ejb-binding>
         <ejb-name>HelloEjb</ejb-name>
         <jndi-name>com/acme/ejb/HelloHome</jndi-name>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>
Lembre-se: Certifique-se de que a configuração para <ejb-name> corresponda à entrada ejb-name no descritor de implementação JAR de EJB. Aqui a configuração é <ejb-name>HelloEjb</ejb-name>.
Configurando a ligação da connection factory para um arquivo JAR EJB
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>yourEjb20.jar</jar-name>
      <connection-factory>
        <jndi-name>eis/jdbc/YourData_CMP</jndi-name>
        <res-auth>Container</res-auth>
      </connection-factory>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>
Configurando a ligação da connection factory para um arquivo EJB
<?xml version="1.0">
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>yourEjb20.jar</jar-name>
      <ejb-bindings>
        <ejb-binding>
          <ejb-name>YourCmp20</ejb-name>
          <connection-factory>
           <jndi-name>eis/jdbc/YourData_CMP</jndi-name>
           <res-auth>PerConnFact</res-auth>
          </connection-factory>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
 </module-bindings>
</dfltbndngs>
Restrição: Certifique-se de que a configuração para <ejb-name> corresponda à tag ejb-name no descritor de implementação. Aqui a configuração é <ejb-name>YourCmp20</ejb-name>.
Configurando o JNDI de referência do destino da mensagem para um enterprise bean específico

Este exemplo mostra uma extração XML em um arquivo de estratégia customizada para configurar message-destination-refs para um enterprise bean específico.

<?xml version="1.0">
 <!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
 <dfltbndngs>
  <module-bindings>
   <ejb-jar-binding>
    <jar-name>yourEjb21.jar</jar-name>
    <ejb-bindings>
     <ejb-binding>
      <ejb-name>YourSession21</ejb-name> 
      <message-destination-ref-bindings>
       <message-destination-ref-binding>
        <message-destination-ref-name>jdbc/MyDataSrc</message-destination-ref-name>
        <jndi-name>eis/somAO</jndi-name>
       </message-destination-ref-binding>
      </message-destination-ref-bindings>
     </ejb-binding>
    </ejb-bindings>
   </ejb-jar-binding>
  </module-bindings>
 </dfltbndngs>
Restrição: Certifique-se de que a configuração para <ejb-name> corresponda à tag ejb-name no descritor de implementação. Aqui a configuração é <ejb-name>YourSession21</ejb-name>. Certifique-se também de que a configuração para <message-destination-ref-name> corresponda à tag message-destination-ref-name no descritor de implementação. Aqui a configuração é <message-destination-ref-name>jdbc/MyDataSrc</message-destination-ref-name>.
Substituindo uma ligação de referência de recurso a partir de um arquivo WAR, arquivo JAR EJB ou arquivo JAR do cliente Java EE

Este exemplo mostra o código para substituir uma ligação de referência de recurso a partir de um arquivo WAR. Utilize um código semelhante para substituir uma ligação de referência de recurso de um arquivo JAR do enterprise bean (EJB) ou um arquivo JAR do cliente Java EE.

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <war-binding>
      <jar-name>hello.war</jar-name>
      <resource-ref-bindings>
        <resource-ref-binding>
          <resource-ref-name>jdbc/MyDataSrc</resource-ref-name>
          <jndi-name>war/override/dataSource</jndi-name>
        </resource-ref-binding>
      </resource-ref-bindings>
    </war-binding>
  </module-bindings>
</dfltbndngs>
Restrição: Certifique-se de que a configuração para <resource-ref-name> corresponda à tag resource-ref no descritor de implementação. No exemplo anterior, a configuração é <resource-ref-name>jdbc/MyDataSrc</resource-ref-name>.
Substituindo o nome JNDI para um bean acionado por mensagens implementado como um recurso compatível com JCA 1.5

Este exemplo mostra uma extração XML em um arquivo de estratégia customizado para substituir o nome JNDI activationSpec do Java Message Service (JMS) para um bean acionado por mensagens EJB 2.0 ou posterior implementado como um recurso compatível com JCA 1.5.

<?xml version="1.0"?>
 <!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
  <dfltbndngs>
  <module-bindings>
   <ejb-jar-binding>
     <jar-name>YourEjbJar.jar</jar-name>
     <ejb-bindings>
      <ejb-binding>
        <ejb-name>YourMDB</ejb-name>
        <activationspec-jndi-name>activationSpecJNDI</activationspec-jndi-name>
      </ejb-binding>
     </ejb-bindings>
   </ejb-jar-binding>
  </module-bindings>
 </dfltbndngs>
Substituindo o nome da porta do listener JMS para um bean acionado por mensagens EJB 2.0, 2.1 ou 3.0

Este exemplo mostra uma extração XML em um arquivo de estratégia customizada para substituir o nome da porta listener do JMS para um bean acionado por mensagens EJB 2.0, ou posterior, implementado como uma porta listener.

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>YourEjbJar.jar</jar-name>
      <ejb-bindings>
        <ejb-binding>
          <ejb-name>YourMDB</ejb-name>
          <listener-port>yourMdbListPort</listener-port>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>
Substituindo uma ligação de referência EJB a partir de um arquivo JAR EJB, arquivo WAR ou arquivo EJB

Este exemplo mostra o código para substituir uma ligação de referências do EJB de um arquivo JAR do EJB. Utilize um código semelhante para substituir uma ligação de referências do EJB a partir de um arquivo WAR ou de um arquivo EJB.

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>YourEjbJar.jar</jar-name>
      <ejb-ref-bindings>
        <ejb-ref-binding>
          <ejb-ref-name>YourEjb</ejb-ref-name>
          <jndi-name>YourEjb/JNDI</jndi-name>
        </ejb-ref-binding>
      </ejb-ref-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>

Especificar um Prefixo Exclusivo para Beans

Especifica uma cadeia que o produto aplica ao início dos nomes JNDI de enterprise beans gerados. O prefixo deve ser exclusivo na célula ou nó.

O padrão é não especificar um prefixo exclusivo para beans.

Especificar um prefixo exclusivo para beans é semelhante à opção de script -defaultbinding.ejbjndi.prefix.

Ligações Padrão para Beans CMP do EJB 1.1

Especifica o nome JNDI da origem de dados padrão e outras ligações para beans CMP (Container-Managed Persistence) 1.1.

O padrão é não utilizar ligações padrão para beans CMP do EJB 1.1.

Se você selecionar Ligações padrão para beans CMP do EJB 1.1, especifique o nome JNDI para a origem de dados padrão a ser utilizada com os beans CMP 1.1. Especifique também o nome de usuário e a senha para essa origem de dados padrão.

Ligações padrão para beans CMP do EJB 1.1 é semelhante à opção de script -defaultbinding.datasource.jndi.

Ligações de Connection Factory Padrão

Especifica o nome JNDI de connection factory padrão.

O padrão é não utilizar as ligações de connection factory padrão. Selecione Ligações de connection factory padrão para especificar ligações para connection factories.

Se você selecionar Ligações de connection factory padrão, especifique o nome JNDI para o connection factory padrão a ser utilizado. Especifique também se a autorização do recurso é para o aplicativo ou para todo o contêiner.

Ligações de Connection Factory Padrão é semelhante à opção de script -defaultbinding.cf.jndi.

Utilizar Nome de Host Virtual Padrão Para Módulos da Web e SIP

Especifica o host virtual para o módulo da Web (arquivo WAR) ou o Módulo de Protocolo de Inicialização de Sessão (SIP) (arquivo SAR).

O padrão é não utilizar o nome do host virtual padrão para módulos da Web ou SIP. Se Usar Nome do Host Padrão para Módulos da Web e SIP for selecionado, um nome do host padrão deverá ser especificado.

Utilizar nome do host virtual padrão para módulos da Web e SIP é semelhante à opção de script -defaultbinding.virtual.host.


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