Skip to main content
このガイドはMacコンピュータとWindowsコンピュータに適用されます

エージェントのチェックインの問題について

Iru Endpointに登録されているmacOSおよびWindowsコンピュータは、さまざまな管理タスクにIru Agentを使用します。エージェントは15分ごとにチェックインを試みます。デバイスが期待どおりにチェックインしない場合は、次の手順で通信を回復できる場合があります。
2026年4月8日をもって、アプリのブランドがKandji からIru に更新されました。アプリ名はKandji Self ServiceからIru Self Serviceに、Kandji AgentからIru Agentに変更されました。手動登録ポータルでもIruのブランドが使用されるようになりました。古いアプリ名を参照しているスクリプト、自動化、ユーティリティを更新してください。

仕組み

Iru AgentはIru Endpointサーバーと通信し、構成の更新、ポリシーの変更、アプリケーションの展開を受け取ります。チェックインが失敗すると、デバイスが重要な更新を受け取れず、コンプライアンスの問題や古い構成につながる可能性があります。

インターネット接続を確認する

デバイスがアクティブなインターネット接続を持ち、エンタープライズネットワークでのIruの使用に記載されているドメインとポートにアクセスできることを確認します。 簡単なトラブルシューティングの手順として:
  • デバイスをモバイルホットスポットなどの別のネットワークに接続してみます
  • チェックインが再開した場合、問題は元のネットワークのフィルタリングまたはファイアウォールの構成にある可能性があります

プラットフォーム固有のトラブルシューティング

チェックインを強制する(macOS)

Self Service

  • エンドユーザーはIru Self Serviceを開き、Device Infoに移動して同期を選択できます

コマンドライン

  • ターミナルで次のコマンドを実行して、チェックインを強制します。
出力に追加の詳細が表示される場合があります。

Iru Agentを再インストールする

macOSでは、IruウェブアプリからIru Agentを再インストールできます。
1

デバイスレコードにアクセスする

Iruウェブアプリでデバイスレコードに移動します
2

Agentを再インストールする

デバイスアクションメニューからReinstall Agentを選択します
3

インストールの状態を監視する

アクティビティタブで状態を監視します。InstallEnterpriseApplication MDMコマンドを探します
コマンドがNotNow(デバイスがビジー状態)を返す場合:
  • Macにユーザーがログインしていて電源に接続されていることを確認してから、再試行してください。Appleの開発者向けドキュメントを参照してください

再起動に関する考慮事項

  • 再起動後、macOSがアップデートやバックグラウンドタスクを完了できるように、Iruはチェックインまで最大30分待機する場合があります

エージェントの状態の確認

エージェントの状態を確認します。

再起動

デバイスを再起動すると、停止したプロセスが解消され、Iru Agentが通常のチェックインを再開できる場合があります。

再登録

上記の手順で問題が解決しない場合は、デバイスを手動で再登録します。
1

既存の登録を削除する

既存のMDM登録を削除します
2

デバイスを再登録する

正しい登録コードを使用して再登録します
デバイスを登録する際は、正しいBlueprintが選択されていることを確認してください。別のBlueprintが選択された場合、デバイスにはそのBlueprintに割り当てられたLibrary Itemsとパラメータが適用されます。再登録後にデバイスレコードが重複することはありません。Iru Endpointは新しい登録を既存のデバイスレコードに関連付けます。

高度なトラブルシューティング

ログで次の点を確認します。
  • インストールエラー
  • ポリシーの失敗
  • 通信の問題
  • ネットワーク接続の問題

ネットワーク診断

1

接続をテストする

ネットワーク診断ツールを使用して、Iruサービスへの接続をテストします
2

ファイアウォールを確認する

ファイアウォールのルールでIruドメインとの通信が許可されていることを確認します
3

DNSをテストする

IruドメインのDNS名前解決が機能していることを確認します
4

プロキシを確認する

該当する場合は、プロキシの設定を確認します

一般的な問題と解決策

症状:
  • Iruでデバイスがオフラインと表示される
  • デバイスレコードに最近のチェックインがない
  • ポリシーが適用されない
解決策:
  • インターネット接続を確認する
  • デバイスを再起動する
  • 手動でチェックインを強制する
  • 必要に応じてエージェントを再インストールする
症状:
  • エージェントのログにエラーメッセージがある
  • ネットワーク接続の問題
  • ファイアウォールが通信をブロックしている
解決策:
  • ネットワーク接続を確認する
  • ファイアウォールのルールを確認する
  • 別のネットワークでテストする
  • エージェントのログで具体的なエラーを確認する
症状:
  • 登録後にエージェントがインストールされていない
  • ログにインストールエラーがある
  • デバイスがIruに表示されない
解決策:
  • デバイスが要件を満たしていることを確認する
  • 登録中のネットワーク接続を確認する
  • インストールログを確認する

ベストプラクティス

定期的に監視する

デバイスのチェックインのステータスを定期的に監視し、問題を早期に特定します

接続をテストする

管理対象デバイスからIruサービスへのネットワーク接続をテストします

ログを確認する

エージェントのログを定期的に確認して、潜在的な問題を見つけます

問題を記録する

繰り返し発生する問題とその解決策を記録し、今後の参考にします