Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
このページの内容
 

Marvis macOSクライアント

事前インストールタスクを完了し、macOSデバイスへのMarvisクライアントのインストールに使用する方法を選択します。

macOS向けMarvisクライアントは、macOSデバイスが無線ネットワークとどのように相互作用するかを詳細に可視化します。デバイスの接続性とパフォーマンスに関するインサイトにより、Marvisクライアントはネットワークパフォーマンスの最適化、トラブルシューティングの合理化、全体的なユーザーエクスペリエンスの向上を支援します。

Marvis macOSクライアントのインストールの概要

インストーラーファイルは、ジュニパーMistポータルからダウンロードできます。ジュニパー Mistポータルからインストーラーファイルをダウンロードするには、次の手順に従います。

  1. 左側のメニューから組織>管理>モバイルSDKを選択します。

  2. モバイルSDKページの上部にある Marvis Client をクリックします。

  3. MacOSで、アプリのバージョンを選択し、[ インストーラーのダウンロード]をクリックします。

    *.dmgインストーラーファイルをデバイスのフォルダーに保存する必要があります。

前提条件

開始する前に、以下のものが必要です。

  • Marvisクライアントをオンボーディングするためのシークレットトークン

    シークレットコードを取得するには:

    1. ジュニパー Mistポータル の左側のメニューから組織> 管理 > モバイルSDK を選択します。

    2. モバイルSDKページの上部にある トークン をクリックします。

    3. 新しいトークンを作成するか、既存のトークンを使用します。

      • 新しいトークンの場合— 招待を作成をクリックします。この招待状の名前を入力し、 作成をクリックします。トークンがページに表示されたら、[ 表示 ]をクリックしてQRコードを表示します。

      • 既存のトークンの場合—トークン名を参照して、使用するトークンを見つけます。ページの右側にある[ 表示 ]リンクをクリックすると、QRコードが表示されます。

      注:APIを使用してシークレットトークンを取得するには、 https://api.mist.com/api/v1/docs/Org#sdk-invite を参照してください。

  • デバイスで実行されているmacOS 14.6以降のリリース

  • インストールに必要な管理者権限

Marvis Client(macOS)のインストールオプション

macOS向けMarvisクライアントは、以下のいずれかの方法でインストールできます。

動作モード

Marvisクライアントは、以下のモードで動作します。

macOS用Marvis Clientをインストールする(CLI方法)

