Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
SUR CETTE PAGE
 

Marvis Android Client

Terminez les tâches de préinstallation, puis choisissez la méthode que vous souhaitez utiliser pour installer Marvis Client sur votre appareil.

Le client Marvis pour Android offre une visibilité détaillée sur la façon dont votre appareil Android interagit avec le réseau sans fil. Il permet d’optimiser les performances du réseau, de rationaliser le dépannage et d’améliorer l’expérience utilisateur globale en fournissant des informations sur la connectivité et les performances des appareils.

Le client Android Marvis est pris en charge sur les appareils suivants :

  • Appareils portables Android et smartphones fonctionnant sous Android 11.0 et versions ultérieures

  • Appareils Zebra fonctionnant sous Android 11.0 et versions ultérieures

Présentation de l’installation du client Android Marvis

Vous pouvez utiliser l’une des méthodes suivantes pour installer l’application :

  • Manuel : téléchargez et installez l’application client Marvis directement depuis le Google Play Store ou le portail Juniper Mist.

    Pour télécharger le client à partir du portail Juniper Mist :

    1. Sélectionnez Organisation > Administrateur > Mobile SDK dans le menu de gauche.

    2. Cliquez sur Marvis Client en haut de la page Mobile SDK.

    3. Sélectionnez la version de l’application sous Android, puis cliquez sur Télécharger le programme d’installation.

  • Android Debug Bridge (ADB) : installez l’application à l’aide d’ADB, un outil de ligne de commande que les développeurs peuvent utiliser pour communiquer avec les appareils Android afin de déboguer les problèmes et d’installer/désinstaller des applications.

  • Gestion des appareils mobiles (MDM) : utilisez l’une des solutions MDM suivantes pour installer l’application :

    • AirWatch ou VMware Workspace ONE

    • SOTI

    Remarque :

    Nous avons testé l’interopérabilité uniquement avec les MDM répertoriés ci-dessus.

Exigences

Avant de commencer l’installation :

  • Activez les autorisations obligatoires répertoriées dans le tableau 1 pour l’application.

    Tableau 1 : autorisations requises pour l’application Marvis Client pour Android

    Autorisation

    Descriptif

    Obligatoire ou facultatif

    Emplacement (Location) : défini sur Autoriser tout le temps

    Permet à l’application cliente Marvis d’obtenir les données d’itinérance Wi-Fi et de fonctionner comme prévu.

    Obligatoire

    Bluetooth

    Permet à l’application d’obtenir les coordonnées x et y de l’emplacement.

    Obligatoire

    Appareils à proximité

    Permet à l’application de déterminer l’emplacement relatif des appareils à proximité. Android 12 a besoin que cette autorisation soit activée pour exécuter le service de localisation sur les appareils mobiles.

    Obligatoire

    Notifications

    Active les notifications si vous souhaitez être averti lorsque le client Marvis s’exécute activement en arrière-plan.

    En option

    Caméra : définie comme Autoriser une seule fois

    Vous permet de scanner le code QR lors de l’inscription. Vous n’avez pas besoin d’activer cette autorisation si vous installez l’application via ADB ou MDM.

    En option

  • Configurez les paramètres de votre pare-feu réseau pour permettre au client Marvis de se connecter à votre organisation.

    Si votre organisation réside dans le cloud Amazon Web Services (AWS) (par défaut), utilisez les paramètres suivants :

    • wss://client-terminator.mistsys.net:443/ws ou protocole WSS (websocket) port 443 pour domaine/chemin

    • https://api.mist.com ou le protocole HTTPS port 443 pour le domaine

    Si votre organisation réside dans le cloud Google Cloud Platform (GCP), utilisez les paramètres suivants :

    • wss://client-terminator.gc1.mist.com/ws ou protocole WSS (websocket) port 443 pour domaine/chemin

    • https://api.gc1.mist.com/ ou le protocole HTTPS port 443 pour le domaine

    Remarque :

    Si votre organisation réside dans un cloud autre qu’AWS ou GCP, contactez l’équipe d’assistance pour obtenir les URL appropriées afin de configurer les paramètres du pare-feu.

  • Obtenez votre jeton secret ou votre code QR pour intégrer le client Marvis.

    1. Sélectionnez Organisation > Administrateur > Mobile SDK dans le menu de gauche.

    2. Cliquez sur Jeton en haut de la page Mobile SDK.

    3. Créez un nouveau jeton ou utilisez un jeton existant :

      • Pour un nouveau jeton, cliquez sur Créer une invitation. Entrez un nom pour cette invitation, puis cliquez sur Créer. Lorsque le jeton apparaît sur la page, cliquez sur Afficher pour voir le code QR.

      • Pour un jeton existant : reportez-vous aux noms de jeton pour trouver celui que vous souhaitez utiliser. Cliquez sur le lien Afficher sur le côté droit de la page pour voir le code QR.

    Remarque : Pour obtenir le jeton secret à l’aide d’API, consultez Créer une invitation au SDK.

