Arbortext Publishing Engine(PE) 작업자 구성
PE 작업자는 Windchill과 함께 자동으로 설치됩니다. 이 작업자는 Arbortext Editor를 사용하여 작성된 동적 문서를 PDF 또는 HTML과 같은 표준 출력 형식으로 게시합니다.
이 단원에서는 PE 작업자를 구성하는 데 필요한 단계를 정의합니다.
사전 요구 사항
PE 작업자 구성 전에 다음이 필요합니다.
• Arbortext Publishing Engine 소프트웨어 및 관련 라이센스가 설치되고 구성되어야 합니다. 이 소프트웨어는 Windchill과는 별도로 구매 및 설치됩니다.
• URL이 Arbortext PE의 작업 인스턴스에 매핑되어야 합니다. URL은 wvsape.properties 파일의 ape.server 값에 저장됩니다.
• Arbortext 호환 Windchill 솔루션이 설치되어야 합니다. Windchill 솔루션이 Arbortext Publishing Engine 소프트웨어와 호환되는지 확인하려면 PTC 참조 문서 웹 사이트에 있는 Arbortext Software Compatibility Matrices를 확인하십시오.
이름 규약
이 설명서의 용도로 다음과 같은 디렉토리 이름 규약이 사용됩니다.
• <Windchill> - Windchill 설치 디렉토리입니다.
• <APEWorker> - 작업자 구성 파일인 arbortextEngineWorkerstart.bat 및 wvsape.properties를 저장하는 디렉토리입니다.
프로세스 개요
다음 다이어그램에서는 구성해야 할 사항을 잘 이해하도록 Windchill 서버, WVS, 작업자 에이전트, PE 작업자 및 PE 간의 관계를 설명합니다.
PE 작업자 구성을 완료하는 데 다음 프로세스가 사용됩니다.
1. PE 작업자를 구성합니다.
2. 작업자 구성 마법사를 사용하여 작업자 에이전트(agent.ini)를 구성합니다.
3. 작업자 에이전트, PE 작업자 및 Arbortext Publishing Engine이 모두 제대로 통신 중인지 확인합니다.
PE 작업자를 구성하는 데 wvsape.properties 파일 및 작업자 배치 파일이 사용됩니다. 이러한 파일 및 해당 매개 변수에 대한 자세한 설명은 후속 단원에서 제공합니다.
PE 작업자 구성
PE 작업자 구성에는 PE 작업자를 실행하는 배치 파일 및 PE 작업자 설정을 지정하는 데 사용되는 wvsape.properties 파일이 포함됩니다. 이러한 구성 파일은 설치된 작업자 파일을 보존하기 위해 작성되는 새 작업 디렉토리에 배치하는 것이 좋습니다. 이 단원에서는 작업자를 구성하는 배치 및 wvsape.properties 파일을 작성하는 방법을 설명합니다.
PE 작업자를 구성하려면 다음 단계를 따르십시오.
1. Windchill 서버에서 새 <APEWorker> 디렉토리(예: C:\PTC\APEWorker)를 작성합니다.
| 원격 PE 작업자 구성은 현재 지원되지 않습니다. 이는 원격 PE 서버를 보유하는 것과 혼동해서는 안 됩니다. PE 작업자는 Windchill 서버와 함께 존재하며 PE 서버의 요청/응답을 처리하는 데 사용됩니다. 이러한 구성을 시각적으로 파악하려면 위의 다이어그램을 참조하십시오. |
2. <Windchill>\codebase\com\ptc\wvs\server\workers 디렉토리에서 예제 구성 파일을 찾습니다. 이 예제 파일은 wvsape.properties이며, 배치 파일 이름은 arbortextEngineWorkerstart.bat입니다.
| 이 절차에서는 Windows를 사용한다고 가정합니다. UNIX 사용 시 예제 셸 스크립트(arbortextEngineWorkerstart.sh)를 사용합니다. |
3. 예제 파일을 단계 1에서 작성된 새 디렉토리로 복사합니다. 이러한 예제 파일을 원본 위치에서 이동하거나 편집하지 마십시오.
4. 텍스트 편집기를 사용하여 작업자 배치 파일을 편집합니다. 이 배치 파일은 후속 단계에서 작업자 에이전트가 구성될 때 PE 작업자 실행 가능 파일 명령으로 사용됩니다.
아래에 예제 작업자 배치 파일이 표시됩니다. 설정에 대한 설명이 뒤에 따라 나옵니다.
@echo on
set WORKER_DIR=C:\ptc\apeworker
set DEBUG="-D"
set PORT="5600"
set HOST="localhost"
set TYPE="APE"
set CMDCLASS="com.ptc.wvs.server.workers.ArbortextEngineWorker"
C:
cd “%WORKER_DIR%”
java -Dwvs.ape.properties=%WORKER_DIR%\wvsape.properties
com.ptc.wvs.server.cadagent.GenericWorker %DEBUG% -PORT %PORT%
-HOST %HOST% -TYPE %TYPE% -CMDCLASS %CMDCLASS% -DIR %WORKER_DIR%
-LOG "worker_"
◦ set WORKER_DIR=C:\PTC\APEWorker - 이 값은 중요하며 단계 1에 작성된 <APEWorker> 디렉토리로 설정해야 합니다.
◦ set DEBUG="-D" - 이 값은 디버깅용으로 예약되었으며 변경하면 안 됩니다.
◦ set PORT="5600" - 이 값은 변경할 수 있지만 이 값을 유지하는 것이 좋습니다. 이 값을 변경할 경우 agent.ini 파일의[agent] 섹션에 있는 "port" 값과 일치해야 합니다. 5600이 기본값입니다.
◦ set HOST="localhost" - 이 값을 "localhost"로 유지할 수 있지만 작업자가 존재하는 컴퓨터(PE 작업자의 경우 Windchill 컴퓨터)의 호스트 이름과 일치해야 합니다.
◦ set TYPE="APE" - 이 값은 변경하면 안 됩니다.
◦ set CMDCLASS="com.ptc.wvs.server.workers.ArbortextEngineWorker" - 이 값은 변경하면 안 됩니다.
5. <APEWorker> 디렉토리의 배치 파일에 변경 사항을 저장합니다.
6. 필요할 때마다 wvsape.properties 파일을 편집합니다. 아래에 예제 등록 정보 파일이 표시됩니다. 설정에 대한 설명이 뒤에 따라 나옵니다.
ape.server=http://localhost/e3/servlet/e3
ape.worker.logfile.dir=C:\\ptc\\Windchill\\logs\\arbortext\\
ape.verbose=false
| 사용자가 제공하는 ape.server URL은 사용자의 현재 Arbortext 릴리즈와 연관된 URL과 일치해야 합니다. 전체 URL을 지정해야 합니다. |
◦ ape.server는 설치된 Arbortext PE 서버에 대한 URL입니다. 이 값은 정의해야 합니다.
◦ ape.worker.logfile.dir은 Arbortext 작업자 로그 파일이 저장되는 디렉토리입니다. 이 디렉토리를 로그 파일을 보관할 위치와 일치하도록 변경해야 합니다.
◦ ape.verbose는 자세한 정보 표시 모드에 대한 true/false 전환입니다.
7. 변경 사항을 <APEWorker> 디렉토리에 저장하고 등록 정보 파일을 닫습니다.
8. 텍스트 편집기에서 Windchill 홈 디렉토리의 site.xconf 파일을 엽니다. site.xconf 파일에 다음 등록 정보를 추가합니다.
<Property name="worker.exe.whitelist.prefixes"
targetFile="codebase/WEB-INF/conf/wvs.properties"
value="APEWorker-path"/>
9. xconfmanager 유틸리티를 사용하여 변경 사항을 전파합니다. <Windchill>\bin 디렉토리에서 다음 명령을 입력합니다.
xconfmanager -pF.
UNIX용 PE 작업자 구성
UNIX의 경우 배치 파일 대신 스크립트 파일을 작성합니다.
PE 작업자 모니터 구성
| Creo View 어댑터 CD에 대한 액세스 권한이 있는 경우 작업자 모니터를 사용하는 것이 좋습니다. Creo View 어댑터 CD가 없는 경우 이 단원은 무시해도 됩니다. |
작업자 모니터는 오류 보고를 위해 작업자에 전적으로 의존하지 않고 자체의 타임아웃을 기반으로 모니터링하여 작업자와의 보다 강력한 통신을 제공합니다. 또한 작업자 모니터 구성 시 작업자 에이전트 UI를 통해 웹 브라우저에서 작업자 로그도 사용할 수 있습니다.
1. 이전 단원의 작업자 구성 절차와 비슷하게 <Windchill>\codebase\com\ptc\wvs\server\workers에서 arbortextEngineMonitorstart.bat를 찾아 <APEWorker> 디렉토리로 복사합니다.
| 이 절차에서는 Windows를 사용한다고 가정합니다. UNIX 사용 시 예제 셸 스크립트(arbortextEngineMoniterstart.sh)를 사용합니다. |
2. 텍스트 편집기를 사용하여 <APEWorker> 디렉토리의 arbortextEngineMonitorstart.bat 파일을 편집합니다.
아래에 예제 모니터 배치 파일이 표시됩니다. 설정에 대한 설명이 뒤에 따라 나옵니다.
@echo on
set WORKER_DIR=C:\ptc\apeworker
set PORT="5600"
set HOST="localhost"
set TYPE="APE"
set PVIEW_HOME=C:\ptc\productview_adapters
C:
cd "%WORKER_DIR%"
"%PVIEW_HOME%\i486_nt\obj\workermonitor" -s "%WORKER_DIR%\
arbortextEngineWorkerstart.bat" -vt -EW %TYPE% -CS%HOST% %PORT%
%1 %2 %3 %4 %5 %6 %7 %8 %9
◦ set WORKER_DIR=C:\PTC\APEWorker - 이 값은 중요하며 단계 1에 참조된 <APEWorker> 디렉토리로 설정해야 합니다.
◦ set PORT="5600" - 이 값은 변경할 수 있지만 기본값을 유지하는 것이 좋습니다. 이 값을 변경할 경우 agent.ini 파일의 [agent] 섹션에 있는 "port" 값과 일치해야 합니다. 5600이 기본값입니다.
◦ set HOST="localhost" - 이 값을 "localhost"로 유지할 수 있지만 작업자가 존재하는 컴퓨터(PE 작업자의 경우 Windchill 컴퓨터)의 호스트 이름과 일치해야 합니다.
◦ set TYPE="APE" - 이 값은 변경하면 안 됩니다.
◦ set PV_HOME= C:\ptc\product_adapters - 이 값은 설치된 productview_adapters 디렉토리의 위치로 설정해야 합니다.
3. <APEWorker> 디렉토리의 배치 파일에 변경 사항을 저장합니다.
이 배치 파일은 작업자 에이전트의 실행 명령에 작업자 배치 파일 대신 사용됩니다(다음 단원 참조).
UNIX용 PE 작업자 모니터 구성
UNIX의 경우 배치 파일 대신 스크립트 파일을 작성합니다.
작업자 에이전트 구성
PE 작업자에 대해 작업자 에이전트를 구성하려면
작업자 에이전트 구성을 참조하고 PE에 대한 다음 지침을 따르십시오.
• 데이터 유형 ARBORTEXT를 선택합니다.
• HOST는 서버의 이름이어야 합니다.
• 작업자 위치는 계속 Windchill 서버여야 합니다.
• 실행 명령은 PE 작업자를 구성할 때 작성한 배치 파일을 가리켜야 합니다.
| 작업자 모니터를 사용할 경우 실행 명령이 작업자 배치 파일이 아닌 모니터 배치 파일을 가리켜야 합니다. |
• 작업자 구성 마법사의 작업자 실행 명령 페이지에 있는 Max Instances 수는 WVS에 지정된 PE 풀에 대해 정의한 maxSubprocesses 값과 일치해야 합니다. 풀 및 maxSubprocesses에 대한 자세한 내용은 Arbortext PE 안내서를 참조하십시오.
