World Map
Java Service Wrapper is the easiest way to make your product more reliable.
  • Free Trial
  • Buy Now

HowTo: How to install on macOS

This section will help you understand the options for installing the Java Service Wrapper on macOS.

There are a number of options available to install the Java Service Wrapper on macOS systems. All download files are available on the download page.

Install from a package

Compatibilidad :3.5.44
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :Windows (No Soportado)Mac OSXLinux (No Soportado)IBM AIX (No Soportado)FreeBSD (No Soportado)HP-UX (No Soportado)Solaris (No Soportado)IBM z/OS (No Soportado)IBM z/Linux (No Soportado)

Please download the pkg installer for the latest release.

Run the installer, clicking through each step to complete the installation. The Wrapper will be installed at /opt/local/Cellar/wrapper/3.5.44. The most recently installed version can be accessed at /opt/local/opt/wrapper.

The Wrapper binaries and all installed files have been signed and notarized.

Once installed, please proceed to the Integration page for instructions to integrate the Java Service Wrapper with your application.

The Wrapper can be uninstalled using the following command. If you have copied the binary files into your integrated application, then the Wrapper installation is no longer needed.

Uninstall the Wrapper from the Terminal:
% sudo /usr/local/Cellar/wrapper/3.5.44-pro/uninstall.sh 
Welcome to Java Service Wrapper Uninstaller
The following packages will be REMOVED:
  Java Service Wrapper (macosx-universal-64-3.5.44-pro)
Do you wish to continue [Y/n]?Y
[2/3] [DONE] Successfully unregistered Java Service Wrapper package
[3/3] [DONE] Successfully deleted Java Service Wrapper
Removed empty /usr/local/Cellar/wrapper
Java Service Wrapper uninstall process finished

Install from a package using the Terminal

Compatibilidad :3.5.44
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :Windows (No Soportado)Mac OSXLinux (No Soportado)IBM AIX (No Soportado)FreeBSD (No Soportado)HP-UX (No Soportado)Solaris (No Soportado)IBM z/OS (No Soportado)IBM z/Linux (No Soportado)

The ability to install a package from the Terminal or remotely via SSH can be very useful.

Please download the pkg installer for the latest release and transfer it to the machine onto which you wish to install the Wrapper.

The Wrapper can be installed using the following command:

Installation from the Terminal:
% sudo installer -pkg wrapper-macosx-universal-64-3.5.44-pro.pkg -target /  
installer: Package name is Java Service Wrapper 3.5.44-pro
installer: Installing at base path /
installer: The install was successful.
Storing installation and detailed log into a file:
% sudo installer -pkg wrapper-macosx-universal-64-3.5.44-pro.pkg -dumplog -target / 2>&1 > wrapper-installer.log

The Wrapper will be installed at /opt/local/Cellar/wrapper/3.5.44. The most recently installed version can be accessed at /opt/local/opt/wrapper.

The Wrapper binaries and all installed files have been signed and notarized.

Once installed, please proceed to the Integration page for instructions to integrate the Java Service Wrapper with your application.

The Wrapper can be uninstalled using the following command. If you have copied the binary files into your integrated application, then the Wrapper installation is no longer needed.

Uninstall the Wrapper from the Terminal:
% sudo /usr/local/Cellar/wrapper/3.5.44-pro/uninstall.sh 
Welcome to Java Service Wrapper Uninstaller
The following packages will be REMOVED:
  Java Service Wrapper (macosx-universal-64-3.5.44-pro)
Do you wish to continue [Y/n]?Y
[2/3] [DONE] Successfully unregistered Java Service Wrapper package
[3/3] [DONE] Successfully deleted Java Service Wrapper
Removed empty /usr/local/Cellar/wrapper
Java Service Wrapper uninstall process finished

Install from a tar.gz file

Compatibilidad :3.0.3
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :Windows (No Soportado)Mac OSXLinux (No Soportado)IBM AIX (No Soportado)FreeBSD (No Soportado)HP-UX (No Soportado)Solaris (No Soportado)IBM z/OS (No Soportado)IBM z/Linux (No Soportado)

The Wrapper binaries are signed starting with version 3.5.44. The downloaded tar.gz files will still be marked as having been downloaded from the internet, and thus quarantined. This can cause warnings later on if used as is. Installing from a package as above will not have this problem.

Verify that the downloaded files are marked as at risk:
% ls -al
-rw-r--r--@  1 you   staff   999999 Oct 29 12:12 wrapper-macosx-universal-64-3.5.44-pro.tar.gz
See the details of the quarantine mark and show where the files came from:
% xattr -l *	

If you extract these tar.gz files as is, then all of the extracted files will also have these same quarantine marks.

Recursively remove all quarantine marks from files:
% find wrapper* -print0 | xargs -0 xattr -d com.apple.macl
find wrapper* -print0 | xargs -0 xattr -d com.apple.metadata:kMDItemWhereFroms
find wrapper* -print0 | xargs -0 xattr -d com.apple.quarantine

Once extracted, please proceed to the Integration page for instructions to integrate the Java Service Wrapper with your application.

You can now safely extract the tar.gz file and extracted files will also be free of any quarantine marks.

The Wrapper can be uninstalled by simply deleting the above extracted Folder. If you have copied the binary files into your integrated application, then the Wrapper installation is no longer needed.

Install from a Delta Pack tar.gz file

Compatibilidad :3.2.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad
Plataformas :Windows (No Soportado)Mac OSXLinux (No Soportado)IBM AIX (No Soportado)FreeBSD (No Soportado)HP-UX (No Soportado)Solaris (No Soportado)IBM z/OS (No Soportado)IBM z/Linux (No Soportado)

The Wrapper binaries are signed starting with version 3.5.44. The downloaded Delta Pack tar.gz files will still be marked as having been downloaded from the internet, and thus quarantined. This can cause warnings later on if used as is. Follow the steps above to remove these quarantine marks.

Once extracted, please proceed to the Integration page for instructions to integrate the Java Service Wrapper with your application.

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

The Wrapper can be uninstalled by simply deleting the above extracted Folder. If you have copied the binary files into your integrated application, then the Wrapper installation is no longer needed.