このページの内容
 

Marvis Windowsクライアント

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

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

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

ジュニパー MistポータルからWindows用のMarvisクライアント(marvisclient-installer.msiファイル)をダウンロードできます。

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

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

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

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

    Download Marvis Client software for Windows, macOS, and Android from Mobile SDK platform with navigation menu on the left.

  4. marvisclient-installer.zipからmarvisclient-installer.msiファイルを抽出します。

.msiファイルをデバイスのフォルダーに保存します。

Marvis Windowsクライアントのインストールオプション

以下のインストールオプションのいずれかを使用できます。

前提条件

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

  • デバイスにインストールされている.Net Framework Runtime(4.6.2以降)。

    注:

    Marvis Windowsクライアントをインストールした後で、これらのアプリケーションをインストールすることもできます。ただし、後でアプリケーションをインストールするには、デバイスを再起動する必要があります。

  • MarvisクライアントをオンボーディングするためのシークレットトークンまたはQRコード。

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

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

      Juniper Mist dashboard showing Mobile SDK section with token details including name, secret, and creation date, highlighted Token tab, options to View, Send, or Delete, and navigation menu with features like Monitor, Marvis, Clients, Access Points, Switches, WAN Edges, Mist Edges, Private 5G, Location, Analytics, Site, and A/B Testing.

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

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

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

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

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

  • 位置情報サービスを有効にすることで、MarvisクライアントがクライアントデバイスからWi-Fiテレメトリを収集できるようにしました

    ここでの位置情報サービスとは、Windowsで利用可能なデバイスレベルの位置情報設定を指します。クライアントリアルタイム位置情報サービスは、Windowsデバイスではサポートされていないことに注意してください。

    注:

    Windows 11バージョン24H2以降を実行しているデバイスでは、Marvisクライアントは位置情報サービスが有効になっている場合にのみ、無線ネットワークのBSSIDを取得できます。位置情報サービスを無効にすると、Marvisクライアントがスリープ状態に切り替わります。

    この動作は、24H2 より前の Windows 11 バージョンでは異なります。これらのバージョンでは、位置情報サービスのステータスはMarvisクライアントの状態に影響を与えません。Marvisクライアントは、位置情報サービスが有効または無効になっているかどうかに関係なく、無線ネットワークのBSSIDを取得します。位置情報サービスが有効または無効になっている場合、Marvisクライアントは接続された状態のままです。

動作モード

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

  • オンボーディングモード—GUI方式を使用してMarvisクライアントアプリをインストールする場合のデフォルトモード。このモードでは、NACポータルを介してデバイスをオンボーディングできます。

  • テレメトリモード—CLI方式を使用してMarvisクライアントアプリをインストールする場合のモード。このモードは、ライブ環境の標準動作モードです。

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

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

テレメトリモードで動作するようにMarvis Windowsクライアントを設定する

Marvisクライアントをテレメトリモードで動作させるには、CLI方式を使用してMarvis Windowsクライアントをインストールする必要があります。

Marvis Windowsクライアントのインストール(GUI方式)

GUI方式を使用してMarvis Windowsクライアントをインストールすると、Marvisクライアントはオンボーディングモードでインストールされます。Marvis Windowsクライアントをインストールするには:
  1. ジュニパー Mistポータルからダウンロードしたmarvisclient-installer.msiファイルをダブルクリックします。
  2. はいをクリックしてインストールを続行します。
  3. インストールが成功していることを確認します。インストールが完了すると、システムトレイにMarvisアイコンが表示されます。
  4. システムトレイのMarvisアイコンをクリックして、Marvisクライアントアプリを開きます。メニューを表示するには、アイコンを右クリックします。
    System tray with application icons including Microsoft Teams and Bluetooth. Context menu for Marvis Client shows options Open MarvisClient, Status Connected, and Stop Marvis.
これで、Marvisクライアントアプリを使用して、NACポータルからデバイスをオンボーディングできるようになりました。「 Marvis Clientアプリを使用したNACポータルからのクライアントオンボーディング」をご覧ください。

Marvis Windowsクライアントのインストール(CLI方式)

