Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
項目一覧
 

Marvis Windowsクライアント

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

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

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

Windows向けMarvisクライアント(marvisclient-installer.msiファイル)は、Juniper Mistポータルからダウンロードできます。

Juniper Mist ポータルから .msi ファイルをダウンロードするには、次の手順を実行します。

  1. 左側のメニューから [ Organization > Admin > Mobile SDK (モバイル SDK )] を選択します。

  2. [Mobile SDK] ページの上部にある [ Marvis Client ] をクリックします。

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

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

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

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

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

前提 条件

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

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

    手記：

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

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

    1. 左側のメニューから [ 組織 > 管理 ] > [Mobile SDK ] を選択します。

    2. [Mobile SDK] ページの上部にある [トークン ] をクリックします。

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

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

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

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

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

  • 位置情報サービスが有効

    手記：

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

    この動作は、24H2 より前の Windows 11 バージョンでは異なります。これらのバージョンでは、位置情報サービスのステータスはMarvisクライアントの状態に影響しません。Marvisクライアントは、ロケーションサービスの有効化または無効化に関係なく、無線ネットワークのBSSIDを取得します。Marvisクライアントは、位置情報サービスを有効化または無効化しても、接続状態を維持します。

動作モード

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

  • 運用モード - インストール時にコマンドライン パラメーターを使用して設定できる、ライブ環境向けの標準動作モード。

  • PoC(PoC)モード:テストおよび評価を目的とした動作モードであり、デフォルト モードでもあります。

  • GUIまたは非GUIモード—Marvisクライアントへのビジュアルアクセスを有効または制限するモード。非GUIモードでは、タスクバーのUIまたはアイコンにはアクセスできません。

  • デバッグモード—ログにアクセスするモード。このモードでは設定を編集できません。

手記：

  • 運用モードのときに構成設定を表示する場合は、デバッグ モードに切り替える必要があります。ただし、設定は編集できません。

  • POC モードでは、デバッグ モードに依存せずに構成設定を表示および編集できます。

接続状態

Marvisクライアントのステータスは、以下の視覚的なインジケータと接続状態によって示されます。

  • [切断(Disconnected)]:クライアントは Juniper Mist クラウドに接続されていません。

  • [接続済み(Connected)]:クライアントは Juniper Mist クラウドに接続されています。

  • [接続中(Connecting)]:クライアントはJuniper Mistクラウドへの接続を要求しています。

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

    手記：

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

Marvis Windowsクライアントのインストール(GUIによる)

Marvis Windowsクライアントをインストールするには、次の手順に従います。
  1. Juniper Mist ポータルからダウンロードした marvisclient-installer.msi ファイルをダブルクリックします。
  2. 「はい」をクリックして、インストールを続行します。
  3. インストールが成功したことを確認します。インストールが完了すると、システムトレイにMarvisのアイコンが表示されます。
  4. システムトレイのMarvisアイコンをクリックして、Marvisクライアントアプリケーションを開きます。メニューを表示するには、アイコンを右クリックします。
  5. アプリのハンバーガーアイコンをクリックし、[設定]を選択します。
  6. [Mobile SDK Secret (モバイル SDK シークレット)] 項目に SDK トークンを入力し、[Apply (適用)] をクリックします。デフォルトでは、バッテリー節約モードは標準に設定されており、必要に応じてモードを変更できます。

    バッテリー節約モードは、ペイロードが送信される頻度を決定します。

    • 高: このモードでは、クライアントは 2 分ごとにデータ ペイロードを送信します。データ転送の頻度を減らすと、このモードはバッテリーの電力を節約するのに役立ちます。このモードは、更新の頻度が低いシナリオに適しています。

    • 標準: このモードでは、クライアントは 30 秒ごとにデータ ペイロードを送信します。このモードでは、データとバッテリー消費のバランスが取れており、バッテリーの寿命に大きな影響を与えることなく、より頻繁な更新を提供します。

    • 低: このモードでは、データ ペイロードを 10 秒ごとに送信することで、データ送信の頻度が最大になります。このモードでは、ネットワークパフォーマンスに関する最も詳細な洞察が得られますが、他のモードと比較してより多くのバッテリー電力を消費します。

