21.7 Migrando os dados de um banco de dados Sybase SQL Anywhere embutido para um banco de dados Oracle externo

O ZENworks 10 Management permite migrar os dados de um banco de dados Sybase SQL Anywhere embutido e interno ou um banco de dados Sybase SQL Anywhere externo em execução em um Servidor Principal ZENworks para um banco de dados Oracle instalado em um dispositivo que não tenha o ZENworks 10 Management instalado.

IMPORTANTE:Se o Servidor de Relatório do ZENworks estiver instalado no dispositivo, ele não funcionará após a migração do banco de dados. Para que o Servidor de Relatório funcione, instale novamente o Servidor de Relatório do ZENworks no Servidor Principal no qual você instalou o cliente Oracle depois de migrar o banco de dados. Para obter mais informações, consulte a Seção 21.7.3, Tarefas pós-migração.

Verifique o seguinte ao migrar o banco de dados:

21.7.1 Preparando para mover os dados

Antes de migrar os dados do banco de dados Sybase para o banco de dados Oracle, faça o seguinte:

  • Verifique se o estado da licença do ZENworks 10 Management é Ativo. O produto deverá estar instalado e em execução na versão licenciada ou na versão de avaliação.

  • Grave todos os relatórios, rights.xml e ownership.xml, usando o comando report-save (rpsv) (pasta de destino). Os arquivos XML contêm detalhes de direitos e propriedade de todos os relatórios.

  • Verifique se foi feito upgrade do Servidor Principal em que está configurado o banco de dados Sybase para o ZENworks 10 Management.

  • Verifique se o Servidor Principal ZENworks tem um banco de dados Sybase interno ou externo instalado.

  • Verifique se o banco de dados Oracle está instalado em um dispositivo que não tenha o ZENworks 10 Management instalado.

  • Verifique se o tablespace USERS tem espaço suficiente para criar e armazenar o esquema de banco de dados do ZENworks. O tablespace requer um mínimo de 100 MB para criar o esquema de banco de dados do ZENworks sem nenhum dado, bem como um espaço adicional razoável, dependendo do tamanho do banco de dados a ser migrado. Por padrão, o Utilitário de Migração de Banco de Dados usa somente o tablespace USERS. Você não pode especificar manualmente outro tablespace durante a migração.

  • Verifique se o parâmetro NLS_CHARACTERSET está definido como AL32UTF8 e o parâmetro NLS_NCHAR_CHARACTERSET como AL16UTF16 executando a seguinte consulta no prompt do banco de dados:

    select parameter, value from nls_database_parameters where parameter like '%CHARACTERSET%';
    
  • (Condicional) Se você quiser migrar o banco de dados através da criação de um novo esquema de usuário, verifique se os seguintes requisitos adicionais são atendidos:

    • Tenha em mente as credenciais do administrador de banco de dados.

    • Um tablespace já deverá existir para ser associado ao usuário de acesso do Oracle.

  • Você pode optar por migrar o banco de dados usando um esquema de usuário existente armazenado em um servidor da sua rede nos seguintes cenários:

    • O administrador do banco de dados cria um esquema de usuário com os direitos necessários e lhe passa as credenciais desse esquema de usuário. Neste caso, as credenciais do administrador de banco de dados não são necessárias para migrar o banco de dados.

    • Você cria um esquema de usuário no banco de dados Oracle e opta por usá-lo durante a migração do banco de dados.

    (Condicional) Se você quiser migrar o banco de dados através do uso de um esquema de usuário existente, verifique se os seguintes requisitos adicionais são atendidos:

    • Verifique se o esquema de usuário possui os direitos a seguir para criar o banco de dados.

      • CREATE SESSION
      • CREATE_TABLE
      • CREATE_VIEW
      • CREATE_PROCEDURE
      • CREATE_SEQUENCE
      • CREATE_TRIGGER
    • Verifique se a quota do esquema de usuário está definida como Ilimitado no tablespace USERS.

  • Interrompa manualmente os serviços do ZENworks em andamento em todos os servidores da zona de gerenciamento.

    Para parar os serviços do

    • No Windows: Faça o seguinte:

      1. No menu Iniciar, na área de trabalho do Windows, clique em Configurações > Painel de Controle.

      2. Clique duas vezes em Ferramentas Administrativas > Serviços.

      3. Interrompa os seguintes serviços: Servidor do Novell ZENworks, Monitor de Serviços do Novell ZENworks e Serviço de Agente do Novell ZENworks.

    • No Linux: No prompt do console, digite os seguintes comandos:

      • /etc/init.d/./novell-zenmntr stop

      • /etc/init.d/./novell-zenserver stop

      • /etc/init.d/./novell-zenloader stop

  • Verifique se o serviço de Armazenamento de Dados Embutido do Novell ZENworks no Servidor Principal está em andamento.

    • No Windows: Faça o seguinte:

      1. No menu Iniciar, na área de trabalho do Windows, clique em Configurações > Painel de Controle.

      2. Clique duas vezes em Ferramentas Administrativas > Serviços.

      3. O status do serviço Armazenamento de Dados Embutido do Novell ZENworks deve ser Iniciado.

    • No Linux: No prompt do console, digite/etc/init.d/./sybase-asa status.

  • (Opcional) O status da migração de banco de dados é registrada no arquivo novell-zenworks-configure.log. Por padrão, somente as mensagens dos tipos Info e Severe são registradas. Se você quiser registrar também outros tipos de mensagens (como Finer, Finest e Warning) no arquivo, faça o seguinte no arquivo novell-zenworks-configure.properties:

    1. Defina o valor de Logger.logLevel com o tipo de mensagem apropriado.

      Por exemplo, se você desejar registrar mensagens do tipo Finest:

       #Logger.logLevel   = FINEST
      
    2. Retire a marca de comentário “#” da linha, conforme a seguir:

      Logger.logLevel   = FINEST
      

    O arquivo novell-zenworks-configure.properties está localizado em %ZENWORKS_HOME%\conf\ no Windows e em /etc/opt/novell/zenworks/ no Linux.

