MIGRANDO PARA ZIM 8.50 (UNIX/WINDOWS)

Transcrição

1 ZIM TECHNOLOGIES DO BRASIL MIGRANDO PARA ZIM 8.50 (UNIX/WINDOWS) Próx

2 Antes de Iniciar O objetivo deste documento é apresentar o processo de Migração para o Zim 8.50 (UNIX/Windows). Para maiores informações consulte: - Nosso website ( - Help Online do Zim 8.50 sugerimos que você o adicione em seus Favoritos do Browser de Internet ( - Suporte da Zim através do telefone ou suporte@zim.biz. Próx

3 Índice I. Recomendações II. Backup base de dados original III. ZOM Update IV. Exportando Seu Banco de Dados 7.11 V. Criando o Banco de Dados no Zim 8.50 VI. Iniciando ZimServer VII. Importação da Definição do Banco de Dados VIII. Verificar pendências e Finalizando ZimServer IX. Copiando Seus Arquivos de Dados da versão 7.11 X. Iniciando ZimServer e Recomendações XI. Recompilar todos os programas XII. Configurando o Terminal (UNIX) XIII. Nota Próx

4 Recomendação, Backup e ZOM Update I. Recomendação Este processo descreve como migrar seu banco de dados Zim nas versões 5.x, 6.x e 7.x para o Zim Se você tem um banco de dados Zim 4.x, primeiro você deve migrar este banco de dados para Zim 7.11 e depois para Zim (Consulte o tutorial Migrando da 4.X para 7.11). Se não tiver uma cópia do Zim 7.11 para executar este passo intermediário, entre em contato com a área comercial para obter uma cópia temporária do Zim 7.11 ou baixe uma copia trial do site da ZIM: II. Backup base de dados original Mesmo que o processo de migração não afete o banco de dados original, é uma boa prática efetuar backup do seu banco de dados para um lugar seguro, como uma fita, cd, dvd ou outro diretório do disco. III. ZOM Update Antes de exportar seu banco de dados, certifique-se que a base foi atualizada com o ZOM (ZIM Object Manager). Para fazer isso, execute os seguintes comandos dentro de uma sessão Zim 7.11 ( base de dados a ser migrada): > ZOMEnable > ZOMReset Ante Índice Próx

5 ZOM Update Migrando para Zim 8.50 (UNIX/Windows) A execução do zomreset exibirá a mensagem a seguir: Ou seja: Isso irá redefinir completamente o ambiente ZOM. * Você não pode recarregar os dados que anteriormente foram salvo com ZOMDataSave. * Você vai perder as chaves de objeto que você definiu. * Você perderá todas as configurações que você fez ZOM. Clique em OK. Em alguns casos pode aparecer a mensagem a seguir, ignore clicando no botão [OK]:

6 Exportação do seu BD Zim 7.11: config.db III. ZOM Update No final do zomreset aparece a opção para alterar a configuração do ZOM, Se optar por alterar um item, faça a alteração desejada e clique em Salvar. Se não aparecer nenhuma outra mensagem o ZOMRESET é finalizado. Para editar e alterar as configurações do ZOM, digite ZOMCONFIG no prompt do ZIM. Para mais informações sobre o ZOM, consulte o Help Online to Zim IV. Exportação do seu banco de dados Siga os passos para exportação da definição do Dicionário de Dados para arquivos de texto e, opcionalmente, as exportações de dados existentes. 1. Copie o arquivo "zim8cnv1.cmd" do diretório onde o Zim 8.50 foi instalado para seu banco de dados onde a exportação vai ocorrer ( base zim711). 2. Antes de entrar em seu banco de dados de migração (base zim711), garanta a configuração mínima do arquivo config.db a seguir: parameter size files 100 directories <nr de diretórios Zim da sua aplicação> (mínimo 3, recomendado 10)

7 Exportação do seu BD Zim 7.11: zim8cnv1 IV. Exportação do seu banco de dados 3. Iniciar uma sessão mono-usuário do Zim 7.11 (ou uma versão anterior) da base de dados que você vai converter para o Zim 8.50 e adicionar e criar o documento zim8cnv1.cmd que você copiou para o seu banco de dados zim711 (ver item 1), exemplo: > aft docs : zim8cnv1 zim8cnv1.cmd Program 0 ZIM > zomenable > zomcreate zim8cnv1 OU > add docs let docname= zim8cnv1 filename= zim8cnv1.cmd dirname= Zim > zomenable > zomcreate zim8cnv1 4. Ainda nesta sessão Zim (prompt), executar o programa zim8cnv1. Ele irá exportar todas as suas definições do dicionário de dados do Zim e criar um arquivo README.TXT no diretório "port do diretório de seu banco de dados; > zim8cnv1

8 Exportação do seu BD Zim 7.11: zim8cnv1 IV. Exportação do seu banco de dados 5. Na execução do zim8cnv1, a primeira pergunta feita pelo programa é se você deseja exportar os dados do banco de dados. Do you want to unload all your data into ASCII Documents, and then them in the New Zim8 Databases? - Reposta Y - Esta alternativa leva mais tempo para completar todo o processo, pois serão criados arquivos de formato TEXTO com os dados de todas as tabelas de seu banco de dados, onde, posteriormente o programa zim8cnv2 fará a importação, a vantagem é que os dados nas entidades/relacionamento com campos ficam organizados. Você não deverã executar a Etapa X-Copiar seus Arquivos de Dados. - Reposta N - Esta alternativa não exportar os dados, economizando tempo nesta etapa da migração. Você deverá copiar os arquivos de dados das entidades/relacionamentos com campos (zim0100 em diante) como está explicado na etapa X-Copiar Seus Arquivos de Dados, já que os dados são compatíveis com Zim 8.50.

9 Exportação do seu BD Zim 7.11: zim8cnv1 IV. Exportação do seu banco de dados Outra mensagem: Do you want to remove all objects created during the exporting process? (Y/N) Responda com Y Ao finalizar o documento zim8cnv1 aparecerá a mensagem indicando que o processo de exportação foi completada:

10 Exportação do seu BD Zim 7.11: AVISOS IV. Exportação do seu banco de dados Lembre-se que tudo isto foi feito na base do Zim 7.11 AVISO: O programa zim8cnv1 exporta apenas as definições do banco de dados, mas não copia arquivos como dirs.zim, areas.zim e etc. É de responsabilidade da pessoa que está exportando, garantir que esses arquivos estejam corretos e copiá-los para os locais apropriados (diretório destino a ser criado e explicado na etapa V-Criando o Banco de Dados Zim ATENÇÃO! O arquivo areas.zim deve ser copiado após a execução do programa zim8cnv2, faça esta cópia conforme explicado no processo da etapa X-Copiar Seus Arquivos de Dados.

11 Criando banco de dados no Zim 8.50: ziminit V. Criando o novo banco de dados no Zim 8.50 Para o procedimento de instalação do Zim 8.50, consulte o Tutorial Zim 8.50 Guia de Instalação. Para o procedimento de criação de um novo banco de dados, consulte o tutorial Zim 8.50 Primeiros Passos. Por exemplo, você pode criar um banco de dados chamado base850 em /zimdata/base850 (Unix) ou C:\ZIMDATA\BASE850 (Windows). Uma vez que este banco de dados for criado, copiar os arquivos do diretório port da base zim711. Veja os exemplos abaixo: Unix: root# cp /zimdata/base711/port/* /zimdata/base850/port Windows: utilizando o Windows Explorer, copiar/colar os arquivos da pasta (origem/destino): de: [C:\ZIMDATA\BASE711\PORT] para: [C:\ZIMDATA\BASE850\PORT]

12 Iniciando ZimServer VI. Iniciando ZimServer Para executar o Zim 8.50, como ele é puramente Cliente/Servidor, é obrigatório você iniciar o servidor Zim 8.50 seguindo as recomendações a seguir: 1. Para sistemas operacionais baseados em Unix, você deve setar as variáveis de ambiente ZIM e ZIMTERM. ZIM=/opt/zim/8.50 ZIMTERM=xterm Export ZIM ZIMTERM 2. ZimServer Para entrar no Zim primeiro precisa iniciar o ZimServer e para fazer isso devemos criar os arquivos de configuração: zimdb.zim, zimconfig.srv (no endereço apontado pela variável $ZIM) e zimconfig.zim no banco de dados que vai ser acessado. Para criar ou atualizar o arquivo zimdb.zim proceda conforme documentado no tutorial Zim 8.50 Guia de Instalação. Veja o exemplo de arquivo zimdb.zim a seguir: Unix 1;base8; /zimdata/base850; <linha em branco> Windows 1;base8; C:\ZIMDATA/BASE850; <linha em branco>

13 Iniciando ZimServer VI. Iniciando ZimServer (cont.) Após configurado corretamente o arquivo zimdb.zim, vamos iniciar o servidor do Zim Veja os passos abaixo para os ambientes Unix e Windows, supondo que o diretório de instalação seja o padrão: 1. Unix root# cd /opt/zim/8.50 root# export ZIM=/opt/zim/8.50 root# export ZIMTERM=build root# nohup $ZIM/zimserver & 2. Windows Iniciar Programas Zim 8.50 Start ZimServer Será aberta uma janela de comandos (MS-DOS), onde o ZimServer estará em execução. Não feche essa janela, fazendo isso você estará finalizando o ZimServer! NOTA: Qualquer problema ou erro ao iniciar o ZimZerver, o mais provável é que exista algum erro na configuração do zimdb.zim, zimbk.zim, zimconfig.srv ou config.db. Para acompanhar estes problemas de erro, edite o arquivo zimsvlog.zim que está no diretório de instalação do Zim 8.50.

14 Importação da definição do banco de dados VII.Importação da definição do banco de dados Esta etapa não pode ser executada sem a criação de um banco de dados da versão Zim 8.50 (conforme descrito na Etapa IV) e nunca deve ser executado duas vezes sobre o mesmo banco de dados. ATENÇÃO: Neste momento o arquivo AREAS.ZIM não deve estar no diretório da base de dados da versão Zim 8.50 (/zimdata/base850 ou C:\ZIMDATA\BASE850), pois todos os arquivos necessários do Zim (zim0100 em diante) serão criados neste diretório (/zimdata/base850 ou C:\ZIMDATA\BASE850). Para importar o banco de dados entre no Zim 8.50 e proceda conforme documentado. Veja exemplo a seguir, tendo como exemplo a base de nome base850 : Para Unix: $> $ZIM/zim n base850 c zim8cnv2 Para Windows: Iniciar Programas ZIM 850 ZIM e preencher os dados de conexão: Obs: para executar este comando você deve primeiro, inicializar o ZimServer (veja etapa VI-Iniciando Zimserver).

15 Importação da definição do banco de dados VII.Importação da definição do banco de dados (cont.) Também pode executar este programa dentro do Zim Entre no Zim 8.50 e execute o programa zim8cnv2 via prompt de comandos do Zim: > zim8cnv2 Será criado um documento com nome $$setting$$ que contém todos os comandos necessários para inicializar tabelas e relacionamentos que são PER-USER (por usuário). Estes comandos deverão ser executados antes da aplicação ser executada, podendo por exemplo, ser inserido no arquivo zimprof. NOTA: nós recomendamos o uso do comando INITIALIZE PERUSER (ENTIDADE/RELACIONAMENTO COM CAMPOS> para trabalhar com objetos por usuário (PER-USER). O recurso de copiar via comando copy/cp (dependendo do sistema operacinal) para criar uma entidade/relacionamento para o diretório de trabalho do usuário não é recomendado. Se a sua aplicação executa um comando como a abaixo: > system $concat( cp f zim0100,$trim($workpath)) ou > system $concat( copy /y zim0100,$trim($workpath)) onde zim0100 é o arquivo físico do objeto a inicializar Um exemplo de utilização do comando seria: > INITIALIZE PERUSER tbcliente

16 Verificar Pendências e Finalizando ZimServer VIII. Verificar pendências/inconsistências na migração Antes de sair da sessão do Zim apos a importação, execute o comando zomdiagnose no prompt do Zim: > zomdiagnose ;d zomoutputdoc O arquivo zomoutputdoc contém todas as inconsistências que deverão ser verificadas, edite este documento e verifique as inconsistências reportadas neste momento. Agora você pode finalizar a sessão do Zim, e finalizar o servidor ZimServer na próxima etapa IX-Finalizando ZimServer. IX. Finalizando ZimServer Para finalizar a execução do ZimServer execute o comando a seguir: Para Unix: $> $ZIM/zimserver -k Para Windows: Iniciar Programas ZIM 850 Stop ZimServer Antes de inicializar novamente o Zim 8.50, copie os arquivos conforme explicado na etapa X-Copiar Seus Arquivos de Dados a seguir.

17 Copiar Arquivos de Dados da versão 7.11 X. Copiar seus arquivos de dados (se não foram importados) Se, na etapa IV-Exportação da Definição do Danco de Dados, Item 5, você escolheu não exportar os dados das tabelas do Zim 7.11, você deve então copiar os arquivos físicos (zimxxxx) da base do Zim 7.11 para a nova base de dados Zim Para isso, basta copiar os arquivos zim0100 em diante para o novo banco de dados Zim 8.50 (/zimdata/base850 ou C:\ZIMDATA\BASE850). ATENÇÃO: Se você tiver diretórios Zim em seu banco de dados, você NÃO PODE COPIAR OS ARQUIVOS CORRESPONDENTES desses diretórios Zim, pois a estrutura interna é diferente no Zim 8.50 em relação às versões anteriores. Se você não tiver certeza sobre quais arquivos você não deve copiar, basta procurar os diretórios do sistema operacional onde está a base Zim 8.50 (/zimdata/base850 ou C:\ZIMDATA\BASE850) nomeado como zimxxxx.ws. Esses arquivos zimxxxx, não devem ser copiados para o novo banco de dados Zim 8.50! Copiar todos os documentos externos, se houver, como: areas.zim, programas fontes e documentos em geral do diretório da base de dados da versão 7.11 para a diretório da base de dados da versão 8.50 (/zimdata/base850 ou C:\ZIMDATA\BASE850).

18 Iniciando ZimServer e Recomendações XI. Iniciar o ZimServer versão 8.50 AVISO: Antes de iniciar o Zimserver, você deve copiar o arquivo AREAS.ZIM do diretório: origem (/zimdata/base711 ou C:\ZIMDATA\BASE711) para o destino (/zimdata/base850 ou C:\ZIMDATA\BASE850). Proceda como explicado na etapa V-Criando o Banco de dados Zim XII. Atualizar o diretório da base de dados e/ou aplicação AVISO: O programa ZIM8CNV2 não faz a cópia dos programas e arquivos externos do diretório origem/destino, é função da pessoa responsável pelo processo de migração, copiar os arquivos necessários para o funcionamento da aplicação na nova base de dados/diretório, tais como comandos externos do sistema operacional (arquivos.bat ou shell script), arquivos de parâmetros (.INI) e os fontes da aplicação, etc.

19 Recompilar todos os programas XIII. Recompilar todos os programas Neste ponto, os arquivos do Zim (zim0100 em diante) ainda estão em versões anteriores do Zim. No entanto, logo que você iniciar o ZimServer novamente e começar a utilizar o aplicativo, todos os arquivos serão convertidos de forma automática e silenciosa para a versão do Zim Se você quiser garantir uma migração completa, inicie o ZimServer manualmente e execute um FIND 1 sobre todos os arquivos Zim. Veja o exemplo abaixo: > add docs let docname= comp1 filename= comp1.cmd dirname= Zim > zomenable > zomcreate comp1 > set head off > set out comp1 > list all ents format find 1 entname > set out terminal > set head on > comp1 dentro deste arquivo estarão a lista de tabelas a convertar via comando FIND 1. Recompilar todos os programas, para isso você pode executar o comando abaixo: > zomenable > zomcompile *

20 Configurando Terminal (UNIX) XIV. Configurando o Terminal (UNIX) Não copie os arquivos ZIMTCAP de versões anteriores do Zim para a versão Zim 8.50, não é compatível! Você deve configurar o arquivo zimtcap referente a configuração de terminal (ansi, vt100, xterm e etc) utilizando o utilitário zimtcap. Consulte o tutorial Criando ou Editando o Zimtcap para mais informações.

21 Migrando para Zim Final IV) NOTAS: Este documento descreve o seguinte assunto: Migrando para Zim 8.50 (UNIX/Windows) FIM Consulte também os tutoriais disponíveis: Instalando Zim 8.50 (Unix) Instalando Zim 8.50 (Windows) Arquivos de Configuração Zim 8.50 (Unix/Windows) Configurando ZimTcap (Unix) Zim 8.50 Primeiros Passos (Unix/Windows)