Windchill 온프레미스 환경에서 AI Parts Rationalization 플러그 인 설치 및 구성

AI Parts Rationalization 플러그 인 > Windchill 온프레미스 환경에서 AI Parts Rationalization 플러그 인 설치 및 구성

이 항목은 Windchill 온프레미스 시스템 관리자를 대상으로 합니다.

플러그 인은 Windchill과 함께 추가 컴포넌트로 설치할 수 있습니다. 플러그 인의 배포 및 업데이트는 Windchill에 있는 플러그 인 관리자를 통해 관리됩니다.

AI Parts Rationalization 플러그 인은 AI Parts Rationalization 플러그 인 소개 항목의 지원되는 Windchill 릴리스 섹션에 나열된 Windchill 버전과 호환됩니다.

플러그 인은 느슨하게 연결된 방식으로 Windchill과 통합됩니다. 즉, Windchill의 핵심 기능에 영향을 주지 않고 독립적으로 플러그 인을 업데이트하고 유지 관리할 수 있습니다.

인증

플러그 인은 사이트 관리자가 PTC SaaS Platform 인증에 따라 사용할 수 있도록 설계되어 있습니다. Windchill 플러그 인을 보려면 Windchill 사이트 관리자여야 하며 Windchill 제품에 액세스할 수 있는 PTC SaaS Platform 계정이 있어야 합니다. PTC SaaS Platform 인증을 위해 다음 단계를 따르십시오.

1. Windchill 계정에 사이트 관리자로 로그인합니다.

2. 탐색기 사이트로 이동하고 플러그 인 관리자를 클릭합니다.

3. PTC SaaS Platform 계정 자격 증명을 입력합니다. 세션당 한 번만 PTC SaaS Platform 자격 증명을 제공하면 됩니다. 그 후에는 다시 인증하지 않고 플러그 인 관리자를 계속 사용할 수 있습니다. 그러나 세션이 만료되면 재인증이 필요합니다.

확인 대화 상자에서:

◦ 아니요를 클릭하면 새로 사용 가능한 플러그 인 또는 업데이트된 플러그 인 목록을 볼 수 없으며 설치된 플러그 인 목록과 이전 버전이 계속 표시됩니다.

◦ 예를 클릭하면 PTC SaaS Platform 자격 증명을 제공하여 계속 진행해야 합니다. 인증하면 새로 나열된 플러그 인과 기존 플러그 인의 업데이트된 버전을 볼 수 있습니다.

이러한 자격 증명은 Windchill 사이트 관리자가 PTC SaaS Platform 2단계로 온보딩하는 동안 제공되었습니다. 자세한 내용은 AI 플러그 인 설치를 위해 Windchill 사이트 관리자 초대 섹션의 참고를 참조하십시오.

PTC SaaS Platform 자격 증명으로 로그인한 후 사용 가능한 플러그 인 목록을 볼 수 있습니다.

AI Parts Rationalization 플러그 인 설치

플러그 인 관리자를 사용하면 사용 가능한 AI Parts Rationalization 플러그 인을 설치하고 구성할 수 있습니다.

플러그 인 관리자를 클릭하면 Windchill 플러그 인 페이지에 PTC SaaS Platform 저장소에서 사용 가능한 플러그 인의 최신 버전이 테이블 형식으로 나열됩니다. 테이블의 행에는 이름, 버전 및 상태(설치됨 또는 설치 안 됨)가 표시됩니다.

필드	설명
플러그 인 이름	플러그 인의 이름을 나타냅니다.
설치된 버전	플러그 인의 설치된 버전을 나타냅니다. 플러그 인이 설치되지 않은 경우 이 필드는 비어 있습니다.
최신 버전	설치할 수 있는 플러그 인 최신 버전을 나열합니다.
설명	사용 가능한 플러그 인에 대해 간략하게 설명합니다.
최종 수정 날짜	플러그 인이 최종 수정 날짜를 나타냅니다.
플러그 인 상태	플러그 인 설치 여부를 나타냅니다.
플러그 인 서버	플러그 인 서버의 상태(작동 중 및 실행 중 또는 다운됨)를 나타냅니다. 플러그 인이 설치되지 않은 경우 이 필드는 비어 있습니다.