21.7.2 Migrando dados do banco de dados Sybase SQL Anywhere para um banco de dados Oracle

Migrando dados do banco de dados Sybase SQL Anywhere para um banco de dados Oracle

  1. Verifique se todas as tarefas listadas na Seção 21.7.1, Preparando para mover os dados foram concluídas.

  2. Execute o Utilitário de Migração de Banco de Dados.

    • No Windows: No prompt de comando, vá para o arquivo caminho_de_instalação_do_ZENworks\bin\novell-zenworks-configure.bat e digite o seguinte comando:

      novell-zenworks-configure.bat -c DBMigrateConfigureAction

    • No Linux: No prompt do console, vá para /opt/novell/zenworks/bin e execute o seguinte comando:

      novell-zenworks-configure -c DBMigrateConfigureAction

  3. Digite Oracle no tipo de banco de dados de destino.

  4. Digite o endereço IP ou o nome de host do servidor de banco de dados Oracle.

  5. Digite a porta usada pelo servidor de banco de dados Oracle.

  6. Digite o nome completo do serviço de rede para o banco de dados Oracle.

  7. Você pode optar por criar um novo esquema de usuário ou utilizar um esquema de usuário existente.

    Se optar por criar um esquema novo, vá para a Etapa 8.

    Se optar por utilizar um esquema de usuário existente, vá para a Etapa 9

  8. Digite o nome de usuário e a senha do administrador do servidor de banco de dados.

  9. Quando solicitado, digite o nome do esquema para o nome de usuário do banco de dados.

  10. Quando solicitado, digite a senha do esquema do banco de dados para a senha de usuário do banco de dados.

    A migração do banco de dados é inicializada.

  11. Quando a migração de banco de dados estiver concluída, você poderá conferir o arquivo novell-zenworks-configure.log para saber se a migração obteve êxito. O arquivo de registro está localizado em %ZENWORKS_HOME%\log\ no Windows e em /var/opt/novell/zenworks/ no Linux.

  12. Quando a migração do banco de dados for concluída com sucesso, continue com a Seção 21.7.3, Tarefas pós-migração.

