UniFiコントローラーが起動しないときの対処法｜起動エラーを解決する11の方法

UniFiコントローラーソフトウェアは、システムドライブの空き容量が不足していると「起動に失敗しました」というエラーメッセージを表示することがあります。さらに、JavaまたはUniFiコントローラーソフトウェア自体が破損していたり、古いバージョンのままである場合にも、同様のエラーが発生する可能性があります。

このエラーは、ユーザーがUniFiコントローラーソフトウェアを起動しようとしたタイミングで表示されます。ソフトウェアのアップグレード後に発生するケースもあれば、アプリケーション起動から5分以上経過した後に突然現れるケースもあります。Windows、Linux、Mac、さらにはRaspberry Piユーザーからも同様の報告が寄せられています。

トラブルシューティングを始める前に、まずネットワークの種類が「プライベート」または「ドメイン」に設定されていることを確認してください。ネットワークが「パブリック」に設定されていると、正常な通信がブロックされることがあります。

解決策1：タスクマネージャーでUniFi関連のプロセスを終了する

一時的なソフトウェアや通信の不具合が原因でエラーが発生している可能性があります。その場合は、UniFi関連のプロセスをすべて終了させてからアプリケーションを再起動することで問題が解決することがあります。ここでは、Windows PCでの手順を例に説明します。

1. UniFiコントローラーアプリケーションを閉じます。
2. Windowsボタンを右クリックし、表示されたメニューから「タスクマネージャー」を選択します。
3. 「プロセス」タブで、UniFiコントローラーソフトウェアに関連するプロセスを選択し、「タスクの終了」ボタンをクリックします。UniFiコントローラーに関連するすべてのプロセスに対して同じ操作を繰り返します。
4. 続いて、JavaおよびMongoDに関連するプロセスもすべて終了させます。
5. その後、コントローラーソフトウェアを再度起動し、正常に動作するか確認します。依存関係の再構築が必要なため、読み込みにある程度時間がかかる場合があります。

解決策2：システムドライブの空き容量を確保する

UniFiコントローラーソフトウェアは、動作を完了させるためにシステムドライブ上に一定の空き容量を必要とします。空き容量が不足していると、このエラーが発生する可能性があります。システムドライブ（Cドライブ）の空き容量を作ることで問題が解決できる場合があります。

1. Cドライブ（システムドライブ）の空き容量を確保します。不要なファイルの削除、ディスククリーンアップの実行、大型ファイルの別ドライブへの移動などを試みてください。
2. その後、コントローラーアプリケーションを起動し、正常に動作するか確認します。

解決策3：System.Propertiesファイルでストレージエンジンを指定変更する

データベースが「mmapv1」ストレージエンジンで作成されているのに、指定されたストレージエンジンが「wiredTiger」になっていると、このエラーが発生することがあります。その場合は、コントローラーアプリケーションにmmapv1ストレージエンジンを使用するよう強制することで問題を解決できます。Windows PCでの手順を例に説明します。

1. エクスプローラーを起動し、コントローラーアプリケーションのインストールディレクトリへ移動します。通常、以下のパスです：

   %USERPROFILE%\Ubiquiti UniFi\data

2. 「System.properties」ファイルをメモ帳で開き、ファイルの末尾に以下の行を追加します：

   db.extraargs=--storageEngine=mmapv1

   
3. 変更を保存し、メモ帳を終了します。
4. コントローラーアプリケーションを起動し、正常に動作しているか確認します。

解決策4：特殊文字を含まないユーザープロファイルを使用する

UniFiコントローラーは、Ubiquiti UniFiフォルダへのパスに特殊文字が含まれていると問題が生じることが知られています（例：C:\Users\ÄçìÞôñçò\Ubiquiti UniFi）。これは、ユーザープロファイル名に特殊文字が含まれている場合に起こります。そのような場合は、特殊文字を含まない新しいユーザープロファイルを作成することで問題を解決できる可能性があります。

