상위 페이지: PLM 통합
하이브리드 통합은 회사가 Altium 365를 사용하여 자사의 워크스페이스를 공용 IP 주소가 없는 회사 네트워크 내부에 호스팅된 PLM 시스템과 통합하고자 할 때 적용됩니다. 즉, 인터넷에 노출되지 않습니다.
이를 달성하기 위해, 회사 네트워크 내부에서 하이브리드 에이전트라고 불리는 작은 프로그램이 실행됩니다. 이 프로그램은 Altium 365와 통신하여 Altium 365 워크스페이스와 폐쇄 네트워크 내부의 PLM 시스템 사이의 정보를 중계합니다. 하이브리드 에이전트와의 통신은 HTTPS를 통해 이루어지며, 인터넷에서 들어오는 트래픽을 위해 네트워크 포트를 열 필요가 없습니다. 오직 나가는 트래픽을 위해 표준 HTTPS 포트 443이 필요합니다.
하이브리드 통합 설정
하이브리드 에이전트 설치 패키지는 Altium 365 Workspace 하이브리드 에이전트 페이지에서 얻을 수 있으며, (관리자 – PLM 통합)의 상단에 있는 하이브리드 에이전트 탭 옵션을 통해 (새로운) PLM 관리 페이지에서 열 수 있습니다.
에이전트 아카이브(
)를 다운로드하고 알려진 위치에 압축을 풀어주세요. 이것은 회사 네트워크 내부에서 실행해야 하는 자바 애플리케이션(hybrid-agent.jar)을 포함하고 있으며, 여기서 온프레미스 PLM 시스템과 Altium 365에 접근할 수 있습니다.
그 기계는 인터넷에서 공개적으로 접근할 필요는 없지만, 귀사가 사용하는 Altium 365 환경에 연결할 수 있어야 합니다.
- 하이브리드 에이전트는 PLM 시스템을 호스팅하는 기계에서 실행할 필요가 없다는 점에 유의하십시오. 그러나 그러한 설정이 문제를 일으키지 않을 것입니다.
- 하이브리드 에이전트 애플리케이션에는 Linux 기반 시스템용으로 동등한 쉘 스크립트 파일(예:
agent.sh)이 포함되어 있으며, 아래 에이전트 설정 지침에서 Windows *.bat 파일 대신 사용하십시오.
하이브리드 에이전트는 Java 개발 키트(JDK) 버전 11 이상이 필요합니다.
JDK 설치하기
Oracle JDK 또는 OpenJDK를 사용할 수 있습니다. Oracle JDK를 사용할 때는 유효한 라이선스가 있는지 확인하세요.
설치 프로그램(실행 파일)이 아닌 일반 아카이브에서 JDK를 설치하는 경우, 해당 경로 환경 변수를 추가해야 합니다. Windows 기계/VM에서는 일반적으로 다음과 같습니다:
PATH – 설치된 bin 폴더를 가리킵니다.JAVA_HOME – 설치 폴더 자체를 가리킵니다.
Java 실행 파일에 대한 접근을 테스트하려면 Java -version 명령어를 실행하세요.
하이브리드 에이전트 애플리케이션이 설치되면:
1. Altium 365 작업 공간의
하이브리드 에이전트 페이지에서 API 키를 생성합니다
(
).
2. 생성된 API 키를 값으로 하는
HYBRID_AGENT_API_KEY 환경 변수를 생성합니다.
3. 다음 명령어 형식을 사용하여
agent.bat를 실행합니다. 여기서 URL 파라미터 인자는 여러분의 Altium 365 작업 공간의 URL이어야 합니다:
agent.bat https://acme.365.altium.com
활성화되면, 하이브리드 에이전트는 애플리케이션의 hybrid-agent\logs 폴더에 로그 파일을 생성합니다.
워크스페이스에는 언제든지 유효한 API 키가 하나만 있으며, 하이브리드 에이전트는 한 번에 하나의 인스턴스만 실행할 수 있습니다. 에이전트는 두 PLM 시스템이 동일한 폐쇄 네트워크 내에 호스팅되는 경우 두 개 이상의 PLM 구성 인스턴스를 지원할 수 있습니다.
생산 환경에서는 터미널에서 직접 실행하는 것보다 Windows 서비스로 하이브리드 에이전트를 실행하는 것이 매우 권장됩니다. 후자는 테스트용으로 사용할 수 있습니다.
하이브리드 에이전트를 Windows 서비스로 실행하는 예시 방법은 NSSM 서비스 매니저를 사용하는 것입니다:
- 명령어 실행:
nssm install HybridAgent.
- NSSM 대화 상자에서 (Application 탭 아래) Path 필드에
agent.bat 파일 경로를 입력하고 Arguments 필드에 작업 공간 URL을 입력한 후 Install service를 클릭합니다.
- NSSM 대화 상자의 Details 탭 아래 Startup type 옵션으로 서비스 시작 동작을 설정할 수 있습니다. 필요한 경우,
nssm edit HybridAgent를 실행하여 이러한 변경을 할 수 있습니다.
- Java에 대한 표준
PATH 및 JAVA_HOME 환경 변수를 생성하는 대신, NSSM Environment 탭 아래에 추가할 수 있습니다. 이 방법을 사용하면 변수들은 HybridAgent 서비스가 실행 중일 때만 활성화됩니다.
-
위와 유사하게, HYBRID_AGENT_API_KEY 변수도 서비스가 실행 중일 때 활성화되도록 NSSM 환경 설정으로 이동할 수 있습니다.
- Windows Services 관리 도구 또는 NSSM 명령어:
nssm start HybridAgent를 사용하여 HybridAgent 서비스를 시작합니다. 서비스가 자동 시작으로 설정된 경우 PC 재시작 후에는 이 작업이 필요하지 않습니다.
- Windows Services 관리 도구 또는 NSSM 명령어:
nssm status HybridAgent를 사용하여 HybridAgent 서비스가 실행 중인지 확인합니다.
하이브리드 에이전트가 Altium 365 작업 공간에 연결되면(브라우저 창을 새로고침하여 상태를 확인), Altium 365 작업 공간에서 PLM 통합을 구성할 수 있습니다. 구성 추가 페이지에서 하이브리드 에이전트 연결 옵션을 활성화하고 URL 필드에 닫힌 네트워크 내에서 볼 수 있는 온프레미스 PLM의 URL을 입력하세요.
이미지 설명이 제공되지 않았습니다.
현재 API 키는 관련된
Revoke 명령을 사용하여 취소할 수 있습니다. 그런 경우, 새 API 키를 생성하고
HYBRID_AGENT_API_KEY 환경 변수를 새 키 값으로 업데이트해야 합니다.
새 키를 사용하려면 Hybrid Agent를 재시작하세요. NSSM을 사용하는 경우
nssm restart HybridAgent 명령을 사용하거나, Windows
서비스에서
HybridAgent 서비스를 중지한 다음 시작하세요.
