Pesquisar em: Doc:Documentation: Altium On-Prem Enterprise Server
Altium DesignerAltium 365Altium MCAD CoDesignerAltium On-Prem Enterprise ServerAltium CircuitMakerAltium CircuitStudioCompany DashboardAltium Infrastructure ServerAltium Developer Center
Ver: Version: 5.5
8.18.07.27.17.06.05.5
Close
Search Pesquisar na Documentação

Informação para Departamentos de TI

Updated: December 20, 2022 | Applies to version: 5.5
Now reading version 5.5. For the latest, read: Informação para Departamentos de TI for version 8.1
 

Parent page: Tópicos Avançados

Embora a instalação e utilização do Altium On-Prem Enterprise Server e dos respetivos serviços associados estejam detalhadas noutras páginas deste site de documentação, o objetivo desta página é disponibilizar um recurso único e detalhado para o departamento de TI de uma organização. Um local onde encontrar respostas para perguntas frequentes sobre esta tecnologia, incluindo:

  • What are the hardware requirements to install the Enterprise Server?
  • What is installed?
  • What programs and processes are running?
  • Where is the data stored?
  • What ports are used?
  • What protocol is used for communications?
  • How is data backed up?

As secções seguintes fornecem respostas detalhadas a estas e outras perguntas, incluindo uma visão geral de alto nível da arquitetura e dos fluxos de dados.

Requisitos de Hardware

O Enterprise Server deve ser instalado num PC com um dos seguintes sistemas operativos oficialmente suportados:

  • Windows Server 2022 Standard Edition (64-bit)
  • Windows Server 2019 Standard Edition (64-bit)
  • Windows Server 2016 Standard Edition (64-bit)
  • O Enterprise Server não pode ser instalado num PC com um SO de 32 bits, nem com um SO de 64 bits que não suporte Windows Authentication (edições Core, Home, Starter e Base). Segue-se um resumo dos sistemas operativos suportados:
    • Officially Supported: Windows Server 2022 Standard Edition 64-bit (Recomendado), Windows Server 2019 Standard Edition 64-bit, Windows Server 2016 Standard Edition 64-bit (Mínimo).
    • Recommended only for Evaluation: Windows 10 64-bit, Windows 8.1 64-bit – versões Ultimate ou Professional para as variantes de SO não servidor.
  • O Enterprise Server depende de vários componentes de runtime da Microsoft para funcionar e ser acedido com sucesso; em algumas situações, estes poderão não estar presentes na máquina de destino. Se receber uma mensagem de erro sobre uma biblioteca em falta (DLL) ao tentar ligar-se a um Enterprise Server, isso indica que faltam componentes de runtime da Microsoft. Obtenha e instale o pacote Microsoft Visual C++ Redistributable adequado ao seu SO.

Requisitos do Altium Designer 

Certifique-se de que está a utilizar o Altium Designer 22.8.2 (build 66) ou posterior. Para aceder plenamente e tirar o máximo partido das funcionalidades e tecnologias continuamente desenvolvidas para, associadas a e instaladas com o Altium On-Prem Enterprise Server, aconselha-se a utilização da versão mais recente do Altium Designer.

Instalação e Outro Software

Devido ao comportamento imprevisível observado em software antivírus, recomenda-se desativar esse software durante a instalação do Enterprise Server.

Se o computador também estiver a executar o Microsoft Exchange Server, poderá receber um erro HTTP Error 503 na primeira tentativa de início de sessão. A instalação do Exchange Server pode alterar a configuração do Internet Information Services (IIS) de uma forma que entra em conflito com o Enterprise Server. Para resolver isto, têm de ser efetuadas as seguintes alterações ao ficheiro applicationHost.config:

<handlers accessPolicy="Read, Script">
...

<add name="kerbauth" image="C:\Program Files\Microsoft\Exchange Server\V15\Bin\kerbauth.dll" preCondition="bitness64" />
<add name="WSMan" image="C:\Windows\system32\wsmsvc.dll" preCondition="bitness64" />
<add name="exppw" image="C:\Program Files\Microsoft\Exchange Server\V15\ClientAccess\Owa\auth\exppw.dll" preCondition="bitness64" />
<add name="cafe_exppw" image="C:\Program Files\Microsoft\Exchange Server\V15\FrontEnd\HttpProxy\bin\exppw.dll" preCondition="bitness64" />

