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. Além disso, a opção Especificar Ligações a Serem Utilizadas é exibida apenas ao atualizar um aplicativo instalado.
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. |
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.
Opção | Descrição |
---|---|
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 aplicativo ou módulo instalado e atualizado não possuírem um valor de ligação, o valor-padrão será usado. O produto designa 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 a partir da versão atualizada do aplicativo ou do módulo serão ignoradas se uma ligação existir na versão instalada. Caso contrário, as novas ligações serão usadas e não ignoradas. |
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.
Se você selecionar Gerar Ligações Padrão, o produto gerará ligações conforme a seguir:
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:
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.
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.
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>
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>
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>
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>
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 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 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>
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.
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.
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.
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.