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. Você pode optar por gerar ligações padrão para qualquer ligação incompleta no aplicativo ou módulo ou 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.

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.

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 mescladas 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.

Opção Descrição
Mesclar ligações novas e existentes Mantém os valores de ligação existentes do aplicativo instalado e inclui novos valores de ligação no aplicativo atualizado para ligações incompletas. Utilize a mesclagem se seu aplicativo atualizado tiver valores de ligação que diferem dos valores especificados para o aplicativo instalado. O produto designa os valores de ligação na seguinte ordem:
  1. Utilize valores de ligação existentes no aplicativo instalado.
  2. Se o aplicativo instalado não tiver um valor de ligação, utilize o novo valor de ligação.
  3. Se o aplicativo instalado e o aplicativo atualizado não tiverem um valor de ligação, utilize o valor padrão. O produto designará um valor padrão apenas se você selecionar Gerar Ligações Padrão.
Utilizar Novas Ligações Utiliza valores de ligação no aplicativo atualizado. Não utiliza valores de ligação existentes no aplicativo instalado.
Utilizar Ligações Existentes Utiliza valores de ligação existentes no aplicativo instalado. Não utiliza valores de ligação no aplicativo atualizado.
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, você poderá 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. No painel Resumo, verifique a célula, o nó e o servidor no qual o aplicativo está instalado.

transição: Não é necessário especificar valores JNDI (Java Naming and Directory Interface) para as interfaces de bean EJB, de início local, de início remoto ou de negócios dos módulos EJB 3.0. O produto designa 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, Web 2.4 ou Web 2.5, não é necessário especificar valores JNDI porque o produto resolve os destinos automaticamente durante o tempo de execução. Mesmo quando você seleciona Gerar Ligações Padrão, o produto não gera valores padrão para os valores JNDI, mas gera 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 especificado na tag <ejb-name> dos descritores de implementação ou em sua anotação correspondente para módulos EJB 3.0. O produto não gera valores padrão para enterprise beans em um módulo EJB 3.0, pois o tempo de execução fornece valores padrão do contêiner.
  • As referências EJB serão ligadas se um <ejb-link> for localizado. Caso contrário, se for encontrado um bean corporativo 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, Web 2.4 ou Web 2.5, pois 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 tag <res-ref-name> ou de sua anotação correspondente para módulos Java EE (Java Platform, Enterprise Edition). 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 connection factory no nível do bean será gerada.
  • As ligações de origem de dados para arquivos JAR do EJB 1.1 são geradas com base no nome JNDI e nas opções de senha do nome de usuário da origem de dados. 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, você pode 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.

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 customizadas estendem a estratégia padrão para que você precise customizar 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 de connection factory para um arquivo JAR do 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 de 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>.

Definindo o JNDI de referência de destino da mensagem para um bean corporativo 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 de um WAR, arquivo JAR do 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 de JNDI para um bean orientado a mensagens implementado como um recurso compatível com JCA 1.5

Este exemplo mostra uma extração XML em um arquivo de estratégia customizada para substituir o nome JNDI do activationSpec JMS para um bean acionado por mensagens EJB 2.0, ou posterior, implementado como um recurso compatível com o 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 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 de um JAR do EJB, arquivo WAR ou arquivo EJB

Este exemplo mostra o código para substituir uma ligação de referência EJB de um arquivo JAR do EJB. Utilize um código semelhante para substituir uma ligação de referência 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 do Host Virtual Padrão para Módulos da Web e SIP

Especifica o host virtual para o módulo da Web (arquivo WAR) ou módulo SIP (Session Initiation Protocol) (arquivo SAR).

O padrão é não utilizar o nome do host virtual padrão para módulos da Web ou SIP. Se você selecionar Utilizar nome do host virtual padrão para módulos da Web e SIP, especifique um nome de host padrão.

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




Links marcados (on-line) requerem acesso à Internet.

Conceitos relacionados
Tarefas relacionadas
Informações relacionadas
Preparando Definições de Instalação do Aplicativo


Nome do arquivo: urun_rapp_instw_gendefbind.html