Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
項目一覧
 

Marvis Androidクライアント

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

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

Marvis Androidクライアントは、次のデバイスでサポートされています。

  • Android 8.0 以降のバージョンを搭載する Android ハンドヘルド デバイスおよびスマートフォン

  • Android 8.0 以降のバージョンを実行する Zebra デバイス

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

次のいずれかの方法を使用して、アプリをインストールできます。

  • 手動—MarvisクライアントアプリをGoogle PlayストアまたはJuniper Mistポータルから直接ダウンロードしてインストールします。

    Juniper Mist ポータルからクライアントをダウンロードするには、次の手順を実行します。

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

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

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

  • Android Debug Bridge(ADB)- デベロッパーが Android デバイスと通信して問題をデバッグし、アプリをインストール / アンインストールするために使用できるコマンドライン ツールである ADB を使用してアプリをインストールします。

  • モバイルデバイス管理(MDM) - 以下のMDMソリューションのいずれかを使ってAppをインストールします:

    • AirWatchまたはVMware Workspace ONE

    • ソティ

    手記：

    上記のMDMとの相互運用性のみをテストしました。

必要条件

インストールを開始する前に、次のことを行ってください。

  • アプリの表 1 に記載されている必須のアクセス許可を有効にします。

    表1: Android用Marvisクライアントアプリに必要な権限

    許可

    形容

    必須またはオプション

    [場所(Location)]:[常に許可(Allow all time)] に設定します。

    MarvisクライアントアプリがWi-Fiローミングデータを取得し、期待どおりに機能するようにします。

    必須

    Bluetooth

    アプリが位置の x 座標と y 座標を取得できるようにします。

    必須

    近くのデバイス

    アプリが近くのデバイスの相対的な位置を特定できるようにします。Android 12 でモバイル端末で位置情報サービスを実行するには、この権限を有効にする必要があります。

    必須

    通知

    Marvisクライアントがバックグラウンドでアクティブに実行されているときに通知を受け取る場合は、通知を有効にします。

    随意

    [カメラ(Camera)]:[一度だけ許可(Allow Once)] に設定

    登録時にQRコードをスキャンできます。ADB または MDM を使用してアプリをインストールする場合は、このアクセス許可を有効にする必要はありません。

    随意

  • Marvisクライアントが組織に接続できるように、ネットワーク ファイアウォール設定を行います。

    組織がアマゾン ウェブ サービス (AWS) クラウド (既定) にある場合は、次の設定を使用します。

    • ドメイン/パスの wss://client-terminator.mistsys.net:443/ws またはプロトコル WSS (websocket) ポート 443

    • ドメインの https://api.mist.com または HTTPS プロトコル ポート 443

    組織が Google Cloud Platform (GCP) クラウドにある場合は、次の設定を使用します。

    • ドメイン/パスの wss://client-terminator.gc1.mist.com/ws またはプロトコル WSS (websocket) ポート 443

    • ドメインの https://api.gc1.mist.com/ または HTTPS プロトコル ポート 443

    手記：

    組織がAWSまたはGCP以外のクラウドに存在する場合、ファイアウォール設定を構成するための適切なURLについてサポートチームにお問い合わせください。

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

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

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

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

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

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

    手記：APIを使用してシークレットトークンを取得するには、「 SDK招待の作成」を参照してください。

ベストプラクティスとして、ランダムMACアドレスを無効にすることをお勧めします。これにより、ネットワークに接続するたびにデバイスを再登録する必要がなくなります。ランダムMACアドレスを無効にするには:

  1. デバイスの [設定] ページに移動します。

  2. 「 ネットワークとインターネット 」または 「接続 」をタップし、「 Wi-Fi」をタップします。

  3. ワイヤレス接続の横にある歯車(設定)アイコンをタップします。

  4. [MAC アドレスの種類] をタップし、[電話 MAC] をタップします。

動作モード

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

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

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

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

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

手記：

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

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

接続状態

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

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

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

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

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

