Manual de Migração ERP PRIMAVERA V9.10

Manual de Migração ERP PRIMAVERA V9.10 Versão 1.0 junho 2015

Índice Índice... 2 Introdução... 4 ERP... 5 Preparação da Instalação... 5 Requisitos...5 Atualização do Servidor de Dados...5 Atualização dos Módulos...5 Instalação e Migração das Bases de Dados... 6 Preparação...6 Atualização de Empresas...6 Cópias de Segurança das Bases de Dados...6 Instalação da Instância do servidor de dados...7 Instalação no Servidor...7 Instalação nos Postos...8 Atualização das Bases de Dados...8 Configurações de Acesso ao Administrador... 11 Cópias de Segurança... 11 Licenciamento... 11 Conversão de Preferências do Utilizador... 12 Conversão dos Projetos VBA... 12 Terminando a Instalação... 13 Configuração Inicial... 13 Plataforma e Administrador... 13 Migração de Licenciamento... 13 Ambiente de Testes... 14 Pressupostos... 14 Configuração do Ambiente... 14 Migração de Mapas... 15 Migração da Extensibilidade... 16 Renomeação dos Componentes... 16 Outras Questões... 16 Pg 2

Tamanho da Base de Dados... 17 Servidor de Atualização... 17 Contatos e Oportunidades... 17 Pg 3

Introdução Este manual documenta os procedimentos recomendados para efetuar a atualização de instalações do ERP para a v9.00. Questões como a migração das bases de dados, das instalações, dos mapas e dos desenvolvimentos específicos são itens fundamentais ao sucesso da atualização do produto. No mercado português, caso seja necessário efetuar uma migração do Contalib v4.x para v.9.00 da Contabilidade Não Organizada (CNO) deverá ser executada uma instalação intermédia de CNO v.7.50 e utilizar respetivo migrador disponível na v.7.50. Posteriormente o Setup & Go fará o upgrade da v7.50 para v9.00. Para migrar as versões Starter Easy 7.60 ou Express 7.60 para o ERP 9.00 é necessário realizar primeiro uma migração para o ERP 8.10 e só posteriormente para o ERP 9.00. De modo a consultar a versão mais atualizada deste manual, sugere-se a sua consulta online na PRIMAVERA KnowledgeBase. Para completar as informações deste manual, sugere-se a consulta dos seguintes manuais disponíveis na PRIMAVERA KnowledgeBase: PKB Documentação Base Dados Documentação de Motores Alterações aos Motores e Base de Dados Manual de Instalação Pg 4

ERP A atualização para o ERP PRIMAVERA, inclui um conjunto bem definido de passos. Nomeadamente, no que diz respeito aos seguintes aspetos: Configuração do servidor de dados; Instalação das novas versões dos Produtos; Configuração de um ambiente de testes comparativos e de segurança entre a versão anterior e a nova versão; Migração das bases de dados; Conversão das preferências dos utilizadores e projetos VBA; Orientação dos testes a realizar para verificar a correção da instalação.. Preparação da Instalação Antes de realizar a instalação da nova versão é necessário proceder a um conjunto de passos no sentido de preparar a instalação previamente. Requisitos Para realizar todo o processo de instalação e migração para a nova versão são necessárias as seguintes ferramentas: Microsoft SQL Server 2005 ou superior. Atualização do Servidor de Dados O servidor de dados onde se encontra instalado o servidor deve estar totalmente atualizado. Atualização dos Módulos Todos os módulos PRIMAVERA em versões anteriores devem estar atualizados de acordo com as últimas Service Releases disponíveis. Sempre que for realizada uma atualização da versão dos componentes aplicacionais do ERP (RHP, L&T) deve igualmente ser atualizada a versão do WebCentral para a última versão disponível (procedimento obrigatório nas Service Releases e aconselhado nas Maintenance Builds). Pg 5

