1. Migração
A migração consiste na mudança de alguns arquivos locais de infraestrutura armazenados atualmente no diretório System para um SGBD em ambientes que utilizem banco de dados relacional.
O processo envolve os seguintes arquivos:
- Menus
- Todos os arquivos .XNU
- Empresas
- SIGAMAT.emp
- XX8
- XX9
- Help
- SIGAHLP
- Perfis de usuários
- Profile
- Metadados
- SXs
- Demais dicionários utilizados pela LIB para Event Viewer, Schedule, Mile e EAI.
Vantagens
A migração oferece as seguintes vantagens:
Para o Cliente
- Melhorar a gestão de configuração do Cliente;
- Centralização dos metadados e dos dados sobre os cuidados do SGBD;
- Uso do C-TREE não obrigatório.
Para o Usuário
- Abertura do Sistema mais rápida.
Para o sistema Microsiga Protheus
- Diminuição do I/Os no AppServer;
- Otimização dos programas na busca de informação;
- Maior facilidade para integração com o Identity.
2. Pré requisitos
Para executar o processo de migração, os seguintes itens devem ser atendidos (eles serão validados antes do processo e a migração não é executada caso algum deles não seja atendido):
• PDV ou Retaguarda de PDV, por hora, não são suportados;
• Utilização de License Server para controle de numeração automática;
• Cadastro de usuários não pode possuir dois ou mais usuários com o mesmo login;
• E-mail de validação para recuperação da senha do Administrador;
• Chave TOPMEMOMEGA configurada no arquivo appserver.ini do Servidor de Aplicação;
• Build do AppServer deve ser maior ou igual a ..........
• Build do DBAccess deve ser maior ou igual a ..........
• Obrigatoriedade do menu do Configurador (SIGACFG.XNU) estar dentro do StartPath (pasta System na configuração padrão). Caso o arquivo não esteja disponível para a importação, será exibida a mensagem "Menu do configurador não disponível no Startpath para importação" e o processo será bloqueado.
Observações importantes sobre o processo
• Registros deletados não serão migrados;
• Após migrar, não é possível "reverter" o processo de maneira automática;
• A migração está disponível apenas a partir da versão 12.1.17 do Protheus.
Mudanças
Quando o Microsiga Protheus é executado utilizando os arquivos de Infraestrutura no SGBD algumas mudanças ocorrem no sistema:
• Para cada conexão de usuário, serão criadas 2 conexões com o DBAccess, sendo que uma delas não consome licença e é não transacionada;
• A conexão utilizada pelas tabelas de infraestrutura não é transacionada;
• É proibido abrir o arquivo de Empresa(SIGAMAT) com DBUseArea, deve-se utilizar OpenSm0 ou OpenSm0Excl;
• É proibido abrir os arquivos de dicionário com DBUseArea, deve-se utilizar a função OpenSX.
3. Procedimento para implementação
Antes de executar o compatibilizador MPSYSTODB é imprescindível: a) Realizar o backup da base de dados do produto que será executado o compatibilizador, da pasta (\TOTVS 12\Microsiga\Protheus_Data\Data) e dos dicionários de dados SXs (\TOTVS 12\Microsiga\Protheus_Data\System); b) Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa; c) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema. |
Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a 28/04/2017. |
1. Em TOTVS SmartClient, digite MPSYSTODB no campo Programa Inicial.
2. Clique em OK para continuar.
3. Após a confirmação é exibida uma tela com informações sobre o procedimento que será executado. Leia e clique em Avançar.
4. Ao avançar é solicitado o login e senha, somente o usuário Administrador poderá executar o procedimento. Faça o login e clique em Avançar.
5. É executada uma verificação para analisar se todos os pré-requisitos da migração são atendidos, caso algum deles não seja, deve-se encerrar o processo, corrigir o problema e executar o compatibilizador novamente. Nesse momento também são listados os menus padrões que não foram encontrados no diretório System do ambiente e que portanto não serão migrados, caso algum desses menus deva ser migrado, encerre o processo, coloque o arquivo no diretório System e inicie o compatibilizador novamente. Se todos os itens estiverem validos, clique em Avançar.
6. Agora é necessário validar o email do Administrador. Essa etapa é importante pois depois da migração, caso o usuário Administrador esqueça a senha, somente será possível recuperar a mesma utilizando esse e-mail. Preencha o e-mail (caso o usuário Administrador já tenha um e-mail cadastrado, será apresentado o mesmo, sendo possível trocar esse endereço caso seja necessário), o SMTP, o login e a senha que serão usados pelo servidor para enviar o e-mail. Depois disso clique em Avançar.
7. Será enviado um email com um código para o endereço informado anteriormente. Aguarde o recebimento e preencha a caixa Chave de Segurança com o código recebido. Clique em Avançar.
8. É mostrada uma lista com todos os itens que serão migrados para o SGBD. Clique em Avançar.
9. Aguarde o fim da migração, isso pode demorar algumas horas. Clique em Finalizar.
Caso ocorra algum erro durante o processo de migração e o mesmo aborte o procedimento, deve-se executar o compatibilizador novamente para restaurar os arquivos como estavam antes e caso deseje, executar a migração novamente.
4. Utilização
Após realizar o processo de migração, deve-se utilizar o sistema normalmente e a partir desse momento o sistema irá utilizar as tabelas transferidas para o SGBD ao invés de usar os arquivos locais.