Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
NESTA PÁGINA
 

Marvis Cliente Android

Preencha as tarefas de pré-instalação e escolha o método que deseja usar para instalar o Cliente Marvis em seu dispositivo.

O cliente Marvis para Android oferece visibilidade detalhada de como seu dispositivo Android interage com a rede sem fio. Ele ajuda a otimizar o desempenho da rede, simplificar a solução de problemas e melhorar a experiência geral do usuário, fornecendo insights sobre a conectividade e o desempenho dos dispositivos.

O cliente Marvis Android é compatível com os seguintes dispositivos:

  • Dispositivos e smartphones portáteis Android que executam o Android 8.0 e versões posteriores

  • Dispositivos Zebra que executam o Android 8.0 e versões posteriores

Visão geral da instalação do cliente Do Marvis Android

Você pode usar qualquer um dos seguintes métodos para instalar o aplicativo:

  • Manual — Baixe e instale o aplicativo do cliente Marvis diretamente na Google Play Store ou no portal Juniper Mist.

    Baixar o cliente no portal Juniper Mist:

    1. Selecione a Organização > administrador > SDK móvel do menu esquerdo.

    2. Clique em Marvis Client no topo da página de SDK móvel.

    3. Selecione a versão do aplicativo no Android e clique em Baixar Instalador.

  • Android Debug Bridge (ADB) — Instale o aplicativo usando a ADB, uma ferramenta de linha de comando que os desenvolvedores podem usar para se comunicar com dispositivos Android para depurar problemas e instalar/desinstalar aplicativos.

  • Gerenciamento de dispositivos móveis (MDM) — Use qualquer uma das seguintes soluções de MDM para instalar o aplicativo:

    • AirWatch ou VMware Workspace ONE

    • SOTI

    Nota:

    Testamos a interoperabilidade apenas com os MDMs listados acima.

Requisitos

Antes de começar a instalação:

  • Habilite as permissões obrigatórias listadas na Tabela 1 para o aplicativo.

    Tabela 1: Permissões necessárias para o aplicativo para cliente Marvis para Android

    Permissão

    Descrição

    Obrigatório ou opcional

    Localização — Definido como Permitir o tempo todo

    Permite que o aplicativo do cliente Marvis obtenha os dados e a função de roam de Wi-Fi, conforme esperado.

    Obrigatório

    Bluetooth

    Permite que o aplicativo obtenha as coordenadas x e y do local.

    Obrigatório

    Dispositivos próximos

    Permite que o aplicativo determine a localização relativa de dispositivos próximos. O Android 12 precisa dessa permissão habilitada para executar o serviço de localização em dispositivos móveis.

    Obrigatório

    Notificações

    Permite notificações se você quiser ser notificado quando o cliente Marvis estiver funcionando ativamente em segundo plano.

    Opcional

    Câmera — definir como permitir uma vez

    Permite que você escaneie o código QR durante a inscrição. Você não precisa habilitar essa permissão se estiver instalando o aplicativo por meio de ADB ou MDM.

    Opcional

  • Configure as configurações do seu firewall de rede para permitir que o cliente Marvis se conecte à sua organização.

    Se sua organização residir na nuvem do Amazon Web Services (AWS) (padrão), use as seguintes configurações:

    • wss://client-terminator.mistsys.net:443/ws ou protocolo WSS (websocket) porta 443 para domínio/caminho

    • https://api.mist.com ou a porta de protocolo HTTPS 443 para domínio

    Se sua organização residir na nuvem do Google Cloud Platform (GCP), use as seguintes configurações:

    • wss://client-terminator.gc1.mist.com/ws ou protocolo WSS (websocket) porta 443 para domínio/caminho

    • https://api.gc1.mist.com/ ou a porta de protocolo HTTPS 443 para domínio

    Nota:

    Se sua organização residir em uma nuvem que não seja AWS ou GCP, entre em contato com a equipe de suporte para obter as URLs apropriadas para configurar as configurações do firewall.

  • Obtenha seu símbolo secreto ou código QR para integrar o cliente Marvis.

    1. Selecione a Organização > administrador > SDK móvel do menu esquerdo.

    2. Clique em Símbolo no topo da página de SDK móvel.

    3. Crie um novo símbolo ou use um símbolo existente:

      • Para obter um novo símbolo — Clique em Criar convite. Insira um nome para este convite e clique em Criar. Quando o símbolo aparecer na página, clique em Visualizar para ver o código QR.

      • Para obter um símbolo existente, consulte os nomes de símbolo para encontrar o que você deseja usar. Clique no link de visualização no lado direito da página para ver o código QR.

    Nota: Para obter o símbolo secreto usando a API, consulte Create SDK Invite.

Como prática recomendada, recomendamos que você desabile o endereço MAC aleatório. Isso evita a necessidade de recadastrar seu dispositivo toda vez que ele se conecta à rede. Para desativar o endereço MAC aleatório:

  1. Navegue até a página de Configurações em seu dispositivo.

  2. Toque em Rede e Internet ou conexões e, em seguida, toque em Wi-Fi.

  3. Toque no ícone de engrenagem (configurações) ao lado da conexão sem fio.

  4. Toque no tipo de endereço MAC e depois toque em Phone MAC.

Modos operacionais

O cliente Marvis opera nos seguintes modos:

  • Modo de produção — modo operacional padrão para ambientes ao vivo que você pode definir usando parâmetros de linha de comando durante a instalação.

  • Modo prova de conceito (POC) — modo operacional para fins de teste e avaliação e também é o modo padrão.

  • GUI ou modo Não-GUI — Modo que permite ou restringe o acesso visual ao cliente Marvis. No modo fora da GUI, você não pode acessar a UI ou o ícone do cliente Marvis na barra de tarefas.

  • Modo Debug — Modo de acesso aos logs. Você não pode editar a configuração neste modo.

Nota:

  • Se você quiser visualizar as configurações quando estiver no modo Produção, precisará mudar para o modo de depuração. No entanto, as configurações não são editáveis.

  • No modo POC, você pode visualizar e editar as configurações de configuração sem qualquer dependência do modo de depuração.

Estados de conexão

O status do cliente Marvis é indicado por indicadores visuais e os seguintes estados de conexão:

  • Desconectado — o cliente não está conectado à nuvem Juniper Mist.

  • Conectado — o cliente está conectado à nuvem Juniper Mist.

  • Conexão — o cliente está solicitando para se conectar à nuvem Juniper Mist.

  • Dormir — o cliente está conectado à nuvem Juniper Mist por meio de um AP não-Juniper.

Implante o cliente Marvis usando o SOTI MDM

Para implantar o cliente Marvis usando uma solução de gerenciamento de dispositivos móveis (MDM), você deve personalizar a implantação do pacote de pacotes Android (APK). Você personaliza a implantação do APK com a ação de intenção para definir o símbolo secreto do kit de desenvolvimento de software (SDK) na instalação. Quando você lança o pacote de aplicativo personalizado, o cliente está totalmente pré-configurado e integrado para operação.

Você pode integrar o cliente Marvis usando o SOTI MDM.

Nota:

Não apresentamos o processo geral genérico de implantação de aplicativos Para Android com o SOTI. Apresentamos apenas as informações necessárias para personalizar o aplicativo para Android para concluir a implantação do cliente Marvis.

Antes de começar:

  1. Certifique-se de ter um dispositivo Windows ou uma máquina virtual (VM). Você executará o Package Studio, que é executado apenas em dispositivos Windows.

  2. Baixe o MobiControl Package Studio (McStudio.exe) do SOTI.

Para implantar o cliente Marvis usando o SOTI MDM:

  1. Em seu dispositivo Windows ou VM, lance o Package Studio e crie um projeto de pacote com as seguintes configurações:

    • Processador —All (a menos que você esteja mirando tipos específicos de CPU ou dispositivo)

    • Plataforma—Android

    • Versão do OS — 8 ou posterior

    • String de versão — o mesmo que a versão APK

    • Fornecedor — Juniper Networks

    • Especificações do requisito de espaço opcional

  2. Adicione o APK do cliente Marvis.
  3. Adicione o arquivo de script a seguir:

    • Mecanismo de script — legado

    • Tipo de script — pós-instalação

  4. Importe o arquivo de script. O arquivo de script deve ter o seguinte conteúdo:

    Se você tiver configurado uma porta específica em um dispositivo Zebra para chamadas de voz, então o arquivo de script deve ter o seguinte conteúdo:

  5. Construa o pacote.

Quando você implanta o pacote personalizado com o SOTI, o cliente Marvis é pré-configurado e integrado.

Implante o cliente Marvis usando AirWatch ou VMware Workspace ONE

Não cobrimos o processo geral de implantação genérica de aplicativos Para Android com o AirWatch. Cobrimos apenas as etapas específicas necessárias para concluir a implantação do cliente marvis.

Use o comando de intenção a seguir para implantar o cliente:

Se você tiver configurado uma porta específica em um dispositivo Zebra para chamadas de voz, use o seguinte comando de intenção:

Você pode usar as seguintes referências para implantar o comando de intenção:

Implante o cliente Marvis usando outros MDMs

Se você estiver usando qualquer outro MDM, verifique se o MDM oferece suporte à execução da intenção. Aqui está uma amostra da implantação baseada em Android Debug Bridge (ADB) baseada em (desenvolvedor/debug) que você pode usar para se adaptar a um MDM de sua escolha:

Se a solução MDM não oferece suporte à execução de intenções do Android, você pode precisar integrar cada dispositivo cliente implantado manualmente. Veja integração e configuração do Cliente Marvis.

Verifique a instalação

Depois de instalar e integrar o cliente Marvis, verifique se esses processos foram executados corretamente. Certifique-se de que seu dispositivo esteja conectado à rede Wi-Fi Mist.

Para verificar a instalação:

  • Confirme se o valor do símbolo secreto é aplicado corretamente. Navegue até a página sobre ou configuração (se você estiver no modo de não produção) no aplicativo do cliente Marvis e verifique se o valor secreto do símbolo ainda está armazenado no campo.

    Se os dados não persistirem e o campo de símbolo secreto estiver vazio, digite o valor secreto do símbolo manualmente. Você pode precisar também configurar a implantação do aplicativo para reter os dados do aplicativo.

  • Cerca de 15 minutos após você integrar o cliente Marvis, confirme que os dados do cliente marvis estão disponíveis no portal Juniper Mist. Você precisa esperar por um mínimo de 10 a 15 minutos após a integração do cliente Marvis para que os dados se propagassem para a nuvem Juniper Mist.

    Os dados do cliente não estão disponíveis no portal Juniper Mist quando ocorre um problema no fluxo de trabalho do cliente de coleta e envio de dados para a nuvem Juniper Mist. Entre em contato com a equipe de suporte. Você pode acessar os logs no aplicativo do cliente Marvis. Veja logs de visualização no Marvis Android Client. Como alternativa, você também pode usar ferramentas como Logcat ou Android Debug Bridge (ADB) para coletar os logs de clientes do Marvis e compartilhar os logs com a equipe de suporte.

    Para dispositivos Zebra, você pode usar a ferramenta RxLogger como um método alternativo para coletar logs.

    Ao entrar em contato com a equipe de suporte, você deve compartilhar o UUID do cliente Marvis. Você pode encontrar o UUID na página Sobre do aplicativo do cliente Marvis. O UUID é usado para rastrear o fluxo de dados do cliente Marvis até a nuvem Juniper Mist.

Integre e configure o Cliente Marvis

Depois de instalar o aplicativo, você precisará integrar e configurar o aplicativo.
  1. Acesse a página da Organização > SDK móvel no portal Juniper Mist e selecione a guia Desembaça para localizar seu símbolo secreto ou código QR. Clique em Visualizar para exibir o código QR.
  2. Abra o aplicativo Marvis Client.
  3. Toque no ícone do hambúrguer e toque em Configuração.
    A página de configuração aparece.

  4. Toque no ícone de código QR ao lado do campo Mobile SDK Secret. Concentre sua câmera de dispositivo no código QR que aparece no portal Juniper Mist.
    O aplicativo verifica o código QR e insere o valor de símbolo secreto correspondente no campo Mobile SDK Secret .
  5. Digite os valores para os seguintes parâmetros:

    • Visibilidade de localização

      Por padrão, a visibilidade de localização está definida para desativar. Se você habilitar a visibilidade de localização, o dispositivo é listado como um cliente de aplicativo na página Clientes > clientes de aplicativos no portal Juniper Mist por 5 segundos. Você pode definir a frequência do display como:

      • Baixo — exibido após cada 10 minutos.

      • Padrão (recomendado)— exibido após cada 5 minutos.

      • Alto — exibido após cada minuto.

      Nota:

      Você precisará ter o vBLE habilitado em seu ponto de acesso (AP) se quiser habilitar a visibilidade de localização. Você pode ativar o vBLE comprando a assinatura de engajamento do usuário ou visibilidade de ativos ou ambas as assinaturas (além da assinatura base do Wireless Assurance).

    • Nome do cliente móvel

    • Porta de chamada de voz móvel (aplicável apenas para dispositivos Zebra)

  6. Toque em Aplicar para salvar a configuração.

    Se você ainda não tiver definido as permissões, verá solicitações de permissão. Habilite as permissões conforme listado na Tabela 1. Certifique-se de definir a permissão de localização para permitir o tempo todo.

  7. Toque no ícone do hambúrguer e toque em Status de conexão para visualizar a página de status da conexão.

    Verifique se o status é exibido como Connected.

    O Cliente Marvis está pronto agora para enviar dados ao portal Juniper Mist. Você precisará esperar cerca de 15 minutos para que os dados apareçam no portal Juniper Mist.

Veja logs no Marvis Android Client

O cliente Marvis classifica os logs como:

  • Informações — Informações gerais

  • Erro — problemas críticos

  • Debug — Dados detalhados que você pode usar para depurar problemas

Para ver os logs no aplicativo, você precisará ativar o modo de depuração no aplicativo:
  1. Toque no ícone do hambúrguer e toque no ícone do Marvis Cliente 7 vezes.
    Você receberá uma senha.
  2. Digite a senha comoAIDriven.

    Você verá a opção Logs listada no menu.

  3. Toque em logs.
  4. Habilite os logs de visualização para visualizar os logs capturados pelo cliente Marvis. Você pode selecionar o tipo de informação que deseja visualizar na lista de desativação do nível de log.
    Você pode clicar no botão Copiar para copiar e enviar os detalhes de log para a equipe de suporte para resolução de problemas.
    Nota:

    Se você entrar em contato com a equipe de suporte da Juniper Mist para resolver qualquer problema, você pode ser solicitado a fornecer o nome da organização ID, UUID e organização. Você pode encontrar esses detalhes na página Sobre , que você pode acessar no menu do hambúrguer.