注意点として、現在のユーザー名を変更しても、Ubiquiti UniFiフォルダへのパスには反映されません。そのため、新しいユーザーアカウントを作成し、データをすべてそちらへ移行する必要があります。

1. Windows PC用の新しいユーザーアカウントを作成し、既存のデータをすべて移行します。
2. その後、コントローラーソフトウェアでエラーが解消されているか確認します。

解決策5：UniFiコントローラーが必要とするデフォルトポートを解放する

UniFiコントローラーアプリケーションは、デフォルトでポート8080を使用して動作します。このポートが他のプログラムによって使用されていると、本エラーが発生する可能性があります。ポートを使用しているプログラムを停止するか、当該プログラム（またはUniFiコントローラーアプリケーション）に別のポートを使用するよう設定することで問題を解決できます。

1. Windows PCをクリーンブート状態で起動し、問題が解決するか確認します。
2. 解決した場合は、ポート競合を引き起こしているプログラムを特定します。あるいは、UniFiコントローラーアプリケーションのデフォルトポートを別の番号に変更するのも有効です。

解決策6：UniFiのログファイルの名前を変更する

UniFiコントローラーは、他の多くのアプリケーションと同様に、トラブルシューティングを容易にするためのログファイルを作成します。これらのログが破損していると、本エラーが発生することがあります。ログファイルの名前を変更すると（次回起動時に新しいログファイルが自動生成されます）、問題が解決する場合があります。

1. UniFiコントローラーアプリケーションを閉じ、タスクマネージャーを使って関連プロセスをすべて終了させます（解決策1を参照）。
2. エクスプローラーを開き、インストールディレクトリへ移動します。通常は以下のパスです：

   %USERPROFILE%\Ubiquiti UniFi\logs\

   
3. ログファイルの名前を変更します。特にmongod.logやserver.logなども忘れずに変更してください（拡張子の末尾に「.old」を追加するのがおすすめです）。その後、ソフトウェアを起動して問題が解決したか確認します。

解決策7：UniFiフォルダ内のジャーナルファイルを削除する

UniFiコントローラーソフトウェアは、さまざまな種類のデータをジャーナルファイルに保存しています。これらのジャーナルファイルが破損していると、本エラーが発生することがあります。ジャーナルファイルを削除することで問題が解決する場合があります。

1. UniFiコントローラーを閉じ、タスクマネージャーで実行中の関連プロセスをすべて終了させます（解決策1を参照）。
2. エクスプローラーを起動し、アプリケーションのインストールディレクトリへ移動します。通常は以下のパスです：

   %USERPROFILE%\Ubiquiti UniFi\data\db\journal

3. 念のため、フォルダ内のすべてのファイルを安全な場所へバックアップしておきます（万が一の場合に備えて）。
4. その後、フォルダ内のすべてのファイルを削除し、システムを再起動します。
5. 再起動後、コントローラーアプリケーションを起動し、正常に動作しているか確認します。

解決策8：UniFiコントローラーソフトウェアをサービスとしてインストールする

UniFiコントローラーソフトウェアがサービスとしてインストールされていない場合、さまざまな不具合が発生することがあり、今回のエラーの原因にもなり得ます。サービスとしてインストールすることで問題が解決する可能性があります。

1. コントローラーを終了し、タスクマネージャーですべての実行中プロセスを閉じます（解決策1を参照）。
2. システム環境変数のPathにJavaのパスを追加します（Temp変数のパス末尾など）。通常は以下のようなパスです：

   C:\Program Files(x86)\Java\jre7\bin\javaw.exe

   
3. タスクバーのWindows検索ボックスをクリックし、「Command Prompt」と入力します。検索結果の「コマンドプロンプト」を右クリックし、「管理者として実行」を選択します。
4. 以下のコマンドを入力し、Enterキーを押します：

   cd "%UserProfile%\Ubiquiti UniFi\"

5. UniFiディレクトリ内で、以下のコマンドを入力し、Enterキーを押します：

   java -jar lib\ace.jar installsvc

6. 「Complete Installation」と表示されたら、以下のコマンドを入力してEnterキーを押します：

   java -jar lib\ace.jar startsvc

   