...
</handlers>

Para obter informações sobre o ficheiro ApplicationHost.config, consulte este artigo. Para obter informações sobre como editar o ficheiro, consulte este artigo.

Software Adicional Instalado ou Configurado

  • Internet Information Services (IIS). Para um funcionamento correto, o Enterprise Server requer, no mínimo, a versão 8.0 (IIS 8.0) instalada. A instalação do Enterprise Server irá simplesmente instalar a versão do IIS nativa do seu sistema operativo:
    • IIS 10.0 – Windows Server 2022 Standard Edition (64-bit), Windows Server 2019 Standard Edition (64-bit), Windows Server 2016 Standard Edition (64-bit), Windows 10 (64-bit)
    • IIS 8.5 – Windows 8.1 (64-bit)
  • Motor de base de dados Firebird 3.0 (quando é escolhida a opção de instalação com base de dados Firebird). Certifique-se de que o endereçamento de rede IPv4 está ativado – para verificar endereços IPv4 ativos, execute ipconfig /all numa linha de comandos.
  • .NET Framework 4.8 e .NET Core 3.1.2

Configuração do IIS

Como parte da configuração do IIS, a funcionalidade ISAPI Extensions é ativada. Esta funcionalidade pode ser encontrada na secção \Internet Information Services\World Wide Web Services\Application Development Features da caixa de diálogo Windows Features – acedida a partir da janela Programs and Features do Windows.

A instalação do Enterprise Server ativa a funcionalidade ISAPI Extensions do Windows, que faz parte da configuração do IIS.
A instalação do Enterprise Server ativa a funcionalidade ISAPI Extensions do Windows, que faz parte da configuração do IIS.

Caminhos de Instalação Predefinidos

Segue-se uma lista dos caminhos de instalação predefinidos ao instalar o Enterprise Server:

  • Enterprise Server Installation Folder – \Program Files (x86)\Altium\Altium365.
  • Firebird Installation Folder – \Program Files (x86)\Firebird\Firebird_3_0.
  • Firebird Database – \ProgramData\Altium\Altium365Data\DXPSERVER.DAT.
  • Revision Files Folder – \Altium\Altium365Data\Revisions. \ProgramData
  • Search Index Data Folder – \Altium\Altium365Data\SearchData. \ProgramData

Portas Predefinidas

Os seguintes números de porta de comunicação predefinidos são usados pelo Enterprise Server:

  • HTTP Port – 9780
  • HTTPS Port – 9785
  • LDAP Service Port – 9791
A porta do serviço LDAP não é, na realidade, utilizada. Para LDAP padrão (com URL 'ldap://'), é usada a porta desse URL. Para LDAP seguro (com URL 'ldaps://'), é usada a porta 636.
  • Websocket Port – 4649
  • Firebird Server Port – 3050
  • SVN Port – 3690

As três primeiras da lista podem ser configuradas durante a instalação inicial, na página Altium On-Prem Enterprise Server Configuration do instalador.

Se uma porta já estiver a ser utilizada, o instalador procurará a próxima disponível e usá-la-á em alternativa.

Ao escolher uma porta, note que esta não deve entrar em conflito com quaisquer portas utilizadas por outras aplicações – se uma porta estiver atualmente em uso, será notificado pelo instalador.

A HTTP Port é servida pelo IIS e utilizada pelas aplicações do Enterprise Server. É a porta principal e deve estar sempre aberta. A Firebird Server Port é utilizada para, e pelo, Firebird RDBMS. Por predefinição, está associada apenas a localhost. Não SHOULD NOT deve ser exposta externamente, por razões de segurança. Os utilizadores não interagem diretamente com esta porta. Ambas as portas fornecem interação HTTP normal (pedido/resposta). Ambas as portas podem ser personalizadas. A HTTP Port pode ser alterada durante a instalação. Embora a Firebird Server Port possa ser alterada manualmente, não é recomendável fazê-lo.
Relativamente à porta de comunicações HTTP, se tiver tecnologia Vault legada (Altium Personal Vault ou Altium Satellite Vault) em execução no mesmo PC, certifique-se de que as portas de comunicação são únicas. Um Altium Personal Vault legado utiliza a porta 9680, enquanto um Altium Satellite Vault legado utiliza a porta 9880. O Enterprise Server não pode ser instalado lado a lado com um Altium Vault legado (3.0 e anteriores), Altium Concord Pro, Altium NEXUS Server, ou um Altium Infrastructure Server (ou seja, no mesmo PC). No caso dos três primeiros, pode atualizar para o Enterprise Server (como se estivesse a atualizar para uma versão posterior dessa entidade).

