O WebSphere ESB versão 6.2 requer o Cloudscape
para execução em uma versão mínima de v10.1.x. (Observe que o Cloudscape v10.1.x é composto
do código base do Apache Derby Versão 10.1.) Durante o upgrade do WebSphere ESB
versão 6.2, a
ferramenta de migração atualiza automaticamente as instâncias de
banco de dados que são acessadas através da estrutura integrada por
alguns componentes internos, como o registro UDDI. A ferramenta também tenta atualizar as instâncias do Cloudscape acessadas por seus aplicativos através da estrutura integrada. Você deve verificar os resultados de migração para esses bancos de dados backend.
Antes de Iniciar
Não utilize o Cloudscape v10.1.x como um banco de dados de produção.
Utilize-o somente para finalidades de desenvolvimento e teste.
Saiba mais: A nova versão do Cloudscape combina o tempo de execução do Derby com benefícios adicionais, como IBM® QA (Garantia de Qualidade) e NLS (Suporte ao Idioma Nacional). Para obter informações
sobre o código base de software livre Cloudscape v10.1.x,
consulte as
páginas da Web do produto Cloudscape.
A ferramenta de migração tenta atualizar as instâncias do banco de dados Cloudscape que são acessadas somente através da estrutura integrada. Você deve atualizar manualmente as instâncias do Cloudscape que efetuam transações com servidores na estrutura do Derby Network Server. (Consulte Atualizando o Cloudscape Manualmente.) Esse requisito elimina o risco de corromper aplicativos de terceiros
que utilizam a estrutura do Network Server para acessar as mesmas
instâncias de banco de dados que o
WebSphere ESB
Outros aplicativos podem acessar o Cloudscape no Network Server, pois a estrutura fornece ao banco de dados uma fundação do software de conectividade; a estrutura integrada não. OCloudscape Network Server pode efetuar transações com diversas JVMs (Java™ Virtual
Machines) (ou servidores) simultaneamente, enquanto que o Cloudscape na estrutura integrada funciona com somente uma única JVM. Implementações em cluster ou coexistentes do WebSphere ESB requerem o Network Server. Para obter informações adicionais, consulte o centro de informações do IBM Cloudscape.
Sobre Esta Tarefa
Para instâncias do banco de dados que seus aplicativos acessam através da estrutura integrada, a migração automática pode ser totalmente bem-sucedida, falhar completamente ou ser bem-sucedida com avisos. Uma migração que produz mensagens de aviso cria um banco de dados Cloudscape v10.1.x com seus dados, mas não migra toda a lógica configurada e outras configurações, como:
- chaves
- verificações
- visualizações
- acionadores
- aliases
- procedimentos armazenados
Para distinguir entre uma migração parcial e uma completamente bem-sucedida, você deve verificar os resultados de migração automática, verificando o log pós-upgrade e os logs individuais do banco de dados.
A execução dessas tarefas fornece dados de diagnóstico vitais para resolução de problemas dos bancos de dados parcialmente migrados, assim como daqueles que falharam completamente a migração automática. Por fim, esses bancos de dados são migrados através de um processo manual.
Procedimento
- Abra o log pós-upgrade de cada novo perfil do WebSphere ESB versão 6.2. O nome do caminho do log é install_rootprofiles/profileName/logs/WASPostUpgrade.timestamp.log.
- Examine o log pós-upgrade para obter mensagens de erro do banco de dados. Essas exceções indicam falhas de migração do banco de dados. As linhas a seguir são um exemplo do conteúdo do log pós-upgrade, no qual o código de erro do banco de dados é DSRA7600E. (A ferramenta de migração faz referência a todas a exceções do banco de dados com o prefixo
DSRA.)
MIGR0344I: Processing configuration file /opt/WebSphere60/AppServer/cloudscape
/db2j.properties.
MIGR0344I: Processing configuration file /opt/WebSphere60/AppServer/config/cells
/migr06/applications/MyBankApp.ear/deployments/MyBankApp/deployment.xml.
DSRA7600E: Cloudscape migration of database instance /opt/WebSphere61/Express
/profiles/default/databases/_opt_WebSphere60_AppServer_bin_DefaultDB failed,
reason: java.sql.SQLException: Failure creating target db
MIGR0430W: Cloudscape Database /fvt/temp/60BaseXExpress/PostUpgrade50BaseFVTTest9
/testRun/pre/websphere_backup/bin/DefaultDB failed to migrate
<nome do novo banco de dados>
Importante: Chame o Suporte do IBM WebSphere ESB
se você vir uma mensagem de falha da migração para uma instância do Cloudscape que é acessada
por um componente interno do WebSphere
(ou seja, um componente do WebSphere ESB em vez
de um de seus aplicativos).
- Abra o log de migração de banco de dados individual que corresponde a cada um dos bancos de dados backend Cloudscape. Esses logs têm o mesmo registro de data e hora que do log geral pós-upgrade. Os logs exibem detalhes adicionais sobre erros que são listados no log geral pós-upgrade, assim como erros de exposição que não são documentados pelo log geral.
O nome do caminho de cada log de banco de dados é WAS_HOME/profiles/profileName/logs/myFulldbPathName_migrationLogtimestamp.log.
- Examine em cada log de migração de banco de dados a ocorrência de erros. Para uma migração totalmente bem-sucedida, o log exibe uma mensagem que é semelhante ao texto a seguir:
MIGR0429I: Cloudscape Database F:\temp\60BaseXExpress\PostUpgrade50BaseFVTTest2\testRun
\pre\websphere_backup\bin\DefaultDB was successfully migrated. See log C:\WebSphere61
\Express\profiles\default\logs\DefaultDB_migrationLogSun-Dec-18-13.31.40-CST-2005.log
Caso contrário, o log exibe mensagens de erro no formato do exemplo a seguir:
connecting to source db <jdbc:db2j:/fvt/temp/60BaseXExpress/PostUpgrade50BaseFVTTest9
/testRun/pre/websphere_backup/bin/DefaultDB>
connecting to source db <jdbc:db2j:/fvt/temp/60BaseXExpress/PostUpgrade50BaseFVTTest9
/testRun/pre/websphere_backup/bin/DefaultDB> took 0.26 seconds
creating target db <jdbc:derby:/opt/WebSphere61/Express/profiles/default/databases
/_opt_WebSphere60_AppServer_bin_DefaultDB>
ERROR: An error occurred during migration. See debug.log for more details.
shutting down databases
shutting down databases took 0.055 seconds
- Para obter dados adicionais sobre um erro de migração, consulte o log de depuração que corresponde ao log de migração do banco de dados. O utilitário de migração do WebSphere Application
Server aciona um rastreio de migração de depuração por padrão; essa função de rastreio gera os logs de depuração de banco de dados. O nome do caminho completo de um log de depuração é WAS_HOME/profiles/profileName/logs/myFulldbPathName_migrationDebugtimestamp.log.
As linhas a seguir são uma amostra do texto de depuração. As linhas exibem dados de exceção detalhados para o erro que é referido na amostra anterior de dados do log e migração do banco de dados.
java.sql.SQLException: Database_opt_WebSphere60_AppServer_bin_DefaultDB already exists.
Aborting migration
at com.ibm.db2j.tools.migration.MigrateFrom60Impl.go(Unknown Source)
at com.ibm.db2j.tools.migration.MigrateFrom60Impl.doMigrate(Unknown Source)
at com.ibm.db2j.tools.MigrateFrom60.doMigrate(Unknown Source)
at com.ibm.ws.adapter.migration.CloudscapeMigrationUtility.migr
O que Fazer Depois
Se ocorrer uma migração parcial, tente solucionar o problema do novo banco de dados v10.1.x somente se tiver conhecimento de especialista do Cloudscape. Caso contrário, exclua o novo banco de dados. Execute um procedimento de migração manual no banco de dados original, assim como faz para cada banco de dados que falha completamente a migração automática.
Consulte
Atualizando o Cloudscape Manualmente para obter instruções.
Para instâncias do Cloudscape migradas com êxito, esteja ciente que as novas origens de dados no escopo da célula podem ser utilizadas somente por nós que executam a versão 6.0.2 ou posterior do WebSphere ESB. Versões anteriores do produto não suportam o novo Cloudscape; quando aplicativos em nós pré-versão
6.0.2 tentam acessar uma origem de dados Cloudscape 10.1.x, o servidor emitirá exceções no tempo de execução.