Ferramentas de Teste e de Implementação - Notas sobre o Release

1.0 Introdução
2.0 Software Suportado e Especificações
3.0 Alterações do Release Anterior
4.0 Limitações
   4.1 O WebSphere Server Deve Ter Página de Código Correspondente
5.0 Problemas Conhecidos
   5.1 Configurando o J2C Resource Adapters para WebSphere v5
   5.2 O WebSphere Application Server Não Pode Ser Criado nem Iniciado Devido a Caracteres Inválidos
   5.3 Nomes de Diretórios Longos Podem Causar Erros no Teste de JSP
   5.4 Internet Explorer: Desativar Servidor Proxy ou Socks ao Utilizar Endereços Locais
   5.5 Problemas ao Utilizar o Apache Tomcat Quando Desconectado da Internet
   5.6 Segurança do Servidor WebSphere
   5.7 Executando Aplicativos Java Que Se Conectam ao WebSphere Application Server
   5.8 Executando o WebSphere V4.0 Administrative Client com Segurança Ativada
   5.9 Versões do WebSphere Test Environment
   5.10 Utilizando Construtores no Universal Test Client
   5.11 Problema de Distinção entre Maiúsculas e Minúsculas ao Publicar o Servidor V5 Remoto no Windows
   5.12 URL de Provedor JNDI Padrão no Universal Test Client
   5.13 O Cliente J2EE Não Pode Acessar o Servidor do Ambiente de Teste em uma Máquina Remota
   5.14 Rastreando com o WebSphere Versão 4.0
   5.15 Alguns Arquivos São Deixados para Trás Após a Desinstalação do Tempo de Execução do WebSphere V4
   5.16 Mensagem ao Aplicar o PTF do WebSphere V4
   5.17 Criando Origens de Dados e Servidores no WebSphere v5 Administration Console
   5.18 Movendo Configurações do Servidor e Renomeando Projetos do Servidor
   5.19 Path Options do Servidor WebSphere
   5.20 Configurando um Servidor Remoto para Utilizar o Embedded Messaging
   5.21 Ignorar Mensagem Embedded Messaging client only has been installed message na Exibição do Console
   5.22 Configurando o Cloudscape 5.1
   5.23 Republicar o WebSphere Server para a Máquina AIX Causa Mensagem de Aviso
   5.24 Depuração de Velocidade Máxima e Suporte de Substituição de Método a Quente
   5.25 Migração do WebSphere MQ
   5.26 Migração de Projetos do Conector Implementado do WebSphere Studio v5.0
   5.27 Os Servidores WebSphere Não Estão Iniciando Porque o Espaço de Trabalho Começa com Barra Invertida
   5.28 Possível Corrupção do Servidor Durante Salvamento de Nova Entrada de Autenticação do JAAS

1.0 Introdução

O recurso Server Tools permite testar e publicar aplicativos J2EE em ambientes de tempo de execução local e remoto diferentes. O arquivo readme descreve as limitações, problemas conhecidos e alternativas associadas às seguintes funções do Server Tools:

A ajuda on-line para testar e publicar contém informações adicionais sobre as restrições das Server Tools e sobre como contornar os problemas nas Server Tools.

Para obter informações sobre ambientes de tempo de execução suportados, consulte o readme do produto.

2.0 Software Suportado e Especificações

O Universal Test Client requer a utilização do Netscape Versão 6.0 ou superior ou o Microsoft Internet Explorer 5.0 ou superior

3.0 Alterações do Release Anterior

As ferramentas do servidor suportam os testes e publicação de projetos para servidores WebSphere em máquinas Windows, Linux e AIX.

4.0 Limitações

4.1 O WebSphere Server Deve Ter Página de Código Correspondente

Quando testar com servidores WebSphere, a máquina remota deve ter a mesma página de código que a máquina local. A execução do servidor local e remoto com páginas de códigos diferentes não é suportada e pode fazer com que o console fique danificado.

