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クライアントのインストールの概要

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

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

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

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

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

前提 条件

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

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

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

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

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

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

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

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

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

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

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

Marvisクライアントのインストールオプション(macOS)

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

動作モード

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

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

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

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

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

手記：

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

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

接続状態

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

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

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

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

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

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

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

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

    の値を設定します。

    • token_value (必須)—シークレット トークンを指定します。

    • mist_ui_enabled (オプション):UI を非表示にする場合は、値を false に設定します。

    • production_mode (オプション)—動作モードを設定します。MarvisクライアントUIに表示される機能の表示は、運用モードによって異なります。

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

      • False (既定値): テストと評価を目的とした概念実証 (POC) モードを示します。

  6. プロンプトが表示されたら、管理者パスワードを入力します。
  7. 位置情報サービスを有効にします。

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

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

  8. インストールが成功したことを確認します。「インストールの確認」を参照してください。

macOS向けMarvisクライアントのインストール(GUIによる方法)

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

  1. .dmg ファイルをダブルクリックし、.pkgファイルをダブルクリックしてインストール プロセスを開始します。
  2. [続行] をクリックします。
  3. 「インストール」をクリックします。
  4. 位置情報サービスを有効にします。

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

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

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

    の値を設定します。

    • token_value (必須)—シークレット トークンを指定します。

    • mist_ui_enabled (オプション):UI を非表示にする場合は、値を false に設定します。

    production_mode(オプション)—動作モードを設定します。MarvisクライアントUIに表示される機能の表示は、運用モードによって異なります。

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

    • False (既定値): テストと評価を目的とした概念実証 (POC) モードを示します。

  9. インストールが成功したことを確認します。「インストールの確認」を参照してください。

    インストールが完了すると、ステータスバーにMarvisのアイコンが表示されます。

  10. ハンバーガーアイコンをクリックし、[設定]を選択します。
  11. [Mobile SDK Secret (モバイル SDK シークレット)] 項目に SDK トークンを入力し、[Apply (適用)] をクリックします。

    デフォルトでは、バッテリー節約モードは標準に設定されており、必要に応じてモードを変更できます。このモードは、ペイロードが送信される頻度を決定します。

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

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

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

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

Marvisクライアントは、SOTI、Intune、またはJamfのモバイルデバイス管理(MDM)ソリューションを使用して、macOSデバイスに展開できます。

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

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

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

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

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

    Marvisクライアントに対して屋内位置情報サービス\を許可するように求められます。アプリケーションが正しく機能するにはアクセス許可が必要なため、[ 許可] を選択する必要があります。

MDMを使用してmacOS用Marvisクライアントをアップグレードする

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

MDMを使用してmacOSのMarvisクライアント設定を更新する

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

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

MDMを使用してMarvisをアンインストールするには、次の手順に従います。

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

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

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

    手記：

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

インストールの確認

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

  • Mistフォルダがアプリケーションディレクトリに存在することを確認します。

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

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

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

    3. サービスエントリ(例:819 0 com.mist.MarvisClient)が存在することを確認します。

  • MarvisClientがアクティビティモニタの[Services]タブに表示されていることを確認します。

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

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

サービスの管理

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

  • サービスを停止します。

  • サービス開始:

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

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

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

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

  • エラー - 重大な問題

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

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

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

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

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

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

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

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

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

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

Marvis macOSクライアントは、Finder(GUI)またはCLIを使用してアンインストールできます。CLI方式には、残留ファイルと設定を削除するためのクリーンアンインストールオプションが用意されています。

Finder を使用した Marvis macOS クライアントのアンインストール (GUI)

Finder方式は、Marvisクライアントをアンインストールするためのユーザーフレンドリーな方法を提供します。

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

  2. 「アプリケーション」フォルダに移動します。

  3. Marvisクライアントアプリケーションを見つけます。

  4. MarvisクライアントのアイコンをDockの ゴミ箱 にドラッグするか、右クリックして[ ゴミ箱に移動]を選択します。

アプリを完全に削除するには、 ゴミ箱 を開いて [ゴミ箱を空にする] を選択します。

手記：

この方法では、Marvisクライアントに関連付けられているすべての設定ファイルとログファイルが削除されるわけではありません。詳細については、「 Macでアプリを削除する方法」を参照してください。

CLIを使用したMarvis macOSクライアントのアンインストール

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

標準アンインストール

アプリケーションのみを削除するには(構成ファイルなし)、次のようにします。

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

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

    このコマンドは、アプリケーションを削除しますが、設定ファイル、ログ、その他の関連ファイルは保持します。

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

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

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

  2. クリーンアンインストールスクリプトを実行します。

    このコマンドでは、次のことを行います。

    • Marvisクライアントアプリケーションを削除します。

    • /Library/Application Support/Mistにある設定ファイルを削除します。

    • ログとその他の残留データを消去します。

アンインストール後、 /Applications フォルダと /Users/Shared/MarvisClient フォルダに移動し、すべてのファイルが削除されたことを確認します。

ご不明な点がございましたら、サポートチームにお問い合わせください。