HowTo : Comment installer sous macOS

Plusieurs options sont disponibles pour installer le Java Service Wrapper sur les systèmes macOS.

Tous les fichiers de téléchargement sont disponibles sur la page de téléchargement.

NOTE

Cette page décrit comment télécharger et extraire les fichiers du Wrapper sur votre système. Une fois extraits, veuillez consulter la page d'intégration pour les instructions permettant d'intégrer le Java Service Wrapper à votre application.

Installer à partir d'un package
Compatibilité :3.5.44
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :Windows (Non pris en charge)Mac OSXLinux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

Veuillez télécharger l'installateur pkg de la dernière version.

Exécutez l'installateur en cliquant sur chaque étape pour terminer l'installation. Le Wrapper sera installé dans /usr/local/Cellar/wrapper/<version du Wrapper>. La version la plus récemment installée est accessible via /usr/local/opt/wrapper.

Les binaires du Wrapper et tous les fichiers installés ont été signés et notariés.

Une fois installé, veuillez consulter la page d'intégration pour les instructions permettant d'intégrer le Java Service Wrapper à votre application.

Si, après l'intégration, vous avez copié les fichiers binaires dans votre application, l'installation du Wrapper n'est plus nécessaire. Le Wrapper peut être désinstallé à l'aide de la commande suivante.

Désinstaller le Wrapper depuis le 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

Installer à partir d'un package via le Terminal
Compatibilité :3.5.44
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :Windows (Non pris en charge)Mac OSXLinux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

La possibilité d'installer un package depuis le Terminal ou à distance via SSH peut s'avérer très utile.

Veuillez télécharger l'installateur pkg de la dernière version et le transférer sur la machine sur laquelle vous souhaitez installer le Wrapper.

Le Wrapper peut être installé à l'aide de la commande suivante :

Installation depuis le 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.
Enregistrer l'installation et le journal détaillé dans un fichier : 
sudo installer -pkg wrapper-macosx-universal-64-3.5.44-pro.pkg -dumplog -target / 2>&1 > wrapper-installer.log

Le Wrapper sera installé dans /usr/local/Cellar/wrapper/<version du Wrapper>. La version la plus récemment installée est accessible via /usr/local/opt/wrapper.

Les binaires du Wrapper et tous les fichiers installés ont été signés et notariés.

Une fois installé, veuillez consulter la page d'intégration pour les instructions permettant d'intégrer le Java Service Wrapper à votre application.

Si, après l'intégration, vous avez copié les fichiers binaires dans votre application, l'installation du Wrapper n'est plus nécessaire. Le Wrapper peut être désinstallé à l'aide de la commande suivante.

Désinstaller le Wrapper depuis le 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

Installer à partir d'un fichier tar.gz
Compatibilité :3.0.3
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :Windows (Non pris en charge)Mac OSXLinux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

Les binaires du Wrapper sont signés à partir de la version 3.5.44. Les fichiers tar.gz téléchargés seront toujours marqués comme ayant été téléchargés depuis Internet, et donc mis en quarantaine. Cela peut provoquer des avertissements par la suite s'ils sont utilisés tels quels. L'installation à partir d'un package comme ci-dessus n'aura pas ce problème.

Vérifier que les fichiers téléchargés sont marqués comme à risque : 
ls -al
-rw-r--r--@  1 you   staff   999999 Oct 29 12:12 wrapper-macosx-universal-64-3.5.44-pro.tar.gz
Voir les détails de la marque de quarantaine et afficher la provenance des fichiers : 
xattr -l *

Si vous extrayez ces fichiers tar.gz tels quels, tous les fichiers extraits porteront également ces mêmes marques de quarantaine. Vous avez alors le choix soit de supprimer les marques de quarantaine de l'archive avant de l'extraire (recommandé), soit de supprimer récursivement toutes les marques de quarantaine des fichiers extraits.


Supprimer les marques de quarantaine de l'archive : 
xattr -d com.apple.macl wrapper-macosx-universal-64-3.5.44-pro.tar.gz
xattr -d com.apple.metadata:kMDItemWhereFroms wrapper-macosx-universal-64-3.5.44-pro.tar.gz
xattr -d com.apple.quarantine wrapper-macosx-universal-64-3.5.44-pro.tar.gz

Vous pouvez maintenant extraire le fichier tar.gz en toute sécurité ; les fichiers extraits seront également exempts de toute marque de quarantaine.


Supprimer récursivement toutes les marques de quarantaine des fichiers : 
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

AVERTISSEMENT

Si vous prévoyez d'installer le Wrapper en tant que démon Unix, il est important d'extraire l'archive en dehors de votre répertoire « Downloads ». L'indexation de Spotlight empêchera en effet tout service installé à cet emplacement de démarrer.

Lorsqu'il est bloqué par Spotlight, le Wrapper ne pourra enregistrer aucun message. Vous pourrez simplement trouver une erreur telle que « Service exited due to SIGKILL | sent by mds[...] » dans le syslog.

Une fois extraits, veuillez consulter la page d'intégration pour les instructions permettant d'intégrer le Java Service Wrapper à votre application.

Le Wrapper peut être désinstallé en supprimant simplement le dossier extrait ci-dessus. Si, après l'intégration, vous avez copié les fichiers binaires dans votre application, l'installation du Wrapper n'est plus nécessaire.

Installer à partir d'un fichier tar.gz Delta Pack
Compatibilité :3.2.0
Éditions :Édition ProfessionnelleÉdition StandardÉdition Community
Plateformes :Windows (Non pris en charge)Mac OSXLinux (Non pris en charge)Alpine Linux (Non pris en charge)FreeBSD (Non pris en charge)Solaris (Non pris en charge)IBM z/Linux (Non pris en charge)

Les binaires du Wrapper sont signés à partir de la version 3.5.44. Les fichiers tar.gz Delta Pack téléchargés seront toujours marqués comme ayant été téléchargés depuis Internet, et donc mis en quarantaine. Cela peut provoquer des avertissements par la suite s'ils sont utilisés tels quels. Suivez les étapes ci-dessus pour supprimer ces marques de quarantaine.

Une fois extraits, veuillez consulter la page d'intégration pour les instructions permettant d'intégrer le Java Service Wrapper à votre application.

Pour plus de détails sur ce qu'est le Delta Pack, consultez la Vue d'ensemble du Delta Pack.

Si, après l'intégration, vous avez copié les fichiers binaires dans votre application, le dossier dans lequel les fichiers ont été extraits n'est plus nécessaire et peut être supprimé.