Гибридная интеграция применяется в ситуации, когда компания, использующая Altium 365, хочет интегрировать свое Workspace с PLM-системой, размещенной локально, внутри корпоративной сети, которая не имеет публичного IP-адреса и не доступна из интернета.
Для этого внутри сети компании запускается небольшая программа под названием Hybrid Agent. Эта программа взаимодействует с Altium 365, передавая информацию между Workspace в Altium 365 и PLM-системой внутри закрытой сети. Связь с Hybrid Agent осуществляется по HTTPS, и нет необходимости открывать какие-либо сетевые порты для входящего трафика из интернета. Для исходящего трафика требуется только стандартный HTTPS-порт 443.
Настройка Hybrid Integration
Загрузите архив Agent (
) и распакуйте его содержимое в известное место. Он содержит Java-приложение (hybrid-agent.jar), которое необходимо запускать на компьютере внутри сети компании, откуда доступны как локальная PLM-система, так и Altium 365.
Этот компьютер not не обязан быть публично доступным из интернета, но должен иметь возможность подключаться к среде Altium 365, которую использует ваша компания.
-
Обратите внимание, что Hybrid Agent notне обязательно запускать на компьютере, на котором размещена PLM-система, хотя такая конфигурация не должна вызывать проблем.
-
Приложение Hybrid Agent включает эквивалентные файлы shell-скриптов (например,
agent.sh) для систем на базе Linux — используйте их вместо файлов Windows *.bat в приведенных ниже инструкциях по настройке агента.
Для Hybrid Agent требуется Java Development Kit (JDK) версии 11 или выше.
Installing JDK
Можно использовать либо Oracle JDK, либо OpenJDK. При использовании Oracle JDK убедитесь, что у вас есть действующая лицензия.
Если JDK устанавливается из обычного архива (а не с помощью исполняемого установщика), необходимо добавить переменные среды пути. На компьютере/виртуальной машине Windows это обычно:
-
PATH – указывает на папку bin установленного пакета.
-
JAVA_HOME – указывает на саму папку установки.
Проверьте доступ к исполняемому файлу Java, выполнив команду Java -version.
После размещения приложения Hybrid Agent:
-
Сгенерируйте API-ключ на странице Workspace в Altium 365 Hybrid Agent (
).
-
Создайте переменную среды
HYBRID_AGENT_API_KEY, присвоив ей в качестве значения API-ключ.
-
Запустите agent.bat в следующем контексте команды, где аргумент параметра URL должен соответствовать вашему Workspace в Altium 365:
agent.bat https://acme.365.altium.com
После запуска Hybrid Agent создаст файл журнала в папке hybrid-agent\logs приложения.
Обратите внимание, что в Workspace в любой момент времени может быть только один действующий API Key, и может работать только один экземпляр Hybrid Agent. Agent будет поддерживать более одной конфигурации PLM, если обе PLM-системы размещены в одной и той же закрытой сети.
В рабочей среде настоятельно рекомендуется запускать Hybrid Agent как службу Windows service, а не напрямую в терминале, хотя последний вариант можно использовать для тестирования.
Пример запуска Hybrid Agent как службы Windows с использованием диспетчера служб NSSM:
-
Выполните команду:
nssm install HybridAgent.
-
В диалоговом окне NSSM (на вкладке Application) укажите путь к файлу
agent.bat в поле Path, URL вашего Workspace — в поле Arguments, затем нажмите Install service.
-
Вы можете настроить поведение запуска службы с помощью параметра Startup type на вкладке Details диалогового окна NSSM. При необходимости выполните
nssm edit HybridAgent, чтобы внести такие изменения.
-
В качестве альтернативы созданию стандартных переменных среды
PATH и JAVA_HOME для Java их можно добавить на вкладке Environment в NSSM. При таком подходе переменные будут активны только во время работы службы HybridAgent.
-
Аналогично, переменную HYBRID_AGENT_API_KEY также можно перенести в настройки среды NSSM, чтобы она была активна во время работы службы.
-
Запустите службу
HybridAgent с помощью средства управления Services Windows или командой NSSM: nssm start HybridAgent. Это не требуется (после перезагрузки ПК), если для службы настроен автоматический запуск.
-
Убедитесь, что служба
HybridAgent запущена, с помощью средства управления Services Windows или команды NSSM: nssm status HybridAgent.
После того как Hybrid Agent подключится к вашему Workspace в Altium 365 (обновите окно браузера, чтобы проверить его состояние), можно переходить к настройке PLM Integration в Workspace Altium 365. На странице Add Configuration включите параметр подключения Hybrid Agent и введите URL вашей локальной PLM-системы, как он виден внутри вашей закрытой сети, в поле URL.
Текущий API Key можно отменить с помощью связанной с ним команды Revoke. В этом случае необходимо сгенерировать новый API Key и обновить переменную среды HYBRID_AGENT_API_KEY, указав новое значение ключа.
Перезапустите Hybrid Agent, чтобы использовать новый ключ: при использовании NSSM примените команду nssm restart HybridAgent либо остановите/запустите службу HybridAgent в средстве Services Windows.
Локализовано с помощью ИИ