********************************** Instructions for Using PTF 5.0.0.4 ********************************** This PTF contains a tool named "wtsservice" which can enable WTS running as a windows service on Windows if preferred. The default behaviour is unchanged and WTS will continue to run as an application if wtsservice is not executed. Version 5.0 5.0.0.4 Before installing this PTF, please backup the whole image of WTS installed, although this PTF will backup the file updated. Install Guide 1. Ensure jvm 1.4 or later is installed. 2. Stop WTS and close WTS console. 3. Create an empty folder.(e.g. c:\ptf) 4. Copy install.jar, installp.cfg, installp.zip to the folder created. i) For Windows, Copy install.bat and uninstall.bat to the folder of install.jar ii) For AIX & Linux, Copy install.sh and uninstall.sh to the folder of install.jar 5. Run install.bat for Windows or install.sh for AIX & Linux. Uninstall Guide 1. Ensure jvm 1.4 or later is installed. 2. Stop WTS and close WTS console. 3. Run uninstall.bat for Windows or uninstall.sh for AIX & Linux. 4. The console will require input, just input "wtscore" 5. Press Enter to execute uninstallation. Usage Guide 1. To install service feature and ENABLE WTS as a windows service 1) After installing of this ptf, go to install path of WTS, there are two files "wtsservice.ini", "wtsservice.exe". 2) Open wtsservice.ini and change the key "jvm" to the path of "jvm.dll" on your machine. e.g. java 1.4.x or 1.5.x: jvm=C:\IBM142\jre\bin\classic\jvm.dll java 6: jvm=C:\Java6\jre\bin\client\jvm.dll wtsservice.ini provides a customized path configuration of jvm.dll. Well, when wtsservice.ini can't provide a right path of jvm.dll, WTS Service will still find the common path of jvm.dll. See below JVM Name Key in registry ibm1.4 \HKEY_LOCAL_MACHINE\SOFTWARE\IBM\Java2 Runtime Environment\1.4\JavaHome ibm1.4.1 \HKEY_LOCAL_MACHINE\SOFTWARE\IBM\Java2 Runtime Environment\1.4.1\JavaHome ibm1.4.2 \HKEY_LOCAL_MACHINE\SOFTWARE\IBM\Java2 Runtime Environment\1.4.2\JavaHome sun1.4.x \HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Runtime Environment\1.4\JavaHome sun1.5.x \HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Runtime Environment\1.5\JavaHome sun1.6.x \HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Runtime Environment\1.6\JavaHome 3) Open a command console and cd to the installed path of WTS. 4) Use "wtsservice.exe -i" to install the service. 5) Open windows services console and find "IBM WebSphere Translation Server", change startup type to "Automatic". 6) Start the "IBM WebSphere Translation Server" service so that WTS Server will work. 2. To uninstall service feature and DISABLE WTS as a windows service (default behaviour) 1) Open windows services console and find "IBM WebSphere Translation Server", shut down the service 2) Open a command console and cd to the installed path of WTS. 3) use "wtsservice.exe -u" to uninstall the service. Notice 1. Please ensure jvm 1.4 or later version is installed and the configuraion of jvm path is ready, so that install.jar can run without exception. 2. For installation, please keep install.jar, installp.cfg, installp.zip in the same folder. Troubleshooting 1. if can't start WTS console normally after installing this PTF, please try the following command line to start WTS without WTS console: for Windows: java -cp .;wts.jar com.ibm.lt.LTserver start for AIX & Linux: java -cp .:wts.jar com.ibm.lt.LTserver start 2. If on AIX, exception "Cannot open or remove a file contains a running program" comes while installing this PTF, please use shell command "slibclean" to clear the memory to release the files, and reinstall this PTF.