Continuando a migração do banco de dados

Caso a migração do banco de dados seja interrompida por qualquer motivo, o Utilitário de Migração do ZENworks permitirá continuar a migração se o arquivo dbmigration.xml tiver sido criado previamente. O arquivo está localizado no diretório caminho_de_instalação_do_ZENworks\bin no Windows, e no diretório /opt/novell/zenworks/bin no Linux.

  1. Execute o Utilitário de Migração de Banco de Dados.

    • No Windows: No prompt de comando, vá para o arquivo caminho_de_instalação_do_ZENworks\bin\novell-zenworks-configure.bat e digite o seguinte comando:

      novell-zenworks-configure.bat -c DBMigrateConfigureAction

    • No Linux: No prompt do console, vá para /opt/novell/zenworks/bin e execute o seguinte comando:

      novell-zenworks-configure -c DBMigrateConfigureAction

  2. Digite Oracle no tipo de banco de dados de destino.

  3. Digite o endereço IP ou o nome de host do servidor de banco de dados Oracle.

    Você deverá especificar o endereço IP ou nome de host do servidor de banco de dados Oracle usado na migração do banco de dados. Por exemplo, se você tiver especificado o endereço IP do servidor de banco de dados durante a migração do banco de dados, deverá especificar o mesmo endereço IP quando for continuar a migração do banco de dados. Você não pode especificar o nome de host do servidor de banco de dados.

  4. Digite a porta usada pelo servidor de banco de dados Oracle.

  5. Digite o nome completo do serviço de rede para o banco de dados Oracle.

  6. Escolha usar um esquema existente.

  7. Quando solicitado, digite o nome de esquema para o nome de usuário do banco de dados especificado antes de interromper a migração do banco de dados.

  8. Quando solicitado, digite a senha de esquema de banco de dados para a senha de usuário do banco de dados especificada antes de interrromper a migração do banco de dados.

  9. Escolha continuar a migração do banco de dados.

    A migração do banco de dados é inicializada.

  10. Quando a migração do banco de dados for concluída com sucesso, continue com a Seção 21.7.3, Tarefas pós-migração

21.7.3 Tarefas pós-migração

Se existe apenas um servidor na zona de gerenciamento, todos os serviços do ZENworks serão automaticamente inicializados depois que os dados forem migrados com sucesso para um banco de dados Oracle.

Se houver vários servidores na Zona de Gerenciamento:

  1. No dispositivo no qual o Utilitário de Migração é executado, copie os seguintes arquivos para o diretório apropriado em todos os servidores:

    • zdm.xml
    • dmaccounts.properties
    • dmmappings.properties

    Os arquivos estão localizados no diretório caminho_de_instalação_do_ZENworks\conf\datamodel no Windows, e no diretório /etc/opt/novell/zenworks/datamodel no Linux.

  2. Reinicie os serviços do ZENworks.

    • No Windows: Faça o seguinte:

      1. No menu Iniciar, na área de trabalho do Windows, clique em Configurações > Painel de Controle.

      2. Clique duas vezes em Ferramentas Administrativas > Serviços.

      3. Inicie os seguintes serviços: Servidor Novell ZENworks, Monitoramento de Serviços do Novell ZENworks e Serviço de Agente do Novell ZENworks.

    • No Linux: No prompt do console, digite os seguintes comandos:

      • /etc/init.d/./novell-zenmntr restart

      • /etc/init.d/./novell-zenserver restart

      • /etc/init.d/./novell-zenloader restart

  3. Migre os relatórios do ZENworks do banco de dados Sybase SQL Anywhere para um banco de dados Oracle:

    1. Instale o cliente Oracle em um Servidor Principal que não tenha uma instância do Servidor de Relatório do ZENworks.

    2. Instale uma nova instância do Servidor de Relatório do ZENworks no dispositivo no qual você instalou o cliente Oracle.

    3. Copie os relatórios para o dispositivo no qual a nova instância do Servidor de Relatório está em andamento. Esses são os relatórios do ZENworks que você gravou antes de migrá-los. Para obter mais informações, consulte a Seção 21.7.1, Preparando para mover os dados.

    4. Publique os relatórios e restaure os direitos Geração de Relatórios e os detalhes de propriedade dos relatórios usando o seguinte comando:

      zman rpld path_of_directory_containing_rights.xml_and_ownership.xml

    5. Desinstale a instância do Servidor de Relatório do ZENworks instalada antes da migração do banco de dados.