► Veja informações sobre portas e endereços IP para software Altium Design.

Suporte do Protocolo HTTPS

Para quem necessita de uma camada adicional de segurança para trocar dados com o Enterprise Server, o Enterprise Server disponibiliza comunicação segura através de redes usando o protocolo HTTPS para proteger a privacidade e a integridade dos dados.

O número de porta utilizado para ligações seguras ao servidor é definido durante o processo de instalação, na página Altium On-Prem Enterprise Server Configuration do instalador. Utilize a porta predefinida (9785) ou introduza uma alternativa.

A configuração e as associações do servidor para o Enterprise Server podem ser acedidas no painel Internet Information Services (IIS) Manager do Windows – disponível na janela Administration Tools (Control Panel\System and Security\Administrative Tools). Selecione a entrada 'Altium On-Prem Enterprise Server' na lista Connections do painel e escolha o separador Features View.

Aceda às definições de configuração e associação do servidor para o Enterprise Server.
Aceda às definições de configuração e associação do servidor para o Enterprise Server.

As portas e os nomes de servidor disponíveis para o Enterprise Server são apresentados como hiperligações selecionáveis no painel Actions. Utilize as hiperligações para consultar e testar os protocolos de ligação ao servidor, ou aceda às associações atuais de nome/porta selecionando a hiperligação Bindings na secção Edit Site do painel.

Uma associação, incluindo o respetivo número de porta do protocolo, pode ser editada na caixa de diálogo Site Bindings através do botão Edit .

Configure as associações através da caixa de diálogo Site Bindings.
Configure as associações através da caixa de diálogo Site Bindings.

Tenha em atenção que o nome do servidor localhost só se aplica à máquina local, pelo que os PCs other do que aquele que aloja o Enterprise Server precisam de usar o nome real (do servidor) dessa máquina anfitriã para se ligarem.

Para confirmar o nome do PC anfitrião no qual o Enterprise Server está instalado e em execução, nessa máquina vá a Control Panel\System and Security\System e tome nota tanto do Computer name como do Full computer name (o seu nome de domínio qualificado) – este último será o utilizado pelo Enterprise Server para ligações seguras através da rede.

Para PCs que não fazem parte de um Domínio (configurados como PCs de Grupo de Trabalho padrão), o Computer name e o Full computer name serão iguais.

Se tiver editado as associações de site do Enterprise Server para utilizar um número de Porta diferente do valor predefinido, essa alteração terá também de ser refletida no ficheiro LocalVault.ini do Enterprise Server. Isto deve-se ao facto de as respetivas referências de porta serem acedidas quando são feitas ligações ao Enterprise Server pelo Altium Designer. O ficheiro LocalVault.ini pode ser encontrado na pasta raiz da instalação do Enterprise Server – tipicamente Program Files (x86)\Altium\Altium365.

Por exemplo, se tiver alterado a associação de site do Enterprise Server para utilizar a porta 443 padrão para ligações HTTPS, atualize a linha HttpsPort=9785 correspondente no ficheiro LocalVault.ini para HttpsPort=443.

Para estabelecer uma ligação segura ao Enterprise Server:

  • A partir do Altium Designer – utilize um endereço de servidor com o prefixo HTTPS e a porta HTTPS configurada. Por predefinição, isto é https://localhost:9785 ao utilizar o PC que aloja o Enterprise Server, ou https://<computername>:9785 para uma ligação remota (em que [computername] é o Nome do Computador da máquina anfitriã ou o nome de domínio qualificado).