Instalação e Migração das Bases de Dados Este capítulo descreve os passos necessários para instalar a nova versão, efetuar a migração de todas bases de dados e preparar o ambiente de utilização para testes finais. Preparação A instalação deve ser preparada cuidadosamente para evitar situações que potenciem problemas na migração das bases de dados e/ou instalação das aplicações. Assim, recomenda-se que: A instalação seja efetuada num horário que garanta que nenhum utilizador necessitará de aceder às aplicações; Sejam removidos em todos os postos os atalhos de acesso às aplicações (exceto numa máquina que servirá para testes e que deve ser preferencialmente o próprio servidor); Antes de iniciar a atualização se verifique que nenhuma base de dados está a ser utilizada; Verifique que o espaço em disco no servidor de dados é suficiente para suportar o processo de migração de base de dados e instalação. Tipicamente, deverá ter espaço para a instalação, e pelo menos o dobro do espaço ocupado pelas bases de dados das empresas; Verificar as collations das bases de dados. As empresas e o PRIEMPRE devem ter a mesma collation da base dados tempdb. Para verificar pode utilizar a seguinte query SQL: SELECT DATABASEPROPERTYEX('tempdb','COLLATION'); Deve ser feita uma cópia de segurança dos anexos, na pasta Dados\Lx\Anexos de cada instância (onde Lx representa a versão original) e das fotografias dos funcionários, na pasta Dados. Atualização de Empresas [Tempo previsto: 5 minutos por exercício] Todas as bases de dados devem estar na última versão. Para verificar esta questão deve-se executar o utilitário de atualização de exercícios do Administrador (Utilitários Empresas Atualização de Empresas (Privada)). Cópias de Segurança das Bases de Dados [Tempo previsto: 5 minutos por base de dados] Pg 6

De seguida deve ser realizada uma cópia de segurança de cada uma das bases de dados usando o utilitário do Administrador existente para o efeito (Empresas Manutenção Cópia de Segurança). Pode também usar a cópia de segurança de Empresas em bloco (Utilitários Empresas Cópia de segurança de Empresas em bloco). Deve ser realizada também uma cópia de segurança do PRIEMPRE (Utilitários Empresas Manutenção da Base de Dados de Empresas). O projeto VBA de cada empresa deve ser exportado (idealmente, para ficheiros de texto) antes de continuar com a migração das bases de dados das Empresas. Estas cópias de segurança são imprescindíveis na medida que servirão de base para a instalação noutra instância do servidor de dados. Instalação da Instância do servidor de dados Num cenário de migração é recomendado que sejam mantidas as duas instalações a funcionar em paralelo para que exista um ambiente de testes completamente funcional. Também é possível migrar a instância no servidor de dados da versão anterior para a nova. Apesar do migrador (Setup&Go) o suportar, é mais aconselhável usar duas instâncias, pois no caso de erros que obriguem a repor a situação inicial torna-se necessário remover todas as empresas e base de dados PRIEMPRE e repor as cópias de segurança criadas anteriormente. Para montar um tal ambiente, será necessário proceder à instalação de uma nova instância do servidor de dados para albergar a nova versão. Em caso de instalação de uma nova instância SQL Server, consultar a documentação do produto ou o administrador de sistema. Atenção O manual de instalação descreve os passos de instalação do SQL Server 2008 R2 Express. Instalação no Servidor [Tempo previsto: 20 minutos] Nesta altura a nova versão está pronta a ser instalada no servidor aplicacional. Para proceder a essa instalação deve utilizar o PRIMAVERA Deployment Center. No caso de uma instalação em rede deve selecionar-se a opção Rede. Pg 7

Depois de terminada a instalação é necessário partilhar a pasta C:\ Program Files (x86)\primavera\ com o nome de partilha PRIMAVERA. A atualização no servidor poderá ser realizada através do serviço Deployment Center (comportamento disponível desde a v7.55 SR2). PKB Como efetuar a instalação de novas aplicações com o Deployment Center? Instalação nos Postos Na instalação de um posto deve ser utilizado o Deployment Center Client. PKB PRIMAVERA Deployment Center Client Como são verificadas as novas atualizações do posto? Atualização das Bases de Dados [Tempo previsto: 20 minutos por empresa] A migração de bases de dados é um processo automático efetuado pelo Setup&Go. Este utilitário executa o seguinte conjunto de ações: 1. Seleção da Linha, Versão e Instância a ser migrada: Pg 8

