Configuring the PE Worker
The PE Worker configuration involves a batch file that executes the PE Worker and a wvsape.properties file that is used to specify the PE Worker settings. PTC recommends that these configuration files reside in a new working directory that you create to preserve the installed worker files. This section explains how to create the batch and wvsape.properties files to configure the worker.
Follow these steps to configure the PE Worker:
1. Create a new <APEWorker>directory on the Windchill server; for example: C:\PTC\APEWorker.
|
|
Remote PE Worker configuration is currently not supported. This is not to be confused with having a remote PE Server. The PE Worker resides with the Windchill Server, and is used to process the requests/responses to and from the PE Server. Refer to the previous diagram for a visual depiction of this configuration.
|
2. Locate the sample configuration files in the <Windchill>\codebase\com\ptc\wvs\server\workers directory. The sample file is called wvsape.properties and the batch file name is arbortextEngineWorkerstart.bat.
|
|
This procedure assumes you are using Windows. If you are on UNIX, you use the sample shell script (arbortextEngineWorkerstart.sh).
|
3. Copy the sample files to the new directory you created in Step 1. Do not edit or move the files from their original location.
4. Using a text editor, edit the worker batch file. This batch file is used as the PE Worker executable command when you configure the Worker Agent in a subsequent step.
The sample worker batch file is shown below, followed by descriptions of the settings.
@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 - This value is critical and must be set to the <APEWorker> directory created in Step 1.
◦ set DEBUG="-D" - This value is reserved for debugging and should not be changed.
◦ set PORT="5600" - This value can be changed, but it is not recommended that you do so. If you change this value, you must ensure that it matches the "port" value in the [agent] section of the agent.ini file. 5600 is the default value.
◦ set HOST="localhost" - This value can be left as "localhost", but should match the hostname of the machine where the worker resides, which, for the PE Worker, will be the Windchill machine.
◦ set TYPE="APE" - This value should not be changed.
◦ set CMDCLASS="com.ptc.wvs.server.workers.ArbortextEngineWorker" - This value should not be changed.
5. Save your changes to the batch file in the <APEWorker>directory.
6. Edit the wvsape.properties file as needed. A sample properties file is shown below, followed by descriptions of the settings.
ape.server=http://localhost/e3/servlet/e3
ape.worker.logfile.dir=C:\\ptc\\Windchill\\logs\\arbortext\\
ape.verbose=false
|
|
The ape.server URL you provide should correspond to the URL associated with your current Servigistics Arbortext release. The full URL should be specified.
|
◦ ape.server is the URL to the installed Servigistics Arbortext PE server. It is required that you define this value.
◦ ape.worker.logfile.dir is the directory that stores the Servigistics Arbortext worker log file. You should change this directory to match the location where you keep your log files.
◦ ape.verbose is a true/false switch for verbose mode.
7. Save your changes into the <APEWorker> directory and close the properties file.
