Integracja agentów hybrydowych

Integracja hybrydowa 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 uruchamiany jest 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. Standardowy port HTTPS 443 jest wymagany wyłącznie dla ruchu wychodzącego.

Konfiguracja Integracji hybrydowej

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

Ten komputer nie not musi być publicznie dostępny z internetu, ale musi mieć możliwość połączenia 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 w Workspace 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ż ta druga metoda może być używana 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 je dodać 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, 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 działa w narzędziu do zarządzania Services w systemie 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 stan), możesz przejść do konfiguracji integracji PLM w Workspace Altium 365. Na stronie Add Configuration włącz opcję połączenia Hybrid Agent i wprowadź adres URL lokalnego systemu PLM, widoczny w Twojej zamkniętej sieci, w polu URL.