Integracja agentów hybrydowych

Hybrid Integration ma zastosowanie w sytuacji, gdy firma korzystająca z Altium 365 chce zintegrować swój Workspace z systemem PLM hostowanym lokalnie, wewnątrz sieci firmowej, który nie ma publicznego adresu IP — nie jest wystawiony do internetu.

Aby to osiągnąć, wewnątrz sieci firmowej uruchamia się niewielki program o nazwie Hybrid Agent. Program ten komunikuje się z Altium 365, przekazując informacje między Workspace w Altium 365 a systemem PLM znajdującym się w zamkniętej sieci. Komunikacja z Hybrid Agent odbywa się przez HTTPS i nie ma potrzeby otwierania żadnych portów sieciowych dla ruchu przychodzącego z internetu. Wymagany jest wyłącznie standardowy port HTTPS 443 dla ruchu wychodzącego.

Konfiguracja Hybrid Integration

Pobierz archiwum Agent () i rozpakuj jego zawartość do znanej lokalizacji. Zawiera ono aplikację Java (hybrid-agent.jar), którą należy uruchomić na komputerze znajdującym się wewnątrz sieci firmowej, z którego dostępny jest zarówno lokalny system PLM, jak i Altium 365.

Ten komputer not nie musi być publicznie dostępny z internetu, ale musi mieć możliwość łączenia się ze środowiskiem Altium 365 używanym przez Twoją firmę.

Gdy aplikacja Hybrid Agent jest już na miejscu:

1. Wygeneruj klucz API na stronie Hybrid Agent Workspace w Altium 365 ().
2. Utwórz zmienną środowiskową HYBRID_AGENT_API_KEY, której wartością będzie klucz API.

3. Uruchom agent.bat, używając następującego kontekstu polecenia, gdzie argument parametru URL powinien być adresem URL Twojego Workspace w Altium 365:
   agent.bat https://acme.365.altium.com

Po uruchomieniu Hybrid Agent wygeneruje plik dziennika w folderze hybrid-agent\logs aplikacji.

Zdecydowanie zaleca się uruchamianie Hybrid Agent jako usługi Windows w środowisku produkcyjnym, a nie bezpośrednio w terminalu, chociaż to drugie rozwiązanie może być używane do testów.

Przykładowe podejście do uruchamiania Hybrid Agent jako usługi Windows przy użyciu menedżera usług NSSM:

1. Uruchom polecenie: nssm install HybridAgent.
2. W oknie dialogowym NSSM (na karcie Application) wprowadź ścieżkę do pliku agent.bat w polu Path oraz adres URL swojego Workspace w polu Arguments, a następnie kliknij Install service.
   1. Zachowanie uruchamiania usługi można ustawić za pomocą opcji Startup type na karcie Details w oknie dialogowym NSSM. W razie potrzeby uruchom nssm edit HybridAgent, aby wprowadzić takie zmiany.
   2. Alternatywnie, zamiast tworzyć standardowe zmienne środowiskowe PATH i JAVA_HOME dla Java, można dodać je na karcie Environment w NSSM. Przy takim podejściu zmienne będą aktywne tylko wtedy, gdy działa usługa HybridAgent.

   3. Podobnie jak powyżej, zmienną HYBRID_AGENT_API_KEY również można przenieść do konfiguracji środowiska NSSM, tak aby była aktywna podczas działania usługi.

3. Uruchom usługę HybridAgent za pomocą narzędzia do zarządzania Services w systemie Windows lub poleceniem NSSM: nssm start HybridAgent. Nie jest to wymagane (po ponownym uruchomieniu komputera), jeśli usługa jest ustawiona na automatyczne uruchamianie.
4. Upewnij się, że usługa HybridAgent jest uruchomiona w narzędziu do zarządzania Services systemu Windows lub za pomocą polecenia NSSM: nssm status HybridAgent.

Gdy Hybrid Agent połączy się z Twoim Workspace w Altium 365 (odśwież okno przeglądarki, aby sprawdzić jego status), możesz przejść do konfiguracji PLM Integration w Workspace w Altium 365. Na stronie Add Configuration włącz opcję połączenia Hybrid Agent i wpisz adres URL swojego lokalnego systemu PLM, widoczny w obrębie zamkniętej sieci, w polu URL.