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ę.
-
Zwróć uwagę, że Hybrid Agent nie not musi być uruchamiany na komputerze hostującym system PLM, chociaż taka konfiguracja nie powinna powodować problemów.
-
Aplikacja Hybrid Agent zawiera równoważne pliki skryptów powłoki (takie jak
agent.sh) dla systemów opartych na Linuksie – należy ich używać zamiast plików Windows *.bat w poniższych instrukcjach konfiguracji agenta.
Hybrid Agent wymaga środowiska Java Development Kit (JDK) w wersji 11 lub nowszej.
Installing JDK
Można użyć zarówno Oracle JDK, jak i OpenJDK. Upewnij się, że posiadasz ważną licencję, jeśli korzystasz z Oracle JDK.
Jeśli instalujesz JDK z prostego archiwum (zamiast z instalatora wykonywalnego), należy dodać jego zmienne środowiskowe ścieżki. W przypadku komputera/maszyny wirtualnej z systemem Windows są to zazwyczaj:
-
PATH – wskazuje na folder bin instalacji.
-
JAVA_HOME – wskazuje na sam folder instalacyjny.
Przetestuj dostęp do pliku wykonywalnego Java, uruchamiając polecenie Java -version.
Gdy aplikacja Hybrid Agent jest już na miejscu:
-
Wygeneruj klucz API na stronie Hybrid Agent w Workspace Altium 365 (
).
-
Utwórz zmienną środowiskową
HYBRID_AGENT_API_KEY, której wartością będzie klucz API.
-
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.
Zwróć uwagę, że Workspace może mieć tylko jeden ważny klucz API w danym momencie i może działać tylko jedna instancja Hybrid Agent. Agent będzie obsługiwał więcej niż jedną instancję konfiguracji PLM, jeśli oba systemy PLM są hostowane w tej samej zamkniętej sieci.
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:
-
Uruchom polecenie:
nssm install HybridAgent.
-
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.
-
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.
-
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.
-
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.
-
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.
-
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.
Bieżący klucz API można anulować za pomocą powiązanego z nim polecenia Revoke. W takim przypadku należy wygenerować nowy klucz API i zaktualizować zmienną środowiskową HYBRID_AGENT_API_KEY nową wartością klucza.
Uruchom ponownie Hybrid Agent, aby użyć nowego klucza – w NSSM użyj polecenia nssm restart HybridAgent albo zatrzymaj/uruchom usługę HybridAgent w narzędziu Services systemu Windows.
Tłumaczenie SI