Instalando Arquivos de Aplicativos Corporativos com o Console
A instalação de arquivos de aplicativo Java EE (Java™ Platform, Enterprise Edition) consiste em colocar módulos montados de aplicativo corporativo, da Web, EJB (enterprise bean) ou outros módulos instaláveis em um servidor ou cluster configurado para conter os arquivos. Os arquivos instalados iniciados e executados corretamente são considerados implementados.
Antes de Iniciar
Antes de instalar arquivos de aplicativos corporativos, assegure-se de que esteja instalando seus arquivos de aplicativos em um destino de implementação compatível. Se o destino de implementação não for compatível, selecione um destino diferente.
Opcionalmente, determine se o aplicativo que você está instalando utiliza arquivos de biblioteca que os outros aplicativos implementados também utilizam. É possível definir uma biblioteca compartilhada para cada um desses arquivos compartilhados. Utilizar essas bibliotecas compartilhadas reduz o número de cópias do arquivo de biblioteca em sua estação de trabalho ou servidor.
Sobre Esta Tarefa
Para instalar novos arquivos do aplicativo corporativo em uma configuração do WebSphere Application Server, é possível utilizar as seguintes opções:
- Administrative console
- Scripts wsadmin
- Implementação de diretório monitorado
- Arquivos de propriedades do aplicativo
- Programas Java MBean
As etapas descrevem como usar o console administrativo para instalar um aplicativo, um componente EJB, um archive do Protocolo de Inicialização de Sessão (SIP) (SAR) ou um módulo da web.