플러그 인을 설치하려면 다음 단계를 따르십시오.

1. 플러그 인을 마우스 오른쪽 버튼으로 클릭한 다음 상황에 맞는 메뉴에서 설치를 선택합니다.

2. 플러그 인 설치 대화 상자에 다음 정보를 입력합니다. 설치 후 Windchill Server Manager가 새 플러그 인 서버 프로세스를 시작합니다.

◦ 시작할 인스턴스 수: 플러그 인 인스턴스 수입니다. 시작할 플러그 인 인스턴스의 수는 사용 가능한 최대 플러그 인 인스턴스 수보다 클 수 없습니다.

설치하는 동안 여러 개의 플러그 인 인스턴스를 추가할 수 있습니다. 하지만 플러그 인 구성이 완료된 후에는 인스턴스 수를 변경할 수 없습니다. 플러그 인 인스턴스의 수를 수정하려면, 플러그 인을 제거했다가 다시 설치하고 인스턴스 수를 업데이트한 다음 플러그 인을 재구성해야 합니다.

◦ 최대 인스턴스 수: 구성할 수 있는 플러그 인 인스턴스의 최대 수는 5개입니다.

◦ 시작 포트: 시스템을 시작해야 하는 범위의 첫 번째 포트 번호입니다. 포트가 이미 사용 중이 아니어야 합니다.

3. 설치를 클릭합니다. 플러그 인이 Windchill 플러그 인 테이블에 나타납니다.

4. Windchill이 사용자 정의 응용 프로그램(예: Navigate 앱)에 대해 사용자 정의 인증서를 사용하도록 구성된 경우, 다음 단계를 수행하십시오.

a. 사용자 정의 인증서 파일의 내용을 HTTPServer/conf/sslvhostconf.d/allClientCerts.crt 파일에 수동으로 복사합니다.

b. 사용자 정의 인증서를 참조하는 구성 파일을 제거합니다.

재호스팅 작업 중에는 기본적으로 플러그 인 인증서만 재생성됩니다. 따라서 사용자 정의 인증서는 수동으로 유지해야 합니다. 플러그 인 인증서와 사용자 정의 인증서를 모두 포함하는 allClientCerts.crt 파일을 재호스팅 전에 소스 시스템에서 대상 시스템으로 복사하지 않으면, 사용자 정의 인증서는 유지되지 않습니다.

사용자 정의 인증서를 유지하려면 재호스팅하기 전에 allClientCerts.crt 파일을 복사하거나 재호스팅 후 사용자 정의 인증서를 파일로 수동으로 가져옵니다. 자세한 내용은 Windchill 12.1.2.0 Rehost Utility Guide(Windchill 12.1.2.0 재호스팅 유틸리티 안내서)의 "WVS Agent Settings" 섹션을 참조하십시오.

설치에 실패하고 "AI Parts Rationalization 설치가 보안 검증 실패로 인해 실패했습니다. 시스템 관리자에게 문의하여 도움을 받으십시오."라는 메시지가 나타나면 해당 Java 버전의 최신 Java 빌드를 사용하고 있는지 확인하십시오. 자세한 내용은 온프레미스 환경 문제 해결을 참조하십시오.

AI Parts Rationalization 플러그 인 구성

플러그 인을 구성하려면 Windchill 제품 인스턴스를 등록하고 서비스 사용자를 만들어야 합니다. 자세한 내용은 Windchill 제품 인스턴스 등록 섹션을 참조하십시오.

플러그 인 구성을 시작하기 전에 Windchill 배포 시나리오를 확인하십시오. 일반적인 시나리오에는 분할형 웹 서버 설정 및 역방향 프록시 구성이 포함됩니다. 사용자의 배포 환경이 이러한 범주 중 하나에 해당하는 경우 이 항목의 “Windchill 배포 시나리오에서 플러그 인 구성” 섹션에서 자세한 지침을 참조하십시오.

1. 플러그 인을 구성하려면 설치됨 플러그 인을 마우스 오른쪽 버튼으로 클릭하고 플러그 인 구성을 선택합니다.

