Deployment de ADF 10.1.3 para IAS 10.1.2

Olá Pessoal!

Uma situação que costuma causar algum trabalho é quando o cliente utiliza a versão do Oracle AS 10.1.2 (que vem com a versão 10.1.2 do J2EE Container da Oracle, o OC4J) e quer instalar aplicações ADF feitas no JDeveloper 10.1.3.3. Tal situação pede alguma atenção por parte da equipe de desenvolvimento. Seguem portanto alguns problemas que podem ocorrer e a respectiva solução:

Problema: O Servidor 10.1.2 é compatível com a spec J2EE 1.3, e o ADF 10.1.3 por padrão é aderente à J2EE 1.4. Podem ocorrer problemas com o formato dos arquivos de configuração J2EE (web.xml, data-sources.xml, application.xml) que na versão 1.3 usam DTD e na versão 1.4 usam XML Schemas para determinar o formato do XML.
Solução: O wizard de criação destes arquivos no JDeveloper permite que você escolha o formato 1.3 para os mesmos, resolvendo o problema. Ao criar um projeto pelo Wizard, tomem cuidado pois alguns arquivos são auto-gerado, precisamos deletá-los e gerar novamente para termos a opção citada acima.

Problema: O 10.1.2 é compativel com JDK 1.4.2, e o 10.1.3 por padrão é baseado no JDK 1.5. Dará problemas de UnsupportedVersionError ao executar.
Solução: Instale o JDK 1.4.2 na sua estação e configure um novo J2SE Definition dentro do JDeveloper, no menu Tools -> Manage Libraries, aba J2SE Definition. apontando para o arquivo java.exe existente no diretório de instalação do 1.4.2 ele pega o resto. Em seguida, vamos nas propriedades do(s) nosso(s) projeto(s) (botão direito -> Project Properties -> Aba Libraries) e mudamos o J2SE Definition que está lá para 1.4.2. Quando fizermos o rebuild do projeto, já estará compilando na versão antiga.

Problema: O ADF 10.1.3 precisa que estejam instalados no servidor algumas bibliotecas, principalmente pertinentes ao ADF BC e ao Toplink, que estão em uma versão mais antiga no 10.1.2. A aplicação não funcionará.
Solução: Executar o ADF Runtime installer, um programa que automatiza a cópia das bibliotecas do ADF, no servidor 10.1.2. Este instalador está disponível em: http://www.oracle.com/technology/software/products/jdev/htdocs/adfinstaller.html

Problema: Mesmo após executar o ADF Installer, ele está dando erros de NoClassDefFoundError para várias classes...
Solução: O ADF Runtime installer faz apenas parte do trabalho. A Oracle identificou diversos JARs que ficaram faltando, para saber quais devem ser copiados veja os notes no metalink (Notes:358791.1 e 412844.1) que dizem o que deve ser feito no servidor para colocar o ADF 10.1.3 para funcionar no OC4J 10.1.2.

É isso pessoal! Um abraço!