Nous vous recommandons de désactiver l’adresse MAC aléatoire. Cela évite d’avoir à réenregistrer votre appareil à chaque fois qu’il se connecte au réseau. Pour désactiver l’adresse MAC aléatoire :

  1. Accédez à la page Paramètres de votre appareil.

  2. Appuyez sur Réseau et Internet ou Connexions , puis sur Wi-Fi.

  3. Appuyez sur l’icône d’engrenage (paramètres) à côté de la connexion sans fil.

  4. Appuyez sur Type d’adresse MAC , puis sur MAC du téléphone.

Modes de fonctionnement

Le client Marvis fonctionne dans les modes suivants :

  • Mode d’intégration : mode par défaut lorsque vous installez l’application cliente Marvis à l’aide de la méthode GUI. Dans ce mode, vous pouvez intégrer des appareils via un portail NAC.

  • Mode Télémétrie : mode lorsque vous installez l’application cliente Marvis à l’aide de la méthode CLI. Ce mode est le mode de fonctionnement standard pour les environnements en direct.

Configurer le client Android Marvis pour l’intégration

Vous pouvez utiliser l’application Marvis Client pour intégrer des appareils au réseau Juniper Mist Access Assurance via un portail de contrôle d’accès réseau (NAC) personnalisé. Pour plus d’informations, consultez Intégration des clients via un portail NAC à l’aide de l’application Marvis Client.

Configurer le client Android Marvis pour qu’il fonctionne en mode télémétrie

Pour permettre au client Marvis de fonctionner en mode Télémétrie, installez-le Marvis à l’aide d’un MDM (Déployer le Marvis Client à l’aide du MDM SOTI) ou adb d’une commande (Déployer Marvis client Android à l’aide d’autres MDM).

Mode Admin sur le client Android de Marvis

Lorsque vous ouvrez le client Marvis en mode d’intégration ou de télémétrie, seules les options Intégration réseau et À propos de s’affichent . Pour afficher d’autres options de menu, vous devrez passer en mode Admin :

  1. Appuyez 7 fois sur l’icône du hamburger, puis sur l’icône du client Marvis.

  2. Entrez le mot de passe sous la forme AIDriven. Vous pouvez maintenant voir que vous êtes en mode Admin et afficher des options de menu supplémentaires.

    En mode Admin, la page À propos affiche l’UUID, le nom de l’appareil, l’ID de l’organisation et le nom de l’organisation.

    Vous pouvez utiliser l’option Configuration pour mettre à jour ou vérifier le nom du client, l’accès à l’emplacement et le jeton du SDK mobile.

États de connexion

L’état du client Marvis est indiqué par les indicateurs visuels et les états de connexion suivants. Notez que vous ne pouvez afficher ces états que si le client Marvis est en mode Télémétrie.

  • Déconnecté : le client n’est pas connecté au cloud Juniper Mist.

  • Connecté : le client est connecté au cloud Juniper Mist.

  • Veille : le client est connecté au cloud Mist Juniper via un AP non Juniper.