O Altium Designer inclui o suporte de segurança necessário para aceitar uma ligação HTTPS ao Enterprise Server sem intervenção.
  • A partir de um navegador – introduza o endereço do serviço local (https://localhost:9785) ou o equivalente com o nome do computador anfitrião (https://<computername>:9785).
O Enterprise Server oferece atualmente um Certificado de Identidade autoassinado para ligações seguras, que pode optar por aceitar no seu navegador para prosseguir. Alguns navegadores (por exemplo, o Firefox) oferecem a opção de aceitar permanentemente o certificado, para que não sejam necessárias ações adicionais.

Ao reconfigurar as associações de site

Se tiver adicionado uma nova Associação de Site IIS para o Enterprise Server, ou editado uma entrada de Associação de Site existente (ver acima), o PC servidor deverá ser reiniciado para estabelecer corretamente a nova configuração. Alterações típicas de Associação de Site podem incluir a edição do número da Porta para uma entrada de anfitrião, ou a adição de uma nova associação para um alias de domínio.

Quando não for prático reiniciar a máquina anfitriã do servidor, o processo alternativo é reiniciar o serviço do servidor na plataforma IIS – Restart em Manage Website – e também reiniciar o serviço Altium DXP App Server Pinger (um serviço do Windows).

Execute o processo de arranque acima se receber uma mensagem de erro 'SignalR Hub "healthmonitorHub" not found!' ao tentar executar a funcionalidade Health Monitor do Enterprise Server.

Protocolo utilizado para comunicações Service-to-Service

SOAP sobre HTTP.

Arquitetura de Serviço – Visão geral

O Enterprise Server instala vários serviços principais, bem como consolas de gestão baseadas no navegador e um Explorer (também baseado no navegador). Para aceder a qualquer um destes serviços, a identidade de um utilizador tem de ser reconhecida e autenticada. O Enterprise Server é fornecido com um utilizador predefinido (Username: admin, Password: admin). A página Users da interface baseada no navegador do Workspace do Enterprise Server pode ser usada para adicionar e gerir mais utilizadores. Não existe limite para o número de utilizadores que podem ser registados para aceder e utilizar o Enterprise Server, mas existe um limite para ligações em simultâneo, conforme determinado e aplicado pelo licenciamento necessário.

O mesmo utilizador pode estar a aceder ao Enterprise Server em simultâneo de diferentes formas (por exemplo, ligado através do Altium Designer AND acedido através de um navegador externo) e isso conta apenas como uma única ligação do ponto de vista do licenciamento, quando o acesso é feito a partir do mesmo PC. Se o mesmo utilizador aceder ao Enterprise Server a partir de PCs diferentes, cada acesso a partir de um PC diferente exigirá uma ligação separada (ou seja, um posto adicional de uma Connector Access License).

O Altium Designer utiliza um canal não encriptado (SOAP sobre HTTP) para comunicar com os seguintes serviços:

  • Applications Registry Service (quando o Network Installation Service está a ser utilizado como origem para extensões/atualizações)
  • Collaboration Service
  • Comments Service
  • Data Acquisition Service
  • Data Storage Service (DSS)
  • Identity Service (IDS)
  • Notifications Service
  • Part Catalog Service
  • Projects Service
  • Simple Lock Service (SLS)
  • SVN (através do protocolo SVN://)
  • Tasks Service
  • Team Configuration Service (TC2)
  • Vault Service

Todos os outros serviços comunicam entre si.

A maioria dos serviços requer acesso à mesma base de dados do Enterprise Server, onde armazenam os dados que lhes são aplicáveis. Seguem-se alguns exemplos dos dados armazenados por alguns destes serviços:

  • Part Catalog Service – armazena itens de fornecedores e fabricantes, alterações no histórico de preço e quantidade, etc...
  • Identity Service – armazena utilizadores, funções, configuração de licenciamento e informação de sessão.
  • Vault Service – armazena a sua estrutura (pastas, itens, revisões, tipos de conteúdo, estados do ciclo de vida, etc...).

Os documentos reais são armazenados no sistema de ficheiros, na pasta Revisions (\Altium\Altium365Data\Revisions). \ProgramData

O Part Catalog Service também requer uma ligação direta (sem proxy) à Internet, para atualizações de preços em tempo real.

As seguintes aplicações baseadas no navegador utilizam a API SOAP para comunicar com os serviços aplicáveis – não requerem acesso à base de dados do Enterprise Server, nem quaisquer outros ficheiros para funcionarem:

  • User Management – a aplicação por trás da página Users e respetivas subpáginas na interface de navegador do Workspace do Enterprise Server.
  • Vault Explorer – a aplicação por trás da página Explorer da interface de navegador do Workspace do Enterprise Server.
  • Catalog Management – a aplicação por trás da página Part Providers da interface de navegador do Workspace do Enterprise Server.
  • Projects Management – a aplicação por trás da página Projects da interface de navegador do Workspace do Enterprise Server.
  • TC2 Console – a aplicação por trás da página Configurations da interface de navegador do Workspace do Enterprise Server.

Ficheiros de licença

Related page: Licenciamento

O licenciamento do Enterprise Server consiste essencialmente nos dois componentes seguintes, que em conjunto constituem um sistema de licenciamento em dois níveis:

  • Server License – esta licença disponibiliza à organização as funcionalidades e os serviços da instalação do Enterprise Server.
  • Client Access License – esta licença permite aos utilizadores de uma organização aceder ao Enterprise Server da organização.

O licenciamento do Enterprise Server pode ser tratado através da cloud, ou localmente através de ficheiros de licença (*.alf). A aquisição destes últimos é efetuada através do Company Dashboard (acedido utilizando a entrada Company Dashboard do menu da conta AltiumLive, no canto superior direito do site da Altium). No separador Licenses , localize a licença aplicável (no agrupamento de licenças Server Applications) e depois clique para abrir a página detalhada de gestão da licença. Aí, clique no botão Activate para gerar e transferir o ficheiro de licença associado.

O software verifica de hora a hora a presença de ficheiros de licença válidos. Sem uma Server License válida, não será possível aceder ao Enterprise Server. Se existir uma Server License válida, mas não existirem Client Access Licenses válidas (sem ligações disponíveis), é permitida uma única ligação administrativa para fins de cópia de segurança e configuração. Além disso, tanto as Server Licenses como as Client Access Licenses são licenças temporizadas. A subscrição tem de ser renovada para proporcionar acesso contínuo ao Enterprise Server aos utilizadores de uma organização, bem como para aceder a novas funcionalidades e capacidades desenvolvidas pela Altium como parte do Enterprise Server. Se essa renovação da subscrição expirar, será disponibilizada uma única licença Server e CAL para aceder aos seus dados para fins de cópia de segurança e configuração.

Cópia de segurança/Restauro de dados do servidor

A cópia de segurança e o restauro dos dados do seu Enterprise Server são efetuados a partir da linha de comandos, de forma automatizada, utilizando a ferramenta dedicada Backup & Restore Tool. Esta ferramenta – avbackup.exe – pode ser encontrada na pasta \Program Files (x86)\Altium\Altium365\Tools\BackupTool\ (para uma instalação predefinida do Enterprise Server).

  • Tem de executar a linha de comandos em modo de administrador para poder utilizar a ferramenta de Backup and Restore.
  • O restauro de uma cópia de segurança só é possível para a mesma versão do Enterprise Server a partir da qual essa cópia foi criada. Nesse sentido, pode ser uma boa ideia manter o instalador dessa versão do Enterprise Server e os ficheiros de licença correspondentes juntamente com o arquivo Zip da cópia de segurança.
Se estiver a atualizar o seu Enterprise Server para uma versão posterior, a cópia de segurança é tratada como parte do processo de instalação. No entanto, embora o instalador do Enterprise Server inclua uma cópia de segurança automatizada do seu Enterprise Server existente, é sempre boa prática fazer você mesmo uma cópia de segurança prévia dos seus dados – criando, por assim dizer, uma cópia redundante à parte. Isto proporciona segurança adicional, caso surjam dificuldades técnicas imprevistas. Adicionalmente, aconselha-se a testar uma nova versão do Enterprise Server numa máquina diferente, antes de atualizar a sua instância de produção. A utilização de Máquinas Virtuais pode ser inestimável neste aspeto.

Reindexação do Conteúdo do Servidor após Migração de Dados

Para reindexar o conteúdo do Enterprise Server, por exemplo, após uma migração de dados:

  1. Pare todos os conjuntos de aplicações IIS associados ao Enterprise Server.
  2. Pare o serviço Elasticsearch (AltiumElasticSearch). Isto é feito no painel Windows Services – acedido a partir da janela Administrative Tools do Windows.
  3. Elimine o conteúdo da pasta SearchData, que contém os dados de indexação de pesquisa ( \Altium\Altium365Data\SearchData para uma instalação predefinida). \ProgramData
  4. Reinicie o serviço Elasticsearch (AltiumElasticSearch).
  5. Reinicie os conjuntos de aplicações IIS associados ao Enterprise Server.

Ao detetar a pasta SearchData vazia, o Enterprise Server irá reindexar o respetivo conteúdo assim que for iniciado.

Repositório de Design SVN Local – Armazenamento

Um Design Repository criado através do serviço local de Controlo de Versões tem os seus dados internos armazenados numa subpasta correspondente na pasta \ProgramData\Altium\Altium365Data\Repository (numa instalação predefinida do Enterprise Server).

  • Uma nova instalação do Enterprise Server disponibiliza um único repositório de design baseado em Git para acolher todos os projetos de design do seu Workspace - e é só! Isto evita qualquer configuração e complexidade relacionadas com o serviço local de Controlo de Versões do Enterprise Server. Tem um único repositório de design - Versioned Storage - para todos os seus designers acederem e efetuarem releases. Como tal, a página VCS da interface do browser do Workspace do Enterprise Server torna-se meramente informativa - não é possível adicionar um novo repositório, e o único repositório Git não pode ser modificado de forma alguma, nem eliminado.
  • A pasta \ProgramData\Altium\Altium365Data\Repository não deve ser acedida de forma alguma, exceto por pessoal de TI para manutenção.

Utilizar Oracle para a Base de Dados do Enterprise Server

Related page: Enterprise Server com Backend Oracle

Ao instalar o Enterprise Server, o tipo de base de dados Oracle permite uma instalação simplificada do Enterprise Server em organizações que já utilizam este tipo de base de dados como backend para os seus sistemas existentes. Alojar o Enterprise Server na infraestrutura já existente reduz a complexidade da instalação e da gestão.

Quando se utiliza o Enterprise Server com Oracle como base de dados backend, o Enterprise Server suporta a versão Oracle 19c.

Colocar o Enterprise Server instalado e em funcionamento com Oracle como base de dados backend é, essencialmente, um processo em duas etapas:

  1. Configurar a base de dados Oracle
  2. Configurar o Enterprise Server.
Recomenda-se instalar o Enterprise Server numa máquina separada da própria base de dados Oracle. Além disso, certifique-se de que a máquina dedicada onde o Enterprise Server é instalado dispõe de amplo espaço de armazenamento e recursos computacionais.

Preparar o Enterprise Server

Para ser instalado e executado com sucesso, o Enterprise Server requer não só o cliente OCI, mas também conectores .Net relevantes. Recomenda-se instalar os componentes 32-bit Oracle Data Access Components (ODAC) with Oracle Developer Tools for Visual Studio adequados, em conformidade com a versão de Oracle que está a utilizar. Recomenda-se o download ODAC 12c Release 1 and Oracle Developer Tools for Visual Studio (12.1.0.1.0) como mínimo a instalar na máquina dedicada utilizada para alojar o Enterprise Server.

  • O Enterprise Server também requer a configuração de tnsnames.ora.
  • A estrutura da base de dados do Enterprise Server é criada e atualizada durante o processo de instalação, pelo que, se existirem políticas rigorosas para a execução de DDL do lado do DBA, a estrutura da base de dados pode ser criada num espaço ou servidor temporário, verificada e depois movida manualmente para o servidor de produção pretendido. Se isto for feito, o Enterprise Server terá de ser reconfigurado para utilizar esse servidor de produção.
O Backup & Restore tool do Enterprise Server não suporta cópias de segurança da base de dados quando se utiliza uma base de dados Oracle como backend. Assim, a cópia de segurança deve ser realizada em cooperação com o DBA Oracle. Para mais informações, consulte Backing up with an Oracle Backend.
AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
Conteúdo