SOTI MDMを使用したMarvisクライアントの導入

モバイルデバイス管理(MDM)ソリューションを使用してMarvisクライアントを展開するには、Androidパッケージキット(APK)パッケージの展開をカスタマイズする必要があります。インテント アクションを使用して APK デプロイをカスタマイズし、インストール時に秘密のソフトウェア開発キット(SDK)トークンを設定します。カスタマイズされたアプリケーション パッケージを起動すると、クライアントは完全に事前構成され、操作用にオンボードされます。

Marvisクライアントは、SOTI MDMを使用してオンボードできます。

手記：

SOTIでは、一般的なAndroidアプリケーション導入プロセス全体は示しません。ここでは、AndroidアプリケーションをカスタマイズしてMarvisクライアントの導入を完了するために必要な情報のみを提示します。

開始する前に、以下を実行します。

  1. Windows デバイスまたは仮想マシン (VM) があることを確認します。Package Studio は、Windows デバイスでのみ実行されます。

  2. SOTI の MobiControl Package Studio (McStudio.exe) をダウンロードしてください。

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

  1. Windows デバイスまたは VM で Package Studio を起動し、次の設定でパッケージ プロジェクトを作成します。

    • プロセッサ - All (特定の CPU またはデバイスタイプをターゲットとしている場合を除く)

    • プラットフォームAndroid

    • OSバージョン:8 以降

    • バージョン文字列 - APK のバージョンと同じ

    • ベンダー:ジュニパーネットワークス

    • オプションのスペース要件の仕様

  2. MarvisクライアントAPKを追加します。
  3. 次のスクリプト ファイルを追加します。

    • スクリプトエンジン - レガシー

    • スクリプト タイプ - インストール後

  4. スクリプト ファイルをインポートします。スクリプト ファイルには、次の内容が含まれている必要があります。

    Zebra デバイスの特定のポートを音声通話用に構成した場合、スクリプト ファイルには次の内容が含まれている必要があります。

  5. パッケージをビルドします。

SOTIを使用してカスタマイズしたパッケージを展開すると、Marvisクライアントが事前設定され、オンボーディングされます。

AirWatchまたはVMware Workspace ONEを使用したMarvisクライアントの導入

AirWatch を使用した一般的な Android アプリの展開プロセス全体については説明しません。ここでは、Marvisクライアントの導入を完了するために必要な具体的な手順についてのみ説明します。

次のインテントコマンドを使用して、クライアントをデプロイします。

Zebraデバイスの特定のポートを音声通話用に構成している場合は、次のインテントコマンドを使用します。

次のリファレンスを使用して、インテントコマンドをデプロイできます。

他のMDMを使用したMarvisクライアントの導入

他のMDMを使用している場合は、MDMがインテント実行をサポートしていることを確認します。以下は、選択した MDM に適応するために使用できる Android Debug Bridge(ADB)ベース(デベロッパー/デバッグ)デプロイのサンプルです。

MDMソリューションがAndroidインテントの実行をサポートしていない場合は、展開された各クライアントデバイスを手動でオンボーディングする必要がある場合があります。 Marvisクライアントのオンボードと設定を参照してください。

インストールの確認

Marvisクライアントをインストールしてオンボードしたら、これらのプロセスが正しく実行されていることを確認します。デバイスがMist Wi-Fiネットワークに接続されていることを確認します。

