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 esta 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ção de instalação. É possível selecionar um Fast Path ou selecionar para ver todas as opções e parâmetros de instalação.
Opção	Description
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ção de ligação. É possível usar ligações mescladas, novas ou existentes.
Opção	Description
Fundir ligações novas e existentes	As informações de ligação a partir do aplicativo ou módulos atualizados têm prioridade sobre as informações de ligação correspondentes a partir da versão instalada. Se qualquer elemento da ligação estiver ausente na versão atualizada, o elemento correspondente a partir 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 de ligação no aplicativo ou módulo atualizado são usadas. As informações de ligação a partir da versão atualizada do aplicativo ou do módulo têm prioridade sobre as informações de ligação correspondentes na versão instalada. As informações de ligação a partir da versão instalada do aplicativo ou do módulo são ignoradas.
Utilizar Ligações Existentes	As informações de ligação a partir da versão instalada do aplicativo ou do módulo têm prioridade sobre as informações de ligação correspondentes na versão atualizada. Se qualquer elemento das informações de 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 esta 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. 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 os valores de Java Naming and Directory Interface (JNDI) para o bean EJB, início local, início remoto ou interfaces de negócios de módulos EJB 3.0 ou posteriores. 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 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 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 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, 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 entregues a partir da tag <res-ref-name> ou de sua anotação correspondente para módulos Java Platform, Enterprise Edition (Java EE) 5 ou 6. 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 e 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.

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 ligações de 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: Assegure-se de que a configuração para <ejb-name> corresponde à entrada de ejb-name no descritor de implementação de EJB JAR. 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: assegure-se de que a configuração para <ejb-name> corresponde à 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: assegure-se de que a configuração para <ejb-name> corresponde à 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: assegure-se de que a configuração para <resource-ref-name> corresponde à 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ê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 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.

Nome do arquivo: urun_rapp_instw_gendefbind.html