Déployer le Marvis Client à l’aide du MDM SOTI

Pour déployer le client Marvis à l’aide d’une solution de gestion des appareils mobiles (MDM), vous devez personnaliser le déploiement du package Android package kit (APK). Vous personnalisez le déploiement de l’APK avec l’action d’intention pour définir le jeton secret du kit de développement logiciel (SDK) lors de l’installation. Lorsque vous lancez le package d’applications personnalisé, le client est entièrement préconfiguré et intégré pour l’exploitation.

Vous pouvez intégrer le client Marvis à l’aide du MDM SOTI.

Remarque :

Nous ne présentons pas l’ensemble du processus de déploiement d’applications Android génériques avec SOTI. Nous présentons uniquement les informations nécessaires pour personnaliser l’application Android afin de terminer le déploiement du client Marvis.

Avant de commencer :

  1. Assurez-vous que vous disposez d’un appareil Windows ou d’une machine virtuelle (VM). Vous allez exécuter Package Studio, qui s’exécute uniquement sur les appareils Windows.

  2. Téléchargez MobiControl Package Studio (McStudio.exe) de SOTI.

Pour déployer le client Marvis à l’aide du MDM SOTI :

  1. Sur votre appareil Windows ou votre machine virtuelle, lancez Package Studio et créez un projet de package avec les paramètres suivants :

    • Processeur :All (sauf si vous ciblez un processeur ou un type d’appareil spécifique)

    • Plate-forme—Android

    • Version du système d’exploitation : 11 ou ultérieure

    • Chaîne de version : identique à la version APK

    • Fournisseur : Juniper Networks

    • Spécifications facultatives concernant l’espace requis

  2. Ajoutez l’APK du client Marvis.
  3. Ajoutez le fichier de script suivant :

    • Moteur de scripts – Ancienne génération

    • Type de script : post-installation

  4. Importez le fichier de script. Le fichier de script doit avoir le contenu suivant :

    Si vous avez configuré un port spécifique sur un appareil Zebra pour les appels vocaux, le fichier de script doit avoir le contenu suivant :

  5. Construisez le package.

Lorsque vous déployez le package personnalisé avec SOTI, le client Marvis est préconfiguré et intégré.

Déployer le Marvis Client à l’aide d’AirWatch ou de VMware Workspace ONE

Nous ne couvrons pas l’ensemble du processus de déploiement d’applications Android génériques avec AirWatch. Nous couvrons uniquement les étapes spécifiques nécessaires pour terminer le déploiement du client Marvis.

Utilisez la commande d’intention suivante pour déployer le client :

Si vous avez configuré un port spécifique sur un appareil Zebra pour les appels vocaux, utilisez la commande d’intention suivante :

Vous pouvez utiliser les références suivantes pour déployer la commande d’intention :

Déployer le client Android Marvis à l’aide d’Intune

Suivez la procédure décrite dans Ajouter des applications Google Play gérées aux appareils Android Enterprise avec Intune pour déployer le client Android Marvis à l’aide d’Intune.

Une fois le client Marvis installé, ajoutez les détails de configuration tels que le jeton secret, le mode d’emplacement, le nom de l’appareil :

  1. Sur le portail Intune, accédez à Applications>Gérer les applications.

  2. Sélectionnez Configuration>Créer>Appareils gérés.

  3. Ajoutez des détails de base tels que le nom, la plate-forme et le type de profil. Sélectionnez Marvis Client comme application ciblée.

  4. Ajoutez les autorisations d’accès à l’emplacement et les paramètres de configuration tels que MOBILE_LOCATION_DURATION, MOBILE_LOCATION_MODE, MOBILE_CLIENT_NAME ET MOBILE_SDK_SECRET.

  5. Ajouter des groupes.

  6. Cliquez sur Créer.