CLI方式を使用してMarvis macOSクライアントをインストールすると、Marvisクライアントはテレメトリモードでインストールされます。CLIを使用してmacOS用Marvisクライアントをインストールするには:

  1. .dmgファイルから.pkgファイルを抽出します。
  2. Command + Space キーを押して、Spotlight 検索ウィンドウを開きます。
  3. タイプTerminal検索結果にターミナルアプリが表示されます。
  4. ターミナルアプリをダブルクリックします。
  5. 以下のコマンドを実行します。

    以下のパラメーターの値を設定します。

    必須パラメータ:

    • token-value—シークレットトークンを指定します。

    オプションのパラメーター:

    • --ui-mode-enabled <true|false> or -ui <true|false>—UIモードを有効または無効にします。デフォルトでは、UIモードが有効になっています。

    • --auto-upgrade-allowed <true|false—自動アップグレードを有効または無効にします。デフォルトでは、このオプションは無効になっています。

    • --force or -f現在の設定に関係なく強制的に再起動します

  6. プロンプトが表示されたら、管理者パスワードを入力します。
  7. インストールが成功していることを確認します。インストールの確認を参照してください。
    インストールが正常に完了すると、Marvisクライアントアプリが開きます。ステータスバーにMarvisクライアントアイコンが表示されています。Marvisクライアントの屋内位置情報サービス：を有効にするように求められます。このコンテキストでの屋内位置情報サービス：は、macOSで使用できるデバイスレベルの位置情報設定を指すことに注意してください。クライアントリアルタイム位置情報サービスは、macOSデバイスではサポートされていません。
  8. 許可を選択します。MarvisクライアントがクライアントデバイスからWi-Fiテレメトリを収集するには、位置情報のパーミッションが必要です。

    Marvis Clientをインストールした後、屋内位置情報サービス：が自動的に有効にされない場合は、次の手順に従います。

    1. [システム設定]>[プライバシー>屋内位置情報サービス：に移動します。

    2. Marvis Clientの位置情報サービスを有効にします。

macOS用Marvis Clientのインストール(GUI方式)

GUI方式を使用してMarvis macOSクライアントをインストールすると、Marvisクライアントはオンボーディングモードでインストールされます。macOS用Marvisクライアントをインストールするには:

  1. .dmgファイルをダブルクリックし、.pkgファイルをダブルクリックして、インストールプロセスを開始します。
  2. 続行をクリックします。
  3. [同意する]をクリックしてライセンス契約に同意します。
  4. インストールをクリックします。

    Marvisクライアントがオンボーディングモードでインストールされます。テレメトリモードに切り替える場合は、次の手順に進みます。

  5. Command + Space キーを押して、Spotlight 検索ウィンドウを開きます。
  6. Terminalと入力します。
    検索結果にターミナルアプリが表示されます。
  7. ターミナルアプリをダブルクリックします。
  8. 以下のコマンドを実行します。

    以下のパラメーターの値を設定します。

    必須パラメータ:

    • token-value—シークレットトークンを指定します。

    オプションのパラメーター:

    • --ui-mode-enabled <true|false> or -ui <true|false>—UIモードを有効または無効にします。デフォルトでは、UIモードが有効になっています。

    • --auto-upgrade-allowed <true|false—自動アップグレードを有効または無効にします。デフォルトでは、このオプションは無効になっています。

    • --force or -f現在の設定に関係なく強制的に再起動します

    • --yes または -y - 強制再起動の確認プロンプトをスキップします。これは、サイレントまたはMDMインストール中に役立ちます。

  9. インストールが成功していることを確認します。インストールの確認を参照してください。
    インストールが正常に完了すると、Marvisクライアントアプリが開きます。ステータスバーにMarvisクライアントアイコンが表示されています。Marvisクライアントの屋内位置情報サービス：を有効にするように求められます。
  10. 許可を選択します。Marvisクライアントが正しく機能するには、位置情報サービスを有効にする必要があります。

    Marvis Clientをインストールした後、屋内位置情報サービス：が自動的に有効にされない場合は、次の手順に従います。

    1. [システム設定]>[プライバシー>屋内位置情報サービス：に移動します。

    2. Marvis Clientの位置情報サービスを有効にします。

オンボーディング用にMarvis Clientを設定する

Marvis Clientアプリを使用して、カスタムNAC(ネットワークアクセス制御)ポータルを介して、デバイスをジュニパー Mist Access Assuranceネットワークにオンボーディングできます。詳細については、「 Marvis Clientアプリを使用したNACポータルを介したクライアントのオンボーディング」を参照してください。

テレメトリモードで動作するようにMarvis Clientを設定する

Marvisクライアントは、デフォルトでオンボーディングモードで動作するように設定されています。Marvisクライアントをテレメトリモードで動作させるには、次のコマンドを使用します。

marvis-cli --token-value <token>

MDMを使用してmacOSデバイスにMarvis Clientを展開する

SOTI、Intune、またはJamfのモバイルデバイス管理(MDM)ソリューションを使用して、macOSデバイスにMarvisクライアントを展開できます。MDMを使用したデバイスの登録と管理については、以下のトピックを参照してください。

Marvisクライアントを展開するには:

  1. 適切なMDMプロファイルを使用してターゲットデバイスまたはデバイスグループを登録します。

  2. MDM ポータル内で必要なプロファイルまたはアプリケーション ポリシーを構成します。

  3. Marvisクライアント.pkgインストーラーファイルをMDMポータルにアップロードし、ターゲットデバイスまたはデバイスグループにファイルを割り当てます。

  4. インストールが完了したら、MDMポータルからデバイスに構成スクリプトを送信します。

MDMを使用してmacOS向けMarvis Clientをアップグレードする

新しいバージョンのMarvisクライアントにアップグレードするには、更新された.pkgファイルをMDMポータルにアップロードし、アプリケーションポリシーをターゲットデバイスまたはデバイスグループに再割り当てします。設定スクリプトを再送信する必要はありません。

MDMを使用してmacOS用のMarvis Client設定を更新する

Marvisクライアント設定パラメーターを更新するには、更新されたパラメーターを使用して設定スクリプトを再送信します。

MDMを使用してmacOS用Marvis Clientをアンインストールする

MDMを使用してMarvisをアンインストールするには:

  1. アプリケーション ポリシーの割り当てが必須のアプリ インストールを強制する場合は、削除します。

  2. アンインストールスクリプトをデバイスに送信します。

    一部のMDMポータルでは、アプリが 「インストール済み」 と表示される場合があります。ポリシーを削除した後、しばらく待ってから、アプリの状態を確認します。

    注:

    アンインストールプロセスで、すべてのログファイルとフォルダーが削除されない場合があります。必要に応じて、ファイルを手動で削除することを選択できます。Marvisクライアントをすべてのログと設定ファイルとともに完全に削除するには、次のコマンドを使用します。

接続状態

Marvisクライアントのステータスは、以下の視覚的なインジケーターと接続状態によって示されます。これらの状態は、Marvisクライアントがテレメトリモードの場合にのみ表示できることに注意してください。

  • 切断—クライアントはジュニパーMistクラウドに接続されていません。

  • 接続済み—クライアントはジュニパーMistクラウドに接続されています。

  • スリープ—クライアントは、ジュニパー以外のAPを介してジュニパーMistクラウドに接続されています。

インストールを確認する

以下のオプションのいずれかを使用して、Marvisクライアントが正常にインストールされたことを確認します。

  • Marvisクライアントがアプリケーションディレクトリに存在することを確認します。

  • バックグラウンドサービスを確認します。

    1. ターミナルアプリを開き、次のコマンドを実行します。

    2. プロンプトが表示されたら、管理者パスワードを入力します。

    3. サービスエントリーが存在することを確認します。

  • Marvis Clientがアクティビティモニターのサービスタブに表示されていることを確認します。

    Marvis Clientが表示されない場合は、Marvisクライアントを再インストールします。それでも問題が解決しない場合は、サポートチームにお問い合わせください。

インストール後、システムトレイまたはメニューバーにMarvisアイコンが表示されます。アイコンをクリックしてMarvisクライアントを開き、接続ステータスを表示できます。

サービスの管理

以下に、以下のメインのMarvisクライアントシステムサービスを管理するために使用できるコマンドを示します。

  • メインサービス:com.mist.MarvisClient

  • 特権ヘルパー:com.mist.MarvisClient.MarvisPrivilegedHelper

  • サービス開始:

  • サービスを再起動します。

  • ログサービス:

  • バージョンサービス:

Marvis macOSクライアントでログを表示する

Marvis macOSクライアントは、ログを次のように分類します。

  • 情報—一般情報

  • エラー—重大な問題

  • デバッグ—問題のデバッグに使用できる詳細データ

Marvis macOSクライアントでログを表示するには、デバッグモードを有効にする必要があります。
  1. ハンバーガーアイコンをクリックし、[バージョン情報]を選択し、バージョン番号を7回タップします。

    メニューに [ログ] オプションが表示されます。

  2. [ログ] を選択します。ログレベルドロップダウンリストからログカテゴリを選択します。
    選択したログレベルに基づいて最近のログが表示されます。 コピー ボタンをクリックしてログの詳細をコピーし、トラブルシューティングのためにサポートチームに情報を送信できます。

  3. 表示をクリックすると、OSネイティブウィンドウにMarvisクライアントによってキャプチャされたログが表示されます。
    注:

    問題の解決のためにジュニパー Mistサポートチームに連絡する場合、組織ID、UUID、組織名などの詳細情報の提供を求められる場合があります。これらの詳細は、ハンバーガーメニューからアクセスできる [バージョン情報 ]ページに記載されています。

    [About]ページの情報は、動作モードによって異なります。

    • オンボーディングモード—アプリケーションのバージョンとUUID、ユーザー情報、組織名
    • テレメトリモード—アプリケーションのバージョンとUUID、ユーザー情報、組織名
    • デバッグモード - アプリケーションのバージョンとUUID、ユーザー情報、組織名、組織ID

Marvis macOSクライアントをアンインストールします

Finder(GUI)またはCLIを使用して、Marvis macOSクライアントをアンインストールできます。CLI方式では、クリーンアンインストールオプションを提供し、残留ファイルや設定を削除できます。

Marvis macOSクライアントのアンインストール(GUI)

GUI方式により、ユーザーフレンドリーにMarvisクライアントをアンインストールできます。

  1. Marvis Clientアプリケーションを開きます。

  2. [バージョン情報] ページに移動します。

  3. アン インストール をタップして、Marvisクライアントをアンインストールします。

    注:アン インストールオプションは、Marvis macOSクライアントバージョン1.1.0以降で使用できます。

CLIを使用してMarvis macOSクライアントをアンインストールする

CLI方式では、Marvisクライアントの標準アンインストールとクリーンアンインストールの両方を上級ユーザーに柔軟に提供できます。この手順には、管理者権限が必要です。プロンプトが表示されたら、管理者パスワードを入力します。

標準アンインストール

アプリケーションのみを削除するには(設定ファイルなし):

  1. ターミナルを開きます。

  2. 次のコマンドを実行します。

    • 標準アンインストールの場合:

    • クリーンアンインストールの場合:

クリーンアンインストール

Marvisクライアント(すべての残留ファイルと設定を含む)を完全に削除するには、次の手順に従います。

  1. バージョン情報ページでバージョン番号を7回タップして、デバッグモードを有効にします。

  2. アン インストールをタップします。

    注:アン インストールオプションは、Marvis macOSクライアントバージョン1.1.0以降で使用できます。

  3. これらのオプションの両方を有効にし、 アンインストール をタップして続行します。

    • 設定プロファイルの削除

    • クリーンアンインストール