5.0 Problemas Conhecidos

5.1 Configurando o J2C Resource Adapters para WebSphere v5

Você pode receber um erro ao clicar no botão Add na página J2C do editor de configuração do servidor WebSphere v5. Para solucionar esse problema, configure o módulo do conector em um EAR ou execute as seguintes etapas:

1. Ative o console administrativo do WebSphere e inicie o servidor.

2. Abra e efetue login no console administrativo. Selecione Resources > Resource Adapters à esquerda.

3. Clique em New. Insira o Name do módulo do conector e especifique o caminho completo para a pasta connectorModule em seu projeto. Por exemplo, C:\workspace\myConnector\connectorModule.

4. Clique em Apply e, em seguida, em Refresh no projeto do servidor no IDE. Você pode continuar a utilizar o editor de configuração do servidor para quaisquer alterações adicionais.

5.2 O WebSphere Application Server Não Pode Ser Criado nem Iniciado Devido a Caracteres Inválidos

Se você instalar o WebSphere Studio em um diretório cujo nome contenha um cifrão ($) ou qualquer caractere incomum como #, %, + ou *, o servidor WebSphere poderá não ser criado ou não será iniciado com êxito. Para evitar isso, não instale o WebSphere Studio em um diretório que contenha um desses caracteres.

Ao criar um servidor WebSphere ou um projeto de servidor que irá conter um servidor WebSphere, não inclua os caracteres #, %, & ou * no nome. O WebSphere Application Server não suporta esses caracteres.

5.3 Nomes de Diretórios Longos Podem Causar Erros nos Testes de JSP

Se você utilizar um espaço de trabalho em um diretório com um caminho longo ou escolher nomes longos para seu projeto de Aplicativo Corporativo ou projeto Web, a seguinte mensagem de erro pode ser obtida ao tentar executar uma página JSP:

Error Message: JSPG0113E: JSP file
"Xxx/Yyy_jsp_0.java (Filename too long)" not found

Se você receber esse erro, uma das seguintes ações podem ser tomadas:

5.4 Internet Explorer: Desativar Servidor Proxy ou Socks Quando Utilizar Endereços Locais

Se estiver usando um servidor proxy ou socks no Internet Explorer, ele deve ser desativado para endereços locais. Caso contrário, isso poderá causar problemas quando você tentar exibir o Universal Test Client ou quaisquer outros aplicativos da Web ao utilizar o navegador da Web interno ou a versão instalada do Microsoft Internet Explorer.

5.5 Problemas ao Utilizar o Apache Tomcat Quando Desconectado da Internet

O arquivo web.xml padrão enviado com o Apache Tomcat contém uma referência para um arquivo DTD na Internet. Devido a isso, os servidores Tomcat não iniciarão quando desconectado da Internet. No WebSphere Studio, essas referências foram removidas da configuração do Tomcat versão 3.2 de modo que você possa trabalhar enquanto executa no modo autônomo. Se você importar uma configuração do servidor Tomcat do WebSphere Studio externo ou estiver usando o Tomcat versão 4.0, você pode ter problemas trabalhando enquanto desconectado da Internet. Se isso ocorrer, execute as seguintes etapas para remover essa referência.

  1. Faça backup do arquivo web.xml da configuração do seu servidor Tomcat.
  2. Edite o arquivo web.xml na configuração do seu servidor Tomcat usando um editor de texto.
  3. Remova o elemento DOCTYPE inteiramente do arquivo.
  4. Salve e feche o editor.
Se você tiver problemas ao iniciar o servidor, pode ser necessário conectar-se à Internet e incluir novamente o elemento DOCTYPE utilizando o arquivo web.xml de backup.

5.6 Segurança do Servidor WebSphere

Quando ativar a segurança para um servidor, não forneça a ele um ID de servidor que possua o mesmo nome que a máquina na qual o WebSphere Application Server está instalado. Caso contrário, o WebSphere Application Server poderá falhar ao iniciar.