2. 플러그 인 구성 창에 필요한 세부 정보를 입력한 다음 저장을 클릭합니다.

◦ PTC SaaS Platform 서비스 사용자 클라이언트 ID - 서비스 사용자 만들기 페이지에 만들어져 표시된 클라이언트 ID를 입력합니다.

◦ PTC SaaS Platform 서비스 사용자 클라이언트 암호 - 서비스 사용자 만들기 페이지에 만들어져 표시된 클라이언트 암호를 입력합니다.

클라이언트 ID 및 클라이언트 암호는 PTC Admin Center에서 Windchill 제품 인스턴스를 등록할 때 시스템에서 자동으로 생성됩니다. 자세한 내용은 Windchill 제품 인스턴스 등록 섹션을 참조하십시오.

◦ 인덱싱을 위한 Windchill 사용자 - 인덱싱을 위한 Windchill 사용자 필드에서 인덱싱 사용자를 지정합니다. 인덱싱 사용자 구성 섹션에서 사용자 세부 정보를 이미 제공했습니다. 이 사용자를 자주 변경하지 않는 것이 좋습니다.

◦ 중복 부품에 대한 변경 공지 하위 유형의 내부 이름 - 중복 부품을 처리하는 데 사용할 변경 공지 유형의 내부 이름을 지정합니다. 예: com.ptc.plugins.cn. 중복 부품 검색을 위해 전용 변경 공지 하위 유형을 작성하고 여기에 내부 이름을 제공하는 것이 좋습니다. 이렇게 하면 중복 부품과 관련된 변경 공지가 지정된 하위 유형을 사용하여 일관되게 작성됩니다.

마찬가지로, 변경 객체의 내부 이름을 지정할 수도 있습니다(예: 중복 부품을 처리를 위한 문제 보고서 및 변경 요청). 변경 요청 및 문제 보고서에 대한 하위 유형 구성은 선택 사항입니다. 그러나 이러한 변경 객체가 구성되지 않은 경우, 사용자 인터페이스에 표시되지 않습니다.

◦ 저장소 유형 - 저장소 유형을 지정합니다(Azure 또는 AWS).

플러그 인을 설치하고 구성한 후, 중복 부품 검색 탭이 Windchill 검색 페이지에 나타납니다.

Windchill AI Parts Rationalization 플러그 인 업데이트

최신 버전의 플러그 인을 사용할 수 있게 되면 플러그 인 업데이트 작업을 사용할 수 있습니다. 플러그 인을 업데이트하려면 플러그 인을 마우스 오른쪽 버튼으로 클릭하고 플러그 인 업데이트를 클릭합니다. 플러그 인 버전이 자동으로 업데이트됩니다.

PTC SaaS Platform 및 Windchill 플러그 인 테이블에서 플러그 인의 최신 버전이 업데이트되면 플러그 인의 새 버전 번호를 볼 수 있습니다. 예를 들어, 이전에 버전 0.1.32를 설치했다면 이제 PTC SaaS 플랫폼에서 버전 0.1.33을 사용할 수 있습니다. Windchill 플러그 인 테이블의 최신 버전 열에 0.1.33 버전이 표시됩니다.

모범 사례

다음 모범 사례는 플러그 인을 효과적으로 설치, 구성 및 업데이트하는 데 도움이 됩니다.

• 설치를 완료한 후 Windows 플랫폼에서 Apache 프로세스를 수동으로 다시 시작합니다.

• 플랫폼에 적절한 설치 디렉터리가 있는지 확인합니다. 플러그 인 설치 디렉터리가 없는 경우 플러그 인 관리자는 오류를 보고합니다.

• 인덱싱을 위한 Windchill 사용자를 제외한 모든 구성 설정은 인덱싱이 시작된 후 변경되지 않아야 합니다. 이러한 설정을 수정하면 이전에 인덱싱된 데이터가 손실되며 관리자는 인덱싱 프로세스를 처음부터 다시 시작해야 합니다.

인덱싱을 위한 Windchill 사용자는 필요에 따라 변경할 수 있습니다. 그러나 해당 사용자는 액세스 권한이 있는 부품만 볼 수 있습니다.

