Instalação

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

Este documento destina-se a um administrador de TI que esteja a configurar o Altium On-Prem Enterprise Server para utilizar uma base de dados Oracle como backend. Contém detalhes sobre o Enterprise Server, o respetivo procedimento de instalação, informações importantes sobre os requisitos do sistema, bem como um exemplo.

Para seguir este guia, deverá ter uma compreensão geral dos conceitos de bases de dados Oracle e do ambiente do sistema operativo.

Visão geral do processo de instalação

A configuração do Enterprise Server para 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 instalação envolve normalmente três etapas, conforme ilustrado na imagem seguinte.

Visão geral de alto nível do procedimento de instalação 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, são assumidos alguns pressupostos ao longo deste documento:

1. Um administrador de TI realiza a instalação. No mínimo, o utilizador que realiza a instalação do Enterprise Server deverá ter direitos administrativos na máquina anfitriã.
2. O Enterprise Server está instalado e em execução num sistema operativo Microsoft Windows completo.
3. O Oracle Client Connector está instalado e em execução na mesma máquina que aloja a aplicação Enterprise Server.
4. O Microsoft .NET 6  está instalado e em execução na mesma máquina que aloja a aplicação Enterprise Server – caso não esteja disponível, será instalado automaticamente durante a instalação do Enterprise Server.
5. O Oracle Server deverá estar em execução numa máquina anfitriã fisicamente diferente da aplicação Enterprise Server.
6. O Schema Oracle e as credenciais da aplicação Oracle utilizadas nos servidores Oracle de origem e de destino devem ser as mesmas, se esta instalação estiver a ser realizada como parte de um processo de migração de dados.

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

Tal como outro software concebido para ser executado no Microsoft Windows, o Enterprise Server é uma aplicação de servidor multithread e multisserviço. Como este documento se centra 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 são um conjunto de serviços de suporte.

Este documento centra-se nos Backend Storages, uma vez que os dados neste bloco são aqueles que são copiados em backup, potencialmente 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, como a associação de footprint de componente e símbolo esquemático, parâmetros, caminhos de ficheiros, ligações a fontes de dados da cadeia de abastecimento de componentes, entre outros. 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 Schematic, footprints, símbolos, Draftsman e outros documentos nativos ou não nativos do Enterprise Server.

Exemplo de configuração do Enterprise Server com backend Oracle na plataforma Windows

Neste exemplo, as instruções destinam-se também a pequenas empresas que podem não ter um administrador de bases de dados Oracle (DBA) dedicado, mas que ainda assim necessitam de implementar uma configuração Enterprise Server-Oracle na sua rede. Os passos seguintes mostram como pode ser implementada uma instalação básica do Enterprise Server e do Oracle.

Pressupõe-se que a instalação é efetuada utilizando a conta interna Oracle SYSTEM e que não é criado nenhum SCHEMA personalizado. No entanto, recomenda-se que os utilizadores mais experientes, ou os DBAs, criem uma conta de utilizador adequada, com o SCHEMA associado ao qual sejam concedidas as permissões apropriadas.

Itens necessários

• Máquina anfitriã do Oracle Database Server, com Windows 7 Professional ou posterior.

• Máquina anfitriã do Enterprise Server, com Windows Server 2016 Standard Edition (64-bit) ou posterior.

• Versão 19c do Oracle Database.
• Conector cliente Oracle Data Access Components (ODAC), tal como ODTwithODAC122011 (ver abaixo).
• Altium On-Prem Enterprise Server.

Procedimento de instalação

1. Na máquina anfitriã do servidor Oracle DB:
   1. Instale o Oracle Database 19c. Anote o nome/palavra-passe que escolher.
   2. Certifique-se de que a configuração NLS_CHARACTERSET está definida para AL32UTF8.
   3. Optional: Configure uma conta de utilizador da base de dados para utilização com o Enterprise Server como alternativa à conta predefinida SYSTEM. Anote o nome de utilizador e as informações de início de sessão que escolher. Pode ser criada uma nova conta de utilizador da base de dados e os respetivos ficheiros com a aplicação Oracle SQL Developer, utilizando, por exemplo, os seguintes comandos SQL (em que o nome/palavra-passe da nova conta de utilizador é ENTERPRISESERVERUSER/ENTERPRISESERVERPASS):

create tablespace ENTERPRISESERVERUSER datafile 'C:\app\odb19\oradata\orcl\ENTERPRISESERVER.dbf' size 100M autoextend on;
create tablespace TEMP datafile 'C:\app\odb19\oradata\orcl\TEMP.dbf' size 100M autoextend on;
CREATE USER ENTERPRISESERVERUSER IDENTIFIED BY ENTERPRISESERVERPASS DEFAULT TABLESPACE ENTERPRISESERVERUSER;
GRANT CONNECT TO ENTERPRISESERVERUSER;
GRANT CONNECT, RESOURCE, DBA TO ENTERPRISESERVERUSER;
GRANT CREATE SESSION TO ENTERPRISESERVERUSER;
GRANT UNLIMITED TABLESPACE TO ENTERPRISESERVERUSER;
GRANT ALL PRIVILEGES TO ENTERPRISESERVERUSER;

2. Na máquina anfitriã do Enterprise Server:
   1. Primeiro, instale o software Oracle Data Access Components (ODAC): ODTwithODAC122011.
   2. Copie o ficheiro tnsnames.ora da máquina anfitriã do servidor Oracle DB para a máquina anfitriã do Enterprise Server.
      1. O ficheiro encontra-se normalmente no diretório %ORACLE_HOME%\Network\Admin, em que a variável de ambiente ORACLE_HOME é determinada pela localização da instalação do Oracle – por exemplo: C:\app\odb19\product\19.x.x\dbhome_1
      2. O local de destino na máquina do Enterprise Server é novamente %ORACLE_HOME%\Network\Admin, em que o caminho ORACLE_HOME corresponde à localização da instalação do ODAC – por exemplo: C:\app\product\12.2.0\client_1\Network\Admin

3. Instale o Enterprise Server.
4. Durante a instalação do Enterprise Server, introduza o seguinte:
   1. TNS Alias: a predefinição é ORCL. Se tiver realizado o passo 1-a, introduza o nome TNS apropriado que aqui definiu.
   2. Username: a predefinição é SYSTEM. Se tiver realizado o passo 1-c, introduza o nome de utilizador apropriado que aqui definiu (ENTERPRISESERVERUSER no exemplo).
   3. Password: o mesmo que foi definido no passo 1-a ou 1-c.
5. Prossiga com a instalação e configuração do Enterprise Server conforme descrito no documento Installing Altium On-Prem Enterprise Server.

Conclusão

Embora o exemplo acima referido inclua detalhes adicionais relacionados com o tratamento de uma base de dados Oracle, existem apenas três passos fundamentais para configurar o seu Enterprise Server para funcionar com um backend Oracle:

1. O passo 1 consiste em criar uma conta Oracle e um SCHEMA.
2. O passo 2 consiste em estabelecer os parâmetros tnsnames.ora.
3. O passo 3 consiste em instalar o Enterprise Server.