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.
Para visualizar essa página do console administrativo, clique em Aplicativos > Novo Aplicativo > Novo Aplicativo Corporativo e então especifique valores conforme necessário para o seu aplicativo nas páginas Preparando instalação de aplicativo.
A página Selecionar opções de instalação é a mesma para os assistentes de instalação de aplicativo e atualização.
Especifique se deseja pré-compilar os arquivos JSP (JavaServer Page) como uma parte da instalação. O padrão é não pré-compilar os arquivos JSP.
Para essa opção, instale somente em um destino de implementação da Versão 6.1 ou posterior.
Se você selecionar Pré-compilar Arquivos JavaServer Pages e tentar instalar seu aplicativo em um destino de implementação mais antigo, tal como a Versão 5.x, a instalação será rejeitada. É possível implementar aplicativos apenas nos destinos de implementação que possuem a mesma versão que o produto. Se os aplicativos forem destinados a servidores que possuem uma versão anterior àquela do produto, então não será possível implementar em tais destinos.
Tipo de Dados | Booleano |
Padrão | false |
Especifica o diretório no arquivo o arquivo EAR (Enterprise Archive) será instalado.
Por padrão, o arquivo EAR é instalado no diretório profile_root/installedApps/cell_name/application_name.ear.
As opções de configuração incluem o seguinte:
O valor padrão é ${APP_INSTALL_ROOT}/cell_name, em que a variável ${APP_INSTALL_ROOT} é profile_root/installedApps. Um diretório que possui o nome do arquivo EAR do aplicativo que está sendo instalado é anexado ao ${APP_INSTALL_ROOT}/cell_name. Assim, se você não especificar um diretório, o arquivo EAR será instalado no diretório profile_root/installedApps/cell_name/application_name.ear.
Se você especificar um diretório em Diretório para instalar o aplicativo, o aplicativo será instalado no diretório specified_path/application_name.ear. Um diretório tendo o nome do arquivo EAR do aplicativo sendo instalado é anexado ao caminho especificado em Diretório para instalar o aplicativo. Por exemplo, se você estiver instalando o Clock.ear e especificar C:/myapps em máquinas Windows, o aplicativo será instalado no diretório myapps/Clock.ear. A variável ${APP_INSTALL_ROOT} é configurada para o caminho especificado.
Caso você pretenda exportar o aplicativo de uma célula e instalar posteriormente o aplicativo exportado em uma célula diferente, especifique a variável ${CELL} para a instalação inicial do aplicativo. Por exemplo, especifique ${APP_INSTALL_ROOT}/${CELL} para essa configuração. A exportação do aplicativo cria um arquivo EAR aprimorado que tem o aplicativo e sua configuração de implementação. A configuração de implementação retém o nome da célula da instalação inicial no diretório de destino, a menos que você especifique a variável ${CELL}. A especificação da variável ${CELL} garante que o diretório de destino tenha o nome da célula atual, e não o nome da célula original.
O arquivo EAR exportado é um arquivo EAR avançado que tem o aplicativo e sua configuração de implementação. A configuração de implementação retém o valor para Diretório para instalar o aplicativo que foi utilizado na instalação anterior do aplicativo. A menos que você especifique um valor diferente em Diretório para instalar o aplicativo nessa instalação, o arquivo EAR avançado será instalado no mesmo diretório da instalação anterior.
Se você não especificou a variável ${CELL} durante a instalação inicial, a configuração de implementação utilizará o nome da célula da instalação inicial no diretório de destino. Caso esteja instalando em uma célula diferente, especifique ${APP_INSTALL_ROOT}/cell_name/application_name.ear, em que cell_name é o nome da célula na qual você deseja instalar o arquivo EAR aprimorado. Se você não designar o nome da célula atual, cell_name será o nome da célula original mesmo que o arquivo EAR avançado esteja sendo instalado em uma célula com nome diferente.
É possível especificar um caminho absoluto ou utilizar uma variável pathmap, como ${MY_APPS}. Você pode utilizar uma variável pathmap em qualquer instalação.
Uma variável pathmap é particularmente necessária ao instalar um aplicativo em um cluster com membros em nós heterogêneos porque, nesses casos, pode não haver uma única maneira de especificar um caminho absoluto. Uma variável ${CELL} do WebSphere Application Server que denota o nome da célula atual também pode estar na variável pathmap; por exemplo, ${MY_APP}/${CELL}. É possível definir variáveis do WebSphere Application Server na página Console de Variáveis do WebSphere, que pode ser acessada clicando em Ambiente > Variáveis do WebSphereVariables.
Esse campo Diretório para Instalar Aplicativo é igual à configuração Local (Caminho Completo) em uma página Binários do Aplicativo.
Tipo de Dados | Cadeia |
Unidades | Nome de caminho completo |
Especifica se o produto expande binários de aplicativos no local de instalação durante a instalação e exclui binários de aplicativos durante a desinstalação. O padrão é ativar a distribuição de aplicativos. Os binários de aplicativos dos aplicativos instalados são expandidos para o diretório especificado.
Em produtos de servidor único, os binários são excluídos quando você desinstala e salva alterações na configuração.
Em produtos de servidor múltiplo, os binários são excluídos quando você desinstala e salva alterações na configuração e sincroniza alterações.
Se você desativar essa opção, deverá certificar-se de que os binários do aplicativo sejam expandidos apropriadamente nos diretórios de destino de todos os nós nos quais o aplicativo é executado.
Esse campo Distribuir Aplicativo é igual à configuração Ativar Distribuição de Binários, Expansão e Limpeza Pós-desinstalação em uma página Binários do Aplicativo.
Tipo de Dados | Booleano |
Padrão | true |
Especifica se o servidor de aplicativos utiliza a ligação, as extensões e os descritores de implementação localizados no documento de implementação do aplicativo, o arquivo deployment.xml (padrão), ou aqueles localizados no arquivo EAR (Enterprise Archive). Selecione essa configuração somente para aplicativos instalados nos destinos de implementação da Versão 6.0 ou posterior. Esta definição não é válida para aplicativos instalados em destinos de implementação 5.x.
O padrão (false) é não utilizar a ligação, as extensões e os descritores de implementação localizados no deployment.xml. Para utilizar a ligação, as extensões e os descritores de implementação localizados no arquivo EAR, ative essa configuração (true).
Esse campo Utilizar Configuração Binária é igual à configuração Utilizar Informações de Configuração em Binário em uma página Binários do Aplicativo.
Tipo de Dados | Booleano |
Padrão | false |
Especifica se a ferramenta EJBDeploy é executada durante a instalação do aplicativo.
A ferramenta de implementação EJB é executada durante a instalação de módulos EJB 1.x ou 2.x. A ferramenta de implementação de EJB não é executada durante a instalação de módulos EJB 3.0.
Para essa opção, instale somente em um destino de implementação da Versão 6.1 ou posterior.
Se você selecionar Implementar Enterprise Beans e tentar instalar seu aplicativo em um destino de implementação mais antigo, tal como a Versão 6.0, a instalação será rejeitada. É possível implementar aplicativos apenas para os destinos que possuem a mesma versão do WebSphere que o produto. Se os aplicativos forem destinados a servidores que possuem uma versão anterior àquela do produto, então não será possível implementar em tais destinos.
Também, se você selecionar Implementar enterprise beans e especificar um tipo de banco de dados na página Fornecer opções para executar a Implementação EJB, os IDs de backend definidos anteriormente para todos os módulos são sobrescritos pelo tipo de banco de dados escolhido. Para ativar IDs de backend para módulos EJB individuais, defina o tipo de banco de dados para "" (nulo) na página Fornecer opções para executar a Implementação EJB.
A ativação dessa configuração pode fazer com que o programa de instalação seja executado por vários minutos.
Tipo de Dados | Booleano |
Padrão | true (false para módulos EJB 3.0) |
Especifica um nome lógico para o aplicativo. Um nome de aplicativo deve ser exclusivo em uma célula e não pode conter um caractere não suportado.
Um nome de aplicativo não pode começar com um ponto (.), não pode conter espaços iniciais ou finais e não pode conter nenhum dos seguintes caracteres:
Caracteres não suportados | ||
---|---|---|
/ barra | $ símbolo do dólar | ' aspas simples |
\ barra invertida | = sinal de igual | " aspas duplas |
* asterisco | % sinal de porcentagem | | barra vertical |
, vírgula | + sinal de mais | < sinal de menor |
: dois pontos | @ sinal de arroba | > sinal de maior |
; ponto e vírgula | # sustenido | & e comercial |
? ponto de interrogação | ]]> Não existe nenhum nome específico para essa combinação de caracteres |
Esse campo Nome do Aplicativo é igual à configuração Nome em uma página Configurações do Aplicativo Corporativo.
Tipo de Dados | Cadeia |
Especifica se MBeans devem ser criados para recursos como servlets ou arquivos JSP em um aplicativo quando o aplicativo for iniciado. O padrão é criar MBeans.
Esse campo é igual à configuração Criar MBeans para Recursos em uma página Comportamento de Inicialização.
Tipo de Dados | Booleano |
Padrão | true |
Especifica se o tempo de execução do produto detecta alterações nas classes de aplicativos quando o aplicativo está em execução. Se essa configuração estiver ativada e se as classes de aplicativos estiverem alteradas, então, o aplicativo é parado e reiniciado para recarregar classes atualizadas.
O padrão é não ativar o recarregamento da classe.
Esse campo é o mesmo que a configuração Substituir Configurações de Recarregamento de Classe para Módulos da Web e EJB em uma página Carregamento de Classes e Detecção de Atualização.
Tipo de Dados | Booleano |
Padrão | false |
Especifica o número de segundos para varrer o sistema de arquivos do aplicativo para arquivos atualizados. O padrão é o valor do atributo do intervalo de recarregamento no arquivo de extensões IBM (META-INF/ibm-application-ext.xmi) do arquivo EAR.
O atributo do intervalo de recarregamento terá efeito somente se o recarregamento da classes estiver ativado.
Para ativar o recarregamento, especifique um valor maior que zero (por exemplo, 1 a 2147483647). Para desativar o recarregamento, especifique zero (0). O intervalo é de 0 a 2147483647.
Esse campo Recarregar Intervalo em Segundos é igual à configuração Intervalo de Sondagem para Arquivos Atualizados em uma página Carregamento de Classes e Detecção de Atualização.
Tipo de Dados | Inteiro |
Unidades | Segundos |
Padrão | 3 |
Especifica se a ferramenta de implementação de serviços da Web wsdeploy é executada durante a instalação do aplicativo.
A ferramenta gera o código necessário para executar os aplicativos utilizando os serviços da Web. O padrão é não executar a ferramenta wsdeploy. Você deve ativar essa configuração se o arquivo EAR contiver módulos utilizando serviços da Web e se a ferramenta wsdeploy não tiver sido executada nele anteriormente, a partir da opção de menu Implementar de uma ferramenta de montagem ou a partir de uma linha de comandos.
Para essa opção, instale somente em um destino de implementação da Versão 6.1 ou posterior.
Se você selecionar Implementar Serviços da Web e tentar instalar seu aplicativo em um destino de implementação mais antigo, tal como a Versão 5.x, a instalação será rejeitada. É possível implementar aplicativos apenas para os destinos que possuem a mesma versão que o produto. Se os aplicativos forem destinados a servidores que possuem uma versão anterior àquela do produto, então não será possível implementar em tais destinos.
Tipo de Dados | Booleano |
Padrão | false |
Especifica se o produto examina as referências do aplicativo especificadas durante a instalação ou atualização do aplicativo e, se a validação estiver ativada, você será avisado sobre referências incorretas ou falhas na operação.
Geralmente, um aplicativo se refere a recursos utilizando origens de dados para beans CMP (Container Managed Persistence) ou utilizando referências de recursos ou referências de ambientes de recursos definidas em descritores de implementação. A validação verifica se o recurso referido pelo aplicativo está definido no escopo do destino de implementação desse aplicativo.
Selecione off para nenhuma validação de recurso, warn para mensagens de aviso sobre referências de recursos incorretas ou fail para parar operações que falham devido a referências de recursos incorretas.
Esse campo Validar Desativação/Aviso/Falha de Entrada é igual à configuração Validação de Referência do Aplicativo na página Configurações do Aplicativo Corporativo.
Tipo de Dados | Cadeia |
Padrão | warn |
Especifica se a configuração incorporada deve ser processada. Uma configuração incorporada consiste em arquivos, como o resource.xml e o variables.xml. Quando selecionada ou true, a configuração integrada é carregada no escopo do aplicativo a partir do arquivo .ear. Se o arquivo .ear não contiver uma configuração integrada, o padrão será false. Se o arquivo .ear contiver uma configuração integrada, o padrão será true.
Essa configuração afeta a instalação dos arquivos EAR aprimorados. Um arquivo EAR aprimorado resulta quando você exporta um aplicativo instalado.
Quando false, um arquivo EAR aprimorado é instalado como qualquer outro aplicativo e o produto ignora sua configuração integrada.
Se você exportou o aplicativo de uma célula que não seja a célula atual e não especificou a variável $(CELL) para Diretório para Instalar Aplicativo ao instalar o aplicativo pela primeira vez, cancele a seleção dessa configuração (false) para expandir o arquivo EAR aprimorado no diretório profile_root/installedApps/current_cell_name. Caso contrário, se essa configuração estiver selecionada (true), o arquivo EAR aprimorado será expandido no diretório profile_root/installedApps/original_cell_name, em que original_cell_name é a célula na qual o aplicativo foi instalado pela primeira vez. Se você especificou a variável $(CELL) para Diretório para Instalar Aplicativo ao instalar o aplicativo pela primeira vez, a instalação expandirá o arquivo EAR aprimorado no diretório profile_root/installedApps/current_cell_name.
Tipo de Dados | Booleano |
Padrão | false (seleção cancelada) |
Especifica as permissões de acesso para os binários de aplicativos para aplicativos instalados expandidos para o diretório especificado.
A opção Distribuir Aplicativo deve ser ativada para especificar permissões de arquivo.
É possível especificar permissões de arquivos no campo de texto. Também é possível configurar algumas das permissões de arquivo mais utilizadas selecionando-as na lista de seleção múltipla. As seleções da lista sobrescrevem as permissões de arquivo configuradas no campo de texto.
Você pode configurar uma ou mais das seguintes cadeias de permissão de arquivo na lista. A seleção de várias opções combina as cadeias de permissão de arquivo.
Opção da Lista de Seleção Múltipla | Cadeia de Permissão de Arquivo Configurada |
---|---|
Permitir que todos os arquivos sejam lidos, mas não gravados | .*=755 |
Permitir que executáveis sejam executados | .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 |
Permitir que arquivos HTML e de imagem sejam lidos por todos | .*\.htm=755#.*\.html=755#.*\.gif=755#.*\.jpg=755 |
Em vez de utilizar a lista de seleção múltipla para especificar permissões de arquivo, você pode especificar uma cadeia de permissão de arquivo no campo de texto. As permissões de arquivo utilizam uma cadeia que tem o seguinte formato:
file_name_pattern=permission#file_name_pattern=permission
em que file_name_pattern é um filtro de nome de arquivo de expressão comum (por exemplo, .*\\.jsp para todos os arquivos JSP), permission fornece as ACLs (Listas de Controle de Acesso) e # é o separador entre várias entradas de file_name_pattern e permission. Se # for um caractere em uma cadeia file_name_pattern, utilize \#.
Se vários padrões de nome de arquivo e permissões de arquivo na cadeia corresponderem a um URI (Identificador Uniforme de Recursos) no aplicativo, o produto utilizará a permissão de arquivo aplicável mais rígida para o arquivo. Por exemplo, se a cadeia de permissão do arquivo for .*\\.jsp=775#a.*\\.jsp=754, o arquivoabc.jsp terá a permissão 754.
1 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war |
2 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jsp |
3 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/META-INF/MANIFEST.MF |
4 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/WEB-INF/classes/MyClass.class |
5 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/mydir/MyClass2.class |
6 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/META-INF |
Os resultados de correspondência de arquivo são:
/opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jspe você especifique a seguinte cadeia de padrão de arquivo a seguir:
.*MyApp.ear$=755#.*\.jsp=644Os resultados de correspondência de arquivo são:
Não é possível desconfigurar a permissão de leitura de um arquivo nas plataformas
Windows. Com bits de permissão de estilo POSIX, o bit para denotar legível em um arquivo é 4, gravável é 2 e executável é 1. Assim, no estilo POSIX, há permissões de usuário, grupo e global.
Você pode configurar a permissão usuário somente para um arquivo nas plataformas Windows. Os bits de permissão grupo e global são ignorados.
As permissões de acesso especificadas aqui estão no nível do aplicativo. Também é possível especificar permissões de acesso para binários de aplicativo na configuração no nível do nó. As permissões do arquivo no nível do nó especificam o máximo de permissões (mais tolerante) que podem ser fornecidas a binários de aplicativo. As permissões de acesso especificadas aqui no nível do aplicativo podem ser somente as mesmas ou mais rígidas que as especificadas no nível do nó.
Essa configuração é igual ao campo Permissões de Arquivo na página Binários do Aplicativo.
Tipo de Dados | Cadeia |
Especifica uma cadeia não editável que identifica a versão do build do aplicativo.
Esse campo Identificador de Construção do Aplicativo é igual ao campo Nível de Construção do Aplicativo na página Binários do Aplicativo.
Tipo de Dados | Cadeia |
Especifica se um aplicativo pode efetuar dispatch de inclusões para recursos em módulos da Web que estão em diferentes Java Virtual Machines em um ambiente de nós gerenciado através do mecanismo do dispatcher do pedido padrão.
Esse campo é igual ao campo Permitir Inclusões de Dispatch para Recursos Remotos na página Propriedades de Dispatch de Pedido Remoto.
Tipo de Dados | Booleano |
Padrão | false |
Especifica se um aplicativo corporativo pode atender um pedido de inclusão a partir de um aplicativo.
Esse campo é igual ao campo Permitir Inclusões de Serviço de Recursos Remotos na página Propriedades de Dispatch de Pedido Remoto.
Tipo de Dados | Booleano |
Padrão | false |
Especifica se o produto cria um novo aplicativo de nível de negócios com o aplicativo corporativo que você está instalando ou torna o aplicativo corporativo uma unidade de composição de um aplicativo de nível de negócios existente.
O padrão é criar um novo aplicativo de nível de negócios com um valor de configuração de WebSphere:blaname=Anyasset,blaedition=BASE. Quando você seleciona para criar um novo aplicativo de nível de negócios na lista drop-down, o produto cria um aplicativo de nível de negócios com o mesmo nome que seu aplicativo corporativo. Se um aplicativo de nível de negócios com o nome do seu aplicativo corporativo já existir, o produto não criará um novo aplicativo de nível de negócios; ele incluirá seu aplicativo corporativo como uma unidade de composição nesse aplicativo de nível de negócios existente.
Para incluir o aplicativo corporativo em um aplicativo de nível de negócios existente, selecione um aplicativo de nível de negócios existente na lista drop-down. O produto torna o aplicativo corporativo uma unidade de composição do aplicativo de nível de negócios existente.
Tipo de Dados | Cadeia |
Padrão | Crie um novo aplicativo de nível de negócios com o mesmo nome que
o aplicativo corporativo que está sendo instalado. WebSphere:blaname=Anyasset,blaedition=BASE |
Especifica se os módulos da Web podem efetuar dispatch de pedidos simultaneamente em encadeamentos separados e, se sim, se o servidor ou cliente efetua dispatch dos pedidos O dispatch simultâneo pode melhorar o tempo de resposta do servlet.
Se as operações forem dependentes umas das outras, não ative o dispatch de pedido assíncrono. Selecione Desativado. O dispatch simultâneo poderá resultar em erros quando as operações forem dependentes.
Selecione Lado do Servidor para possibilitar que o servidor efetue dispatch de pedidos simultaneamente. Selecione Lado do Cliente para possibilitar que o cliente efetue dispatch de pedidos simultaneamente.
Tipo de Dados | Cadeia |
Padrão | Desativado |
Especifica se o produto designará valores padrão de JNDI ou se resolverá automaticamente os destinos de referência EJB incompleta.
Selecione essa opção para possibilitar que os destinos de referência EJB sejam resolvidos automaticamente se as referências forem de módulos EJB 2.1 ou Web 2.3 ou anteriores. Se você ativar essa opção, o contêiner de tempo de execução fornecerá um valor padrão ou resolverá automaticamente a referência EJB para qualquer referência EJB que não tiver uma ligação.
Se você selecionou Gerar Ligações Padrão na página Preparando para a Instalação do Aplicativo, não será necessário selecionar essa opção. O produto gera valores padrão.
Se você selecionar Permitir que destinos de referência EJB sejam resolvidos automaticamente, todos os módulos no aplicativo deverão compartilhar um destino de implementação. Se essa opção for selecionada e os módulos aplicativos não compartilharem um servidor comum, depois que você clicar em Concluir na página Resumo, o produto exibirá uma mensagem de aviso e não instalará o aplicativo. É necessário cancelar a seleção dessa configuração antes de clicar em Concluir para instalar o aplicativo.
Tipo de Dados | Booleano |
Padrão | false |
Links marcados (on-line) requerem acesso à Internet.