Marvis Windowsクライアントのインストール(CLIメソッド)

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

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

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

    • デフォルト設定:

    • カスタム構成:

      表 1 にリストされている追加のパラメーターを構成することによって、インストールをカスタマイズできます。次に例を示します。

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

      パラメーター

      形容

      MOBILE_SDK_SECRET

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

      MIST_BATTERY_SAVING

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

      • 高: このモードでは、クライアントは 2 分ごとにデータ ペイロードを送信します。データ転送の頻度を減らすと、このモードはバッテリーの電力を節約するのに役立ちます。このモードは、更新の頻度が低いシナリオに適しています。

      • 標準: このモードでは、クライアントは 30 秒ごとにデータ ペイロードを送信します。このモードでは、データとバッテリー消費のバランスが取れており、バッテリーの寿命に大きな影響を与えることなく、より頻繁な更新を提供します。

      • 低:

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

      生産

      運用モードに基づいて、MarvisクライアントUIにおける機能の表示/可視性を決定します。

      • True: 本番環境の標準操作モードである本番モードを示します。

      • False: テストと評価の目的で使用される概念実証 (POC) モードを示します。

      デフォルト値は False です。

      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クライアントのインストールの確認」を参照してください。

Marvis Windowsクライアントのインストール(構成ファイルによる方法)

変換ファイルを使用してMarvisクライアントをインストールすると、カスタマイズインストールや一括インストールが可能になります。
  1. 変換ファイルを設定します。変換ファイル (*.mst) は、既定のインストールをカスタマイズするための構成パラメーターを含む .msi ファイルを提供します。表 1 にリストされている構成パラメーターを使用できます。

    変換ファイルの設定については、「 [ORCA Editor (および代替ツール)]を使用して MSI ファイルを編集する方法」を参照してください。

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

MDMを使用したWindowsデバイスへのMarvisクライアントの導入

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

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

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

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

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

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

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

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

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

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

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

Intune で Marvis Windows クライアント構成を更新するUpdate the Marvis Windows Client Configuration in Intune

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

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

    パス:HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Juniper\Marvis\Config

    値: MOBILE_SDK_SECRET、MIST_BATTERY_SAVING、PRODUCTION

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

    手記：

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

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

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

  3. レジストリ更新スクリプトをデプロイします。

    [ デバイス構成 > Scripts ]に移動して、スクリプトをデバイスグループに割り当てます。

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\Juniper\Marvis\Config

    値: MOBILE_SDK_SECRET、MIST_BATTERY_SAVING、PRODUCTION、MIST_UI_ENABLED

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

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

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

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

Marvisクライアントをアンインストールするには、次の手順に従います。

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

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

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

    手記：

    クライアントをアンインストールした後は、今後のインストール時の競合を回避するために、 アンインストール 規則からデバイスを削除してください。

Windows向けMarvisクライアントのインストールの確認

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

  • サービスの検証:

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

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

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

    1. ファイルが 「C:/Program Files(x86)/Juniper Networks/Mist/Marvis 」フォルダにあることを確認します。

    2. システムレジストリに移動し、設定変数が HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Juniper\Marvis\Configにリストされていることを確認します。

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

Marvis Windowsクライアントでのログの表示

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

  • [情報(Info)]:一般情報

  • エラー - 重大な問題

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

Marvis Windowsクライアントアプリでログを表示するには、アプリでデバッグモードを有効にする必要があります。
  1. ハンバーガーアイコンをクリックし、次にMarvisアイコンを7回クリックします。
    パスワードの入力を求められます。
  2. AIDrivenのようにパスワードを入力します。

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

  3. [ログ] を選択します。表示する情報のタイプを選択するには、「ログ・レベル」ドロップダウン・リストからオプションを選択します。

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

    「コピー」ボタンをクリックすると、ログの詳細がコピーされ、トラブルシューティングのためにサポートチームにデータが送信されます。

  4. [View]をクリックすると、MarvisクライアントによってキャプチャされたログがOS固有のログビューアに表示されます。
    手記：

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

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

    • 実稼働モード—アプリケーションバージョン、UUID、組織名

    • POC およびデバッグモード — アプリケーションバージョン、UUID、Mobile SDK シークレット、組織 ID、組織名

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

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

Marvisクライアントをアンインストールするには、次の手順に従います。

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

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

手記：

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