インストールを確認するには:

  • シークレットトークン値が正しく適用されていることを確認します。Marvisクライアントアプリの[バージョン情報]または[設定]ページ(非本番モードの場合)に移動し、シークレットトークン値がまだフィールドに保存されていることを確認します。

    データが保持されず、シークレットトークンフィールドが空の場合は、シークレットトークン値を手動で入力します。また、アプリケーション データを保持するようにアプリケーションのデプロイを構成する必要がある場合もあります。

  • Marvisクライアントをオンボードしてから約15分後に、MarvisクライアントのデータがJuniper Mistポータルで利用できることを確認します。Marvisクライアントのオンボーディング後、データがJuniper Mistクラウドに伝播されるまで、最低でも10分から15分は待つ必要があります。

    データを収集してJuniper Mistクラウドに送信するクライアントワークフローで問題が発生した場合、クライアントデータはJuniper Mistポータルで利用できません。サポートチームにお問い合わせください。Marvisクライアントアプリでログにアクセスできます。 Marvis Androidクライアントでのログの表示を参照してください。または、LogcatやAndroid Debug Bridge(ADB)などのツールを使用してMarvisクライアントログを収集し、サポートチームと共有することもできます。

    Zebra デバイスの場合は、ログを収集する代替方法として RxLogger ツールを使用できます。

    サポートチームに連絡する際は、MarvisクライアントUUIDを共有する必要があります。UUIDは、Marvisクライアントアプリの [バージョン情報 ]ページで確認できます。UUIDは、MarvisクライアントからJuniper Mistクラウドへのデータフローを追跡するために使用されます。

Marvisクライアントのオンボーディングと設定

アプリをインストールしたら、アプリをオンボードして構成する必要があります。
  1. Juniper Mist ポータルの [Organization > Mobile SDK] ページに移動し、 [トークン] タブを選択して、シークレット トークンまたは QR コードを見つけます。[表示] をクリックして QR コードを表示します。
  2. Marvis Clientアプリを開きます。
  3. ハンバーガーアイコンをタップし、[設定]をタップします。
    [Configuration] ページが表示されます。

  4. [Mobile SDK Secret (モバイル SDK シークレット)] 項目の横にある QR コードアイコンをタップします。Juniper Mistポータルに表示されるQRコードにデバイスのカメラの焦点を合わせます。
    アプリケーションは QR コードをスキャンし、一致する秘密トークン値を [Mobile SDK の秘密 ] 項目に挿入します。
  5. 次のパラメータの値を入力します。

    • ロケーションの可視性

      デフォルトでは、[場所の表示設定] は [オフ] に設定されています。位置情報の可視化を有効にすると、デバイスは Juniper Mist ポータルの [クライアント > アプリ クライアント ] ページにアプリ クライアントとして 5 秒間表示されます。表示頻度は次のように設定できます。

      • [低(Low)]:10 分ごとに表示されます。

      • 標準(推奨):5 分ごとに表示されます。

      • [高(High)]:1 分ごとに表示されます。

      手記：

      ロケーションの可視化を有効にするには、アクセスポイント(AP)でvBLEを有効にする必要があります。vBLEを有効にするには、ユーザーエンゲージメントまたはアセットの可視化サブスクリプション、またはその両方のサブスクリプション(Wireless Assuranceの基本サブスクリプションに加えて)を購入します。

    • モバイルクライアント名

    • モバイル音声通話ポート(Zebraデバイスにのみ適用可能)

  6. 「適用」をタップして、設定を保存します。

    アクセス許可をまだ設定していない場合は、アクセス許可の要求が表示されます。 表 1 にリストされているアクセス許可を有効にします。 位置情報 のアクセス許可を [常に許可] に設定していることを確認します。

  7. ハンバーガーアイコンをタップし、[接続ステータス]をタップして[接続ステータス]ページを表示します。

    ステータスが [接続済み] と表示されていることを確認します。

    これで、Marvisクライアントは、Juniper Mistポータルにデータを送信するための準備が整いました。Juniper Mist ポータルにデータが表示されるまで、約 15 分待つ必要があります。

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

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

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

  • エラー - 重大な問題

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

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

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

  3. 「ログ」をタップします。
  4. [View Logs](ログの表示)を有効にすると、Marvisクライアントによってキャプチャされたログが表示されます。「ログ・レベル」ドロップダウン・リストから、表示する情報のタイプを選択できます。
    [コピー]ボタンをクリックすると、ログの詳細をコピーしてサポートチームに送信でき、トラブルシューティングに役立ちます。
    手記：

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