• 재호스팅 작업 중에는 대상 시스템에 설치된 플러그 인이 유지됩니다. 재호스팅 후 대상 시스템에서 플러그 인을 수동으로 재구성하고 해당 인스턴스에 대해 다른 서비스 사용자를 사용해야 합니다. 또한 데이터를 재인덱싱해야 합니다. 재인덱싱하는 동안 AI 크레딧 사용을 효과적으로 관리하기 위해 인덱싱할 항목을 신중하게 선택합니다.

• 재호스팅 후 인덱싱 사용자를 A(소스)에서 B(대상)로 변경해야 하는 경우 다음 단계를 수행합니다.

1. 인덱싱 사용자 A(소스)를 사용하여 플러그 인을 재구성합니다.

2. 구성을 저장합니다.

3. 인덱싱 사용자를 B(대상)로 업데이트합니다.

• 플러그 인을 업데이트한 후에는 최적의 성능을 보장하고 예기치 않은 동작을 방지하기 위해 브라우저 캐시를 지우는 것이 좋습니다.

플러그 인에서 관리하는 작업

플러그 인 관리자를 사용하여 플러그 인을 설치한 후, 일반적으로 PTC SaaS Platform 저장소에서 플러그 인 파일을 다운로드한 다음 로컬 서버의 플러그 인 설치 디렉터리에 압축을 풉니다.

인스턴스는 아래에 설명된 대로 AI 게시 작업을 처리하는 서비스로 작동합니다. AI 게시 작업에 대한 VCS(Visualization Content Service) 요청에 대한 세부내용과 폴링 작업 결과를 제공합니다. 인스턴스는 다음 작업을 담당합니다.

• 인덱싱 작업 실행.

• AI 인덱싱 작업을 위해 VCS에 요청 전송.

• VCS 요청 모니터링 및 로깅, VCS를 폴링하여 작업 상태(예: 성공, 실패 또는 진행 중)를 확인하고 세부내용 로깅.

• 로그를 생성하고 플러그 인 설치 디렉터리에 저장 플러그 인 로그 생성을 위한 사용자 지정 위치를 지정할 수 있는 전용 등록 정보 wt.plugins.logs.dir가 제공됩니다.

• 대기열에 있는 각 작업의 상태 업데이트.

플러그 인 인증서 교체

이 항목에서는 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 온프레미스의 클러스터 환경에서 임의의 노드에 이 작업을 실행하면 모든 노드에서 인증서가 교체됩니다.

노드 중 하나가 다운되고 다른 노드에서 인증서가 교체되는 경우, 노드를 재시작하기 전에 현재 활성 노드에서 이전에 다운된 노드로 clients.crt 파일을 수동으로 복사해야 합니다.

예를 들어, 노드 1이 작동 중이고 노드 2가 다운되었으며 인증서가 노드 1에서 교체되는 경우 노드 2를 시작하기 전에 allClients.crt 파일을 노드 1에서 노드 2로 수동으로 복사합니다. 이 파일을 복사하면 노드 2를 시작합니다.

인증서 교체 작업을 수행한 후 AllClientsCerts 파일을 로컬 Apache 폴더에서 분할형 웹 서버의 원격 Apache 폴더로 복사합니다.

이 단계는 위에 언급된 배포 시나리오에서 AI Parts Rationalization 플러그 인을 구성한 후 완료해야 합니다. 플러그 인 구성 방법에 대한 자세한 내용은 AI Parts Rationalization 플러그 인 설치 및 구성 섹션을 참조하십시오.

자체 서명된 인증서 관리

다음은 자체 서명된 인증서를 관리하고 인증서 교체 후 정상적인 기능을 유지하기 위해 고려해야 할 주요 사항들입니다.

• 인증서 교체 후 Apache 및 Windchill 서비스를 수동으로 다시 시작해야 합니다.

• 자체 서명된 인증서의 유효 기간은 6개월입니다.

• 플러그 인 폴더와 Apache 인증서 파일 모두에 이전 인증서를 그대로 유지하십시오.

