Integracja agenta hybrydowego
W skrócie
- Poznaj wymagania dotyczące licencji, środowiska Java i sieci dla Hybrid Agent.
- Dowiedz się, jak wygenerować klucz API, uruchomić agenta i skonfigurować połączenie z systemem PLM w swojej przestrzeni roboczej.
- Znajdź wskazówki dotyczące uruchamiania agenta jako usługi systemu Windows i aktualizowania jego konfiguracji w celu użycia nowego klucza API.
Integracja hybrydowa ma zastosowanie, gdy firma korzystająca z Altium 365 chce zintegrować swoją przestrzeń roboczą z systemem PLM hostowanym lokalnie, w sieci firmowej, który nie ma publicznego adresu IP — nie jest dostępny z internetu.
W tym celu wewnątrz sieci firmowej uruchamiany jest niewielki program o nazwie Hybrid Agent. Program ten komunikuje się z Altium 365, pośrednicząc w wymianie informacji między przestrzenią roboczą Altium 365 a systemem PLM w zamkniętej sieci. Komunikacja z Hybrid Agent odbywa się przez HTTPS i nie wymaga 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 agenta i rozpakuj jego zawartość do znanej lokalizacji. Zawiera ono aplikację Java (hybrid-agent.jar), którą należy uruchomić na komputerze w sieci firmowej, mającym dostęp do lokalnego systemu PLM i Altium 365.
Ten komputer nie musi not być publicznie dostępny z internetu, ale musi mieć możliwość łączenia się ze środowiskiem Altium 365 używanym przez firmę.
Gdy aplikacja Hybrid Agent jest już gotowa:
- Wygeneruj klucz API na stronie Hybrid Agent przestrzeni roboczej Altium 365
-
Utwórz zmienną środowiskową
HYBRID_AGENT_API_KEYi przypisz jej klucz API jako wartość. -
Uruchom
agent.bat, korzystając z poniższej składni polecenia, w której argument parametru URL powinien wskazywać Twoją przestrzeń roboczą Altium 365:
agent.bat https://acme.365.altium.com
Podczas działania Hybrid Agent generuje plik dziennika w folderze hybrid-agent\logs aplikacji.
W środowisku produkcyjnym zdecydowanie zaleca się uruchamianie Hybrid Agent jako usługi systemu Windows, a nie bezpośrednio w terminalu, choć ten drugi sposób można wykorzystać do testów.
Przykładowy sposób uruchamiania Hybrid Agent jako usługi systemu 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.batw polu Path i adres URL swojej przestrzeni roboczej w polu Arguments, a następnie kliknij Install service.-
Sposób uruchamiania usługi możesz ustawić za pomocą opcji Startup type na karcie Details okna dialogowego NSSM. W razie potrzeby uruchom
nssm edit HybridAgent, aby wprowadzić takie zmiany. -
Zamiast tworzyć standardowe zmienne środowiskowe
PATHiJAVA_HOMEdla Java, można dodać je na karcie Environment w NSSM. W takim przypadku zmienne będą aktywne tylko wtedy, gdy uruchomiona jest usługaHybridAgent. -
Podobnie jak powyżej, zmienną
HYBRID_AGENT_API_KEYrównież można przenieść do konfiguracji środowiska NSSM, aby była aktywna podczas działania usługi.
-
Sposób uruchamiania usługi możesz ustawić za pomocą opcji Startup type na karcie Details okna dialogowego NSSM. W razie potrzeby uruchom
-
Uruchom usługę
HybridAgentza pomocą narzędzia administracyjnego Services systemu Windows lub polecenia NSSM:nssm start HybridAgent. Nie jest to wymagane (po ponownym uruchomieniu komputera), jeśli usługa ma ustawione automatyczne uruchamianie. -
Upewnij się, że usługa
HybridAgentjest uruchomiona, korzystając z narzędzia administracyjnego Services systemu Windows lub polecenia NSSM:nssm status HybridAgent.
Gdy Hybrid Agent połączy się z Twoją przestrzenią roboczą Altium 365 (odśwież okno przeglądarki, aby sprawdzić jego stan), możesz przejść do konfiguracji integracji PLM w przestrzeni roboczej Altium 365. Na stronie Add Configuration włącz opcję połączenia Hybrid Agent i w polu URL wprowadź adres URL lokalnego systemu PLM, pod którym jest on dostępny w zamkniętej sieci.



