Integracja hybrydowa dotyczy sytuacji, w której firma korzystająca z Altium 365 chce zintegrować swój Workspace z systemem PLM, który jest hostowany lokalnie, wewnątrz sieci firmy, która nie ma publicznego adresu IP - nie jest narażona na działanie Internetu.
Aby osiągnąć ten cel, mały program o nazwie Hybrid Agent jest uruchamiany wewnątrz sieci firmy. Program ten komunikuje się z Altium 365, przekazując informacje pomiędzy Altium 365 Workspace i systemem PLM wewnątrz zamkniętej sieci. Komunikacja z Hybrid Agent odbywa się za pośrednictwem protokołu HTTPS i nie ma potrzeby otwierania żadnych portów sieciowych dla ruchu przychodzącego z Internetu. Standardowy port HTTPS 443 jest wymagany tylko 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óra musi być uruchomiona na komputerze wewnątrz sieci firmy, z którego można uzyskać dostęp do lokalnego systemu PLM i Altium 365.
Ta maszyna nie not musi być publicznie dostępna z Internetu, ale musi być w stanie połączyć się ze środowiskiem Altium 365, z którego korzysta Twoja firma.
-
Należy pamiętać, że Hybrid Agent nie not musi być uruchomiony na komputerze, który hostuje 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 systemie Linux - należy ich użyć zamiast plików *.bat dla systemu Windows w poniższych instrukcjach konfiguracji agenta.
Hybrid Agent wymaga Java Development Kit (JDK) w wersji 11 lub wyższej.
Click here to expand or collapse this section
Można użyć
Oracle JDK lub
OpenJDK. Upewnij się, że posiadasz ważną licencję podczas korzystania z Oracle JDK.
W przypadku instalacji JDK ze zwykłego archiwum (a nie pliku wykonywalnego instalatora) należy dodać zmienne środowiskowe ścieżki. W przypadku maszyn z systemem Windows są to zazwyczaj:
-
PATH - który wskazuje na folder bin instalacji.
-
JAVA_HOME - który wskazuje na sam folder instalacji.
Przetestuj dostęp do pliku wykonywalnego Java, uruchamiając polecenie Java -version.
Po uruchomieniu aplikacji Hybrid Agent:
-
Wygeneruj klucz API na stronie Altium 365 Workspace Hybrid Agent (
).
-
Utwórz zmienną środowiskową
HYBRID_AGENT_API_KEY z kluczem API jako wartością.
-
Uruchom agent.bat używając następującego kontekstu poleceń, gdzie parametr URL powinien być argumentem Altium 365 Workspace:
agent.bat https://acme.365.altium.com
Po uruchomieniu, Hybrid Agent wygeneruje plik dziennika w folderze hybrid-agent\logs aplikacji.
Należy pamiętać, że Workspace ma tylko jeden ważny klucz API w danym momencie i tylko jedna instancja Hybrid Agent może być uruchomiona. 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ż ten ostatni może być używany do testowania.
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 (w zakładce Application ) wprowadź ścieżkę pliku
agent.bat w polu Path i adres URL obszaru roboczego w polu Arguments, a następnie kliknij Install service.
-
Zachowanie podczas uruchamiania usługi można ustawić za pomocą opcji Startup type w zakładce Details okna dialogowego NSSM. W razie potrzeby należy uruchomić stronę
nssm edit HybridAgent, aby wprowadzić takie zmiany.
-
Alternatywnie do tworzenia standardowych zmiennych środowiskowych
PATH i JAVA_HOME dla Javy, można je dodać w zakładce NSSM Environment. Przy takim podejściu zmienne będą aktywne tylko wtedy, gdy uruchomiona jest usługa HybridAgent.
-
Podobnie jak powyżej, zmienną HYBRID_AGENT_API_KEY można również przenieść do konfiguracji środowiska NSSM, aby była aktywna, gdy usługa jest uruchomiona.
-
Uruchom usługę
HybridAgent za pomocą narzędzia do zarządzania Windows Services lub za pomocą polecenia 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 jest uruchomiona w narzędziu do zarządzania Windows Services lub za pomocą polecenia NSSM: nssm status HybridAgent.
Gdy Hybrid Agent połączy się z Altium 365 Workspace (odśwież okno przeglądarki, aby sprawdzić jego status), możesz przystąpić do konfiguracji integracji PLM w Altium 365 Workspace. Na stronie Add Configuration włącz opcję połączenia Hybrid Agent i wprowadź adres URL lokalnego PLM, widoczny w 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 o nową wartość klucza.
Uruchom ponownie Hybrid Agent, aby użyć nowego klucza - w NSSM użyj polecenia nssm restart HybridAgent lub zatrzymaj/uruchom usługę HybridAgent w systemie Windows Services.
AI-localized