Интеграция гибридного агента PLM с рабочим пространством Altium 365

Гибридная интеграция относится к ситуации, когда компания, использующая Altium 365, хочет интегрировать свое рабочее пространство с PLM-системой, которая размещена в локальной сети компании и не имеет публичного IP-адреса - она не подключена к Интернету.

Чтобы достичь этого, в сети компании запускается небольшая программа под названием Hybrid Agent запускается внутри сети компании. Эта программа взаимодействует с Altium 365, передавая информацию между рабочим пространством Altium 365 и PLM-системой внутри закрытой сети. Связь с Hybrid Agent осуществляется по протоколу HTTPS, и нет необходимости открывать какие-либо сетевые порты для входящего трафика из Интернета. Стандартный порт HTTPS 443 требуется только для исходящего трафика.

Настройка гибридной интеграции

Скачайте архив агента () и распакуйте его содержимое в известное место. Он содержит Java-приложение (hybrid-agent.jar), которое необходимо запустить на машине в сети компании, откуда доступны локальная PLM-система и Altium 365.

Эта машина not не должна быть общедоступной из Интернета, но должна иметь возможность подключения к среде Altium 365, которую использует ваша компания.

Как только приложение Hybrid Agent будет установлено:

1. Сгенерируйте ключ API на странице Altium 365 Workspace Hybrid Agent на странице Altium 365 Workspace ().
2. Создайте HYBRID_AGENT_API_KEY переменную окружения со значением ключа API.

3. Запустите agent.bat с помощью следующего командного контекста, где в качестве аргумента параметра URL должно быть указано рабочее пространство Altium 365:
   agent.bat https://acme.365.altium.com

Когда агент Hybrid Agent активен, он генерирует файл журнала в папке приложения hybrid-agent\logs папке.

Настоятельно рекомендуется запускать Hybrid Agent как службу Windows в производственной среде, а не непосредственно в терминале, хотя последний может использоваться для тестирования.

Пример запуска Hybrid Agent в качестве службы Windows с помощью менеджера служб NSSM:

1. Выполните команду: nssm install HybridAgent.
2. В диалоговом окне NSSM (на вкладке Application вкладка) введите agent.bat путь к файлу в поле Path и URL-адрес рабочей области в поле Arguments и нажмите кнопку Install service.
   1. Вы можете настроить поведение при запуске службы с помощью опции Startup type в диалоговом окне NSSM на вкладке Details вкладка. При необходимости запустите nssm edit HybridAgent для внесения таких изменений.
   2. В качестве альтернативы созданию стандартных PATH и JAVA_HOME переменных окружения для Java, их можно добавить на вкладке NSSM Environment вкладке. При таком подходе переменные будут активны только тогда, когда HybridAgent когда служба запущена.

   3. Как и в предыдущем случае, переменную HYBRID_AGENT_API_KEY также можно переместить в настройку окружения NSSM, чтобы она была активна, когда служба запущена.

3. Запустите HybridAgent запустите службу с помощью инструмента управления Windows Services или с помощью команды NSSM: nssm start HybridAgent. Этого не требуется (после перезагрузки компьютера), если служба настроена на автоматический запуск.
4. Убедитесь, что HybridAgent служба запущена в программе управления Windows Services или с помощью команды NSSM: nssm status HybridAgent.

После того как Hybrid Agent подключился к рабочей среде Altium 365 (обновите окно браузера, чтобы проверить его статус), можно приступать к настройке PLM-интеграции в рабочей среде Altium 365. На Add Configuration странице включите опцию Hybrid Agent опцию подключения и введите URL-адрес вашей локальной PLM, как видно в вашей закрытой сети, в поле URL поле.