Déployer le client Android Marvis à l’aide d’autres MDM

Si vous utilisez un autre MDM, vérifiez qu’il prend en charge l’exécution de l’intention. Voici un exemple de déploiement basé sur Android Debug Bridge (ADB) (développeur/débogage) que vous pouvez utiliser pour l’adapter à un MDM de votre choix :

Activez le mode de localisation et mettez à jour le nom du client :

Si la solution MDM ne prend pas en charge l’exécution des intentions Android, vous devrez peut-être intégrer manuellement chaque appareil client déployé.

Vérifiez l’installation

Après avoir installé et intégré le client Marvis, vérifiez que ces processus se sont exécutés correctement. Assurez-vous que votre appareil est connecté au réseau Wi-Fi Mist.

Pour vérifier l’installation :

  • Confirmez que la valeur du jeton secret est appliquée correctement. Accédez à la page À propos ou Configuration (si vous êtes en mode hors production) de l’application cliente Marvis et vérifiez que la valeur du jeton secret est toujours stockée sur le terrain.

    Si les données ne persistent pas et que le champ du jeton secret est vide, saisissez la valeur du jeton secret manuellement. Vous devrez peut-être également configurer le déploiement de l’application pour conserver les données de l’application.

  • Environ 15 minutes après avoir intégré le client Marvis, vérifiez que les données du client Marvis sont disponibles sur le portail Juniper Mist. Après avoir intégré le client Marvis, il faut attendre au moins 10 à 15 minutes pour que les données se propagent vers le cloud Juniper Mist.

    Les données client ne sont pas disponibles sur le portail Juniper Mist lorsqu’un problème survient dans le workflow client de collecte et d’envoi de données vers le cloud Juniper Mist. Contactez l’équipe d’assistance. Vous pouvez accéder aux journaux dans l’application client Marvis. Consultez Afficher les journaux dans le client Android Marvis. Vous pouvez également utiliser des outils tels que Logcat ou Android Debug Bridge (ADB) pour collecter les journaux des clients Marvis et les partager avec l’équipe d’assistance.

    Pour les appareils Zebra, vous pouvez utiliser l’outil RxLogger comme méthode alternative pour collecter des journaux.

    Lorsque vous contactez l’équipe d’assistance, vous devez partager l’UUID du client Marvis. Vous trouverez l’UUID sur la page À propos de l’application cliente Marvis. L’UUID est utilisé pour suivre le flux de données depuis le client Marvis vers le cloud Juniper Mist.

Consultez les journaux dans le client Android Marvis

Le client Marvis classe les journaux comme suit :

  • Info—Informations générales

  • Erreur : problèmes critiques

  • Déboguer : données détaillées que vous pouvez utiliser pour déboguer les problèmes

Pour afficher les journaux dans l’application, vous devez activer le mode de débogage sur l’application :
  1. Appuyez 7 fois sur l’icône du hamburger, puis sur l’icône du Marvis Client.
    Vous serez invité à saisir un mot de passe.
  2. Entrez le mot de passe sous la forme AIDriven.

    Vous verrez l’option Journaux répertoriée dans le menu.

  3. Appuyez sur Journaux.
  4. Activez Afficher les journaux pour afficher les journaux capturés par le client Marvis. Vous pouvez sélectionner le type d’informations que vous souhaitez afficher dans la liste déroulante Niveau de journalisation.
    Vous pouvez cliquer sur le bouton Copier pour copier et envoyer les détails du journal à l’équipe d’assistance pour dépannage.
    Remarque :

    Si vous contactez l’équipe d’assistance de Juniper Mist pour résoudre un problème, il peut vous être demandé de fournir des détails tels que l’ID de l’organisation, l’UUID et le nom de l’organisation. Vous trouverez ces détails sur la page À propos. Notez que vous devrez accéder à cette page en mode Admin pour afficher les informations. Voir Mode Admin sur le client Android Marvis.