2. Migração da base de dados PRIEMPRE; 3. Diagnósticos sobre as bases de dados dos Exercícios; 4. Caso existam erros durante a execução dos diagnósticos, é dada a oportunidade ao utilizador de efetuar as correções adequadas antes de prosseguir com a migração; 5. Migração das bases de dados dos Exercícios; 6. No final, é apresentado o Relatório de Migração (cujo ficheiro é guardado na pasta C: \Program Files (x86)\primavera\sg900\dados\lx\relmigração) onde se pode observar a eventual existência de erros de migração. Quando o processo da migração é efetuado entre duas instâncias de SQL, há a possibilidade para fazer a cópia das bases de dados com um backup/restore (selecionar a pasta partilhada que ambos devem ter permissões). Esta funcionalidade tem algumas considerações especiais, pelo que é recomendada quando se tem: 1. Instâncias de SQL distintas no mesmo posto, para migrar instâncias de qualquer versão; 2. Instâncias de SQL distintas em postos diferentes, para migrar a instância da versão anterior. Por omissão, esta opção está sempre ativa e é aplicada para os cenários recomendados, podendo ser desativada através da opção de migração Criar as empresas criando cópias de segurança : Pg 9

A opção Migrar projecto VBA está selecionada por omissão (comportamento disponível desde a v7.50 SR2). Significa isto que deixa de ser necessário importar o projeto VBA no final do processo de migração (exceto se o mecanismo de segurança se encontrar ativo). O Setup&Go apenas suporta migrações a partir da versão V7.50 do ERP. O mesmo se aplica para a migração de projetos VBA através do Setup&Go. Os projetos VBA do POS e/ou Shell que estejam protegidos por palavra-chave terão de ser migrados manualmente. Outra nova opção, que se pode observar na figura acima, é: Utilizar uma transação na migração. Esta opção permite-nos executar o processo de migração no contexto de uma transação. Significa que quando ocorre um erro de migração a base de dados é reposta (rollback) na última versão válida, permitindo-nos continuar o processo de migração a partir daqui. Por vezes, poderemos ter a necessidade de perceber porque está a acontecer determinado erro de migração mais complexo e para isso teríamos de deixar a base de dados no estado imediatamente anterior à ocorrência do erro. É necessário ter muita atenção ao utilizar este modo porque, a partir desse momento, a base de dados fica num estado inválido sendo obrigatório repor manualmente a última cópia de segurança e reiniciar o processo de migração completo. O objetivo deste modo é apenas o de permitir fazer debug ao processo de migração. Caso ocorram erros durante o processo de migração, é necessário proceder à correção manual das inconsistências apresentadas e repetir a migração. Pg 10

O Setup&Go também pode reportar os erros de migração para o ficheiro de texto C:\7UpGo.log. O objetivo desta nova opção não é o de substituir o Relatório Final de Migração, mas sim proporcionar um meio adicional, mais compacto e de fácil tratamento, de reportar os erros de migração. Este modo está ativo por omissão podendo ser desativado através da opção de migração Log de erros para ficheiro de texto. Recomenda-se que os Diagnósticos do Setup&Go sejam executados para todas as bases de dados, de forma a poder corrigir eventuais problemas de inconsistência de dados. Configurações de Acesso ao Administrador [Tempo previsto: 3 minutos] Em cenários de migrações, no caso de não se encontrarem verificadas as condições para o cumprimento de requisitos em vigor com a publicação do Despacho n.º 8632/2014 (Portugal), será possível continuar a utilizar o ERP, de forma a não criar muito ruído e permitir ao utilizador realizar normalmente o seu trabalho. No entanto, a abertura do Administrador, quando não se verificarem estas condições (por exemplo: inexistência de utilizador Super Administrador com uma conta de e-mail configurada e Servidor de e-mail configurado), obrigará à inicialização da Plataforma PRIMAVERA, onde será garantido o cumprimento destes requisitos. Cópias de Segurança [Tempo previsto: 5 minutos por base de dados] Imediatamente após a conclusão do processo de migração de todas as bases de dados, recomenda-se a realização de uma cópia de segurança de cada uma destas bases de dados convertidas. Estas cópias de segurança servirão de referência futura, nomeadamente para esclarecer alguma dúvida sobre problemas que possam ter sido gerados pela migração e/ou pela utilização posterior a esta nova versão. Licenciamento [Tempo previsto: 10 minutos] O licenciamento foi alterado em vários aspetos em relação às versões anteriores. Assim sendo, são necessárias novas licenças para esta versão que devem ser introduzidas no Administrador antes que os utilizadores realizem o primeiro acesso aos produtos. Relativamente ao licenciamento para o mercado de Angola e Moçambique, para além da respetiva licença, deverá ser solicitada uma chave HASP. A chave HASP funciona em conjunto com o PRIMAVERA License Watcher. O PRIMAVERA License Watcher pode ser instalado em qualquer máquina da rede local e a chave HASP deve-se encontrar nessa mesma máquina. Pg 11

