Restaurar

Parent page: Altium On-Prem Enterprise Server com backend Oracle

Este documento destina-se a um administrador de TI que esteja a restaurar os dados do seu Altium On-Prem Enterprise Server quando o Enterprise Server utiliza um backend de Base de Dados Oracle. Contém detalhes sobre o Enterprise Server, o respetivo procedimento de restauro no contexto de utilização de Oracle, informações importantes sobre os requisitos do sistema, bem como um exemplo que descreve o restauro de dados na plataforma Microsoft Windows.

Visão geral do processo de restauro

O restauro do Enterprise Server ao utilizar um backend Oracle depende da forma como a sua empresa gere as respetivas Bases de Dados Oracle. Algumas empresas executam Bases de Dados Oracle sobre sistemas operativos Windows Server, enquanto outras dispõem de datacenters Oracle completos. O processo de restauro envolve, normalmente, três passos, conforme ilustrado na imagem seguinte.

Visão geral de alto nível do procedimento de restauro do Enterprise Server e da base de dados Oracle.

Pressupostos assumidos ao longo deste documento

Embora as configurações Oracle possam variar de local para local, ao longo deste documento são assumidos os seguintes pressupostos:

1. Foi efetuada uma cópia de segurança completa dos dados do Enterprise Server e do respetivo dump de dados Oracle associado, conforme descrito no documento Backing up Altium On-Prem Enterprise Server with an Oracle Backend.
2. O restauro é realizado por um administrador de TI. No mínimo, o utilizador que executa o restauro do Enterprise Server deverá ter direitos administrativos na máquina anfitriã.
3. Deverá estar presente um Administrador de Base de Dados (DBA) para realizar a importação dos dados Oracle. No mínimo, o utilizador que segue este guia deverá ter acesso total de leitura/escrita para importar e modificar a base de dados Oracle da empresa.
4. Este guia assume que existe uma instalação do Enterprise Server já existente, configurada e funcional com um backend Oracle. (Consulte a secção de exemplo para mais detalhes sobre como lidar com um ambiente em que está a ser implementado um novo Enterprise Server numa máquina e os dados são importados para essa instância do Enterprise Server).
5. O esquema Oracle e as credenciais da aplicação Oracle utilizadas nos servidores Oracle de origem e de destino têm de ser os mesmos.

Visão geral de alto nível da arquitetura do Enterprise Server

À semelhança de outro software concebido para ser executado no Microsoft Windows, o Enterprise Server é uma aplicação de servidor multithread e multisserviço. Uma vez que este documento se foca exclusivamente nas partes do Enterprise Server que podem interagir com uma Base de Dados Oracle, a imagem seguinte foi simplificada para representar a arquitetura global do backend do Enterprise Server.

Visão geral de alto nível da arquitetura do Enterprise Server. Os Backend Storages do Enterprise Server contêm a maior parte dos dados binários do cliente, enquanto os Windows Services são um conjunto de serviços de suporte.

Este documento centra-se nos Backend Storages, uma vez que os dados contidos neste bloco são aqueles de que é feita cópia de segurança, podendo ser migrados para outra máquina e, depois, restaurados na mesma máquina ou noutra diferente. Nos Backend Storages, podem ser encontrados os seguintes itens:

• Databases – contém metadados, tais como a associação de footprints de componentes e símbolos esquemáticos, parâmetros, caminhos de ficheiros, ligações para fontes de dados da cadeia de fornecimento de componentes e muito mais. Esta informação pode residir numa base de dados Firebird ou Oracle.
• File Storage – esta área de File Storage guarda dados binários dentro do repositório VCS do Enterprise Server. Estes dados binários incluem informações como documentos de projetos PCB e esquemáticos, footprints, símbolos, Draftsman e outros documentos nativos ou não nativos do Enterprise Server.

Visão geral de alto nível da ferramenta de restauro Altium

A ferramenta de restauro da Altium chama-se avbackup.exe. É o mesmo utilitário utilizado para fins de cópia de segurança e restauro com o Enterprise Server. Trata-se de um utilitário de linha de comandos que os administradores de TI podem executar para restaurar os dados do seu Enterprise Server. avbackup.exe é o mesmo utilitário utilizado para fins de restauro quando o Enterprise Server está configurado com uma base de dados Firebird predefinida como backend, ou quando utiliza a base de dados Oracle como backend.