O critério de Direitos do Usuário para o ID de usuário do servidor deve também conceder ao usuário o privilégio de Act as part of the operating system.

5.7 Executando Aplicativos Java Que Se Conectam ao WebSphere Application Server

O WebSphere Application Server tem uma restrição que determina que todos os aplicativos Java que utilizam o cliente WebSphere para se conectarem a beans corporativos em execução em um servidor WebSphere devem utilizar o mesmo nível do IBM Java ORB que foi utilizado para construir o cliente WebSphere. Se você não utilizar o mesmo nível de ORB, poderá receber um erro semelhante ao mostrado a seguir quando executar o aplicativo cliente:

java.lang.NoClassDefFoundError: com/ibm/rmi/iiop/GIOPVersionException

Para assegurar que o nível ORB correto seja utilizado, você pode executar o aplicativo cliente utilizando o WebSphere JRE. Para fazer isso, execute as etapas a seguir:

  1. Abra o diálogo Launch Configurations utilizando os itens de menu Run > Run ou Run > Debug na perspectiva Debug.
  2. Selecione a Configuração de Lançamento de Aplicativo Java que você deseja editar.
  3. Vá para a página JRE e selecione o WebSphere JRE apropriado a partir da caixa de combinação.
  4. Aplique as alterações.

Como alternativa, você pode executar o aplicativo cliente com qualquer JRE contanto que assegure que o nível de ORB correspondente seja utilizado. Para fazer isso, execute as etapas a seguir:

  1. Abra o diálogo Launch Configurations utilizando os itens de menu Run > Run ou Run > Debug na perspectiva Debug.
  2. Selecione a Configuração de Lançamento de Aplicativo Java que você deseja editar.
  3. Vá para a página Arguments e inclua o seguinte no campo VM Arguments:
    -Xbootclasspath/p:WAS_installdir\java\jre\lib\ext\ibmorb.jar
    em que WAS_installdir é o diretório que contém o tempo de execução, por ex., c:\Program Files\IBM\WebSphere Studio\runtimes\aes_v4
  4. Aplique as alterações.

5.8 Executando o WebSphere V4.0 Administrative Client com Segurança Ativada

O WebSphere Versão 4 Administrative Client não pode ser lançado diretamente a partir do workbench quando a segurança está ativada. Para lançar o cliente administrativo, siga estas etapas:

  1. Inicie o servidor WebSphere.
  2. Abra um navegador da Web e digite a seguinte URL: http://[localhost:8080]/admin, em que [localhost:8080] é o nome do servidor e porta que você está utilizado.
  3. Digite o ID do usuário e senha utilizados para configurar a segurança. Clique em Send.
  4. Na área de janela à direita, clique em Configuration > Open.
  5. Selecione "Enter full path to file on server".
  6. Digite o caminho completo para a configuração do servidor no campo de texto. Por exemplo: C:\studio\eclipse\workspace\Servers\was.wsc\server-cfg.xml.
  7. Clicar em OK.

5.9 Versões do Ambiente de Teste do WebSphere

O ambiente de teste do WebSphere Versão 4 baseia-se no WebSphere versão 4.06. O ambiente de teste do WebSphere Versão 5 baseia-se no WebSphere versão 5.02. Quando migrar de uma versão anterior do WebSphere Studio, os e-fixes para o Ambiente de Teste do WebSphere serão removidos e você deve reinstalá-los manualmente.

5.10 Utilizando Construtores no Universal Test Client

Ao utilizar o Universal Test Client, você não poderá construir objetos que consideram interfaces como parâmetros na página de parâmetros. Todos os objetos a ser construídos a partir de parâmetros com tipos de interface devem utilizar a seção de referências de classe.