7. コマンドプロンプトを終了します。
8. 「UniFi」サービスが実行中であることを確認するには、タスクマネージャーを開き、「サービス」タブでUniFiサービスの状態をチェックします。
9. コントローラーのインターフェースIPアドレスへアクセスし、問題が解決したか確認します。

解決策9：Javaを最新ビルドへ更新する

JavaはUniFiコントローラーソフトウェアの動作に不可欠な要素です。Javaは定期的に更新されており、新技術への対応や既知のバグ修正が行われています。古いバージョンのJavaを使用していると、本エラーが発生する可能性があります。Javaを最新版へ更新することで問題が解決する場合があります。

1. タスクバーのWindows検索ボックスをクリックし、「Java」と入力します。検索結果から「Javaの構成（Configure Java）」をクリックします。
2. 「更新」タブを開き、ウィンドウ右下付近にある「今すぐ更新」ボタンをクリックします。
3. Javaの更新完了後、UniFiコントローラーソフトウェアでエラーが解消されているか確認します。

解決策10：Javaを再インストールする

Javaの更新でも問題が解決しない場合、Javaのインストールが破損しているか、互換性のないバージョンが原因である可能性があります。その場合は、Javaをアンインストールして再インストールすることで問題が解決することがあります。

1. UniFiコントローラーソフトウェアを閉じ、タスクマネージャーで関連プロセスをすべて終了させます（解決策1を参照）。
2. アプリケーションがサービスとしてインストールされている場合は、先にサービスをアンインストールします。
3. タスクバーのWindows検索ボックスに「Control Panel」と入力し、検索結果から「コントロールパネル」を開きます。
4. 「プログラムのアンインストール」をクリックします。
5. インストール済みプログラムの一覧でJavaを右クリックし、「アンインストール」を選択します。画面の指示に従ってアンインストールを完了させます。
6. システムを再起動します。この際、システム起動時にコントローラーアプリケーションが自動的に立ち上がらないよう注意してください。
7. 最新バージョンのJavaをダウンロードしてインストールします（UniFiを正しく動作させるには、Windowsでは64ビット版のJavaをインストールする必要があります）。ファイアウォールからJavaによるネットワーク通信を許可するよう求められた場合は、許可してください。
8. コントローラーアプリケーションを起動し、エラーが解消されているか確認します。

解決策11：UniFiネットワークコントローラーソフトウェアを再インストールする

Javaの再インストールでも問題が解決しない場合、UniFiコントローラーソフトウェア自体のインストールが破損しているか、古くなっている可能性があります。その場合は、コントローラーソフトウェアをアンインストールして再インストールすることで問題を解決できる可能性があります。

1. コントローラーアプリケーションを閉じ、タスクマネージャーで関連プロセスをすべて終了させます（解決策1を参照）。
2. エクスプローラーを起動し、以下のパスへ移動します：

   %userprofile%\Ubiquiti UniFi\data\backup

3. 設定ファイル（.unfファイル）を安全な場所へバックアップします。
4. タスクバーのWindows検索ボックスに「Control Panel」と入力し、検索結果から「コントロールパネル」を開きます。
5. 「プログラムのアンインストール」をクリックします。
6. インストール済みアプリケーションの一覧で、UniFiコントローラーソフトウェアを右クリックし、「アンインストール」を選択します。「設定を保持しますか？」という確認画面が表示されたら、「いいえ」を選択します。
7. 画面の指示に従って、アンインストール処理を完了させます。
8. エクスプローラーを開き、以下のパスへ移動します：

   %userprofile%\Ubiquiti UniFi

9. このフォルダを完全に削除します。
10. 続いて、解決策10の手順に従ってJavaを削除します。
11. 最新版のUniFiネットワークコントローラーソフトウェアをダウンロードしてインストールします。
12. 手順2～3でバックアップした.unfファイルから設定を復元します。
13. UniFiネットワークコントローラーソフトウェアを起動し、エラーが解消されていることを確認しましょう。