インストール中に高度なカスタマイズを行う場合は、CLIメソッドを使用してMarvisクライアントアプリをインストールできます。

  1. 管理者または管理者権限を持つユーザーとしてコマンド プロンプト ウィンドウを開きます。
  2. marvisclient-installer.msiファイルを保存したフォルダーに移動します。
  3. 以下のオプションのいずれかを使用して、シークレット SDK トークンを使用してクライアントをインストールします。
    注:

    管理者権限を使用して、Marvisクライアントをクワイエットモードでインストールする必要があります。Windows 11 の場合は、msiexec インストール コマンドの最後に/qnクワイエット モード パラメーターを必ず入力してください。Windows 10 の場合、/qn パラメーターの配置に制限はありません。

    • デフォルト設定:

    • カスタム設定:

      表1に示す追加パラメータを設定することで、インストールをカスタマイズできます。以下に例を示します。

      表1:Marvis Clientインストール用のカスタム設定パラメーター

      パラメータ

      説明

      MOBILE_SDK_SECRET

      組織の SDK 招待コードまたはシークレット

      MIST_BATTERY_SAVING

      クライアントがペイロードを送信する頻度を決定します。以下のバッテリー節約モードのいずれかを使用できます。

      • 高: データ送信の頻度を下げると、このモードはバッテリー電力を節約するのに役立ちます。このモードは、更新頻度が低いシナリオに適しています。

      • 標準: このモードはデータとバッテリー消費のバランスを提供し、バッテリー寿命に大きな影響を与えることなく、より頻繁なアップデートを提供します。

      • 低:

        データ転送の頻度が最も高いこのモードでは、ネットワークパフォーマンスに関する最も詳細なインサイトが得られます。ただし、このモードは他のモードに比べてより多くのバッテリー電力を必要とします。
       

      MIST_LOG_LEVEL

      Marvisクライアントのログレベルを定義します。

      MIST_UI_ENABLED

      インストール中にMarvisクライアントUIを非表示(value=True)または表示(value=False)します。デフォルト値は trueです。

      プロキシサーバー設定

      MIST_PROXY_URL

      ポートを含むプロキシサーバーの完全なURL。

      MIST_PROXY_BYPASS_LIST

      プロキシ設定を適用したくないホストのリスト。

      MIST_PROXY_USERNAME

      ユーザー名(プロキシサーバーが認証を必要とする場合に必要)。

      MIST_PROXY_PWD

      パスワード(プロキシサーバーが認証を必要とする場合に必要)
  4. インストールが成功したことを確認します。 Windows向けMarvis Clientのインストールを確認するを参照してください。

Marvis Windowsクライアントをインストールする(設定ファイルの方法)

変換ファイルを使用してMarvisクライアントをインストールできるため、カスタマイズまたは一括インストールできます。
  1. 変換ファイルを設定します。変換ファイル(*.mst)は、デフォルトのインストールをカスタマイズするための設定パラメーターを.msiファイルに提供します。 表1に示した設定パラメーターを使用できます。

    変換ファイルの設定については、[ ORCA Editor (plus alternative tool)] を使用して MSI ファイルを編集する方法を参照してください。

  2. コマンド プロンプト ウィンドウを開き、次のコマンドを入力します。

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

SOTIまたはIntuneモバイルデバイス管理(MDM)ソリューションを使用して、WindowsデバイスにMarvisクライアントを展開できます。開始する前に、すべてのデバイスに適切なMDMプロファイルと権限が割り当てられていることを確認してください。

MDMを使用したデバイスの登録と管理については、以下のトピックを参照してください。

Intune MDMを使用してMarvis Windowsクライアントを展開する

Intune MDMを使用してMarvisクライアントを展開するには、次の手順に従います。

  1. ターゲット デバイスを Intune に登録します。

  2. Intune ポータルに Windows LOB (基幹業務) アプリとして .msi インストーラーを追加します。

  3. 必要なポリシーを設定し、以下のインストール後スクリプトを含めます。

    パラメーターの詳細については、 表1 を参照してください。

    ポリシーの種類(必須または推奨)に応じて、Marvisクライアントアプリが直接インストールされるか、インストールできるオプションのアプリとしてポータルに表示されます。

  4. MDMポータルでインストールステータスを確認して、展開が成功していることを確認します。

IntuneでMarvis Windowsクライアントをアップグレードする

