...
- Download YAJSW (Yet Another Java Service Wrapper) from Sourceforge: http://sourceforge.net/projects/yajsw/files/ (these instructions were written and tested against YAJSW version 1112.0316)
- Unzip the file into a suitable folder, e.g. C:\Pentaho\CarteService.
Note: This should not be created below any other Pentaho Kettle folder since it is independent of the Pentaho Kettle Version and makes it easy to upgrade to future Kettle versions (see also chapter "Upgrade Instructions"). - When you unzipped YAJSW, you have e.g. a folder C:\Pentaho\CarteService\yajsw-stable-1112.0316. We recommend to rename this folder to C:\Pentaho\CarteService\default. The reason for this is the possibility of having multiple configurations on one machine, see chapter "Multiple Instances of Carte on one Machine". Another reason is that you do not need to change any references to this folder in case you upgrade to a later YAJSW version.
Note: We will reference the YAJSW directory in the following instructions as <CarteServiceFolder>. - Download the prepared wrapper.conf configuration file (attachment to this Page).
- Copy the downloaded wrapper.conf to <CarteServiceFolder>\conf\wrapper.conf (replace the existing one).
- Edit the wrapper.conf with a text editor and change the following entries manually (you can search for your convenience for the markers ###InstallerOrModify### within the file):
Parameter | Sample | Description / Notes |
---|---|---|
wrapper.working.dir | C:/Pentaho/pdi-ee-4.3.0-GA/data-integration\\\\pentaho\\\\design-tools\\\\data-integration\\\\ | The working directory of Carte. Please mind to change back slashes to forward slashes or double back slashes in the file path! |
wrapper.app.account | The user account the Carte service will run. When nothing is given here, it starts as the Local System account. Please check with your system administrator about the right user settings. Please mind to remove the leading '#' in case you enter a property here. | |
wrapper.app.password | Password for the given account. Please mind to remove the leading '#' in case you enter a property here. | |
wrapper.java.app.jar | . | You need to replace the version of this jar file. |
wrapper.java.commandC:/Pentaho/BA-4.5.0-GA/java/bin/java.exe or | ${pentahoPENTAHO_javaJAVA_home}/bin/HOME}\\\\bin\\\\java.exe | The Path to your java.exe. Please mind to change back slashes to forward slashes or double back slashes in the file path! |
wrapper.app.parameter.3 | 127.0.0.1 | The Carte listening IP Address (or dynamic configuration file), see Carte User Documentation for more details. |
wrapper.app.parameter.4 | 8081 | The Carte listening port, see Carte User Documentation for more details. |
wrapper.java.additional.1 | -Xmx512mDorg.mortbay.util.URI.charset=UTF-8 | URL Encoding. |
wrapper.java.additional.2 | -Xmx4g | This may vary depending on your needed memory. |
wrapper.java.additional.3 | -Xms1g | This may vary depending on your needed memory. |
wrapper.java.additional.4 | -Dhttps.protocols=TLSv1,TLSv1.1,TLSv1.2 | Support for HTTPs TLS |
wrapper.java.additional.5 | -DKETTLE_HOME=/some/path | This PATH is used to read the kettle home. If not defined, it will user the %USER_HOME% and will create or use existing .kettle folder. This folder is where kettle.properties file, shared.xml and other settings files are used by PDI. |
wrapper.java.additional.6 | -XX:+AggressiveOpts | Used to have a better GC memory management. However, we are currently recommending the use of -XX:+UseG1GC |
wrapper.java.additional.7 | -XX:+ExitOnOutOfMemoryError | In case of an Out Of Memory, we recommend the CARTE to exit. If used in combination with Windows Services auto-restart in case of failure, will make the service to be back in few minutes. |
Test your Configuration
- Execute <CarteServiceFolder>\bat\runConsole.bat
- When everything is configured correct, Carte starts up as usual.
- Check if you can login to Carte from your Browser on your local machine, e.g. http://localhost:8081
- When the test went successfully, you can stop Carte with selecting "Stop" in the new yajsw system tray or with Ctrl-C in the console window.
...