はじめに
この記事では、WindowsServer環境でUniFi NetworkアプリケーションをWindowsサービスとして設定する手順を紹介します。通常はUniFi Network Applicationをインストールした状態だとランチャーとしてフォアグラウンドで実行されてしまいますが、UniFi Network Applicationをバックグラウンドで実行することで、より安定した運用や自動起動の実現が可能となります。
なお、公式でも同様の手順を英語で紹介しています。
ほとんど日本語訳したものになりますが、少しだけ手順を追加していたり、私なりのアレンジを加えたりしています。
【公式ドキュメント】
Self-Hosted UniFi Network Server as a Windows Service (Advanced)
https://help.ui.com/hc/en-us/articles/205144550-UniFi-Run-the-Network-Application-as-a-Windows-Service
ランチャーとWindowsサービス
- ランチャー：UniFi Network Applicationが前面で実行されます（デフォルト）
- Windowsサービス：UniFi Network Applicationがバックグラウンドで実行されます（高度な設定）
注意事項と要件
公式サイトの動作保証範囲を超える内容ですので、注意が必要です。
- Windows Server環境でUniFi Network Application ver7.3.83.0を利用していますが、公式サイトではWindows 10/11での動作が保証されています。
- 本記事では、Windows Server環境でのUniFi Network Applicationの設定方法について説明しています。
- UniFi Network Applicationが使用するポートをWindowsファイアウォールで許可するようにしてください。詳細については、UniFi Network - Required Ports Referenceの記事を参照してください。
説明概要
- UniFi Network Applicationのダウンロード
- Java 11のインストールと設定
- UniFi Network Applicationの新規インストール
- サービスのインストール
- サービスの起動と動作確認
- UniFi Network Applicationの既存インストールからのアップグレード手順
新しいUniFi Network Applicationをサービスとして設定する
注意
- 最新バージョンのUniFi Network Application（7.3）では、Java 11が必要です。
- 以前のバージョン（7.2）では、Java 8が使用されます。
- 【x64 Javaリリース】のみをインストールし、Javaのバージョンは1つだけにしてください。
UniFi Network Applicationのダウンロード
ダウンロードページから最新のUniFi Networkアプリケーションをダウンロードしておきます。
Java 11のインストールと設定
こちらのサイトで以下のオプションを選択し、Windows用のx64 .msiファイルをダウンロードします。
ダウンロードするファイル
- OS：Windows
- アーキテクチャ：x64（それぞれの環境に合わせてください）
- パッケージタイプ：JRE
- バージョン：11
注意
JAVA_HOME変数が正しく設定されていない場合、サービスのインストールは成功しません。
Java 11インストーラーや変数に問題がある場合は、システムに存在する他の/古いJavaバージョンを削除してください。
インストールを実行し、カスタムセットアップ画面で「Set JAVA_HOME variable」を「ローカルハードドライブにインストール」に設定します。
設定出来たら次へを押していき、インストールを完了させて下さい。
UniFi Network Applicationの新規インストール
ダウンロードしたUniFi Network Applicationの.exeファイルを実行して案内のままインストールを実行してください。
インストールが完了したら、ランチャーは起動せずに完了してください。もし起動してもランチャーを閉じれば問題ありません。
サービスのインストール
管理者権限のあるWindowsコマンドプロンプト（cmd）ウィンドウを開きます。
UniFi Network Applicationのインストール場所にディレクトリを変更します。
cd "%UserProfile%\Ubiquiti UniFi"
UniFiフォルダーのルートに入ったら、以下のコマンドを実行してサービスをインストールします。
java -jar lib\ace.jar installsvc
インストールが完了するまで待ちます。完了したことを示す「Complete Installation」のログメッセージが表示されます。
サービスにUniFiNetworkアプリケーションが追加されたか確認しましょう。
Windowsキー + Rキーを押して「実行」ダイアログボックスを開き、ダイアログボックスに「services.msc」と入力して「OK」ボタンをクリックしてください。
サービス管理コンソールが開くのでUniFiNetworkアプリケーションを探します。
画像の様に見つかれば問題ありません。
※画像では状態が「実行中」になっていますが、この段階では「停止」になっているはずです。
サービスの起動と動作確認
以下のコマンドでサービスを起動します
java -jar lib\ace.jar startsvc
ブラウザを開き、アプリケーションのIPアドレスまたはhttps://localhost:8443に移動します。
404ERRORが出たら
1分ほど待ってからもう一度アクセスしてみてください。
サービス起動から少し時間がかかります。
下図のように初期セットアップ画面が出てくれば成功です。
UniFi Network Applicationの既存インストールからのアップグレード手順
バックアップ
UniFi Network Applicationのバックアップファイルをダウンロードします。
サービスのアンインストール
管理者権限のあるWindowsコマンドプロンプト（cmd）ウィンドウを開きます。
UniFiのインストール場所にディレクトリを変更します。
cd "%UserProfile%\Ubiquiti UniFi"
UniFiフォルダーのルートに入ったら、以下のコマンドを実行してサービスをアンインストールします。
java -jar lib\ace.jar uninstallsvc
サービスのアンインストールプロセスが完了するまで待ちます。
この後は新規インストール手順と同じです。
おまけ「\Program Filesにサービスをインストールする方法」
サービスを特定のユーザーにインストールせずにProgram Filesにインストールする方法があります。
あくまでもおまけなので箇条書きです。
- サービスを停止します。
- コマンドプロンプトを起動し、「Ubiquiti UniFi」ディレクトリにディレクトリを変更します。
- javaコマンドでサービスをアンインストールします。
- 「Ubiquiti UniFi」ディレクトリを切り取り、「\Program Files」ディレクトリに貼り付けます。
- コマンドプロンプトで「\Program Files\Ubiquiti UniFi」にディレクトリを移動します。
- Javaコマンドでサービスをインストールします。
- サービスを起動します。
最後にWebブラウザからアクセスできれば完了です。
各種コマンド
- サービスインストールコマンド
java -jar lib\ace.jar installsvc
- サービスアンインストールコマンド
java -jar lib\ace.jar uninstallsvc
おわりに
今回はUniFi NetworkをWindowsServerでサービスとして利用する手順を紹介しました。
もちろん、WindowsServerでUniFiNetwork Applicationをランチャーとして起動しても問題なく利用できますが、高度な設定が出来ません。もし高度な設定をする方はサービスで起動させた方がおすすめです。