Guía para garantizar el correcto funcionamiento de Tekus DS
En este artículo te explicamos los recursos web, restricciones, destinos y demás características necesarias para que la aplicación de señalización digital funcione de manera óptima. Estas indicaciones aplican para todas las plataformas en las que Tekus DS está disponible: Android, Windows, iOS, WebOS, Tizen, Universal Web App y Java.
Generalidades
La red donde se habilita un player con Tekus DS puede tener restricciones como Firewalls, Proxys u otros componentes que limitan la navegación hacia internet. Por eso, aquí te detallamos los requisitos mínimos que deben cumplirse para garantizar el funcionamiento adecuado de nuestras aplicaciones.
¿Cómo interpretamos los requisitos?
Los requerimientos están organizados considerando los dos extremos involucrados en cada proceso de comunicación. Estos extremos incluyen:
Servidor Tekus Suite
Servidor Cliente
Player Tekus DS
Computador con cliente de datos instalado
Navegador web
Cada extremo se describe mediante:
Una URL (dirección web).
Un puerto (para comunicación).
El protocolo asociado.
Además, para representar las direcciones usamos los símbolos < (menor que) y > (mayor que).
A continuación, te mostramos un ejemplo práctico para ayudarte a comprender mejor estos requisitos:
Ejemplo
Descripción
Recurso1 > Recurso2
La comunicación es establecida por el Recurso1 y va hacia el Recurso2. Esto se interpretará como un requerimiento de salida.
Recurso1 < Recurso2
La comunicación es establecida por el Recurso2 y va hacia el Recurso1. Esto se interpretará como un requerimiento de entrada
Los destinos pueden representarse mediante un FQDN, una dirección IP o un rango de direcciones IP. Si el recurso se presenta como un FQDN, es posible que incluya el carácter * (asterisco), que actúa como un comodín.
Por ejemplo, el destino FQND api.tekus.co/* puede referirse a los distintas URL que tienen como base api.tekus.co, es decir que las siguientes URL’s estarán contenidas dentro de este destino:
Restricciones de acceso por IP en redes específicas
En algunas configuraciones de red, el acceso a los recursos se restringe según la IP del destino y no por el FQDN (nombre de dominio completo). Como nuestra solución está alojada en un entorno de cloud computing con balanceo de carga y escalabilidad automática, es importante que tengas en cuenta que no utilizamos una única IP en nuestros servidores, sino un rango de direcciones IP asociadas a los recursos implementados.
Nuestra infraestructura está respaldada por Amazon Web Services (AWS). Por esta razón, te recomendamos establecer las restricciones según los rangos de IP definidos en el siguiente enlace: 👉 Rangos de IP de AWS.
Dado que estos rangos son amplios, AWS proporciona herramientas que permiten filtrar las IPs según regiones y servicios. A continuación, detallamos las regiones y servicios utilizados por nuestra solución:
Regiones: US East (N. Virginia). Esta región se identifica como us-east-1.
Si las restricciones se pueden establecer por URL, puedes encontrar los destinos usados por los componentes de Tekus Suite en las siguientes secciones.
Entre player Tekus DS y servidor Tekus Suite
Conexión entre Player Tekus DS y el Servidor Tekus Suite
Player: Dispositivo que ejecuta la aplicación Player Tekus DS o Lighthouse. Algunos ejemplos de players incluyen Android TV Box, pantallas de señalización digital con WebOS, o PC con Windows.
Servidor: Recurso en la nube que se encarga de recibir todas las solicitudes de clientes, como usuarios y players, para gestionar y administrar los contenidos de manera eficiente.
Funcionalidad
Dirección
Destino ó FQDN
Protocolo
Puertos
Sincronización de datos, contenidos, comandos de administración. REST/API
Conexión entre el Cliente Web y el Servidor Tekus Suite
Cliente Web: Es el navegador que utiliza el usuario para acceder a la administración de su cuenta. Ten en cuenta que cada cuenta tiene asignado un subdominio único. En los ejemplos de la tabla siguiente, se utilizará mydomain como el dominio representativo para la cuenta.
Servidor: Recurso alojado en la nube encargado de recibir todas las solicitudes de los clientes para gestionar y administrar contenidos de forma eficiente.
Funcionalidad
Dirección
Destino ó FQDN
Protocolo
Puertos
Navegación y administración de contenidos y players
Entre equipo con cliente de datos y servidor Tekus Suite
Entre equipo con cliente de datos y servidor Tekus Suite
Esta sección aplica únicamente para implementaciones que necesitan mostrar datos en las pantallas provenientes de algún recurso informático dentro de la red. Si este caso no aplica a tu implementación, puedes omitir estas recomendaciones.
Cliente de datos: Es un componente de software proporcionado por Tekus Suite que permite interpretar diferentes orígenes de datos, como XLS, XLSX, texto plano o bases de datos, y convertirlos en una fuente Web XML. Este componente debe instalarse en un equipo con Windows.
Funcionalidad
Dirección
Destino ó FQDN
Protocolo
Puertos
Sincronización de datos, comandos de administración. REST/API
El destino dependerá de la IP o del nombre del recurso visible en la red donde se instale el cliente de datos. Es fundamental configurar el firewall en el equipo para garantizar que el tráfico entrante por el puerto correspondiente se permita correctamente.
El puerto 8181 es un puerto sugerido. Si el cliente desea cambiar este puerto lo puede hacer en las configuraciones del cliente de datos.
Resolución de problemas
A continuación te presentamos algunas posibles situaciones en las que no se logra una conexión correcta entre los componentes de la plataforma. Así también te explicamos las posibles causas y posibles soluciones.
Error de certificado de seguridad (HTTPS):
Error de certificado de seguridad (HTTPS)
Si al ingresar a la página de tu cuenta en https://mydomain.tekus.co desde un equipo o un player aparecen errores relacionados con el certificado de seguridad, es posible que la causa esté relacionada con la configuración de la hora en el dispositivo.
Causa
Es probable que la hora del equipo no esté configurada correctamente.
En el caso de players sin batería para almacenar esta información, el problema podría estar asociado a la configuración de la red, ya que algunos routers no ajustan la hora automáticamente.
Solución
Verifica y corrige la fecha y hora en el dispositivo que está intentando acceder a la plataforma.
Código de registro no mostrado en pantalla principal
Código de registro no mostrado en pantalla principal
Si al abrir la aplicación Tekus DS el player no muestra un código alfanumérico en la pantalla, no podrás registrar el dispositivo.
Causa
El dispositivo no tiene acceso a internet.
Solución
Verifica la conexión a internet del player:
Abre un navegador en el dispositivo e ingresa la siguiente URL según la versión del sistema operativo:
Para dispositivos con versiones anteriores a Android V4 y Windows V2, utiliza: https://api.tekus.co
La página debería cargarse correctamente como se muestra en la imagen a continuación.
Causa 2
El dispositivo tiene acceso a internet, pero existen restricciones en la red que impiden la navegación hacia ciertos destinos. Por ejemplo, puedes acceder a https://www.google.com, pero no a los recursos de Tekus Suite.
Resolución 2
Contacta a tu administrador de red y proporciónale la lista de puertos y destinos especificados en este documento para que los habilite correctamente.
Pantalla registrada, pero no descarga contenido
Pantalla registrada, pero no descarga contenido
Si al abrir la aplicación Tekus DS en el player aparece un código alfanumérico en pantalla, pero después de registrar el dispositivo no se descarga el contenido de la lista de reproducción, podrían estar ocurriendo los siguientes problemas:
Causa 1
El dispositivo no tiene asociada una lista de reproducción.
Resolución 1
Accede a tu cuenta y vincula una lista de reproducción desde la sección ‘Contenido’, en la edición del player correspondiente.
Causa 2
Aunque el dispositivo logró conectarse y registrarse, es posible que los recursos de red necesarios para la descarga de contenidos no estén habilitados.
Para comprobarlo, ingresa desde un navegador a las siguientes URLs:
El presente documento no podrá ser reproducido ni transmitido de ninguna forma ni por ningún medio sin el consentimiento previo otorgado por escrito de Tekus S.A.S y sus filiales.
El producto que se describe en este manual puede contener software cuyos derechos de autor pertenecen a Tekus S.A.S y a sus posibles licenciantes. Los clientes no podrán reproducir, distribuir, modificar, descompilar, desarmar, decodificar, extraer, ceder ni arrendar dicho software de ningún modo, como tampoco practicar ingeniería inversa, ni otorgar una sublicencia de este, salvo en aquellos casos en que la ley aplicable prohíba dichas restricciones o que dichas acciones hayan sido aprobadas por los titulares de los derechos de autor respectivos.
JavaScript errors detected
Please note, these errors can depend on your browser setup.
If this problem persists, please contact our support.