Primeiro carregue e construa um objeto do tipo interface ou abstrato. Em seguida, carregue a classe que contém o construtor com o tipo abstrato/interface. Agora escolha o objeto pré-criado na página de parâmetros.

5.11 Problema de Distinção entre Maiúsculas e Minúsculas ao Publicar o Servidor Remoto V5 no Windows

Se um projeto foi publicado em um servidor V5 remoto no Windows e, em seguida, o projeto for renomeado com o mesmo nome, mas com maiúsculas e minúsculas diferentes, ex.: renomear "MyEarProject" para "myearproject", poderão ocorrer alguns erros File does not exist durante a inicialização do servidor. É uma limitação do Windows que o WebSphere Studio não pode distinguir entre os dois projetos publicados com o mesmo nome com maiúsculas e minúsculas diferentes. O problema pode ser corrigido manualmente removendo a configuração do servidor publicada da máquina remota e, em seguida, republicando o projeto.

5.12 URL do Provedor JNDI Padrão no Universal Test Client

O URL do provedor JNDI padrão para o Universal Test Client foi alterada do WebSphere Studio versão 4.0. O novo URl do provedor é "iiop://2809", em vez de "iiop://900". Se você estiver lançando o cliente de teste manualmente e precisar do antigo número da porta (por ex.: para acessar o WebSphere v4.0), você pode alterar a URL do provedor através da página Properties no cliente de teste.

5.13 O Cliente J2EE Não Pode Acessar o Servidor de Ambiente de Teste em uma Máquina Remota

Você pode obter org.omg.CORBA.COMM_FAILURE ao tentar acessar um servidor de ambiente de teste a partir de um cliente J2EE em execução em uma máquina remota. É preciso configurar o nome do host de bootstrap do ORB definido na configuração do servidor remoto para corrigir o problema. Para editar o nome do host de bootstrap do ORB, vá para a página Ports do editor do servidor e defina o campo Host name na seção da porta de bootstrap do ORB como o nome do host remoto.

Depois de fazer a alteração, salve as alterações e reinicie o servidor do ambiente de teste para que as alterações sejam efetivadas.

5.14 Rastreando com o WebSphere Versão 4.0

Se você desativar o rastreio para o WebSphere versão 4.0, receberá uma ConnectionException no console e não poderá parar o servidor corretamente.

5.15 Alguns Arquivos São Deixados para Trás Após a Desinstalação do Tempo de Execução do WebSphere V4

Quando o tempo de execução do WebSphere V4 é desinstalado, o diretório WS_installdir/runtimes/aes_v4 ainda existirá depois da desinstalação. Você precisa remover manualmente este diretório caso ele ainda exista; de outro modo, você pode encontrar alguns problemas no suporte ao servidor WebSphere V4. A mesma verificação precisa ser feita manualmente se o WebSphere Studio for desinstalado e instalado na mesma localização novamente.

5.16 Mensagem ao Aplicar PTF do WebSphere V4

Ao aplicar o PTF do WebSphere V4, você pode ver a mensagem "NOTE: Please regenerate the plugin configuration once the server is started in order to update the plugin-cfg.xml file". Você pode ignorar essa mensagem.

5.17 Criando Origens de Dados e Servidores no Console de Administração do WebSphere v5

Você pode receber uma NullPointerException ou outros erros ao adicionar origens de dados ou criar servidores utilizando o Console de Administração do WebSphere v5 dentro do WebSphere Studio. Utilize uma das seguintes soluções alternativas:

  1. Se estiver criando uma origem de dados, utilize o editor do servidor WebSphere v5 em vez dele. O editor pode ser aberto clicando duplamente em seu servidor WebSphere v5 na exibição Servers ou Server Configurations. Vá para a página Data source para adicionar, editar ou remover origens de dados do servidor.
  2. Pare o servidor.
    1. Copie o diretório de gabaritos do seguinte diretório (em que WS_installdir é o diretório onde o WebSphere Studio está instalado):
      WS_installdir\runtimes\base_v5\config\templates
      para seu espaço de trabalho atual sob:
      pasta workspace_ dir\server_project\server_ name.wsc
    2. Reinicie o servidor e tente novamente.