新しいバージョンの Marvis クライアントにアップグレードするには、Intune ポータルで既存の .msi ファイルを最新バージョンに置き換えます。インストール後のスクリプトを変更する必要はありません。更新プログラムが Intune ポータルに反映されるまでに時間がかかる場合があります。

IntuneでMarvis Windowsクライアント設定を更新する

Marvisクライアント設定パラメーターを更新するには、ターゲットデバイスのレジストリ値を変更し、システムを再起動します。この方法では、再インストールせずに設定を更新できます。アプリの機能とユーザー エクスペリエンスをカスタマイズするために、構成スクリプトの更新とレジストリの調整は慎重に行ってください。

  1. 以下のレジストリパスで、Marvisクライアント設定値を更新します。

    パス: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\ジュニパー\Marvis\Config

    値: MOBILE_SDK_SECRET、MIST_BATTERY_SAVING

    パラメーターの詳細については、 表1 を参照してください。

    注:

    Marvisクライアントをインストールした後は、レジストリを介してMIST_UI_ENABLEDパラメーターを更新することはできません。

  2. レジストリ更新スクリプトを作成します。PowerShell を使用して、次に示すようにレジストリ値を更新します。

    PowerShell script setting registry properties MOBILE_SDK_SECRET to a secret token and MIST_BATTERY_SAVING to standard in HKLM SOFTWARE WOW6432Node Juniper Marvis Config.

    一部の設定変更により、デバイスの再起動が必要になる場合があります。必要に応じて、スクリプトの最後にrestartコマンドを含めます。

  3. レジストリ更新スクリプトを展開します。

    デバイス設定>スクリプトに移動して、スクリプトをデバイスグループに割り当てます。

Intune MDMを使用したMarvis Windowsクライアントのアンインストール

Marvisクライアントをアンインストールするには:

  1. Intune でアプリケーションの割り当てを取り消します。ターゲットデバイスにMarvisクライアントのインストールを強制するポリシーを削除します。

  2. CLEAN=trueパラメーターを使用してスクリプトを作成し、Marvisクライアントを完全に削除します。

  3. アンインストールスクリプトを展開します。 デバイス構成 > スクリプト を使用し、PowerShellスクリプトをデバイスグループに割り当てます。

    注:

    アンインストールが完了したら、今後のインストール時に競合が発生しないように、 必ずアンインストール ルールからデバイスを削除してください。

SOTI MDMを使用したMarvis Windowsクライアントの展開

SOTI MDMを使用してMarvisクライアントを展開するには、次の手順に従います。

  1. ターゲットのWindowsデバイスがSOTI MobiControlに登録され、管理コンソールに接続されていることを確認します。

  2. Marvisクライアント用の.msiインストーラをアップロードします。

    1. SOTI MobiControlでアプリケーションを追加に移動し、Windows>エンタープライズアプリを選択します。

    2. Marvisクライアント用の.msiインストーラーを選択して、SOTIサーバーにアップロードします。

  3. Marvisクライアントアプリを、SOTI内の適切なデバイスまたはデバイスグループに割り当てます。導入設定に基づいて、アプリケーションは自動的にインストールされるか、オンデマンドで利用できます。

  4. 設定に必要な環境変数を使用して、SOTIに別のスクリプトジョブを作成します。

SOTIでMarvis Windowsクライアントをアップグレードする

SOTIでMarvisクライアントをアップグレードするには、次の手順に従います。

  1. Marvisクライアントの現在の.msiインストーラを、SOTIの更新されたインストーラに置き換えます。

  2. アプリケーションを再割り当てします。

    ポリシーは、割り当てに従って更新されたインストーラーをデバイスにプッシュします。

SOTIでMarvis Windowsクライアント設定を更新する

レジストリ編集を通じて設定の更新を直接適用できます。

  1. 以下のレジストリパスで、Marvisクライアント設定値を更新します。

    パス: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\ジュニパー\Marvis\Config

    値: MOBILE_SDK_SECRET、MIST_BATTERY_SAVING、MIST_UI_ENABLED

  2. レジストリ更新スクリプトを作成します。PowerShell を使用して、次に示すようにレジストリ値を更新します。

    PowerShell script setting registry properties MOBILE_SDK_SECRET to a secret token and MIST_BATTERY_SAVING to standard in HKLM SOFTWARE WOW6432Node Juniper Marvis Config.

    一部の設定変更では、システムの再起動が必要になる場合があります。必要に応じて、スクリプトの最後にrestartコマンドを含めます。

  3. レジストリ更新スクリプトを展開します。ジョブ機能を使用して、このPowerShellスクリプトをターゲットデバイスに展開します。