Procedimento
- Clique em Aplicativos > Novo Aplicativo > Novo Aplicativo Corporativo na árvore de navegação do console.
- Na primeira página Preparando-se para
a instalação do aplicativo:
- Especifique o nome do caminho completo do arquivo do aplicativo corporativo de origem (arquivo .ear, também conhecido como um arquivo EAR).
O arquivo EAR que está sendo instalado pode estar no computador cliente (a máquina que executa o navegador da web) ou na máquina servidor (a máquina à qual o cliente está conectado). Se você especificar um arquivo EAR na máquina cliente, o console administrativo fará o upload do arquivo EAR para a máquina na qual o console está em execução e prosseguirá com a instalação do aplicativo.
Também é possível especificar um archive Web (WAR) independente, SAR ou Java archive (JAR) para instalação.
Se o arquivo EAR residir na máquina servidor e o servidor for um servidor IBM® i, certifique-se de que o perfil do usuário QEJBSVR tenha autoridade *R para o arquivo EAR e pelo menos autoridade *X para todos os diretórios no caminho que contêm o arquivo EAR.
Evitar Problemas: Se você tentar instalar um aplicativo a partir de um sistema de arquivos remoto e a Java Virtual Machine (JVM) estiver registrada como um serviço do Microsoft Windows, o console administrativo não mostrará uma unidade de rede mapeada. Neste cenário, o serviço do Windows é executado como uma nova sessão de logon cujo id de segurança (SID) é diferente da sessão do usuário. Dessa forma, o serviço não pode manipular a unidade de rede mapeada, que é estabelecida pelo usuário de login. Para instalar o aplicativo de um sistema de arquivos remoto, você deve usar o comando WASService para cancelar registro da JVM do serviço do Windows. Para obter informações adicionais, consulte a documentação sobre o comando WASService.gotcha
- Clique em Avançar.
- Especifique o nome do caminho completo do arquivo do aplicativo corporativo de origem (arquivo .ear, também conhecido como um arquivo EAR).
- Na segunda página Preparando para a instalação do aplicativo:
- Selecione se deseja visualizar todas as opções de instalação.
- Atalho - Avisar somente quando informações adicionais forem necessárias
- Exibe a etapa de mapeamento do módulo, assim como quaisquer etapas que requerem que você especifique as informações necessárias para instalar o aplicativo com êxito.
- Detalhado - Mostrar todas as opções e parâmetros de instalação
- Exibe todas as opções de instalação.
- Selecione se deseja gerar ligações padrão.
Selecione Gerar Ligações Padrão para que o produto forneça valores para ligações de Java Naming and Directory (JNDI) e de outros aplicativos incompletas. O produto não altera as ligações existentes.
Você não precisa especificar valores de JNDI para bean EJB, início local, início remoto ou interfaces de negócios de módulos EJB 3.x. O produto designa valores padrão do contêiner durante o tempo de execução. De maneira similar, para qualquer referência EJB dentro de um EJB 3.x ou de um módulo da Web 2.4 ou posterior, você não precisa especificar valores de JNDI, pois 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.
Novo Recurso:
Por padrão, os recursos padrão pré-configurados não são usados para ligações Java EE. Selecione Usar ligações padrão Java EE para que as ligações geradas sejam padrões Java EE.newfeatÉ possível personalizar os valores padrão utilizados na geração de ligações padrão. Preparando as Configurações de Ligação de Instalação do Aplicativo descreve a customização disponível e fornece ligações de amostra.
- Clique em Avançar. Se forem exibidos avisos de segurança, clique em Continuar. As páginas Instalar Novo Aplicativo são exibidas. Se optar por gerar ligações padrão, poderá prosseguir para a etapa Resumo. O Exemplo: Instalando um Arquivo EAR Utilizando as Ligações Padrão apresenta etapas de amostra.
- Selecione se deseja visualizar todas as opções de instalação.
- Especifique valores para as opções de instalação, conforme necessário.
É possível clicar em um número de etapa para mover-se diretamente para essa página em vez de clicar em Avançar. O conteúdo do aplicativo ou módulo que está sendo instalado determina quais páginas estão disponíveis.
Tabela 1. Descrições da Página do Assistente. A tabela descreve cada página do assistente. Página Descrição Selecione Opções de Instalação Na página Selecionar Opções de Instalação, forneça valores para as configurações específicas do produto. Os valores padrão são utilizados se você não especificar um valor. Mapear Módulos para Servidores Na página Mapear Módulos para Servidores, especifique os destinos de implementação onde deseja instalar os módulos contidos em seu aplicativo. Os módulos podem ser instalados no mesmo destino de implementação ou dispersos entre vários destinos de implementação. Cada módulo deve ser mapeado para um servidor de destino. Em produtos de servidor único, um destino de implementação pode ser um servidor de aplicativos ou servidor da Web.
Em produtos de diversos servidores, um destino de implementação pode ser um servidor de aplicativos, cluster de servidores de aplicativos ou servidor da Web.
Fornecer Opções para Compilar JSPs Se a configuração Pré-compilar Arquivos JavaServer Pages estiver ativada na página Selecionar Opções de Instalação e seu aplicativo utilizar arquivos JSP (JavaServer Pages), então, você pode especificar as opções do compilador JSP na página Fornecer Opções para Compilar JSPs. Fornecer Nomes da JNDI para Beans Na página Fornecer Nomes da JNDI para Beans, especifique um nome da JNDI para cada enterprise bean em cada módulo EJB 2.1 e anterior. Você deve especificar um nome de JNDI para cada bean corporativo definido no aplicativo. Por exemplo, para o módulo EJB MyBean.jar, especifique MyBean. Com relação a módulos EJB 3.x, é possível especificar nomes JNDI, nomes JNDI de início local, nomes JNDI de início remoto ou nenhum nome JNDI. Se você não especificar um valor, o produto fornecerá um valor padrão.
Ligar negócios do EJB Na página Ligar Negócios de EJB, é possível especificar nomes JNDI da interface de negócios para módulos EJB 3.x. Se você especificou um nome da JNDI para um bean na página Fornecer Nomes da JNDI para Beans, não especifique um nome da JNDI da interface de negócios nesta página para o mesmo bean. Se você não especificar o nome JNDI para um bean, poderá opcionalmente especificar um nome JNDI da interface de negócios. Quando você não especificar um nome JNDI da interface de negócios, o produto fornecerá um padrão de contêiner. Para obter uma visualização de não interface, o valor da interface de negócios é uma sequência vazia (""). Mapear Origens de Dados Padrão para Módulos que Contêm Beans de Entidade 1.x Se o seu aplicativo utilizar os módulos EJB que contêm beans CMP (Container Managed Persistence) que se baseiam na especificação EJB 1.x, em Mapear origens de dados padrão para os módulos que contêm beans de entidade 1.x, especifique um nome JNDI para a origem de dados padrão para os módulos EJB. A origem de dados padrão para os módulos EJB é opcional se as origens de dados forem especificadas para beans CMP individuais. Mapear Referências EJB para Beans Na página Mapear Referências EJB para Beans, se seu aplicativo definir referências EJB, será possível especificar nomes da JNDI para enterprise beans que representam os nomes lógicos especificados em referências EJB. Se a referência EJB for de um EJB 3.x ou módulo da Web 2.4 ou posterior, o nome JNDI será opcional. Para os módulos anteriores, cada referência do EJB definida no aplicativo deve ser limitada a um arquivo EJB.
Se a opção Permitir destinos de referência do EJB para resolver automaticamente estiver ativada, o nome JNDI será opcional para todos os módulos. O produto fornece um valor padrão do contêiner ou determina automaticamente a referência do EJB para as ligações incompletas.
Mapear Referências de Recurso para Recursos Se seu aplicativo definir referências de recursos, para Mapear Referências de Recursos para Recursos, especifique nomes JNDI para os recursos que representam nomes lógicos definidos nas referências de recursos. Como opção, é possível especificar o nome da configuração de login e as propriedades de autenticação para o recurso. Depois de especificar as propriedades de autenticação, clique em OK para salvar os valores e retornar à etapa de mapeamento. É possível opcionalmente especificar as propriedades da origem de dados estendida para ativar uma origem de dados que utiliza um conjunto heterogêneo para conectar-se com um banco de dados DB2. Cada referência de recurso definida no aplicativo deve ser ligada a um recurso definido em sua configuração WebSphere Application Server antes de clicar em Concluir na página Resumo. Mapear hosts virtuais para módulos da Web Se o seu aplicativo usar módulos da Web, para Mapear hosts virtuais para módulos da Web, selecione um host virtual na lista para mapear para um módulo da Web definido no aplicativo. O número da porta especificado na definição de host virtual é usado na URL usada para acessar artefatos, como servlets e arquivos JSP no módulo da Web. Cada módulo da Web deve ter um host virtual para o qual ele é mapeado. Não especificar todos os hosts virtuais necessários resultará na exibição de um erro de validação depois de clicar em Concluir na página Resumo. Mapear Funções de Segurança para Usuários ou Grupos Se o aplicativo possuir funções de segurança definidas em seu descritor de implementação, na opção Mapear funções de segurança para usuários ou grupos, especifique os usuários e grupos que são mapeados para cada uma da funções de segurança. Selecione Função para selecionar todas as funções ou selecionar funções individuais. Para cada função, é possível especificar se usuários predefinidos, como Todos ou Todos Usuários Autenticados são mapeados para ele. Para selecionar usuários ou grupos específicos no registro de usuário: - Selecione uma função e clique em Consultar Usuários ou Consultar Grupos.
- Na página Consultar Usuários ou Grupos exibida, insira os critérios de procura para extrair uma lista de usuários ou grupos a partir do registro do usuário.
- Selecione usuários ou grupos individuais nos resultados exibidos.
- Clique em OK para mapear os usuários ou grupos selecionados para a função selecionada na página Mapear Funções de Segurança para Usuários ou Grupos.
Mapear Funções RunAs para Usuários Se o aplicativo possuir funções Executar Como definidas em seu descritor de implementação, na opção Mapear funções Executar Como para usuários, especifique o nome do usuário e senha para cada função Executar Como. As funções Executar Como são utilizadas pelos beans corporativos que devem ser executados como uma função específica enquanto interage com outro enterprise bean. Selecione Função para selecionar todas as funções ou selecionar funções individuais. Depois de selecionar uma função, insira valores para o nome do usuário, a senha e a confirmação da senha e clique em Aplicar. Assegurar que Todos os Métodos 1.x Não protegidos Têm o Nível Correto de Proteção Se seu aplicativo contiver beans CMP EJB 1.x que não possuem permissões de método definidas para alguns dos métodos EJB, para Assegurar que Todos os Métodos 1.x Desprotegidos Tenham o Nível de Proteção Correto, especifique se deseja deixar esses métodos desprotegidos ou se deseja designar proteção com rejeitar todo acesso. Ligar Listeners para Beans Acionados por Mensagens Se o seu aplicativo contiver enterprise beans acionados por mensagens, para Ligar Listeners para Beans Acionados por Mensagens, forneça um nome da porta listener ou um nome da JNDI da especificação de ativação para cada bean acionado por mensagens. Mapear Origens de Dados Padrão para Módulos que Contêm Beans de Entidade 2.x Se o seu aplicativo utilizar os módulos EJB que contêm beans CMP baseados na especificação EJB 2.x, em Mapear origens de dados padrão para os módulos que contêm beans de entidade 2.x, especifique um nome JNDI para a origem de dados padrão e o tipo de autorização de recurso a serem utilizados para a origem de dados padrão para os módulos EJB. Como opção, é possível especificar um nome de configuração de login e as propriedades de autenticação para a origem de dados. Ao criar propriedades de autenticação, você deve clicar em OK para salvar os valores e retornar à etapa de mapeamento. É possível opcionalmente especificar as propriedades da origem de dados estendida para ativar uma origem de dados que utiliza um conjunto heterogêneo para conectar-se com um banco de dados DB2. A origem de dados padrão para módulos EJB é opcional se as origens de dados forem especificadas para beans CMP individuais. Mapear Origens de Dados para Todos os Beans CMP 2.x Se seu aplicativo tiver beans CMP que sejam baseados na especificação EJB 2.x, na página Mapear Origens de Dados para Todos os Beans CMP 2.x, para cada um dos beans CMP 2.x, especifique um nome da JNDI e o tipo de autorização de recurso para origens de dados a serem usadas. Como opção, é possível especificar um nome de configuração de login e as propriedades de autenticação para a origem de dados. Ao criar propriedades de autenticação, você deve clicar em OK para salvar os valores e retornar à etapa de mapeamento. O atributo da origem de dados é opcional para os beans CMP individuais se uma origem de dados padrão for especificada para o módulo EJB que contém beans CMP. Se uma origem de dados padrão para o módulo EJB e uma origem de dados para beans CMP individuais não forem especificadas, um erro de validação será exibido após você clicar em Concluir e a instalação será cancelada.
Assegurar que Todos os Métodos 2.x Não Protegidos Têm o Nível Correto de Proteção Se seu aplicativo contiver beans CMP EJB 2.x que não possuem permissões de método definidas nos descritores de implementação para alguns dos métodos EJB, na página Assegurar que Todos os Métodos 2.x Desprotegidos Tenham o Nível de Proteção Correto, especifique se deseja designar uma função específica para os métodos desprotegidos, inclua os métodos na lista de exclusão ou marque-os como com seleção cancelada. Os métodos adicionados à lista de exclusões são marcados como não chamáveis. Para métodos marcados com seleção cancelada nenhuma verificação de autorização é executada antes de sua chamada. Fornecer Opções para Executar a Implementação de EJB Se a configuração Implementar Enterprise Beans estiver ativada na página Selecionar Opções de Instalação, será possível especificar opções para a ferramenta de implementação EJB na página Fornecer Opções para Executar a Implementação EJB. Nesta página, é possível especificar caminhos de classe extras, opções RMIC, tipos de bancos de dados e nomes de esquemas do banco de dados para serem usados durante a execução da ferramenta de implementação EJB. É possível especificar as opções da ferramenta de implementação EJB nesta página ao instalar ou atualizar um aplicativo que contenha módulos EJB. A ferramenta de implementação do EJB é executada durante a instalação dos módulos EJB 1.x ou 2.x. A ferramenta de implementação EJB não é executada durante a instalação dos módulos EJB 3.x.
Mapear Bibliotecas Compartilhadas Nas páginas Referências de Biblioteca Compartilhada e Mapeamento de Biblioteca Compartilhada, especifique os arquivos de biblioteca compartilhada a serem usados por seu aplicativo ou módulos da Web. Deve existir uma biblioteca compartilhada definida para associar seu aplicativo ou módulo ao arquivo de biblioteca. Mapear relacionamentos de biblioteca compartilhada Na página Mapear Relacionamentos de Biblioteca Compartilhada, especifique identificadores de relacionamentos e nomes de unidades de composição para bibliotecas compartilhadas em sua referência de aplicativo corporativo. Ao instalar seu aplicativo corporativo, o produto cria uma unidade de composição para cada relacionamento de biblioteca compartilhada no aplicativo em nível de negócios especificado para Nome do Aplicativo em Nível de Negócios na página Selecionar Opções de Instalação.
Fornecer opções de recarregamento de JSP para módulos da Web Se o seu aplicativo usar módulos da Web, para Fornecer opções de recarregamento de JSP para módulos da Web, configure o recarregamento da classe de arquivos JavaServer Pages (JSP). Mapear raízes de contexto para módulos da Web Se o seu aplicativo usar módulos da Web que sejam definidos no descritor de implementação XML do aplicativo, para Mapear raízes de contexto para módulos da Web, especifique uma raiz de contexto para cada módulo da Web no aplicativo. O produto não inclui módulos da Web de anotações nesta página.
Inicializar Parâmetros para Servlets Se o seu aplicativo usar módulos da Web que suportem Servlet 2.5, para Inicializar Parâmetros para Servlets, especifique ou sobrescreva os parâmetros iniciais que são passados para o método de inicialização de filtros de servlet do módulo da Web. Esta página mostra servlets do descritor de implementação XML do módulo. As informações de implementação do servlet de anotações não estão disponíveis nesta página.
Mapear Entradas de Ambiente para Módulos EJB Se o seu aplicativo usar módulos EJB, para Mapear Entradas de Ambiente para Módulos EJB, configure as entradas de ambiente de módulos EJB como beans de entidade, de sessão ou acionados por mensagens. Mapear entradas de ambiente para módulos de cliente Se você estiver implementando um ou mais módulos de aplicativo cliente, para Mapear entradas de ambiente para módulos de cliente, configure as entradas de ambiente de módulos de cliente que sejam implementadas como arquivos JAR. Para visualizar a página Mapear entradas de ambiente para módulos de cliente, selecione a opção Implementar Módulos de Cliente na página Selecione Opções de Instalação. Mapear entradas de ambiente para módulos de cliente Se o seu aplicativo usar módulos da web que suportem Servlet 2.5, para Mapear entradas de ambiente para módulos de cliente, configure as entradas de ambiente de módulos da Web, como servlets e arquivos JSP. Mapear entradas de ambiente para o nível do aplicativo Se o aplicativo definir uma ou mais entradas de ambiente, para Mapear entradas de ambiente para o nível do aplicativo, configure as entradas de ambiente de aplicativos que sejam implementados como arquivos EAR. Mapear Referências de Entradas de Ambiente de Recursos para Recursos Se o seu aplicativo contiver referências de ambiente de recursos, em Mapear referências de entrada do ambiente de recurso para os recursos, especifique os nomes JNDI dos recursos que são mapeados para os nomes lógicos definidos nas referências de ambiente de recurso. Se cada referência de ambiente de recursos não tiver um recurso associado a ela, depois de clicar em Concluir, um erro de validação será exibido. Utilização Correta da Identidade do Sistema Se o seu aplicativo definir Identidade Executar Como como a Identidade do Sistema, em Corrigir uso da identidade do sistema, será possível opcionalmente alterá-la para Função Executar Como e especificar um nome do usuário e senha para a função Executar Como especificada. Selecionar Identidade do Sistema indica que a chamada é feita através do ID do servidor de segurança do WebSphere Application Server e deve ser utilizado com cuidado, já que esse ID não possui privilégios. Corrigir Níveis de Isolamento para Todas as Referências de Recursos Se o seu aplicativo possuir referências de recurso que são mapeados para os recursos que possuem um banco de dados Oracle que executam processamento de backend, na opção Corrigir níveis de isolamento para todas as referências de recursos, especifique ou corrija o nível de isolamento a ser utilizado para esses recursos quando utilizado pelo aplicativo. Os bancos de dados Oracle suportam somente os níveis de isolamento ReadCommitted e Serializable. Mapear Provedor JASPI Na página Mapear Provedor JASPI, se o seu aplicativo tiver módulos da Web, será possível especificar valores para sobrescrever as configurações de JASPI a partir da configuração de segurança global ou de domínio. Por padrão, um aplicativo herda as configurações de JASPI definidas na configuração de segurança global ou de domínio do WebSphere Application Server e os módulos da web herdam a configuração do aplicativo. Ligar Referências de Destino de Mensagens a Objetos Administrados Se o seu aplicativo utilizar beans acionados por mensagens, na opção Ligar referências de destino de mensagens para objetos administrados, especifique o nome JNDI do objeto administrado J2C para ligar a referência de destino da mensagem aos beans acionados por mensagens. Se a referência de destino da mensagem for de um módulo EJB 3.0 ou anterior, o nome JNDI será opcional e o tempo de execução fornecerá um valor padrão de contêiner.
Atenção: Se várias referências de destino de mensagem forem vinculadas ao mesmo destino de mensagem, apenas um nome JNDI será coletado. Quando uma referência de destino da mensagem é vinculada ao mesmo destino de mensagem que um bean orientado a mensagens e o nome de JNDI de destino já foi coletado, o nome de JNDI de destino para a referência de destino de mensagem não é coletado.Fornecer Nomes JNDI para Objetos JCA Se o seu aplicativo contiver um arquivo .rar integrado, para Fornecer Nomes da JNDI para Objetos JCA, especifique o nome e o nome da JNDI de cada connection factory JCA, objeto administrado e especificação de ativação. Ligar Especificações de Ativação J2C aos Nomes JNDI de Destino Se o seu aplicativo contiver um arquivo .rar integrado, sua propriedade activationSpec possui o valor Destino e o seu tipo integrado for javax.jms.Destination, em Ligar activationspecs J2C aos nomes JNDI de destino, especifique o valor jndiName para cada ativação limitada a ele. Selecionar ID de Backend Atual Se o seu aplicativo possuir módulos EJB para os quais o código de implementação foi gerado para vários bancos de dados backend utilizando uma ferramenta de montagem, em Selecionar ID de backend Atual, especifique o ID de backend que representa o banco de dados de backend a ser utilizado quando o módulo EJB for executado. Para obter informações sobre bancos de dados backend, consulte os tópicos na ferramenta de implementação EJB.
Esta etapa não será mostrada se a configuração Implementar Enterprise Beans estiver ativada na página Selecionar Opções de Instalação e se um tipo de banco de dados diferente de Nenhum for especificado na página Fornecer Opções para Executar a Implementação EJB.
Metadados dos módulos Se o seu aplicativo tiver módulos EJB 3.x ou Web 2.5, será possível bloquear descritores de implementação para um ou mais dos módulos EJB 3.x ou Web 2.5. Se você configurar o atributo metadata-complete para true e bloquear os descritores de implementação, o produto gravará o descritor de implementação do módulo completo, incluindo informações de implementação das anotações, no formato XML. Fornecer opções para executar a implementação de serviços da Web Se a configuração Implementar Serviços da Web estiver ativada na página Selecionar Opções de Instalação e seu aplicativo usar serviços da Web, será possível especificar opções do comando wsdeploy na página Fornecer opções para executar a implementação de serviços da Web. Para obter informações sobre esta página, consulte as descrições das opções wsdeploy -cp e -jardir. Configurar propriedades de dispatch de solicitação remota Se estiver utilizando um dispatcher de pedido remoto, primeiro, é necessário configurá-lo para utilização. O Remote Request Dispatcher (RRD) é uma extensão conectável ao contêiner da web que permite que as estruturas do aplicativo, servlets e JavaServer Pages incluam conteúdo de fora do recurso Java virtual machine (JVM) em execução atualmente como parte da resposta enviada para o cliente. Consulte as configurações da propriedade de Dispatcher Remoto, para obter informações sobre onde configurar essas propriedades no console administrativo. Exibir o ID de Build do Módulo Se o arquivo MANIFEST.MF de um módulo em um aplicativo corporativo especificar um identificador de build, essa página mostrará o identificador de build do módulo. - Na página Resumo, verifique
a célula, o nó e o servidor nos quais os módulos do aplicativo
serão instalados:
- Ao lado da opção Célula/Nó/Servidor, clique em Clique Aqui.
- Verifique as configurações.
- Retorne para a página Resumo.
- Clique em Concluir.
Resultados
Várias mensagens são exibidas, indicando se o arquivo de aplicativo está sendo instalado com êxito.
Se Validar Entrada Desligado/Aviso/Falha na página Selecionar Opções de Instalação estiver configurado como Aviso, o padrão, poderão ser exibidos vários avisos de validação. Se a configuração for falha, os avisos de validação poderão causar erros.
Se você receber uma exceção OutOfMemory e o arquivo de aplicativo de origem não for instalado, seu sistema poderá não ter memória suficiente ou seu aplicativo poderá ter um número excessivo de módulos para instalar com êxito no servidor. Neste caso, verifique o SystemOut.log, ou SystemErr.log, e os arquivos de log de primeira captura de dados com falha (FFDC) das máquinas que estão envolvidas no erro para determinar quais processos Java em qual sistema experimentaram o erro. No sistema que experimentou a exceção, tente aumentar o tamanho máximo do heap Java em 256 megabytes. Para obter mais informações, consulte a documentação sobre o ajuste da máquina virtual IBM para Java. Após ajustar o tamanho máximo do heap Java, tente instalar o arquivo de aplicativo novamente. Dependendo da quantia de memória necessária para instalar esse aplicativo, pode ser necessário aumentar o tamanho de heap máximo mais de uma vez. Se atingir o tamanho de heap máximo suportado para sua JVM e o problema ainda assim ocorrer, tente empacotar seu aplicativo novamente para que tenha menos módulos.
Se você estiver utilizando o assistente de instalação do aplicativo em um navegador Internet Explorer, a instalação do aplicativo pode falhar de forma intermitente. O navegador Internet
Explorer não envia todos os dados criptografados esperados pelo servidor. Para instalar o aplicativo, utilize o assistente de instalação do aplicativo em um navegador Firefox 1.5 ou posterior ou utilize a ferramenta wsadmin.
![[z/OS]](../images/ngzos.gif)
- Clique em Servidores > Tipos de Servidor > Servidores de Aplicativos do WebSphere > server_name > Infraestrutura do Servidor > Administração > Propriedades Customizadas.
- Configure a propriedade customizada protocol_http_large_data_inbound_buffer do servidor de aplicativos como 20000000.
- Pare e reinicie o servidor de aplicativos.
- Tente instalar o arquivo EAR novamente.
O que Fazer Depois
Depois do arquivo de aplicativo ser instalado com êxito, faça o seguinte:
- Salve as alterações na configuração.
Por exemplo, clique no link Salvar nas mensagens de instalação do aplicativo.
O aplicativo é registrado com a configuração administrativa e os arquivos do aplicativo são copiados para o diretório de destino, que é app_server_root/installedApps/cell_name por padrão, ou para o diretório designado por você.
Para um produto com servidor único, os arquivos de aplicativos são copiados para o diretório de destino quando as alterações são salvas.
Para um produto com vários servidores, os arquivos são copiados para nós remotos quando a configuração do gerenciador de implementação é sincronizada com a configuração em nós individuais.
Se você clicou no link Salvar nas mensagens de instalação do aplicativo, a página Preparando para a Instalação do Aplicativo será exibida novamente. Clique em Aplicativos > Tipos de Aplicativos > Aplicativos Corporativos WebSphere para sair da página e ver seu aplicativo na lista de aplicativos instalados.
- Inicie o aplicativo.
- Teste o aplicativo. Por exemplo, aponte um navegador da Web na URL para o aplicativo implementado e examine o desempenho do aplicativo. Se necessário, edite a configuração do aplicativo.
Subtópicos
Exemplo: Instalando um Arquivo EAR Utilizando as Ligações Padrão
Se as ligações de aplicativos não foram especificadas para todos os enterprise beans ou recursos em um aplicativo corporativo durante o desenvolvimento ou montagem do aplicativo, poderá optar por criar ligações padrão. Após a instalação do aplicativo, será possível modificar as ligações, conforme necessário, utilizando o console administrativo.Exemplo: Instalando uma Amostra de Serviços da Web com o Console
O produto V8.5.5 fornece um aplicativo de amostra de serviços da web que você instala em um servidor de aplicativos.Preparando Definições de Instalação do Aplicativo
Utilize essa página para especificar um aplicativo ou módulo para instalação.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.Selecionar Configurações das Opções de Instalação
Use esta página para especificar opções para a instalação de um aplicativo Java Platform, Enterprise Edition (Java EE) em um destino de implementação WebSphere Application Server. Os valores padrão para as opções serão utilizados se você não especificar um valor. Após a instalação do aplicativo, é possível especificar valores para muitas dessas opções a partir de uma página de configurações do aplicativo corporativo.Gerenciar Configurações do Módulo
Use essa página para especificar os destinos de implementação em que você deseja instalar os módulos que estão contidos em seu aplicativo. Os módulos podem ser instalados no mesmo destino de implementação ou dispersos entre vários destinos de implementação.Configurações do Módulo do Cliente
Use esta página para configurar um módulo do cliente implementado.Configurações da Propriedade do Módulo do Cliente
Use essa página para configurar o modo de implementação de um módulo do cliente implementado.Fornecer Opções para Compilar Configurações de JavaServer Pages
Use essa página para especificar opções a serem usadas pelo compilador JavaServer Pages (JSP).Nomes de JNDI de EJB para Beans
Use esta página para visualizar e modificar os nomes Java Naming and Directory Interface (JNDI) dos enterprise beans não acionados por mensagem em seu aplicativo ou módulo.Configurações de Ligação de Negócios do EJB
Use essa página do console administrativo para especificar as ligações de nome da Java Naming and Directory (JNDI) de cada enterprise bean com uma interface de negócios em um módulo EJB. Cada enterprise bean com uma interface de negócios em um módulo EJB deve ser ligado a um nome JNDI. Para qualquer interface de negócios que não fornece um nome JNDI, ou se seu bean não fornecer um nome JNDI, um nome de ligação padrão será fornecido. Se o seu bean fornecer um nome de JNDI, o nome da JNDI padrão da interface de negócios será fornecido sobre seu nome da JNDI do bean, anexando-se o nome de classe qualificado do pacote da interface.Mapear Origens de Dados Padrão para Módulos Contendo Beans de Entidade 1.x
Utilize essa página para configurar o mapeamento da origem de dados padrão para os módulos EJB que contêm beans CMP (Container-Managed Persistence) 1.x. A menos que você configure origens de dados individuais para seus beans CMP 1.x, esse mapeamento padrão aplica-se a todos os beans dentro do módulo.Configurações do módulo RAR
Use esta página para visualizar e gerenciar um módulo adaptador de recursos (RAR) correspondente a um módulo conector em um aplicativo implementado (EAR).Referências EJB
Use esta página para visualizar e modificar as referências de Enterprise JavaBeans (EJB) para enterprise beans. Referências são nomes lógicos utilizados para localizar recursos externos para aplicativos corporativos. Elas são definidas no arquivo descritor de implementação do aplicativo. Na implementação, as referências são ligadas à localização física (nome global da Java Naming and Directory Interface (JNDI)) do recurso no ambiente operacional de destino.Referências de Recurso
Utilize essa página para designar como as referências de recursos de módulos aplicativos são mapeadas para os verdadeiros recursos que estão configurados para o aplicativo.Configurações de Hosts Virtuais
Use essa página para especificar hosts virtuais para módulos da Web contidos no aplicativo. Os módulos da Web podem ser instalados no mesmo host virtual ou dispersos entre vários hosts virtuais.Função de Segurança para Mapeamento de Usuário ou de Grupo
Utilize esta página para especificar os usuários e grupos que são mapeados para as funções de segurança utilizadas com o aplicativo corporativo.Ativação de Autenticação JASPI para Aplicativos
Use esta página para ativar ou desativar a autenticação Java Authentication SPI (JASPI) para um aplicativo ou módulo da Web e para especificar o nome de um provedor de autenticação JASPI que será usado para autenticar mensagens para o aplicativo ou módulo da Web.Coleção RunAs do Usuário
Utilize esta página para mapear uma identidade e senha do usuário especificadas para uma função RunAs. Este painel permite que você especifique privilégios específicos de aplicativos para usuários individuais executarem tarefas específicas utilizando outra identidade do usuário.Assegurar que Todos os Métodos 1.x Não Protegidos Tenham o Nível Correto de Proteção
Utilize essa página para verificar se os métodos EJB (Enterprise JavaBeans) Versão 1.x protegidos possuem o nível correto de proteção, antes de mapear usuários para funções.Configurações de Listeners de Ligação para Beans Orientados a Mensagens
Use essa página para especificar ligações para beans acionados por mensagens no aplicativo ou módulo.Mapear Origens de Dados para Todos os Beans 2.x CMP
Utilize essa página para configurar o mapeamento da origem de dados padrão para os módulos EJB que contêm beans CMP (Container-Managed Persistence) 2.x. A menos que você configure origens de dados individuais para seus beans CMP 2.x, esse mapeamento padrão aplica-se a todos os beans dentro do módulo.Mapear Origens de Dados para Todas as Configurações de Beans CMP 2.x
Utilize essa página para mapear beans CMP (persistência gerenciada por contêiner) 2.x de um aplicativo para as origens de dados que estão disponíveis ao aplicativo.Assegurar que Todos os Métodos 2.x Não Protegidos Tenham o Nível Correto de Proteção
Utilize essa página para verificar se os métodos EJB (Enterprise JavaBeans) Versão 2.x protegidos possuem o nível correto de proteção, antes de mapear usuários para funções.Fornecer Opções para Executar as Configurações de Implementação de EJB
Utilize esta página para especificar opções para a ferramenta de implementação do enterprise bean (EJB). A ferramenta gera código necessário para executar arquivos de enterprise bean. É possível especificar caminhos de classes extras, opções do RMIC (Remote Method Invocation Compiler), tipos de banco de dados e nomes de esquemas de banco de dados a serem utilizados na execução da ferramenta de implementação EJB.Configurações de Referências e Mapeamento de Bibliotecas Compartilhadas
Use as páginas Referências de Biblioteca Compartilhada e Mapeamento de Biblioteca Compartilhada para associar bibliotecas compartilhadas definidas a um aplicativo ou módulo da Web. Uma biblioteca compartilhada é um arquivo JAR (Java Archive) externo utilizado por um ou mais aplicativos. A utilização de bibliotecas compartilhadas permite que vários aplicativos implementados em um servidor utilizem uma única biblioteca, em vez utilizarem várias cópias da mesma biblioteca. Após associar bibliotecas compartilhadas a um aplicativo ou módulo, o carregador de classes de aplicativo ou módulo carrega classes representadas por bibliotecas compartilhadas e disponibiliza essas bibliotecas para o aplicativo ou módulo.Configurações de Relacionamento e Mapeamento da Biblioteca Compartilhada
Utilize as páginas Relacionamento da Biblioteca Compartilhada e Mapeamento de Relacionamentos da Biblioteca Compartilhada para especificar identificadores de relacionamento e nomes de unidade de composição para bibliotecas compartilhadas que os módulos em seu aplicativo corporativo consultam. Ao instalar seu aplicativo corporativo, o produto cria uma unidade de composição para cada relacionamento de biblioteca compartilhada no aplicativo em nível de negócios que você especificou na página Selecionar opções de instalação do assistente de instalação do aplicativo.Configurações de Opções de JSP e JSF
Use esta página para configurar o recarregamento de classe de módulos da web tais como arquivos JavaServer Pages (JSP) e para selecionar uma implementação de JSF para usar com este aplicativo.Raiz de Contexto para Configurações de Módulos da Web
Use esta página para especificar a raiz de contexto para módulos da Web durante ou após a instalação de um aplicativo em um destino de implementação do WebSphere Application Server.Configurações de Parâmetros Iniciais para Servlets
Use esta página para especificar parâmetros iniciais que são transmitidos ao método init dos filtros de servlet do módulo da Web. Você pode especificar os valores de parâmetro iniciais para servlets nos módulos da Web durante ou após a instalação de um aplicativo em um destino de implementação do WebSphere Application Server. Os valores <param-value> especificados nas instruções <init-param> do arquivo web.xml dos módulos da Web são usados por padrão.Configurações de Entradas de Ambiente para Módulos do Cliente
Utilize esta página para configurar as entradas de ambiente de módulos de aplicativos clientes que estão implementados como arquivos Java archive (JAR).Configurações de Entradas de Ambiente para Módulos EJB
Use essa página para configurar as entradas de ambiente de módulos Enterprise JavaBeans (EJB), como beans de entidade, de sessão ou acionados por mensagens.Configurações de Entradas de Ambiente para Módulos da Web
Utilize essa página para configurar as entradas de ambiente de módulos da Web, como servlets e arquivos JSP (JavaServer Pages).Entradas de Ambiente para Configurações de Aplicativos
Use essa página para configurar as entradas de ambiente de aplicativos que são implementados como arquivos enterprise archive (EAR).Referências de Ambiente de Recursos
Utilize esta página para designar como as referências de ambiente de recursos dos módulos de aplicativos são mapeadas para recursos remotos, que são representados no produto como entradas de ambiente de recursos.Configurações de Referência de Destino da Mensagem
Se o aplicativo usar beans acionados por mensagens, use essa página para especificar o nome Java Naming and Directory Interface (JNDI) do objeto administrado J2C para ligar a referência de destino da mensagem aos beans acionados por mensagens. Você deve mapear cada referência de destino de mensagem definida no aplicativo para um objeto administrado.Configurações Selecionar ID de Backend Atual
Use essa página para selecionar um identificador de backend para os beans de persistência gerenciada por contêiner (CMP) que contêm mapeamentos para diversos bancos de dados backend.Configurações Fornecer Nomes JNDI para Objetos JCA
Use essa página para configurar valores de nomes Directory Interface (JNDI) para objetos J2C (J2CConnectionFactory, J2CActivationSpec e J2CAdminObject) em seu aplicativo ou módulo. Se o aplicativo contiver um arquivo RAR (Resource Archive) integrado, especifique o nome e o nome JNDI de cada connection factory JCA, objeto administrado e especificação de ativação.Utilização Correta da Identidade do Sistema
Utilize essa página para gerenciar as propriedades de identidade do sistema para o método EJB (Enterprise JavaBeans) em seu aplicativo.Requisitos para Configurar os Níveis de Isolamento de Acesso a Dados
Este artigo discute os critérios e efeitos da configuração de níveis de isolamento para componentes de acesso a dados que formam os módulos Enterprise JavaBeans (EJB) 2.x e mais recente.Metadados para Configurações do Módulo
Use esta página para orientar um descritor de implementação Java Platform, Enterprise Edition (Java EE) enterprise bean (EJB), um descritor de implementação de módulo da Web ou um módulo JCA resource adapter archive (RAR) para ignorar as anotações que especificam informações de implementação.Fornecer Opções para Executar as Configurações de Implementação de Serviços da Web
Use esta página para especificar as opções para a implementação de serviços da web.Exibir Configurações do ID de Construção do Módulo
Use esta página para visualizar o identificador de construção de um módulo em um archive corporativo (arquivo EAR) Java Platform, Enterprise Edition (Java EE). O identificador de construção de um módulo será mostrado, se o arquivo MANIFEST.MF de um módulo ou aplicativo especificar um identificador de construção.Implementando Aplicativos da Web com Aplicativos da Web Remotos ou de Portlet Utilizando RRD
O RRD (Remote Request Dispatcher) é uma extensão plugável ao contêiner da Web que permite às estruturas de aplicativo, aos servlets e às JavaServer Pages (JSP) incluírem conteúdo externo da Java Virtual Machine (JVM) do recurso executando no momento como parte da resposta enviada ao cliente.


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=trun_app_instwiz
Nome do arquivo: trun_app_instwiz.html