5.18 Movendo Configurações do Servidor e Renomeando Projetos do Servidor

A associação entre um servidor e sua configuração de servidor inclui o projeto em que reside a configuração do servidor. Quando se renomeia um projeto de servidor ou se move uma configuração de servidor para um projeto diferente, quaisquer servidores que utilizem as configurações terão suas associações interrompidas. Para resolver o problema, na exibição Servers, clique com o botão direito do mouse no servidor e selecione Switch Configuration > server_configuration_name para associar novamente a configuração ao servidor.

5.19 Path Options para Servidor WebSphere

A funcionalidade Path Option na página Environment do editor de servidor WebSphere não funciona. O caminho inserido no campo Java Library Path será adicionado ao PATH existente do servidor. Você não terá controle sobre onde os dados são adicionados, por exemplo, se os dados são adicionados ao início, ao final ou substituindo o PATH existente do servidor.

5.20 Configurando um Servidor Remoto para Utilizar Embedded Messaging

No tópico Definindo um Servidor para Utilizar Embedded Messaging, algumas partes do conteúdo para a sessão Test Environment aplicam-se às instruções na seção Remote Server. Os seguintes precisam ser definidos para uma configuração de servidor local ou remoto: WAS_PUBSUB_ROOT, MQ_INSTALL_ROOT e um Gerenciador de Filas no lado do servidor. Além disso, também é necessário ter uma entrada na seção ws.ext.dirs da configuração do servidor apontando para o diretório java/lib em que o WebSphere MQ está instalado.

Instruções sobre a configuração de um Gerenciador de Filas podem ser encontradas na seção Test Environment deste tópico. O mesmo arquivo em batch createmq existe em uma máquina independente do WebSphere Application Server  no mesmo diretório relativo à raiz da instalação do WebSphere Application Server. Será necessário executar esta etapa se você estiver implementando remotamente seu servidor a partir do WebSphere Studio para uma máquina remota do WebSphere Application Server.

Nota: Se você tiver instalado Embedded Messaging com o instalador do WebSphere Studio, não precisa executar createmq.bat nem configurar variables.xml ou criar um arquivo em batch para ativar o workbench assegurando que os binários do MQ estão no caminho do servidor do WAS. Ainda é preciso fazer a adição ao ws.ext.dirs no servidor. Esta tarefa somente é necessária se você tiver instalado Embedded Messaging com o instalador do WebSphere Application Server.

5.21 Ignorar Mensagem Embedded Messaging client only has been installed na Exibição do Console

Durante a inicialização do ambiente de teste do WebSphere v5.0, você pode ver uma mensagem na exibição do Console que diz "Embedded Messaging client only has been installed", embora o Embedded Messaging, um componente opcional, não tenha sido instalado como parte da instalação do WebSphere Studio. Essa mensagem pode ser desconsiderada e não significa que o Embedded Messaging foi instalado, mas sim que certas variáveis de configuração do servidor estão definidas, as quais geram esta mensagem confusa.

5.22 Configurando o Cloudscape 5.1

