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.

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 bases de dados Oracle. Algumas empresas executam bases de dados Oracle sobre sistemas operativos Windows Server, enquanto outras dispõem de centros de dados Oracle completos. O processo de instalação envolve normalmente três passos, conforme ilustrado na imagem seguinte.

Visão geral 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 instalação para instalação, são assumidos alguns pressupostos ao longo deste documento:

1. Uma instalação é realizada por um administrador de TI. No mínimo, o utilizador que realiza a instalação do Enterprise Server deve 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 .NET Framework 4.8 e o .NET Core 3.1.22 estão instalados e em execução na mesma máquina que aloja a aplicação Enterprise Server – se não estiverem disponíveis, serão instalados automaticamente durante a instalação do Enterprise Server.
5. O Oracle Server deve 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 destino devem ser os mesmos, caso esta instalação esteja a ser realizada como parte de um processo de migração de dados.

Visão geral da arquitetura do Enterprise Server

Tal como outro software concebido para ser executado em Microsoft Windows, o Enterprise Server é uma aplicação de servidor multithread e multisserviço. Uma vez que 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 geral de backend do Enterprise Server.

Visão geral 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 foca-se nos Backend Storages, uma vez que os dados dentro deste bloco são aqueles que são guardados em cópia de segurança, potencialmente migrados para outra máquina e depois restaurados na mesma ou noutra máquina. Nos Backend Storages, podem ser encontrados os seguintes elementos:

• Databases – contém metadados como a associação entre footprint de componente e símbolo esquemático, parâmetros, caminhos de ficheiros, 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ção como documentos de projeto PCB e esquemático, 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 também se destinam a empresas mais pequenas que poderão 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 Oracle.

Parte-se do princípio de que a instalação é efetuada utilizando a conta interna Oracle SYSTEM e de que não é criado qualquer SCHEMA personalizado. No entanto, recomenda-se que utilizadores mais experientes, ou DBAs, criem uma conta de utilizador adequada, com o SCHEMA associado e as permissões apropriadas.

Itens necessários

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

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

• 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 os dados de início de sessão que escolher. Uma nova conta de utilizador da base de dados e os respetivos ficheiros podem ser criados 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 na pasta %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. A localização 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: o valor predefinido é ORCL. Se tiver executado o passo 1-a, introduza o nome TNS apropriado que definiu aqui.
   2. Username: o valor predefinido é SYSTEM. Se tiver executado o passo 1-c, introduza o nome de utilizador apropriado que definiu aqui (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 inclua detalhes adicionais relativos ao 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.