SOTI MDMを使用したMarvis Windowsクライアントのアンインストール

Marvisクライアントをアンインストールするには:

  1. SOTIでアプリケーションの割り当てを取り消します。ターゲットデバイスにMarvisクライアントのインストールを強制するポリシーを削除します。

  2. CLEAN=true パラメーターを使用してスクリプトを作成し、Marvis クライアントを完全に削除します。

  3. アンインストールスクリプトを展開します。ジョブ機能を使用して、このPowerShellスクリプトをターゲットデバイスに展開します。

    注:

    クライアントをアンインストールした後は、今後のインストール時に競合が発生しないように、 必ずアンインストール ルールからデバイスを削除してください。

Windows向けMarvis Clientのインストールを確認する

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

  • サービスの確認:

    1. タスクマネージャーを開き、[ サービス ]タブに移動します。または、Windows サービスマネージャー (compmgmt.msc) を使用できます。

    2. MarvisClientサービスが実行されていることを確認します。

      Services tab in Windows Task Manager displaying system services with columns for Name, PID, Description, Status, and Group. MarvisClient highlighted as running with PID 11568.

  • ファイルとシステムレジストリを確認します。

    1. ファイルが C:/Program Files(x86)/ジュニパーネットワークス/Mist/Marvis フォルダにあることを確認します。

      File explorer showing directory path: Windows C: > Program Files x86 > Juniper Networks > Mist > Marvis. Toolbar includes navigation and file sorting options.

    2. システム レジストリに移動し、構成変数が HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\ジュニパー\Marvis\Config の下に表示されていることを確認します。

      Windows Registry Editor displaying path HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Juniper\Marvis\Config with keys MIST_BATTERY_SAVING set to standard, MIST_DEBUG_MODE set to false, and MIST_LOG_LEVEL set to debug.

  • スタートアップフォルダC :\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUpにMarvisクライアントアイコンが表示されていることを確認します。

接続状態

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

Status indicators showing connection states: Connected with green light, Disconnected with red light, Sleep with blue light.

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

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

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

注:Windows 11バージョン24H2以降を実行しているデバイスでは、Marvisクライアントは位置情報サービスが有効になっている場合にのみ、無線ネットワークのBSSIDを取得できます。位置情報サービスを無効にすると、Marvis Clientがスリープ状態に切り替わります。

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

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

  • 情報—一般情報

  • エラー—重大な問題

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

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

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

    User interface of Marvis Client app with dark theme showing menu options: Connection Status, Configuration, Logs, About. DEBUG toggle enabled. Apply and Cancel buttons partially visible.

  2. [ログ] を選択します。ログレベルドロップダウンリストからオプションを選択して、表示する情報のタイプを選択できます。

    選択したログレベルに基づいて最近のログが表示されます。

    Marvis Client logging configuration screen with Log Level dropdown set to debug, View Logs button, and Application Logging toggle turned off.

    コピーボタンをクリックしてログの詳細をコピーし、トラブルシューティングのためにデータをサポートチームに送信できます。

  3. 表示をクリックすると、OS固有のログビューアでMarvisクライアントによってキャプチャされたログが表示されます。
    注:

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

    [バージョン情報]ページの情報は、Marvisクライアントの動作モードによって異なります。

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

Marvis Windowsクライアントをアンインストールする

Marvisクライアントをアンインストールするのは、名前の変更やファイルパスの場所の変更など、大きな変更を行った場合にのみです。軽微なアップデートや組織の変更があった場合、Marvisクライアントをアンインストールする必要はありません。

Marvisクライアントをアンインストールするには:

  1. デバイスで [設定 ] > [アプリ ] に移動します。
  2. アプリケーションのリストから MarvisClient を検索します。
  3. ...をクリックし、アンインストールを選択します。

Marvisクライアントがデバイスからアンインストールされます。

注:

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