하이브리드 에이전트 통합

하이브리드 통합(Hybrid Integration)은 Altium 365를 사용하는 회사가 자사의 네트워크 내부, 즉 온프레미스에 호스팅되어 있으며 공인 IP 주소가 없어 인터넷에 노출되지 않은 PLM 시스템과 Workspace를 통합하려는 경우에 적용됩니다.

이를 구현하기 위해 Hybrid Agent라는 작은 프로그램을 회사 네트워크 내부에서 실행합니다. 이 프로그램은 Altium 365와 통신하며, Altium 365 Workspace와 폐쇄형 네트워크 내부의 PLM 시스템 간 정보를 중계합니다. Hybrid Agent와의 통신은 HTTPS를 통해 이루어지며, 인터넷으로부터의 인바운드 트래픽을 위해 네트워크 포트를 열 필요가 없습니다. 표준 HTTPS 포트 443은 아웃바운드 트래픽에만 필요합니다.

하이브리드 통합 설정

Agent 아카이브()를 다운로드한 후 내용을 잘 알려진 위치에 압축 해제합니다. 여기에는 회사 네트워크 내부의 컴퓨터에서 실행해야 하는 Java 애플리케이션(hybrid-agent.jar)이 포함되어 있으며, 해당 컴퓨터에서는 온프레미스 PLM 시스템과 Altium 365 모두에 연결할 수 있어야 합니다.

해당 컴퓨터는 인터넷에서 not 공개적으로 접근 가능할 필요는 없지만, 회사에서 사용하는 Altium 365 환경에는 연결할 수 있어야 합니다.

Hybrid Agent 애플리케이션이 준비되면:

1. Altium 365 Workspace의 Hybrid Agent 페이지()에서 API 키를 생성합니다.
2. API 키 값을 갖는 HYBRID_AGENT_API_KEY 환경 변수를 생성합니다.

3. 다음 명령 컨텍스트를 사용하여 agent.bat를 실행합니다. 여기서 URL 매개변수 인수는 사용 중인 Altium 365 Workspace의 URL이어야 합니다:
   agent.bat https://acme.365.altium.com

활성화되면 Hybrid Agent는 애플리케이션의 hybrid-agent\logs 폴더에 로그 파일을 생성합니다.

운영 환경에서는 Hybrid Agent를 터미널에서 직접 실행하기보다 Windows 서비스로 실행하는 것을 강력히 권장합니다. 다만 후자의 방식은 테스트 용도로 사용할 수 있습니다.

NSSM 서비스 관리자를 사용하여 Hybrid Agent를 Windows 서비스로 실행하는 예시 방법:

1. 다음 명령을 실행합니다: nssm install HybridAgent.
2. NSSM 대화 상자 창(Application 탭 아래)에서 agent.bat 필드에 agent.bat 파일 경로를 입력하고, Arguments 필드에 Workspace URL을 입력한 다음 Install service를 클릭합니다.
   1. NSSM 대화 상자의 Details 탭에 있는 Startup type 옵션으로 서비스 시작 동작을 설정할 수 있습니다. 이러한 변경이 필요하면 nssm edit HybridAgent를 실행하십시오.
   2. Java용 표준 PATH 및 JAVA_HOME 환경 변수를 생성하는 대신, NSSM의 Environment 탭에서 추가할 수도 있습니다. 이 방식에서는 HybridAgent 서비스가 실행 중일 때만 해당 변수들이 활성화됩니다.

   3. 위와 마찬가지로 HYBRID_AGENT_API_KEY 변수도 NSSM 환경 설정으로 옮길 수 있으며, 그러면 서비스가 실행 중일 때 활성화됩니다.

3. Windows Services 관리 도구 또는 NSSM 명령 nssm start HybridAgent를 사용하여 HybridAgent 서비스를 시작합니다. 서비스가 자동 시작으로 설정되어 있다면(PC 재시작 후에는) 이 작업이 필요하지 않습니다.
4. Windows Services 관리 도구 또는 NSSM 명령 nssm status HybridAgent를 사용하여 HybridAgent 서비스가 실행 중인지 확인합니다.

Hybrid Agent가 Altium 365 Workspace에 연결되면(상태를 확인하려면 브라우저 창을 새로 고침), Altium 365 Workspace에서 PLM Integration 구성을 계속 진행할 수 있습니다. Add Configuration 페이지에서 Hybrid Agent 연결 옵션을 활성화하고, 폐쇄형 네트워크 내부에서 보이는 온프레미스 PLM의 URL을 URL 필드에 입력합니다.