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 da 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

Restaurar o Enterprise Server quando se utiliza um backend Oracle depende da forma como a sua empresa gere as suas Bases de Dados Oracle. Algumas empresas executam Bases de Dados Oracle em Sistemas Operativos Windows Server, enquanto outras têm centros de dados 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 considerados ao longo deste documento

Embora as configurações Oracle possam variar de local para local, ao longo deste documento são considerados 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 Cópia de segurança do Altium On-Prem Enterprise Server com um backend Oracle.
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 efetuar 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 tratar 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 Schema Oracle e as credenciais da aplicação Oracle utilizadas nos servidores Oracle de origem e de destino têm de ser as mesmas.

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

À semelhança de outro software concebido para ser executado em Microsoft Windows, o Enterprise Server é uma aplicação de servidor multithread e multisserviço. Como 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 de 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 constituem 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, que podem ser migrados para outra máquina e depois restaurados na mesma máquina ou numa máquina diferente. Nos Backend Storages, podem ser encontrados os seguintes itens:

• Databases – contém metadados como a associação entre footprint de componente e símbolo esquemático, parâmetros, caminhos de ficheiro, ligações a 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 contém dados binários dentro do repositório VCS do Enterprise Server. Estes dados binários incluem informações como documentos de projeto PCB e esquemático, 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 um backend de base de dados Firebird predefinido, ou quando utiliza a base de dados Oracle como backend.

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

1. avbackup.exe NOTnão suporta restaurar os metadados do seu Enterprise Server para uma Base de Dados Oracle. Esta funcionalidade só funciona em implementações do Enterprise Server que utilizem um backend de base de dados Firebird originalmente configurado automaticamente pelo instalador do Enterprise Server.
2. 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.
3. O Enterprise Server tem de estar em execução. avbackup.exe 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 dos dados do Enterprise Server com backend Oracle na plataforma Windows

Neste exemplo, as instruções também se destinam a empresas mais pequenas que possam não ter um Administrador de Base de Dados Oracle (DBA) dedicado, mas que ainda assim necessitem 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 base de dados Oracle.

Itens necessários

• Instância funcional pré-existente do Enterprise Server com backend Oracle.
• Pastas e origens de dados pré-existentes:
  • As pastas onde os seus dados do Enterprise Server e Oracle ficarão localizados já devem existir e conter uma cópia do ficheiro zip de cópia de segurança do seu 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 adequado ao servidor Oracle (ou seja, adicionar a conta Windows do utilizador à função sysDBA em ambiente Windows).

Procedimento de restauro

1. Se não tiver sido configurada nenhuma instância pré-existente do Enterprise Server com backend Oracle, leia o documento Instalar o Altium On-Prem Enterprise Server com um backend Oracle para um exemplo de como configurar o Enterprise Server com backend Oracle numa nova máquina.
2. Neste ponto, 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 ficheiro 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 encontra-se 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 nesta pasta (é útil ter caminhos de ficheiro comuns, por exemplo: C:\Backups).
   2. Elimine/apague o schema existente e a conta de utilizador da base de dados Oracle.

A eliminação de uma conta de utilizador Oracle e do respetivo schema associado pode ser feita da seguinte forma. Neste exemplo, iremos eliminar a conta de utilizador existente AESUSER313 e o respetivo Schema associado de uma Base de Dados Oracle em Microsoft Windows:

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

sqlplus / as sysdba

shutdown immediate;

startup restrict;

4. Elimine o schema associado ao Enterprise Server (neste exemplo, AESUSER313 é o nome do schema que queremos apagar):

drop user AESUSER313 cascade;

5. reative a BD normalmente, reiniciando a máquina ou utilizando os seguintes comandos:

shutdown immediate;

startup;

3. Crie um Schema 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. Após importar com êxito a BD, 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 schemas têm ambos o nome AESUSER313 e a palavra-passe Altium):
   1. Inicie a linha de comandos com privilégios de Administrador
   2. Pare os servidores IIS utilizando o comando:

net stop WAS

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

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

onde,

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

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

xe – nome do serviço de rede da BD 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 de 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 alterou o servidor da BD).
   2. Valide as definições do servidor IIS. Verifique se a coluna “Host name” nas associações no IIS Manager está atualizada. Deve lá constar 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 – proprietário do esquema.
      5. Password=Altium – palavra-passe do utilizador definida pelo DBA.
      6. DBLocation=FQDN ou ip_address:1521 – endereço do seu servidor de BD.
      7. DatabaseName=xe – nome atual do serviço de rede da BD, contido em tnsnames.ora.

Conclusão

Embora o exemplo acima inclua detalhes adicionais relativos à interface com uma Oracle Database e à sua manipulação, 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 IIS Application Pools do Enterprise Server.
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.

A execução deste procedimento pela ordem descrita reduz significativamente a probabilidade de corrupção de dados devido a incompatibilidade entre a base de dados Oracle e os dados binários do Enterprise Server.