Ao utilizar avbackup.exe numa implementação do Enterprise Server que usa uma Base de Dados Oracle, os administradores devem ter em conta o seguinte:

1. avbackup.exe NOTnão suporta o restauro dos metadados do seu Enterprise Server para uma Base de Dados Oracle. Esta funcionalidade apenas funciona em implementações do Enterprise Server que utilizem um backend de base de dados Firebird originalmente configurado automaticamente pelo Enterprise Server Installer.
2. avbackup.exe
3. avbackup.exe aceita o ficheiro Zip que gera quando é utilizado como ferramenta de cópia de segurança. Este ficheiro Zip contém todos os dados binários do Enterprise Server.
4. O Enterprise Server tem de estar em execução. avbackup.exe irá encerrar automaticamente todos os serviços do Enterprise Server (incluindo os serviços IIS) durante o restauro dos dados e, após um restauro bem-sucedido, reiniciará todos os serviços que tiver encerrado.

Exemplo de restauro de dados do Enterprise Server com backend Oracle na plataforma Windows

Neste exemplo, as instruções também se destinam a pequenas empresas que possam não ter um Administrador de Base de Dados Oracle (DBA) dedicado, mas que ainda assim necessitam de restaurar o seu Enterprise Server e os dados Oracle associados na sua rede. Os passos seguintes mostram como uma cópia de segurança básica do Enterprise Server e da respetiva base de dados Oracle associada pode ser restaurada para uma nova máquina e uma nova base de dados Oracle.

Itens necessários

• Instância funcional pré-existente do Enterprise Server com backend Oracle.
• Pastas e fontes de dados pré-existentes:
  • As pastas onde os seus dados do Enterprise Server e Oracle ficarão localizados já têm de existir e conter uma cópia do ficheiro zip de cópia de segurança do Enterprise Server e do ficheiro Oracle .DMP.
• Acesso de administrador à máquina anfitriã do Enterprise Server. Isto é necessário para executar corretamente o utilitário de linha de comandos de cópia de segurança do Enterprise Server (avbackup.exe).
• Acesso DBA apropriado ao servidor Oracle (ou seja, adicionar a conta Windows do utilizador à função sysDBA no ambiente Windows).

Procedimento de restauro

1. Se não tiver sido configurada qualquer instância pré-existente do Enterprise Server com backend Oracle, leia o documento Installing Altium On-Prem Enterprise Server with an Oracle Backend para ver um exemplo de como configurar o Enterprise Server com backend Oracle numa nova máquina.
2. Nesta fase, já deverá ter uma instância existente do Enterprise Server com Oracle – quer devido a uma instalação nova, quer anterior.
3. Na máquina anfitriã do Enterprise Server:
   1. Crie uma pasta de restauro (é útil ter caminhos de ficheiros comuns, por exemplo: C:\Backups). Coloque o ficheiro Zip de cópia de segurança do Enterprise Server nesta pasta.
   2. Restaure os dados do seu Enterprise Server executando a ferramenta avbackup.exe como Administrador. A ferramenta está localizada na pasta C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool.
   3. Desligue os serviços IIS do Enterprise Server ou desligue a máquina anfitriã do Enterprise Server. Isto evitará quaisquer operações de escrita não intencionais na sua Base de Dados Oracle por parte dos serviços do Enterprise Server.

4. Na máquina anfitriã da Base de Dados Oracle:
   1. Crie uma pasta de restauro e coloque o ficheiro Oracle .dmp nessa pasta (é útil ter caminhos de ficheiros comuns, por exemplo: C:\Backups).
   2. Remova/elimine o esquema existente e a conta de utilizador da base de dados Oracle.

A remoção de uma conta de utilizador Oracle e do esquema associado pode ser feita da seguinte forma. Neste exemplo, iremos remover a conta de utilizador existente AESUSER313 e o respetivo esquema associado de uma Base de Dados Oracle no Microsoft Windows:

1. Abra uma linha de comandos com privilégios de Administrador.
2. Pare os serviços IIS, se estiverem presentes na máquina Oracle, usando o comando: net stop WAS, depois prima Y e Enter.Ligue-se à Oracle DB iniciando uma sessão SqlPlus:

sqlplus / as sysdba

shutdown immediate;

startup restrict;

4. Remova o esquema associado ao Enterprise Server (neste exemplo, AESUSER313 é o nome do esquema que queremos eliminar):

drop user AESUSER313 cascade;

5. reative a DB normalmente, reiniciando a máquina ou usando os seguintes comandos:

shutdown immediate;

startup;

3. Crie um esquema idêntico no servidor Oracle e atribua direitos elevados:
   1. Abra a linha de comandos como Administrador e escreva:

sqlplus / as sysdba;

CREATE user AESUSER313 identified by “Altium”;

GRANT ALL PRIVILEGES TO AESUSER313;

GRANT IMP_FULL_DATABASE TO AESUSER313;

2. Em alternativa, pode conceder temporariamente a função DBA a este utilizador, importar os ficheiros e depois revogar este privilégio, conforme mostrado abaixo:

GRANT DBA TO AESUSER313;

3. Depois de importar a DB com sucesso, revogue os privilégios DBA:

revoke DBA from AESUSER313;

4. Restaure os dados Oracle (esta secção assume que a conta de utilizador e os esquemas se chamam ambos AESUSER313 e têm a palavra-passe Altium):
   1. Abra a linha de comandos com privilégios de Administrador
   2. Pare os servidores IIS usando o comando:

net stop WAS

3. Importe os dados Oracle. Um exemplo de comando de importação é:

imp AESUSER313/Altium@xe file=c:\Backups\AESUSER313.dmp log=c:\Backups\AESUSER313_import.log fromuser=AESUSER313 touser=AESUSER313

em que,

AESUSER313 – utilizador que tem privilégios totais sobre o esquema e direitos de acesso à DB.

Altium – palavra-passe da conta de utilizador Oracle associada ao Enterprise Server.

xe – nome do serviço de rede da DB de destino contido em tnsnames.ora.

file = c:\Backups\AESUSER313.dmp – localização da cópia de segurança.

log = c:\Backups\AESUSER313_import.log – registo do restauro (opcional).

fromuser=AESUSER313 – proprietário do esquema da cópia de segurança.

touser=AESUSER313 – o novo proprietário do esquema (se os proprietários forem diferentes, tem de criar um novo utilizador com os privilégios e funções adequados).

5. Verifique a integridade dos dados.
   1. Verifique o ficheiro tnsname.ora. Deve atualizar o nome do serviço de rede (se tiver alterado o servidor DB).
   2. Valide as definições do servidor IIS. Verifique se a coluna “Host name” nas bindings, no IIS Manager, está atualizada. Deve conter o Fully Qualified Domain Name (FQDN) atual do seu Enterprise Server.
   3. Verifique os valores dos seguintes parâmetros no ficheiro C:\Program Files (x86)\Altium\Altium365\LocalVault.ini.
      1. Domain – o nome do seu domínio.
      2. WebsiteDomain – FQDN do seu Enterprise Server.
      3. DataSourceType=Oracle – se estiver a utilizar Oracle DB.
      4. User=AESUSER313 – o proprietário do esquema.
      5. Password=Altium – a palavra-passe do utilizador definida pelo DBA.
      6. DBLocation=FQDN ou ip_address:1521 – endereço do seu servidor DB.
      7. DatabaseName=xe – nome atual do serviço de rede da DB, contido em tnsnames.ora.

Conclusão

Embora o exemplo acima inclua detalhes adicionais relacionados com a interface e manipulação de uma Oracle Database, existem apenas três passos principais para restaurar os dados do seu Enterprise Server:

1. O Passo 1 consiste em parar os serviços IIS e os Enterprise Server IIS Application Pools.
2. O Passo 2 consiste em restaurar os dados do Enterprise Server .
3. O Passo 3 consiste em restaurar os dados Oracle associados ao Enterprise Server.

Executar este procedimento pela ordem descrita reduz significativamente a probabilidade de corrupção de dados devido a incompatibilidades entre a base de dados Oracle e os dados binários do Enterprise Server.