Integração de Agente Híbrido

A Integração Híbrida aplica-se à situação em que uma empresa que utiliza Altium 365 pretende integrar o seu Workspace com um sistema PLM alojado on-premises, dentro da rede da empresa, que não tem um endereço IP público – ou seja, não está exposto à internet.

Para o conseguir, é executado dentro da rede da empresa um pequeno programa chamado Hybrid Agent. Este programa comunica com o Altium 365, retransmitindo informação entre o Workspace do Altium 365 e o sistema PLM dentro da rede fechada. A comunicação com o Hybrid Agent é feita através de HTTPS e não é necessário abrir quaisquer portas de rede para tráfego de entrada proveniente da internet. A porta HTTPS padrão 443 é necessária apenas para tráfego de saída.

Configurar a Integração Híbrida

Transfira o arquivo do Agent () e descompacte o seu conteúdo para uma localização conhecida. Contém uma aplicação Java (hybrid-agent.jar) que tem de ser executada numa máquina dentro da rede da empresa, a partir da qual o sistema PLM on-premises e o Altium 365 sejam acessíveis.

Essa máquina not não precisa de estar publicamente acessível a partir da internet, mas tem de ser capaz de estabelecer ligação ao ambiente Altium 365 que a sua empresa utiliza.

Quando a aplicação Hybrid Agent estiver instalada:

1. Gere a chave API na página Hybrid Agent do Workspace do Altium 365 ().
2. Crie uma variável de ambiente HYBRID_AGENT_API_KEY com a chave API como valor.

3. Execute agent.bat utilizando o seguinte contexto de comando, em que o argumento do parâmetro URL deve ser o do seu Workspace do Altium 365:
   agent.bat https://acme.365.altium.com

Quando estiver ativo, o Hybrid Agent irá gerar um ficheiro de registo na pasta hybrid-agent\logs da aplicação.

É altamente recomendável executar o Hybrid Agent como um serviço Windows no ambiente de produção, em vez de diretamente no terminal, embora esta última opção possa ser utilizada para testes.

Um exemplo de abordagem para executar o Hybrid Agent como um serviço Windows utilizando o gestor de serviços NSSM:

1. Execute o comando: nssm install HybridAgent.
2. Na janela de diálogo do NSSM (no separador Application), introduza o caminho do ficheiro agent.bat no campo Path e o URL do seu Workspace no campo Arguments, e clique em Install service.
   1. Pode definir o comportamento de arranque do serviço com a opção Startup type no separador Details da janela de diálogo do NSSM. Se necessário, execute nssm edit HybridAgent para efetuar essas alterações.
   2. Como alternativa à criação das variáveis de ambiente padrão PATH e JAVA_HOME para Java, estas podem ser adicionadas no separador Environment do NSSM. Com esta abordagem, as variáveis estarão ativas apenas quando o serviço HybridAgent estiver em execução.

   3. De forma semelhante ao acima descrito, a variável HYBRID_AGENT_API_KEY também pode ser movida para a configuração de ambiente do NSSM, para que fique ativa quando o serviço estiver em execução.

3. Inicie o serviço HybridAgent com a ferramenta de gestão Services do Windows, ou com o comando NSSM: nssm start HybridAgent. Isto não é necessário (após reiniciar o PC) se o serviço estiver configurado para arranque automático.
4. Certifique-se de que o serviço HybridAgent está em execução na ferramenta de gestão Services do Windows, ou com o comando NSSM: nssm status HybridAgent.

Assim que o Hybrid Agent se tiver ligado ao seu Workspace do Altium 365 (atualize a janela do navegador para verificar o estado), pode prosseguir para configurar a Integração PLM no Workspace do Altium 365. Na página Add Configuration, ative a opção de ligação Hybrid Agent e introduza o URL do seu PLM on-premises, tal como é visto dentro da sua rede fechada, no campo URL.