O número de utilizadores que acedam a uma determinada aplicação não pode exceder um número de licenças disponíveis. O acesso do utilizador N+1 (sendo N o número de utilizadores da licença do módulo X) não será permitido. Conversão de Preferências do Utilizador [Tempo previsto: 2 minutos] Para converter as preferências manualmente, copiar todo conteúdo da pasta C:\Program Files (x86)\primavera\sg800\config\lx para a pasta C:\Program Files (x86)\primavera\sg900\config\lx exceto os seguintes ficheiros: PRISECLE.BIN *.DAT (existentes apenas na raiz) Conversão dos Projetos VBA [Tempo previsto: 10 minutos por Empresa] Após a migração para uma nova versão da Plataforma (PLT), poderá ser apresentada a seguinte mensagem de aviso na abertura da empresa: "O projeto foi importado, mas ocorreram erros de compatibilidade. Pode consultar o ficheiro de log 'privba.log' na pasta da aplicação." Esta mensagem é apresentada quando existe quebra de compatibilidade entre versões, tendo consequências no projeto VBA (por exemplo, componentes ou eventos que foram descontinuados e eram utilizados no projeto VBA). Para saber como identificar quais os componentes que deixaram de ser suportados, sugere-se a consulta do artigo Aviso: "O projeto foi importado, mas ocorreram erros de compatibilidade. disponível na PRIMAVERA KnowledgeBase. PKB Visual Basic for Applications (VBA) Aviso: "O projeto foi importado, mas ocorreram erros de compatibilidade." Pg 12

Terminando a Instalação Quando a instalação terminar com sucesso e as bases de dados tenham sido convertidas com sucesso, a versão anterior deve ser removida de todos os postos exceto um (a máquina a utilizar para efetuar os testes comparativos). A desinstalação deve ter em conta os seguintes aspetos em cada posto: Devem ser removidos todos os atalhos para as aplicações existentes no posto (para evitar acessos por engano); Devem ser removidas no Administrador todas as permissões de acesso às aplicações exceto a um utilizador (o que realizará os testes comparativos, preferencialmente um administrador de sistema). Configuração Inicial Antes de colocar a nova versão em produção há um conjunto de operações de configuração necessárias e que dependem da aplicação. Plataforma e Administrador Verificar o licenciamento de cada um dos módulos; Verificar as permissões de acesso de cada perfil de utilizadores (verificando que as novas operações configuráveis como, por exemplo, o acesso a listas de sistema, estão devidamente atribuídas); Verificar as permissões dinâmicas (para cada empresa) para cada perfil de utilizadores; Verificar as permissões de acesso às aplicações de cada utilizador (propriedades da ficha de utilizador); Verificar o idioma associado ao utilizador; Verificar estado geral das bases de dados (consola de administração e assistente de desempenho). Migração de Licenciamento Encontra-se disponível no Partner Space uma ferramenta auxiliar que permite realizar a migração do licenciamento de versões v8.xx do ERP para a versão v9.00, PRIMAVERA License Migrator. Depois de instalado, é possível aceder à aplicação através do menu Iniciar Programas PRIMAVERA v9.00 Ferramentas License Migrator v9.00. PKB Como migrar o licenciamento da v8.xx para a v9.00? Pg 13

Ambiente de Testes O processo de migração descrito anteriormente visa, para além de efetuar a instalação, montar um ambiente de testes comparativos entre versões seguro e que permita a resolução rápida de qualquer problema. Pressupostos Este ambiente de testes pretende permitir: A manutenção da instalação da versão anterior completamente funcional e sem qualquer tipo de alteração; A existência de uma máquina na rede que permita a consulta e confrontação de valores na versão anterior; A verificação dos erros já existentes na instalação da versão anterior (consultando essa instalação); A verificação de erros eventualmente introduzidos no processo de migração das bases de dados (mantendo cópias de segurança das bases de dados antes e depois da migração); A verificação de erros introduzidos pelo funcionamento da nova versão; A configuração rápida de todos os outros postos para passarem a utilizar a nova versão. Configuração do Ambiente A configuração ideal do ambiente de testes e instalação deve ser a seguinte: Pg 14

