HowTo：macOS 上でインストールする手法

macOS システムに Java Service Wrapper をインストールするために利用できるオプションがいくつかあります。

全てのダウンロードファイルはダウンロードページより入手できます。

注意

このページでは、Wrapper ファイルをダウンロードして、お使いのシステムに抽出する方法について説明します。 抽出後、インテグレーションページに進んで、Java Service Wrapper をアプリケーションに統合する手順を確認してください。

パッケージからインストールする
対応バージョン :3.5.44
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :Windows (未対応)Mac OSXLinux (未対応)IBM AIX (未対応)FreeBSD (未対応)HP-UX (未対応)Solaris (未対応)IBM z/OS (未対応)IBM z/Linux (未対応)

最新リリースの pkg インストーラーをダウンロードしてください。

インストーラーを実行し、各ステップをクリックしてインストールを完了します。 Wrapper は /opt/local/Cellar/wrapper/<Wrapper バージョン> にインストールされます。 最後にインストールされたバージョンは、/opt/local/opt/wrapper からアクセスできます。

Wrapper バイナリとインストールされているすべてのファイルは署名され、公証されています。

インストール後、インテグレーション ページへ進み、 Java Service Wrapper をアプリケーションに統合する手順を確認してください。

もし、統合後にバイナリファイルをアプリケーションにコピーした場合、Wrapper のインストールは不要になります。 Wrapper は、次のコマンドを使用してアンインストールできます。

ターミナルから Wrapper をアンインストールする： 
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

ターミナルを使ってパッケージからインストールする
対応バージョン :3.5.44
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :Windows (未対応)Mac OSXLinux (未対応)IBM AIX (未対応)FreeBSD (未対応)HP-UX (未対応)Solaris (未対応)IBM z/OS (未対応)IBM z/Linux (未対応)

ターミナルから、または SSH 経由でリモートにパッケージをインストールする機能は非常に便利です。

最新リリースの pkg インストーラーをダウンロードして、Wrapper をインストールしたいマシンへ転送してください。

Wrapper は、次のコマンドを使用してインストールできます。

ターミナルからインストールする： 
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.
インストールと詳細ログをファイルに保存する： 
sudo installer -pkg wrapper-macosx-universal-64-3.5.44-pro.pkg -dumplog -target / 2>&1 > wrapper-installer.log

Wrapper は、/opt/local/Cellar/wrapper/<wrapper-version> にインストールされます。 最後にインストールされたバージョンは、/opt/local/opt/wrapper からアクセスできます。

Wrapper バイナリとインストールされているすべてのファイルは署名され、公証されています。

インストール後、インテグレーション ページへ進み、 Java Service Wrapper をアプリケーションに統合する手順を確認してください。

もし、統合後にバイナリファイルをアプリケーションにコピーした場合、Wrapper のインストールは不要になります。 Wrapper は、次のコマンドを使用してアンインストールできます。

ターミナルから Wrapper をアンインストールする： 
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

tar.gz ファイルからインストールする
対応バージョン :3.0.3
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :Windows (未対応)Mac OSXLinux (未対応)IBM AIX (未対応)FreeBSD (未対応)HP-UX (未対応)Solaris (未対応)IBM z/OS (未対応)IBM z/Linux (未対応)

Wrapper バイナリは、バージョン 3.5.44 以降で署名されています。 ダウンロードされた tar.gz ファイルは、インターネットからダウンロードされたものとしてマークされ、隔離されます。 これをそのまま使用すると、後で警告が発生する可能性があります。 上記のようにパッケージからインストールするとこの問題は発生しません。

ダウンロードしたファイルが危険と判定されていることを確認する： 
ls -al
-rw-r--r--@  1 you   staff   999999 Oct 29 12:12 wrapper-macosx-universal-64-3.5.44-pro.tar.gz
隔離マークの詳細を確認し、ファイルの出所を表示： 
xattr -l *

これらの tar.gz ファイルをそのまま抽出すると、抽出されたすべてのファイルにも同じ隔離マークが付けられます。 次に、アーカイブを抽出する前にアーカイブから検疫マークを削除するか（推奨）、 抽出したファイルからすべての検疫マークを再帰的に削除するかを選択できます。


ファイルから隔離マークを削除： 
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

これで tar.gz ファイルを安全に抽出でき、抽出されたファイルにも隔離マークがなくなります。


ファイルからすべての隔離マークを再帰的に削除： 
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

警告

Wrapper を Unix デーモンとしてインストールする場合は、 アーカイブを「ダウンロード」ディレクトリの外部へ抽出することが重要です。 Spotlight のインデックス作成により、その場所にインストールされているサービスが開始されなくなります。

Spotlight によってブロックされた場合、Wrapper はメッセージをログに記録できなくなります。 「SIGKILL が原因でサービスが終了しました | mds[...]により送信」 などのエラーが syslog に表示される場合があります。

解凍後、インテグレーション ページへ進み、Java Service Wrapper をアプリケーションに統合する手順を確認してください。

上記で抽出したフォルダを削除するだけで、Wrapper をアンインストールできます。 バイナリファイルを統合アプリケーションにコピーした場合、Wrapper のインストールは不要になります。

デルタパック tar.gz ファイルからインストールする
対応バージョン :3.2.0
対応エディション :プロフェッショナル版スタンダード版コミュニティー版
対応プラットフォーム :Windows (未対応)Mac OSXLinux (未対応)IBM AIX (未対応)FreeBSD (未対応)HP-UX (未対応)Solaris (未対応)IBM z/OS (未対応)IBM z/Linux (未対応)

Wrapper バイナリは、バージョン 3.5.44 以降で署名されています。 ダウンロードされたデルタパックの tar.gz ファイルは、インターネットからダウンロードされたものとしてマークされ、隔離されます。 これをそのまま使用すると、後で警告が発生する可能性があります。 上記の手順に従って、これらの隔離マークを削除してください。

解凍後、インテグレーション ページへ進み、Java Service Wrapper をアプリケーションに統合する手順を確認してください。

デルタパックの詳細については、デルタパックの概要を参照してください。

もし、統合後にバイナリファイルをアプリケーションにコピーした場合、 ファイルを抽出されたフォルダーは不要になりますので削除しても構いません。