O servidor ZENworks agora aponta para o novo banco de dados.

No caso do banco de dados Oracle 10g, qualquer nome de administrador diferenciará maiúsculas de minúsculas, incluindo os nomes de login das origens de usuário. A conta padrão de administrador do ZENworks criada automaticamente durante a instalação usa uma inicial maiúscula, portanto, para efetuar login no ZENworks Control Center, digite Administrador.

21.7.4 Solucionando problemas de migração de banco de dados

Solucionando problemas de uma exceção do Java Heap Space

Se ocorrer uma exceção do Java Heap Space durante a migração do banco de dados devido à insuficiência de memória:

  1. Edite o arquivo caminho_de_instalação_do_ZENworks\bin\novell-zenworks-configure.bat no Windows ou /opt/novell/zenworks/bin/novell-zenworks-configure no Linux para mudar o valor do heap space na linha a seguir, dependendo da RAM do dispositivo no qual o Utilitário de Migração está em andamento:

    "%JAVA_HOME%\bin\java" -Djava.library.path=%ZENLIB% -cp "%MYCP%" %DEBUG_OPTS% %JAVA_OPTS% -Xmx128m com.novell.zenworks.configure.ConfigureLoader %CONFIG_OPTS%
    

    O valor de heap space é representado em megabytes (MB) em -Xmx128m. O padrão é 128.

    Por exemplo, se a RAM do dispositivo for 512 MB, a linha no arquivo novell-zenworks-configure.bat poderá ser atualizada como mostra a seguir:

    "%JAVA_HOME%\bin\java" -Djava.library.path=%ZENLIB% -cp "%MYCP%" %DEBUG_OPTS% %JAVA_OPTS% -Xmx512m com.novell.zenworks.configure.ConfigureLoader %CONFIG_OPTS%
    

    IMPORTANTE:O valor de heap space deve ser igual a ou menor que a RAM do dispositivo.

  2. No prompt do console, execute o arquivo caminho_de_instalação_do_ZENworks\bin\novell-zenworks-configure.bat no Windows ou /opt/novell/zenworks/bin/novell-zenworks-configure no Linux.

  3. Siga os prompts.

    Quando solicitado a inserir o local do arquivo necessário para continuar com a migração, digite o caminho completo de DBMigration.xml. O arquivo está localizado no diretório caminho_do_arquivo_de_instalação_do_ZENworks\bin no Windows, e no diretório /opt/novell/zenworks/bin no Linux.

    O arquivo XML contém uma lista de tabelas e um flag indicando se a tabela foi migrada com sucesso ou não. Quando a migração do banco de dados continua, são migradas apenas as tabelas com valor de flag definido como falso.

Solucionando problemas de falha no banco de dados Oracle

Se houver falha no banco de dados Oracle durante a migração do banco de dados:

  1. No prompt do console, execute o arquivo caminho_de_instalação_do_ZENworks\bin\novell-zenworks-configure.bat no Windows ou /opt/novell/zenworks/bin/novell-zenworks-configure no Linux.

  2. Siga os prompts.

    Quando solicitado a inserir o local do arquivo necessário para continuar com a migração, digite o caminho completo de DBMigration.xml. O arquivo está localizado no diretório caminho_do_arquivo_de_instalação_do_ZENworks\bin no Windows, e no diretório /opt/novell/zenworks/bin no Linux.

    O arquivo XML contém uma lista de tabelas e um flag indicando se a tabela foi migrada com sucesso ou não. Quando a migração do banco de dados continua, são migradas apenas as tabelas com valor de flag definido como falso.

    IMPORTANTE:Não edite o conteúdo de DBMigration.xml.

