This page describes the how to download and extract the Wrapper files on your system.
Once extracted, please proceed to the Integration page for instructions to integrate the Java Service Wrapper with your application.
After integration, if you have copied the binary files into your application, then the folder where the files were extracted is no longer needed and can be removed.
Install from the installer
Please download the installer for the latest release.
You may either save it in your download folder or at the location where you want to install the Java Service Wrapper.
Once you run the installer, it will suggest a path to where the files should be extracted.
The default path will be a new directory whose name is the base name of the installer and created at the location from which the installer is executed.
You may change it to any location you prefer, then just click "Install" to extract the files.
Because the installer itself is signed and authenticated, all files it extracts will be trusted by your system.
In addition, the Wrapper binaries and jar files have all been digitally signed and timestamped to certify that Tanuki Software, Ltd. is the author.
This also guarantees that the code has not been altered or corrupted since it was signed.
Install from a zip file
When a zip file is downloaded from the internet, the default security policy of Windows is to mark all files contained in the archive as untrusted.
This doesn't apply to the Wrapper binaries and jar files, which have been digitally signed and certified as safe. However, batch files, which aim to ease launching and controling the Wrapper, can't by nature be signed like normal binaries, and Windows Defender SmartScreen might display a "Windows protected your PC" blue popup when executing them for the first time.
Installing from the installer as above will not have this problem.
Please be reassured. It is perfectly safe to execute these batch files if they were acquired from the download page of the Tanuki Software website or the Official "Java Service Wrapper" SourceForge page.
There are a few solutions that we recommend as a workaround to this issue:
The first solution is to simply click "More Info" and then "Execute anyway" when the popup appears.
Once the batch file is executed, the popup will not show up on subsequent executions.
The second solution is to:
1. Right click on the bat file you want to execute and open the Properties
window from the contextual menu.
2. At the bottom of the "General" tab, you should see a "Security" section
with an "Unblock" checkbox or button. Click on the button or check the box.
3. Click OK.
4. You should now be able to execute the bat file without the warning.
The third solution is to right click on the downloaded zip file before extracting it, and unblock it the same way as the previous solution.
All of the extracted files will maintain the unblocked status.
It is also possible to change the security policy of your system to never show this popup, but we do not recommend this solution as this will apply to all programs executed on the machine, thus decreasing the whole security level of the machine.
Install from the Delta Pack installer
Like for the Windows package, the delta pack can be extracted on Windows systems using an installer.
Please follow the above steps to launch and execute the installer.
The Delta Pack installer will let you choose the binaries you want to extract. By default, all available platforms will be checked.
Please uncheck the platforms you don't need.
There are a couple of configuration properties that tells the Wrapper to edit the Windows registry.
In certain cases you might want to revert the changes made.
This can be achieved by using the TeardownApp.bat.in or the teardown command.
Please make sure that your application is stopped before exucuting them.
3. Remove the Wrapper files:
Finally, the Wrapper can be uninstalled by simply deleting the above extracted folder.