Do diagrama interessa salientar os seguintes aspetos: Servidor (v8.xx): instância original a que apenas uma máquina terá acesso; Servidor (v9.00): nova instância a que todos os postos terão acesso para utilizar as aplicações da nova versão; Cópias de Segurança Antes : cópias de segurança de todas as bases de dados antes da migração; Cópias de Segurança Depois : cópias de segurança de todas as bases de dados imediatamente após a conclusão da migração; Máquina de testes v8.xx : máquina apenas com a v8.xx instalada para utilização preferencialmente por um administrador de sistema para confrontação de valores; Máquina de testes v9.00 : qualquer um dos postos da v9.00 usado para confrontação de valores. Migração de Mapas Encontra-se disponível no Partner Space um assistente que auxiliará o utilizador no processo de migração dos seus mapas: "PRIMAVERA Crystal Report Migrator". Depois de instalado, é acessível a partir do menu Iniciar Programas PRIMAVERA Ferramentas Crystal Report Migrator. PKB Como migrar mapas entre versões diferentes? Pg 15

Migração da Extensibilidade Renomeação dos Componentes Com a v9.00, os componentes foram renomeados de 800 para 900. Por exemplo, o objeto ADMBE800 passou a ser designado ADMBE900. Esta é a forma utilizada pela PRIMAVERA para permitir que duas grandes versões, por exemplo v8.00 e v9.00, coexistam em simultâneo. Assim, para que as aplicações integradas com o ERP PRIMAVERA v9.00 funcionem, é necessário atualizar as referências aos componentes da versão anterior para os componentes da v9.00. PKB Documentação de Motores Outras Questões O processo de migração das bases de dados PRIMAVERA não contempla as seguintes situações que devem ser geridas pelos respetivos responsáveis: Existência de qualquer objeto (tabela, campo, view, trigger, stored procedure, etc.) que não faça parte da estrutura padrão (incluindo também tabelas e campos do utilizador) das bases de dados PRIMAVERA; Alterações não documentadas da estrutura padrão da base de dados; Falta de algum objeto que faça parte da estrutura padrão. Qualquer um dos casos referidos anteriormente pode resultar no cancelamento do processo de migração com erros. Esses erros devem ser corrigidos manualmente caso a caso e o processo de migração deve ser reiniciado (repondo cópias de segurança). Pg 16

Tamanho da Base de Dados O tamanho físico dos ficheiros da base de dados pode ser reduzido compactando a base de dados a partir do Administrador. No entanto, a compactação poderá ter impacto negativo na performance, sendo necessário no final desta operação, efetuar uma reindexação dos índices. Servidor de Atualização Para tornar o processo de atualização mais rápido evitando tempos de espera resultantes de transferência de dados pela rede é recomendado que a atualização seja efetuada na mesma máquina onde o servidor de dados esteja instalado. Contatos e Oportunidades Este procedimento tem como objetivo realizar a migração de projetos VBA de Contactos e Oportunidades (CRM) e apenas é necessário para quem possui a v8.xx. Devido à separação do módulo de CRM da Logística e Tesouraria as operações de CRM passam a ter um Motor próprio. Nas referências dos projetos VBA passa a existir a referência das Business Entities do CRM. Pg 17

Para efetuar uma migração de projetos VBA de CRM torna-se necessário exportar o Projeto VBA e proceder manualmente à renomeação das novas chamadas aos motores CRM. Exemplos: Dim Contacto As GcpBEContacto (antigo) Dim Contacto As CrmBEContacto (novo) BSO.Comercial.Contactos.Atualiza (antigo) BSO.CRM.Contactos.Atualiza (novo) Depois da migração do ERP efetuada deve-se proceder à importação do projeto VBA e garantir que a Referência PRIMAVERA CRMBE9.00 se encontra selecionada. PKB Documentação de Motores Alterações aos Motores e Base de Dados Pg 18