Windchill AI Assistant 플러그 인 구성
이 항목은 Windchill 시스템 관리자를 대상으로 합니다.
Windchill AI Assistant 플러그 인을 설치한 후 온프레미스 환경에 대한 Azure 리소스를 생성하는 경우, 배포 도우미 스크립트로 생성된 구성 출력을 사용하여 플러그 인을 구성해야 합니다.
자세한 내용은 배포 도우미 스크립트의 구성 출력 섹션을 참조하십시오.
절차
Windchill AI Assistant 플러그 인을 구성하려면 다음 단계를 따르십시오.
1. > > 으로 이동합니다.
2. Windchill AI Assistant 플러그 인을 마우스 오른쪽 버튼으로 클릭하고 플러그 인 구성을 선택합니다.
Windchill AI Assistant - 구성 창이 열립니다.
3. Windchill AI Assistant 구성 창에 필요한 세부 정보를 입력합니다.
a. Azure AI 검색 섹션에서 편집을 클릭하고 다음 세부 정보를 지정합니다.
i. 엔드포인트 - 배포 도우미 스크립트 출력의 Azure AI 검색 엔드포인트를 입력합니다.
ii. 인덱스 이름 - 배포 도우미 스크립트 출력의 인덱스 이름을 입력합니다.
iii. 인증 모드 - 목록에서 서비스 사용자를 선택한 다음 배포 도우미 스크립트 출력의 테넌트 ID, 클라이언트 ID 및 클라이언트 암호를 입력합니다.
iv. 저장을 클릭하여 구성을 적용합니다.
b. Azure OpenAI 섹션에서 편집을 클릭하고 다음 세부 정보를 지정합니다.
i. 엔드포인트 - 배포 도우미 스크립트 출력의 Azure OpenAI 엔드포인트를 입력합니다.
ii. 배포 - 배포 도우미 스크립트 출력의 배포 이름을 입력합니다.
iii. 인증 모드 - 목록에서 서비스 사용자를 선택한 다음 배포 도우미 스크립트 출력의 테넌트 ID, 클라이언트 ID 및 클라이언트 암호를 입력합니다.
iv. 저장을 클릭하여 구성을 적용합니다.
c. Azure Storage 섹션에서 편집을 클릭하고 다음 세부 정보를 지정합니다.
i. 계정 이름 - 배포 도우미 스크립트 출력의 Azure Storage 계정 이름을 입력합니다.
ii. 컨테이너 이름 - 배포 도우미 스크립트 출력의 스토리지 컨테이너 이름을 입력합니다.
iii. 인증 모드 - 목록에서 서비스 사용자를 선택한 다음 배포 도우미 스크립트 출력의 테넌트 ID, 클라이언트 ID 및 클라이언트 암호를 입력합니다.
iv. 저장을 클릭하여 구성을 적용합니다.
4. Windchill AI Assistant 구성 창을 닫습니다.
구성 후 상태 표시기를 확인합니다. 표시기가 정상 상태가 아닌 경우 온프레미스 환경 문제 해결을 참조하십시오.
플러그 인 인증서 교체
이 항목에서는 Windchill 플러그 인에서 사용하는 자체 서명된 인증서를 관리하기 위한 전략에 대해 설명합니다. AI 플러그 인은 보안 통신을 위해 자체 서명된 인증서에 의존합니다. 여기서는 보안 통신을 보장하기 위한 인증서 생성, 검증, 교체뿐만 아니라, Windchill 및 Apache 구성 요소와의 통합 방법까지 다룹니다. 인증서 교체 작업은 이러한 자체 서명된 인증서를 관리하는 데 사용됩니다.
인증서 교체 프로세스를 시작하려면 Windchill 플러그 인 페이지에서 > 를 클릭합니다. 이 작업을 수행하면 다음과 같은 교체 프로세스가 수행됩니다.
1. 새 인증서가 같은 이름으로 생성됩니다.
◦ certificate.crt(공용 키)
◦ privateKey.pem(개인 키)
2. 이전 인증서는 다음과 같이 이름이 바뀝니다.
◦ certificate_rotated.crt
◦ privateKey_old.pem
3. 새 공개 키가 Apache 인증서 파일에 추가됩니다.
 | 플러그 인 폴더와 Apache 인증서 파일 모두에 이전 인증서를 그대로 유지하십시오. 인증서 교체 후 Apache 및 Windchill 서비스를 다시 시작합니다. |