Solucionando o problema de tablespace do Oracle

Se o tablespace USERS do Oracle não tiver espaço suficiente para criar e armazenar o esquema de banco de dados do ZENworks, a migração do banco de dados falhará com as seguintes mensagens de erro na tentativa de criar as tabelas:

SEVERE: Terminating the database migration...
SEVERE: An error has occurred while migrating the database.

Para resolver este problema, o administrador de banco de dados Oracle deverá aumentar o tamanho do tablespace USERS. Verifique se o tablespace tem no mínimo 100 MB para criar o esquema de banco de dados do ZENworks sem nenhum dado, bem como um espaço adicional razoável, dependendo do tamanho do banco de dados a ser migrado.

Solucionando o problema de falha na migração do banco de dados

Se o parâmetro NLS_CHARACTERSET não estiver definido como AL32UTF8 e o parâmetro NLS_NCHAR_CHARACTERSET não estiver definido como AL16UTF16, a migração do banco de dados falhará com as seguintes mensagens de erro:

Failed to run the sql script: localization-updater.sql,
message:Failed to execute the SQL command: insert into
zLocalizedMessage(messageid,lang,messagestr)
values('POLICYHANDLERS.EPE.INVALID_VALUE_FORMAT','fr','La stratégie {0} n''a
pas pu être appliquée du fait que la valeur de la variable "{1}" n''est pas
dans un format valide.'),
message:ORA-00600: internal error code, arguments: [ktfbbsearch-7], [8], [],
[], [], [], [], []

Para resolver esse problema, defina o parâmetro NLS_CHARACTERSET como AL32UTF8 e o parâmetro NLS_NCHAR_CHARACTERSET como AL16UTF16. Para conferir se os parâmetros de conjunto de caracteres estão configurados com os valores recomendados, execute a seguinte consulta no prompt do banco de dados:

select parameter, value from nls_database_parameters where parameter like '%CHARACTERSET%';

Solucionando problemas da migração de banco de dados com um esquema de usuário existente

Se você optar por migrar o banco de dados utilizando um esquema de usuário existente, o Utilitário de Migração de Banco de Dados criará o banco de dados do ZENworks, mas é possível que não consiga migrar os dados.

Para resolver este problema:

  1. Verifique se o administrador de banco de dados apagou do banco de dados do ZENworks recém-criado as tabelas, telas e seqüência de usuários do ZENworks. Em seguida, remova a tabela user_recyclebin do banco de dados.

  2. Reinicie a migração do banco de dados com o mesmo esquema de usuário. Para obter mais informações, consulte Migrando dados do banco de dados Sybase SQL Anywhere para um banco de dados Oracle.

21.7.5 Revertendo para o banco de dados Sybase

Se você quiser voltar a usar o banco de dados Sybase:

  1. No dispositivo no qual o Utilitário de Migração é executado, renomeie os seguintes arquivos:

    • zdm.xml.bak to zdm.xml
    • dmaccounts.properties.bak to dmaccounts.properties
    • dmmappings.properties.bak to dmmappings.properties

    Os arquivos estão localizados no diretório ZENworks_installation_path\conf\datamodel no Windows e no diretório /etc/opt/novell/zenworks/datamodel no Linux.

  2. Reinicie todos os serviços do ZENworks:

    • No Windows: Faça o seguinte:

      1. No menu Iniciar, na área de trabalho do Windows, clique em Configurações > Painel de Controle.

      2. Clique duas vezes em Ferramentas Administrativas > Serviços.

      3. Inicie os seguintes serviços: Servidor Novell ZENworks, Monitor de Serviços do Novell ZENworks e Serviço de Agente do Novell ZENworks.

    • No Linux: No prompt do console, digite os seguintes comandos:

      • /etc/init.d/./novell-zenmntr restart

      • /etc/init.d/./novell-zenserver restart

      • /etc/init.d/./novell-zenloader restart