• 이전 인증서 교체 이후 최소 1시간이 경과하지 않으면 인증서 교체가 이루어질 수 없습니다.

• 플러그 인에 대한 인증서 교체에 실패할 경우 메서드 서버 로그에 해당 플러그 인 ID가 표시됩니다.

• 인증서 교체 후 Apache 및 Windchill을 다시 시작하지 않을 경우 플러그 인이 오래된 인증서를 사용할 수 있습니다.

Windchill 배포 시나리오에서 플러그 인 구성

이 항목은 Windchill 시스템 관리자를 대상으로 합니다.

이 문서에서는 여러 Windchill 배포 시나리오에서 웹 서버 설정 및 역방향 프록시 구성 등 AI Parts Rationalization 플러그 인을 구성하기 위한 자세한 지침을 제공합니다.

분할형 웹 서버 구성

분할형 웹 서버 구성을 사용하는 Windchill에서 AI Parts Rationalization 플러그 인을 구성하려면 다음 단계를 따르십시오.

1. 원격 Apache 및 Windchill에 SSL이 구성되어 있는지 확인합니다.

2. 플러그 인 관리자 > Windchill 플러그 인 페이지에서 필요한 플러그 인을 설치합니다.

3. 원격 Apache를 다시 시작합니다(Windows의 경우에만 해당).

4. 로컬 Apache 폴더로 이동합니다.

HTTPServer_HOME\conf\sslvhostconf.d

5. 다음 파일을 복사합니다.

◦ AllClientsCerts.crt

◦ pluginClients.conf

6. 원격 Apache의 다음 위치에 이 파일들을 붙여넣습니다.

HTTPServer_HOME\conf\sslvhostconf.d

인증서 교체 작업을 수행한 후 원격 Apache 서버에서 AllClientsCerts.crt 파일을 바꾸고 원격 Apache 서비스와 Windchill 서버를 둘 다 다시 시작합니다. 인증서 교체 프로세스에 대한 자세한 내용은 이 항목의 "플러그 인 인증서 교체" 섹션을 참조하십시오.

7. pluginClients 파일을 편집하여 AllClientsCerts의 경로를 업데이트합니다.

8. AIPartsRationalization-proxy.conf 파일을 플러그 인 설치 디렉터리에서 복사한 후 원격 Apache의 HTTPServer_HOME\conf\conf.d에 붙여넣습니다.

9. AIPartsRationalization-proxy.conf 파일을 열고 balancemember localhost를 Windchill 호스트 이름으로 바꾼 다음 저장합니다.

<Proxy balancer://AIPartsRationalization_lb/>
BalancerMember http://localhost:9090/Windchill/WCPlugins/partsearch route=AIPartsRationalization1
ProxySet stickysession=AIPartsRationalization_sticky
</Proxy>

10. 분할형 웹 서버 또는 원격 Apache를 다시 시작합니다.

11. 플러그 인 관리자 > Windchill 플러그 인 페이지로 이동하여 플러그 인을 구성합니다. 구성이 성공적으로 완료되었는지 확인합니다.

역방향 프록시 구성

역방향 프록시 구성을 사용하는 Windchill에서 AI Parts Rationalization 플러그 인을 구성하려면 다음 단계를 따르십시오.

1. 모든 관련 Apache 서버와 Windchill에 SSL이 구성되어 있는지 확인합니다.

원활한 통신을 위해 역방향 프록시 IP 주소와 해당 공개 DNS 호스트 이름을 Windchill 노드의 hosts 파일에 추가합니다.

• Linux: /etc/hosts 또는

• Windows: C:\Windows\System32\drivers\etc\hosts

2. 플러그 인 관리자 > Windchill 플러그 인 페이지에서 필요한 플러그 인을 설치합니다.

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. 플러그 인 관리자 > Windchill 플러그 인 페이지로 이동하여 플러그 인을 구성합니다. 구성이 성공적으로 완료되었는지 확인합니다.

AI Parts Rationalization 플러그 인 설치 및 구성 방법에 대한 자세한 내용은 AI Parts Rationalization 플러그 인 설치 및 구성을 참조하십시오.

도움이 되셨나요?