Para instalar o Cloudscape 5.1, execute o arquivo installCloudscape51.bat no Windows ou o arquivo Cloudscape51.sh no Linux. Esse arquivo está localizado no diretório WS_installdir/runtimes/base_v5/cloudscape51 (em que WSinstalldir é o diretório onde o WebSphere Studio foi instalado. O instalador ativa um instalador do Cloudscape específico para o WebSphere. Quando consultado sobre o Directory name, procure ou digite seu diretório WS_installdir/runtimes/base_v5.

Nota: Depois de instalar o Cloudscape 5.1, você não poderá executar nem ter nenhuma origem de dados definida no Cloudscape 5.0. Se quiser executar o Cloudscape 5.0, você deverá primeiro desinstalar o Cloudscape 5.1 e, em seguida, remover as origens de dados do Cloudscape 5.1 ou alterá-las para origens de dados do Cloudscape 5.0.

5.23 Republicar o WebSphere Server para a Máquina AIX Causa Mensagem de Aviso

Ao republicar um WebSphere server em uma máquina AIX, podem ser obtidas algumas mensagens de aviso sobre falha para excluir alguns arquivos na caixa de diálogo de publicação. Essas mensagens de aviso podem ser seguramente ignoradas.

5.24 Depuração de Velocidade Máxima e Suporte de Substituição de Método a Quente

A depuração de velocidade máxima e a substituição de método a quente apenas são suportadas durante a depuração no ambiente de teste do WebSphere V5. Os aplicativos de depuração fora do ambiente de teste do WebSphere V5 não são suportados.

5.25 Migração do WebSphere MQ

O componente WebSphere MQ não suporta compatibilidade de versão cruzada. É necessário assegurar que a versão do WebSphere MQ que você está utilizando esteja no mesmo nível de fixpack que o ambiente de teste do WebSphere ou servidor WebSphere no qual você está implementando.

Por exemplo, você não deve utilizar o WebSphere MQ instalado pelo WebSphere Studio v5.0 com um ambiente de teste do WebSphere v5.0.2. Em vez disso, é necessário desinstalar o WebSphere MQ e instalar a versão enviada com o WebSphere Studio v5.1.

5.26 Migração de Projetos do Conector Implementado do WebSphere Studio v5.0

Os espaços de trabalhos criados no WebSphere Studio v5.0 contendo projeto do conector implementado em um ambiente de teste do WebSphere ou em um servidor WebSphere não são migrados automaticamente ao se moverem para um release superior. Você pode receber erros ao tentar publicar os projetos do conector no servidor.

Para resolver o problema, na exibição Servers, clique com o botão direito do mouse no servidor e selecione Add and remove projects. Remova o projeto EAR do servidor e, em seguida, adicione-o novamente. Isso irá corrigir a configuração do servidor WebSphere, para que os projetos do conector sejam corretamente implementados.

5.27 Os Servidores WebSphere Não Estão Iniciando Porque o Espaço de Trabalho Começa com Barra Invertida

Os servidores WebSphere não podem ser iniciados ao utilizar um caminho do espaço de trabalho que começa com uma barra invertida. Alguns exemplos de caminhos de espaços de trabalhos que irão provocar o problema:

 \workspaceA
 \my_workspaces\work1 

Os caminhos de espaços de trabalhos que começam com uma letra da unidade ou que não começam com uma barra invertida não irão provocar esse problema. Se você já tiver iniciado o WebSphere Studio com um espaço de trabalho que começa com uma barra invertida, em seguida, siga estas etapas para permitir que os servidores WebSphere sejam iniciados:

  1. Encerre o WebSphere Studio.
  2. Inicie novamente o WebSphere Studio (utilize o sinalizador -setworkspace, se você tiver optado anteriormente por ocultar a caixa de diálogo de seleção de espaço de trabalho na inicialização).
  3. Quando solicitado a informar a localização do espaço de trabalho, adicione a letra da unidade no começo do caminho do espaço de trabalho. Por exemplo,  \workspace1 ficaria c:\workspace1.
  4. Agora, você pode iniciar o servidor WebSphere.

5.28 Possível Corrupção do Servidor Durante Salvamento de Nova Entrada de Autenticação do JAAS

Se você abrir um editor do servidor V5, crie e salve uma nova Entrada de Autenticação do JAAS sem sair do editor e, em seguida, vá para a guia Data source e adicione uma origem de dados V5, um diálogo File changed aparecerá. Você deve clicar em NO para evitar corromper a configuração do servidor.

Retornar para o arquivo leia-me principal