인증 교체 작업 사용
플러그 인 인증서 교체는 Windchill 온프레미스 환경에만 적용되므로 인증서 교체 작업은 Windchill 플러그 인 페이지에서만 사용할 수 있습니다.
Windchill 온프레미스의 클러스터 환경에서 임의의 노드에 이 작업을 실행하면 모든 노드에서 인증서가 교체됩니다.
노드 중 하나가 다운되고 다른 노드에서 인증서가 교체되는 경우, 노드를 재시작하기 전에 현재 활성 노드에서 이전에 다운된 노드로 allClientCerts.crt 파일을 수동으로 복사해야 합니다.
예를 들어, 노드 1이 작동 중이고 노드 2가 다운되었으며 인증서가 노드 1에서 교체되는 경우 노드 2를 시작하기 전에 allClientCerts.crt 파일을 노드 1에서 노드 2로 수동으로 복사합니다. 이 파일을 복사하면 노드 2를 시작합니다.
| | 인증서 교체 작업을 수행한 후 AllClientsCerts 파일을 로컬 Apache 폴더에서 분할형 웹 서버의 원격 Apache 폴더로 복사합니다. 이 단계는 위에 언급된 배포 시나리오에서 Windchill AI Assistant 플러그 인을 구성한 후 완료해야 합니다. |
자체 서명된 인증서 관리
다음은 자체 서명된 인증서를 관리하고 인증서 교체 후 정상적인 기능을 유지하기 위해 고려해야 할 주요 사항들입니다.
• 인증서 교체 후 Apache 및 Windchill 서비스를 수동으로 다시 시작해야 합니다.
• 자체 서명된 인증서의 유효 기간은 6개월입니다.
• 플러그 인 폴더와 Apache 인증서 파일 모두에 이전 인증서를 그대로 유지하십시오.
• 이전 인증서 교체 이후 최소 1시간이 경과하지 않으면 인증서 교체가 이루어질 수 없습니다.
• 플러그 인에 대한 인증서 교체에 실패할 경우 메서드 서버 로그에 해당 플러그 인 ID가 표시됩니다.
• 인증서 교체 후 Apache 및 Windchill을 다시 시작하지 않을 경우 플러그 인이 오래된 인증서를 사용할 수 있습니다.
Windchill 배포 시나리오에서 플러그 인 구성
이 항목은 Windchill 시스템 관리자를 대상으로 합니다.
이 섹션에서는 웹 서버 설정, 역방향 프록시 구성 등 다양한 Windchill 배포 시나리오에서 Windchill AI Assistant 플러그 인을 구성하기 위한 자세한 지침을 제공합니다.
분할형 웹 서버 구성
분할형 웹 서버 구성을 사용하는 Windchill에서 AI Assistant 플러그 인을 구성하려면 다음 단계를 따르십시오.
1. 원격 Apache 및 Windchill에 SSL이 구성되어 있는지 확인합니다.
2. > 페이지에서 필요한 플러그 인을 설치합니다.
3. 원격 Apache를 다시 시작합니다(Windows의 경우에만 해당).
4. 로컬 Apache 폴더로 이동합니다.
HTTPServer_HOME\conf\sslvhostconf.d
5. 다음 파일을 복사합니다.
◦ allClientCerts.crt
◦ pluginClients.conf
6. 원격 Apache의 다음 위치에 이 파일들을 붙여넣습니다.
HTTPServer_HOME\conf\sslvhostconf.d
| | 인증서 교체 작업을 수행한 후 원격 Apache 서버에서 allClientCerts.crt 파일을 바꾸고 원격 Apache 서비스와 Windchill 서버를 둘 다 다시 시작합니다. 인증서 교체 프로세스에 대한 자세한 내용은 이 항목의 "플러그 인 인증서 교체" 섹션을 참조하십시오. |
7. pluginClients 파일을 편집하여 allClientCerts.crt에 대한 경로를 업데이트합니다.
8. WindchillAIAssistant-proxy.conf 파일을 플러그 인 설치 디렉터리에서 복사한 후 원격 Apache의 HTTPServer_HOME\conf\conf.d에 붙여넣습니다.
9. WindchillAIAssistant-proxy.conf 파일을 열고 balancemember localhost를 Windchill 호스트 이름으로 바꾼 다음 저장합니다.
<Proxy balancer://WindchillAIAssistant_lb/>
BalancerMember http://localhost:9090/Windchill/WCPlugins/wcaiassistant route=WindchillAIAssistant1
ProxySet stickysession=WindchillAIAssistant_sticky
</Proxy>
BalancerMember http://localhost:9090/Windchill/WCPlugins/wcaiassistant route=WindchillAIAssistant1
ProxySet stickysession=WindchillAIAssistant_sticky
</Proxy>
10. 분할형 웹 서버 또는 원격 Apache를 다시 시작합니다.
11. > 페이지로 이동하여 플러그 인을 구성합니다. 구성이 성공적으로 완료되었는지 확인합니다.
역방향 프록시 구성
역방향 프록시 구성을 사용하는 Windchill에서 AI Assistant 플러그 인을 구성하려면 다음 단계를 따르십시오.
1. 모든 관련 Apache 서버와 Windchill에 SSL이 구성되어 있는지 확인합니다.
| | 원활한 통신을 위해 역방향 프록시 IP 주소와 해당 공개 DNS 호스트 이름을 Windchill 노드의 hosts 파일에 추가합니다. • Linux: /etc/hosts 또는 • Windows: C:\Windows\System32\drivers\etc\hosts |
2. > 페이지에서 필요한 플러그 인을 설치합니다.
3. Apache를 다시 시작합니다(Windows만 해당, Linux의 경우 필요 없음).
4. %APACHE_HOME%/conf/conf.d에 있는 로컬 Apache에서 20-mod_ssl.conf 파일을 열고, %APACHE_HOME%/conf.에 있는 httpd.conf 파일을 엽니다.
5. 문자열: RewriteCond %{HTTP_HOST}를 검색합니다. 이 문자열이 있으면 5a 및 5b 단계로 진행합니다. 이 문자열이 없으면 5a부터 5c까지의 단계를 생략하고 6단계로 바로 진행합니다.
a. 이 조건에 역방향 프록시 시스템의 호스트 이름을 추가합니다.
RewriteCond %{HTTP_HOST} !^(<reverse_proxy_hostname>|<local_Apache>):<port>$ [NC]
예:
▪ 변경 전: RewriteCond %{HTTP_HOST} !^XYZ.localapache.example.com:22444$ [NC]
▪ 변경 후: RewriteCond %{HTTP_HOST} !^(XYZ.proxy.example.com|ABC.localapache.example.com):22444$ [NC]
| | 로컬 Apache와 역방향 프록시 Apache가 동일한 포트를 사용하도록 구성되었는지 확인합니다. |
b. 20-mod_ssl.conf 및 httpd.conf 파일을 저장합니다.
c. 로컬 Apache를 다시 시작합니다.
6. > 페이지로 이동하여 플러그 인을 구성합니다. 구성이 성공적으로 완료되었는지 확인합니다.