Preparando Definições de Instalação do Aplicativo

Utilize esta página para instalar um aplicativo (arquivo EAR) ou módulo (arquivo JAR ou WAR).

Para visualizar essa página do console administrativo, clique em Aplicativos > Instalar Novo Aplicativo.

Siga as etapas nesta página para instalar um aplicativo ou módulo. Você deve concluir, no mínimo, a primeira etapa; você deve concluir algumas ou todas as etapas posteriormente, dependendo se estiver instalando um aplicativo, um módulo EJB ou um módulo da Web.

Caminho
Especifica o caminho completo para o arquivo .ear, .jar ou .war para o aplicativo corporativo.

Utilize Caminho local se o navegador e os arquivos do aplicativo estiverem na mesma máquina (independentemente de se o servidor está na máquina também).

Utilize Caminho do Servidor se o arquivo do aplicativo residir em um nó no contexto da célula atual. Somente os arquivos .ear, .jar ou .war são mostrados durante a procura.

Durante a instalação do aplicativo, geralmente é efetuado upload dos arquivos do aplicativo de uma máquina cliente executando o navegador para a máquina servidor executando o console administrativo, onde são implementados. Nesses casos, o navegador da Web que está executando o console administrativo é utilizado para selecionar módulos EAR, WAR ou JAR para efetuar upload para a máquina servidor.

No entanto, em alguns casos, os arquivos do aplicativo residirão no sistema de arquivos de qualquer um dos nós em uma célula. Para que o servidor de aplicativos instale esses arquivos, utilize a opção Caminho do servidor.

Você também pode utilizar a opção para especificar um arquivo de aplicativo que já reside na máquina que está executando o servidor de aplicativos. Por exemplo, o valor de campo no Windows NT poderá ser C:\WebSphere\AppServer\installableApps\test.ear. Se você estiver instalando um módulo WAR independente, também deverá especificar a raiz do contexto.

Raiz de Contexto
Especifica a raiz de contexto do aplicativo da Web (WAR).

Esse campo é utilizado somente para instalar um arquivo WAR independente. A raiz de contexto é combinada com o mapeamento de servlet definido (do arquivo WAR) para compor o URL completo que os usuários digitam para acessar o servlet. Por exemplo, se a raiz do contexto for /gettingstarted e o mapeamento do servlet for MySession, então o URL será http://host:port/gettingstarted/MySession.

Gerar Ligações Padrão
Especifica se irá gerar ligações padrão. Se você colocar uma marca de seleção na caixa de opções, todas as ligações incompletas no aplicativo serão preenchidas com valores padrão. As ligações existentes não serão alteradas.

Escolhendo essa opção, você pode ir diretamente para a etapa Resumo e instalar o aplicativo se nenhuma das etapas tiver um asterisco (*) vermelho ao lado delas. 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.

As ligações são geradas da seguinte forma:

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. No entanto, ela não funcionará se:

Em tais casos, é possível alterar o comportamento com um documento XML (uma estratégia personalizada). Utilize o campo Arquivo de Ligações Específicas para especificar uma estratégia personalizada e ver a ajuda do campo para obter exemplos.

Prefixos
Especifica prefixos para utilizar em nomes JNDI gerados.
Substituir
Especifica se deve substituir ligações existentes.

Se essa caixa de opção estiver selecionada, as ligações existentes serão substituídas pelas geradas.

Ligações CMP do EJB 1.1
Especifica o nome de JNDI da origem de dados padrão.

Se o botão de opções Ligações Padrão para CMPs EJB 1.1 estiver selecionado, especifique o nome de JNDI para a origem de dados padrão a ser utilizada com os beans CMP 1.1. Além disso, especifique o ID do usuário e a senha para essa origem de dados padrão.

Ligações de Fábrica de Conexão
Especifica o nome de JNDI da origem de dados padrão.

Se o botão de opções Ligações da Fábrica de Conexões Padrão estiver selecionado, especifique o nome de JNDI para a origem de dados padrão a ser utilizada com as ligações. Além disso, especifique a autorização de recurso.

Host Virtual
Especifica o host virtual para os módulos WAR.
Arquivo de Ligações Específicas
Especifica um arquivo de ligações que substitui a ligação padrão.

Altere o comportamento da ligação padrão com um documento XML (estratégia personalizada (aka). 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. Ou seja, você precisa descrever apenas como deseja alterar as ligações geradas pela estratégia padrão; não é necessário definir ligações para o aplicativo inteiro.

A seguir há exemplos breves de como substituir vários aspectos do gerador de ligações padrão:

Controlando um nome de JNDI do EJB

<?xml version="1.0"?>
<!DOCTYPE dfltbndngs SYSTEM "dfltbndngs.dtd">
<dfltbndngs>
  <module-bindings>
    <ejb-jar-binding>
      <jar-name>helloEjb.jar</jar-name>
<!-- esse nome deve corresponder ao nome do módulo no arquivo .ear -->
      <ejb-bindings>
        <ejb-binding>
         <ejb-name>HelloEjb</ejb-name>
<!-- deve corresponder à entrada <ejb-name> no DD jar do EJB -->
         <jndi-name>com/acme/ejb/HelloHome</jndi-name>
        </ejb-binding>
      </ejb-bindings>
    </ejb-jar-binding>
  </module-bindings>
</dfltbndngs>

Definindo a ligação da fábrica de conexões para um arquivo JAR de 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>

Definindo a ligação da fábrica de conexões para um arquivo de 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>
<!-- corresponde à marcaçao ejb-name no DD -->
          <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>

Substituindo uma Ligação de Referência de Recurso de um arquivo WAR, JAR de EJB ou arquivo JAR do cliente J2EE

A seguir está o código de exemplo para substituir uma Ligação de Referência de Recurso de um arquivo WAR. Utilize código semelhante para substituir uma Ligação de Referência de Recurso de um arquivo JAR de EJB (bean corporativo) ou um arquivo JAR de cliente J2EE.

<?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>
          <!-- o seguinte deve corresponder a resource-ref no DD -->
          <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 portas atendentes JMS do MDB

<?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>

Informações relacionadas

Botões do console administrativo