하이브리드 에이전트 통합

개요

온프레미스 PLM 시스템을 인터넷에 노출하거나 인바운드 트래픽용 포트를 열지 않고도 Altium 365 워크스페이스에 연결할 수 있습니다. 이 문서에서는 Hybrid Agent가 아웃바운드 HTTPS를 통해 정보를 중계하는 방식을 설명하고, 에이전트를 Windows 서비스로 실행하는 방법을 비롯해 요구 사항, 설치 및 구성 과정을 안내합니다. 하이브리드 PLM 통합 설정을 위한 다음 단계를 알아보세요.

- Hybrid Agent의 라이선스, Java 및 네트워크 요구 사항을 확인하세요.
- API 키를 생성하고, 에이전트를 시작하고, 워크스페이스에서 PLM 연결을 구성하는 방법을 알아보세요.
- 에이전트를 Windows 서비스로 실행하고 새 API 키를 사용하도록 업데이트하는 방법을 확인하세요.
AI로 더 깊이 알아보기:

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

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

Note:

  • 하이브리드 통합을 사용하려면 특수 Altium 워크스페이스 라이선스가 필요합니다.

  • Siemens Teamcenter® PLM과의 통합(Hybrid Agent 필요)을 설정하는 경우, 먼저 Siemens Teamcenter 추가 설치 및 설정 페이지를 참조하세요.

하이브리드 통합 설정

에이전트 압축 파일()을 다운로드하고 찾기 쉬운 위치에 압축을 풉니다. 이 파일에는 회사 네트워크 내부의 컴퓨터에서 실행해야 하는 Java 애플리케이션(hybrid-agent.jar)이 포함되어 있습니다. 해당 컴퓨터에서 온프레미스 PLM 시스템과 Altium 365에 모두 접근할 수 있어야 합니다.

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

  • Hybrid Agent를 PLM 시스템이 호스팅되는 컴퓨터에서 실행할 not필요는 없습니다. 다만, 그렇게 구성해도 문제는 없습니다.
  • Hybrid Agent 애플리케이션에는 Linux 기반 시스템용으로 동일한 기능을 수행하는 셸 스크립트 파일(예: agent.sh)이 포함되어 있습니다. 아래 에이전트 설정 지침에서 Windows *.bat 파일 대신 이 파일을 사용하세요.

Hybrid Agent 버전 5 이하는 Java Development Kit(JDK) 버전 11 이상이 필요합니다. 버전 6(2026년 7월 6일 출시)부터는 Hybrid Agent에 JDK 버전 17 이상이 필요합니다.

Altium 365 워크스페이스는 Hybrid Agent 버전 5와 6을 모두 지원합니다. 따라서 Hybrid Agent 버전 5가 이미 설치되어 있다면 버전 6으로 업그레이드할 필요가 없습니다.

Hybrid Agent 애플리케이션이 준비되면 다음을 수행합니다.

  1. Altium 365 워크스페이스의 Hybrid Agent 페이지()에서 API 키를 생성합니다.
  2. API 키를 값으로 갖는 HYBRID_AGENT_API_KEY 환경 변수를 생성합니다.
  3. 다음 명령 형식으로 agent.bat을 실행합니다. URL 파라미터 인수에는 Altium 365 워크스페이스의 URL을 지정해야 합니다.
    agent.bat https://acme.365.altium.com

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

워크스페이스에는 한 번에 하나의 유효한 API 키만 존재할 수 있으며, Hybrid Agent도 하나의 인스턴스만 실행할 수 있습니다. 두 PLM 시스템이 동일한 폐쇄형 네트워크 내에서 호스팅되는 경우, 에이전트는 여러 PLM 구성 인스턴스를 지원합니다.

프로덕션 환경에서는 터미널에서 직접 실행하기보다 Hybrid Agent를 Windows 서비스로 실행하는 것을 적극 권장합니다. 다만, 테스트할 때는 터미널에서 직접 실행해도 됩니다.

NSSM 서비스 관리자를 사용하여 Hybrid Agent를 Windows 서비스로 실행하는 방법의 예는 다음과 같습니다.

  1. 다음 명령을 실행합니다. nssm install HybridAgent.
  2. NSSM 대화 상자의 Application 탭에서 Path 필드에 agent.bat 파일 경로를 입력하고 Arguments 필드에 워크스페이스 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 워크스페이스에 연결되면(브라우저 창을 새로 고쳐 상태 확인), Altium 365 워크스페이스에서 PLM 통합 설정을 진행할 수 있습니다. Add Configuration 페이지에서 Hybrid Agent 연결 옵션을 활성화하고, URL 필드에 폐쇄형 네트워크 내부에서 접근할 때 사용하는 온프레미스 PLM의 URL을 입력합니다.

 

현재 API 키는 연결된 Revoke 명령을 사용하여 취소할 수 있습니다. 이 경우 새 API 키를 생성하고 HYBRID_AGENT_API_KEY 환경 변수를 새 키 값으로 업데이트해야 합니다.

새 키를 사용하려면 Hybrid Agent를 다시 시작합니다. NSSM에서는 nssm restart HybridAgent 명령을 사용하거나, Windows Services에서 HybridAgent 서비스를 중지한 후 다시 시작합니다.

AI-LocalizedAI로 번역됨
만약 문제가 있으시다면, 텍스트/이미지를 선택하신 상태에서 Ctrl + Enter를 누르셔서 저희에게 피드백을 보내주세요.
Contents
기능 가용성

사용할 수 있는 기능은 보유한 Altium 솔루션(Altium Develop, Altium Agile Teams, Altium Agile Enterprise, 또는 Altium Designer(활성 기간 중))에 따라 달라집니다.

실제 소프트웨어에서 문서화된 기능이 보이지 않는 경우, Altium 영업팀에 문의하여 자세한 내용을 확인하세요.