HowTo: How to install on Windows

There are a number of options available to install the Java Service Wrapper on Windows systems.

All download files are available on the download page.

NOTE

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

Compatibility :3.5.46
Editions :Professional EditionStandard EditionCommunity Edition
Platforms :WindowsMac OSX (Not Supported)Linux (Not Supported)IBM AIX (Not Supported)FreeBSD (Not Supported)HP-UX (Not Supported)Solaris (Not Supported)IBM z/OS (Not Supported)IBM z/Linux (Not Supported)

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

Compatibility :2.2.0
Editions :Professional EditionStandard EditionCommunity Edition
Platforms :WindowsMac OSX (Not Supported)Linux (Not Supported)IBM AIX (Not Supported)FreeBSD (Not Supported)HP-UX (Not Supported)Solaris (Not Supported)IBM z/OS (Not Supported)IBM z/Linux (Not Supported)

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.

NOTE

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

Compatibility :3.2.0
Editions :Professional EditionStandard EditionCommunity Edition
Platforms :WindowsMac OSX (Not Supported)Linux (Not Supported)IBM AIX (Not Supported)FreeBSD (Not Supported)HP-UX (Not Supported)Solaris (Not Supported)IBM z/OS (Not Supported)IBM z/Linux (Not Supported)

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.

For details on what the Delta Pack is, see the Delta Pack Overview.

Install from a Delta Pack zip file

Compatibility :3.2.0
Editions :Professional EditionStandard EditionCommunity Edition
Platforms :WindowsMac OSX (Not Supported)Linux (Not Supported)IBM AIX (Not Supported)FreeBSD (Not Supported)HP-UX (Not Supported)Solaris (Not Supported)IBM z/OS (Not Supported)IBM z/Linux (Not Supported)

Just like described in the "Install from a zip file" section, the delta pack will be marked as downloaded from the internet. Please follow the above steps to unblock the archive or the bat files.

For details on what the Delta Pack is, see the Delta Pack Overview.

Uninstall the Wrapper

1. Uninstall the service:

If the Wrapper was installed as a Windows service, please read the "Uninstall (remove) from the Windows Service" section of this page.


2. Execute the --teardown command (optional):

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.