하이브리드 에이전트 통합

Hybrid Integration은 Altium 365를 사용하는 회사가 공개 IP 주소가 없고 인터넷에 노출되지 않은, 즉 회사 내부 네트워크의 온프레미스 환경에 호스팅된 PLM 시스템과 해당 Workspace를 통합하려는 경우에 적용됩니다.

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

Hybrid Integration 설정

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 service로 실행하는 것을 강력히 권장하지만, 테스트 목적으로는 후자도 사용할 수 있습니다.

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

1. 명령을 실행합니다: nssm install HybridAgent.
2. NSSM 대화상자 창(Application 탭 아래)에서 agent.bat 파일 경로를 Path 필드에 입력하고 Workspace URL을 Arguments 필드에 입력한 다음 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 필드에 입력합니다.