Outubro de 2006 [Número da revisão: V1-0]
A plataforma Java Enterprise Edition 5 (Java EE 5) Tools Bundle inclui NetBeans IDE 5.5, NetBeans Enterprise Pack 5.5 e a plataforma Java Enterprise Edition 5 SDK atualização 1 (Java EE 5 SDK atualização 1). O NetBeans Enterprise Pack 5.5 inclui módulos de ferramentas do esquema XML, módulos BPEL, módulos de serviços de segurança da Web, Project Open ESB Starter Kit, Sun Java System Access Manager 7.1 e Sun Java System Policy Agent 2.2 for Sun Java System Application Server 9.0 atualização 1/ Web Services.
Estas notas da versão se aplicam ao Java EE 5 Tools Bundle.
Observação: A funcionalidade UML já não está disponível na versão final (primeira remessa a clientes) para download do NetBeans Enterprise Pack 5.5. Mas é oferecida separadamente na Central de atualizações automáticas.
Conteúdo
|
Observação: Se quiser informações sobre a instalação do software incluído no Java EE 5 Tools Bundle, consulte as Notas da versão do Java EE 5 Tools Bundle.
Sistemas operacionais suportados
O NetBeans IDE 5.5 pode ser executado nos sistemas operacionais que oferecem suporte à máquina virtual Java. Abaixo se encontram as plataformas nas quais o Java EE 5 Tools Bundle foi testado.
O NetBeans Enterprise Pack também pode ser executado nas seguintes plataformas:
Configuração mínima de hardware
Observação: A resolução mínima da tela do IDE do NetBeans é de 1024x768 pixels.
Configuração de hardware recomendada
Software necessário
O NetBeans IDE 5.5 pode ser executado no Java SE Development Kit 5.0 atualização 9 ou superior (JDK 5.0, versão 1.5.0_09 ou superior), que compreende o Java Runtime Environment (JRE) mais as ferramentas de desenvolvedores para compilação, depuração e execução de aplicativos escritos na linguagem Java. O Sun Java System Application Server Platform Edition 9 atualização 1 foi testado com o JDK 5.0 atualização 6.
Requisitos do servidor de aplicativos Sun Java System
Para poder usar os recursos de desenvolvimento do J2EE do Java EE 5 Tools Bundle, você deve ter o Sun Java System Application Server Platform Edition 9 atualização 1. Esse servidor de aplicativos é oferecido com o download do Java EE 5 Tools Bundle.
Este tópico oferece informações sobre a configuração que podem ser necessárias para configurar o software.
Servidor de aplicativo Sun Java System
Os valores da senha e do nome de usuário padrão do domínio padrão do servidor de aplicativos, domain1, são os seguintes:
nome de usuário: admin
senha: adminadmin
Gerenciador de acesso Sun Java System
Se precisar acessar o console da administração do servidor do gerenciador de acesso, use os valores seguintes:
nome de usuário: amadmin
senha: admin123
As limitações dessa versão do NetBeans Enterprise Pack 5.5 são as seguintes:
Essa versão do Java EE 5 Tools Bundle permite explorar e avaliar a nova funcionalidade no IDE. Pedimos que você participe e nos envie a sua opinião registrando qualquer problema que tenha encontrado no sistema de rastreamento de problemas em http://www.netbeans.org/community/issues.html.
Observação: Consulte Notas da versão do NetBeans IDE 5.5 para ver a lista de problemas específicos do IDE.
Os problemas não solucionados dessa versão são os seguintes:
Instalação
temp.
Descrição: No Microsoft Windows, se o sistema estiver configurado para usar um diretório temporário no drive
Ce este diretório temporário não tiver espaço suficiente para os arquivos temporários que o instalador necessita, o instalador notifica que não há espaço em disco suficiente no driveC. Este problema irá ocorrer mesmo se você tiver optado por realizar a instalação em outro drive. O instalador está, na verdade, avisando que necessita mais espaço temporário.
O problema encontra-se na estrutura do InstallShield.Solução:Inicie o instalador com o parâmetro de linha de comando
-is:tempdir dir-temp-personalizado. Odir-temp-personalizadodeve ter no mínimo 130 MB de espaço livre em disco.
NoClassDefFoundError: não foi possível acessar amserver ocorre durante a instalação.
Descrição: Ao tentar instalar o software pela segunda vez sem limpar o diretório do gerenciador de acesso, a configuração do gerenciador de acesso pode falhar durante a instalação.
Solução:
- No Microsoft Windows:
Exclua o diretório especificado:%SystemDrive%\Documentos e configurações\nome-de-usuário\AMConfig_server_amserver_e remova o arquivo%SystemDrive%\Documentos e configurações\nome-de-usuário\AMConfig_server_amserver_.- No UNIX/Mac OS X:
Exclua o diretório especificado:$HOME/AMConfig_server_amserver_e remova o arquivo$HOME\AMConfig_server_amserver_.
-console e -silent.
Descrição: Nas plataformas UNIX, se o instalador não puder executar o processo de instalação sem o modo de gráficos, o próprio instalador sugere que você o execute com as opções
-consolee-silent. Ao tentar fazer desta maneira, o instalador falha.Solução: Ignore a mensagem do instalador e configure o ambiente de GUI conforme descrito abaixo para continuar a instalação.
Este problema se deve na maioria das vezes a que a conexão ao destino está sendo realizada via telnet/ssh/rlogin, o que quer dizer que você deve redirecionar a GUI ao sistema original. Para ter sucesso, os dois requisitos seguintes devem ser cumpridos:
- Um servidor X deve estar configurado e em execução no sistema a partir do qual está realizando a conexão.
- A variável de ambiente DISPLAY deve estar definida com o valor correto no sistema de destino. Adotando um shell bash, o valor e o comando corretos da variável são:
export DISPLAY=nome-da-máquina:número-da-exibição
Em quenúmero-da-máquinaé o endereço IP do sistema no qual está se conectando enúmero-da-exibiçãoé o número da exibição, geralmente0.0.
Descrição: Se tentar instalar o produto após desinstalação através de remover arquivos manualmente, a instalação falhará porque os dados no registro VPD (dados vitais do produto) do InstallShield não foram apagados.
Solução: Antes de iniciar uma nova instalação, remova o registro VPD do InstallShield. No Microsoft Windows, este registro está em
%SystemDrive%\Arquivos de programas\Arquivos comuns\InstallShield\Universale, no Linux/Solaris/Mac OS X, em~/InstallShield.Observe que outros aplicativos (por exemplo, o IDE do NetBeans) podem usar o registro VPD do InstallShield para armazenar os dados de desinstalação. A remoção do registro VPD do InstallShield impede que tais aplicativos sejam desinstalados corretamente. É bastante aconselhável desinstalar os aplicativos que usam o mecanismo de instalação InstallShield Universal antes de remover o registro VPD.
Descrição: No Mac OS, se a versão padrão de Java do seu sistema for 1.4, não será possível iniciar a instalação com um duplo clique no arquivo
.jar.Solução: Execute o arquivo
.jarmanualmente a partir da linha de comando que usa o Java 1.5.
Descrição: No Microsoft Windows, se não houver um JDK compatível pré-instalado na máquina de destino, o iniciador InstallShield Windows permite selecionar um
java.exepersonalizado. Após selecionar umjava.exepersonalizado, o instalador não realiza validação de compatibilidade. Isso significa que se selecionar umjava.exede um JRE 1.4, que não é compatível com o instalador, você encontrará várias exceções. O problema encontra-se na estrutura do InstallShield.Solução: Selecione um
java.exede um JRE 1.5. Consulte Software necessário para obter informações sobre o download e a instalação de um JDK compatível.
Descrição: O instalador apresenta falhas ao se iniciar corretamente no UNIX quando há pouco ou nenhum espaço em disco no diretório raiz do sistema de arquivos. O problema encontra-se na estrutura do InstallShield. Este problema foi observado em máquinas com menos de 2,5 MB livres na raiz do sistema de arquivos.
Solução: Libere suficiente espaço em disco na raiz do sistema de arquivos e reinicie o instalador.
Descrição: Ao arrastar uma guia, uma área quadrada negra também é arrastada. Após soltar a guia, aparecem os problemas em redesenhar a tela de boas-vindas.
Solução: Defina -J-Dapple.awt.graphics.UseQuartz=true ou use o Java 1.5 para executar o IDE (ou _select_ Java 1.5 durante a instalação do NetBeans Enterprise Pack).
BPEL
Descrição: O modelo WSDL não pode resolver o portType quando o principal WSDL importado tem o mesmo targetNamespace.
Solução: Atribua um espaço de nome para o arquivo WSDL importado, diferente do espaço de nome do arquivo WSDL de importação.
Descrição: O mapeador BPEL não é atualizado após a adição de um novo elemento em um arquivo XSD.
Solução: Feche e reabra a janela Mapeador.
Descrição: A importação de um arquivo WSDL para outro arquivo WSDL não é validada. A mensagem de erro correspondente é exibida.
Solução: Vá à exibição Fonte do editor WSDL, remova a importação e espaço de nome que acabaram de ser adicionados. Vá ao modo em árvore da exibição WSDL e adicione a mesma importação novamente.
Descrição: Hoje todas as expressões xpath criadas na ferramenta BPEL têm prefixo de nome de espaço. Em todas as versões anteriores da ferramenta, as expressões xpath não foram prefixadas com espaço de nome. Se editar um BPEL mais antigo (criado com uma versão mais antiga da ferramenta) e lhe adicionar novas atribuições, as expressões prefixadas e não-prefixadas se misturarão visto que o mecanismo não pode manipular esta mistura. Pode ocorrer a seguinte combinação de problemas:
- Você não consegue obter os resultados esperados porque as expressões não-prefixadas não podem devolver um resultado.
- Pode ocorrer uma exceção devido a que o código espera que um resultado seja devolvido e devido a que a ausência de prefixo faz com que nenhum resultado seja devolvido.
Solução: Edite manualmente as expressões não-prefixadas a fim de adicionar um prefixo.
Descrição: O erro ao lado do servidor Encontrada atividade Responder inesperada. Causa possível: várias atividades responder para dada atividade receber. ocorre ao executar o projeto de referência em um ambiente multissegmentado, isto é:
- O BPEL-SE é configurado com mais de 1 segmento (o padrão são 10 segmentos)
- O BPEL-SE está sendo executado em uma máquina com multiprocessador (deve ocorrer também em uma máquina muito potente com CPU simples)
Este problema pode ocorrer em qualquer processo comercial que recebe uma falha de outro processo comercial ou do serviço da Web externo e está sendo executado em um ambiente multissegmentado.
Visto que o projeto de referência tem um processo comercial que recebe uma falha de outro processo comercial, este erro é exibido durante a execução do teste de longevidade.
O problema se reproduz no Solaris e no Windows.Solução: Altere o projeto de referência de modo que os processos comerciais não se comuniquem usando falhas, mas sim usando respostas normais.
Descrição: O tempo de execução atual não oferece suporte aos tempos-limites na execução de um processo. Isso faz com que o processo comercial espere um evento determinado por um período ilimitado.
Solução: Considere o uso das atividades Selecionar com as ramificações onAlarm onde aplicável.
Descrição: Depois de implantar o projeto BluePrint4Application no servidor de aplicativos, os testes de amostra irão falhar se não forem executados em uma ordem determinada. A causa disso se deve ao uso de correlação nos processos BPEL BluePrint 4.
Solução: Execute os testes do BluePrint4Application em qualquer uma das ordens especificadas abaixo:
- poServiceRequest -> poRequestCancel
- poServiceRequest -> poRequestConfirm
Descrição: Ao cancelar a caixa de diálogo PartnerLink que aparece ao se arrastar um arquivo WSDL ou um nó do serviço da Web de um projeto NetBeans para um diagrama, o IDE não reverte a recuperação do(s) arquivo(s) WSDL.
Solução: Se estes arquivos não forem necessários para o projeto, simplesmente exclua-os manualmente na janela Projetos, como faria com outro recurso do projeto.
Descrição: Ao excluir uma propriedade de um conjunto de correlações usando os comandos do menu pop-up no navegador, a propriedade é incorretamente excluída do arquivo WSDL.
Solução: Use o editor de propriedades do conjunto de correlações para excluir corretamente uma propriedade de um conjunto de correlações.
Descrição: Se a interface do serviço de parceiro sofrer alterações, por exemplo, quando a assinatura de uma operação de serviço da Web é alterada e você não tiver importado o arquivo WSDL modificado, o processo BPEL trava.
Solução: Importe um novo arquivo WSDL e reimplante o aplicativo. Pode ser necessário reiniciar o mecanismo de serviços BPEL.
Descrição: A mensagem Impossível mostrar diagrama é exibida embora o arquivo BPEL seja válido.
Solução: Reinicie o IDE.
Descrição: Ao chamar ações do navegador de um BPEL interrompido são lançadas exceções ou o IDE trava.
Solução: Todas as ações devem ser desativadas no navegador quando o BPEL for interrompido. Não chame as ações do BPEL interrompido a partir do navegador. Primeiro corrija o BPEL.
Descrição: No UNIX, após clicar duas vezes no campo de texto na literal de seqüência, a caixa fica editável por alguns segundos e, em seguida, volta ao modo não editável.
Solução: Clique duas vezes no campo de texto da caixa da literal de seqüência e clique rapidamente em um espaço em branco dentro do campo do editor do mapeador BPEL (antes que o campo de texto volte ao modo não editável). A caixa da literal de seqüência permanecerá no modo de edição.
Serviços da Web seguros
Descrição: A execução do aplicativo ativado com serviços de segurança da Web com perfil do Liberty falha se o URL estiver baseado em "localhost". Quando o Executar projeto é chamado a partir do IDE, o URL padrão gerado pelo IDE inclui localhost.
Solução: Acesse o cliente de finanças a partir do navegador com o nome de host que inclua o nome de localhost.
Descrição: Ao adicionar módulos J2EE com segurança de perfil de símbolo do Liberty ao projeto de aplicativo empresarial, as funções adicionadas aos módulos J2EE precisam ser adicionadas manualmente no aplicativo empresarial para que a segurança atue do início ao fim.
Solução: Adicione manualmente as linhas abaixo em EnterpriseApplication->Arquivos de configuração->sun-application.xml usando o editor de texto xml.
<security-role-mapping> <role-name>USUÁRIOS_AUTENTICADOS</role-name> <principal-name>USUÁRIOS_AUTENTICADOS</principal-name> </security-role-mapping>
Descrição: No Windows, o NetBeans Enterprise Pack 5.5 usa as configurações de proxy do Internet Explorer como configurações do proxy do sistema. Isso pode provocar falha na conexão e desativar a edição dos perfis do gerenciador de acesso se as configurações de proxy do Internet Explorer não forem corretas.
Solução: Defina as suas próprias configurações de proxy no IDE. Abra a caixa de diálogo Ferramentas > Opções, alterne para Proxy HTTP e insira as configurações de proxy corretas.
Descrição: Trata-se de um recurso do gerenciador de acesso. Há uma configuração em AMConfig.properties de um limite de tempo-limite na resposta do serviço de descoberta. A solicitação de registro é rejeitada, segundo uma "mensagem antiga", devido à diferença entre os relógios do sistema.
Solução: Sincronize os relógios do sistema.
Descrição: O gerenciador de acesso não é suportado pela versão 1.6 do Java.
Solução: Use Java 1.5.x para executar o gerenciador de acesso.
Descrição: Se a configuração do servidor do gerenciador de acesso for alterada após a instalação, o arquivo AMConfig.properties se modifica para refletir tais alterações. Isso pode causar discrepâncias entre o servidor do gerenciador de acesso configurado e o arquivo AMConfig.properties fazendo com que o IDE não possa se comunicar com o servidor do gerenciador de acesso através do SDK do cliente.
Solução: Sincronize manualmente o arquivo AMConfig.properties do cliente para que reflita as informações apropriadas do servidor do gerenciador de acesso.
Descrição: Ao usar a exibição em coluna, às vezes somente um dos nós selecionados é removido após o comando Excluir do menu pop-up ter sido chamado.
Solução: Selecione vários nós e use a tecla Delete ou selecione sucessivamente um único nó e escolha Excluir no menu de contexto ou use o editor em árvore.
Módulos BPEL, de serviços de segurança da Web e de ferramentas do esquema XML
Os problemas descritos abaixo ocorrem com o IDE ao usar os módulos do NetBeans Enterprise Pack 5.5.
Descrição: No Mac OS X, no Solaris e no Linux, o IDE não reconhece os projetos criados sob o diretório raiz
"/".Solução: Crie projetos em uma pasta.
Descrição: Quando o IDE é executado no Red Hat Fedora Core 3 no local zh_CN e possivelmente em outros locais asiáticos, o texto pode não ser legível devido a problemas de renderização. Esse problema se deve à questão de suporte de fontes do JDK na distribuição do Fedora Core, de modo que tal problema também pode ocorrer em outros aplicativos Java executados no Fedora Core.
Solução: Não existe solução segura para o problema de renderização no Red Hat Fedora Core 3, de forma que o melhor é usar outro sistema operacional ou distribuição do Linux nesses locais. Verificamos que este problema não ocorre no Red Hat Enterprise Linux 3.
Consulte também: