Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
EN ESTA PÁGINA
 

Instalar el cliente de Marvis

RESUMEN Complete las tareas previas a la instalación y, a continuación, elija el método que desea utilizar para instalar Marvis Client en el dispositivo.

Antes de empezar

Configure los ajustes del firewall de red para permitir que el cliente de Marvis se conecte a su organización de Mist.

  • Si su organización de Mist reside en la nube de Amazon Web Services (AWS) (predeterminada), utilice la siguiente configuración:

    • wss://client-terminator.mistsys.net:443/ws o protocolo del puerto WSS (websocket) 443 para dominio o ruta

    • https://api.mist.com

      o el puerto de protocolo HTTPS 443 para el dominio

  • Si tu organización de Mist reside en la nube de Google Cloud Platform (GCP), usa la siguiente configuración:

    • wss://client-terminator.gc1.mist.com/ws o protocolo del puerto WSS (websocket) 443 para dominio o ruta

    • https://api.gc1.mist.com/

      o el puerto de protocolo HTTPS 443 para el dominio
    Nota:

    Si tu organización de Mist reside en una nube que no sea AWS o GCP, ponte en contacto con el equipo de soporte para obtener las URL adecuadas para configurar los ajustes del firewall.

Obtenga el código QR (token secreto)

  1. Seleccione Organization > Admin > Mobile SDK en el menú de la izquierda.
  2. Haga clic en Token en la parte superior de la página Mobile SDK.
  3. Cree un token nuevo o use uno existente:

    • Para un nuevo token: haz clic en Crear invitación. Escriba un nombre para esta invitación y, a continuación, haga clic en Crear. Cuando el token aparezca en la página, haga clic en Ver para ver el código QR.

    • Para un token existente: consulte los nombres de token para encontrar el que desea usar. Haga clic en el enlace Ver en el lado derecho de la página para ver el código QR.

Despliegue el cliente de Marvis mediante SOTI MDM

Para implementar el cliente de Marvis mediante una solución de administración de dispositivos móviles (MDM), debe personalizar la implementación del paquete del kit de paquetes de Android (APK). Puede personalizar la implementación del APK con la acción Intención para establecer el token secreto del kit de desarrollo de software (SDK) durante la instalación. Cuando inicie el paquete de aplicación personalizado, el cliente estará completamente preconfigurado e incorporado para su funcionamiento.

Puede incorporar el cliente Marvis mediante SOTI MDM.

Nota:

No presentamos el proceso general de implementación de aplicaciones genéricas de Android con SOTI. Presentamos solo la información necesaria para personalizar la aplicación de Android para completar la implementación del cliente.

Antes de empezar:

  1. Asegúrese de tener un dispositivo Windows o una máquina virtual (VM). Ejecutará Package Studio, que solo se ejecuta en dispositivos Windows.

  2. Descargue MobiControl Package Studio de SOTI (McStudio.exe).

Para implementar el cliente de Marvis mediante MDM:

  1. En su dispositivo Windows o VM, inicie Package Studio y cree un proyecto de paquete con la siguiente configuración:

    • Procesador: todos (a menos que estén destinados a tipos específicos de CPU o dispositivo)

    • Plataforma: Android

    • Versión del sistema operativo: de 5 a 13 (a menos que desee utilizar una versión específica)

    • Cadena de versión: se establece en el mismo control de versiones que la versión APK

    • Proveedor: Mist Systems, Inc.

    • Especificaciones de requisitos de espacio opcionales

  2. Agregue el APK del cliente de Marvis.
  3. Agregue el siguiente archivo de script:

    • Motor de scripts: heredado

    • Tipo de script: posterior a la instalación

  4. Importe el archivo de script. El archivo de script debe tener el siguiente contenido:

    Si ha configurado un puerto específico en un dispositivo Zebra para llamadas de voz, el archivo de script debe tener el siguiente contenido:

  5. Compile el paquete.

Cuando implementa el paquete personalizado con SOTI, el cliente de Marvis se preconfigura y se incorpora.

Despliegue el cliente de Marvis mediante AirWatch o VMWare Workspace ONE

No cubrimos el proceso general de implementación de aplicaciones genéricas de Android con AirWatch. Solo cubrimos los pasos específicos necesarios para completar el despliegue del agente.

Utilice el siguiente comando de intención para desplegar el agente:

Si ha configurado un puerto específico en un dispositivo Zebra para llamadas de voz, utilice el siguiente contenido:

Puede usar las siguientes referencias para implementar el comando de intención:

Implementar el cliente de Marvis mediante otros MDM

Si utilizas cualquier otro MDM, verifica que el MDM admita la ejecución de intenciones. Si el MDM no admite la implementación intencional, puede usar el procedimiento de instalación de prueba descrito en Instalación mediante instalación mediante instalación de prueba. Aquí hay otro ejemplo de implementación basada en ADB (desarrollador / depuración) que puede usar para adaptarse a un MDM de su elección:

Si la solución MDM no admite la ejecución de intenciones de Android, es posible que deba incorporar cada dispositivo cliente implementado manualmente.

Instalación a través de la instalación de prueba

Nota:

Siga este procedimiento para uso interno, desarrollo, pruebas o depuración. Este proceso no es para implementaciones oficiales de clientes. Sin embargo, puede usar este procedimiento en los casos en que la solución MDM no admita la ejecución de intenciones de Android para configurar automáticamente el token secreto durante la instalación.

Este procedimiento requiere intervención manual para cada dispositivo que se incorpora.
  1. Instala el APK en el dispositivo. Puedes usar Android Debug Bridge (ADB), MDM o el administrador de archivos (almacenamiento local del dispositivo o una tarjeta SD que contenga el APK).
  2. Abra la aplicación cliente de Marvis en el dispositivo.
  3. Toque el icono de Marvis 7 veces para abrir un menú de depuración especial.

    En el caso de los dispositivos Zebra, el menú de depuración muestra el puerto configurado para las llamadas de voz.

  4. Incorpore el cliente mediante el código secreto o el código de escaneo:

    Para usar el código QR:

    1. Toque el botón Escanear organización para abrir la cámara y escanear el código QR de la invitación. Proporcione los permisos necesarios.

    2. Cuando se escanea el código QR, el valor del token secreto correspondiente se inserta en el campo Secreto.

      El valor secreto se aplica automáticamente al cliente de Marvis. Aparece un mensaje que indica que se ha aplicado el valor.

    Para usar el código secreto:

    1. Escriba o pegue el valor del token secreto en el campo Secreto. El valor predeterminado de Secret está vacío.

    2. Toque el botón gris Iniciar Marvis para aplicar los cambios.

      Aparece un mensaje que indica que se ha aplicado el valor.

Ha incorporado correctamente el cliente de Marvis.

Verificar la instalación

Después de instalar e incorporar el cliente de Marvis, compruebe que esos procesos se hayan ejecutado correctamente.

Para verificar la instalación:

  • Confirme que el valor del token secreto se agregó correctamente. Cierre el proceso del cliente de Marvis y vuelva a iniciarlo. Abra el menú de depuración tocando el icono de Marvis 7 veces y verifique que el valor del token secreto aún esté almacenado en el campo.

    Si el campo de token secreto está vacío y los datos no persisten, introduzca el valor del token secreto manualmente, como se describe en Instalación mediante instalación mediante instalación de prueba. Es posible que también deba configurar la implementación de la aplicación para conservar los datos de la aplicación.

  • Unos 15 minutos después de incorporar el cliente de Marvis, confirme que los datos del cliente de Marvis estén disponibles en el panel de control de Mist. Debe esperar un mínimo de 10 minutos después de incorporar el cliente de Marvis para que los datos se propaguen a la nube de Mist.

    Si los datos no están disponibles en el panel de control de Mist, se produjo un problema en el flujo de trabajo del cliente al recopilar datos y enviarlos a la nube de Mist. Póngase en contacto con el equipo de soporte técnico. Si puede usar herramientas como logcat o Android Debug Bridge (ADB), puede usarlas para recopilar los registros del cliente de Marvis y compartirlos con el equipo de soporte.

    Para dispositivos Zebra, utilice la herramienta RxLogger para recopilar registros.

    Cuando se ponga en contacto con el equipo de soporte, debe compartir el UUID del cliente de Marvis. Puede encontrar el UUID en la pantalla del modo de depuración del cliente Marvis. El UUID se utiliza para realizar un seguimiento del flujo de datos desde el cliente de Marvis a la nube de Mist.