Solución de Problemas
Error: conexión fallida
Síntomas:
-
El plugin no puede conectarse al servidor BioStar X.
-
En los registros aparecen errores de autenticación o de conexión.
Soluciones:
-
Verifica la conectividad de red
ping (IP del servidor BioStar X) -t
-
Verifica las credenciales
-
Confirma que el nombre de usuario y la contraseña configurados sean correctos.
-
Inicia sesión directamente en la interfaz web de BioStar X con las mismas credenciales.
-
-
Revisa el firewall y el enrutamiento
-
Permite los puertos requeridos (por ejemplo, HTTP o HTTPS y
C:\Program Files\BioStar X(x64)\setting.conf) entre los servidores Milestone XProtect y BioStar X. -
Revisa conflictos en el estado de los puertos.
-
-
Confirma el estado del servidor BioStar X
-
Verifica que el servicio de BioStar X se esté ejecutando.
-
Reinicia el servicio de BioStar X si es necesario, según el proceso de gestión de cambios de tu organización.
-
Problema: no se reciben eventos
Síntomas:
-
El plugin se conecta correctamente, pero Milestone XProtect no muestra eventos.
-
Las listas de eventos permanecen vacías, aunque se registre actividad de acceso.
Soluciones:
-
Revisa los ajustes de sondeo de eventos
-
Configura Event polling interval (ms) con un intervalo menor, como 1000–5000 ms, para recibir actualizaciones de eventos casi en tiempo real.
-
Aumenta Event polling max count a 200 o 500 para manejar mayores volúmenes de eventos.
-
-
Verifique la generación de eventos en BioStar X
-
Genere eventos de prueba (por ejemplo, presente una credencial en un lector) para confirmar que el sistema genera eventos.
-
Revise los registros de eventos de BioStar X para confirmar que BioStar X registra los eventos.
-
Errores de certificados SSL
Síntomas:
-
Fallas al conectar mediante SSL/TLS entre Milestone XProtect y BioStar X.
-
Errores de validación de certificados o de confianza en los registros.
Soluciones:
-
Certificados autofirmados
-
Para las pruebas iniciales, establezca "Use SSL" en false de forma temporal para confirmar la conectividad mediante HTTP, si la política de seguridad lo permite.
-
Importe el certificado del servidor de BioStar X o el certificado de la CA emisora en el almacén de certificados de Windows del servidor Milestone XProtect para establecer la confianza.
-
-
Certificados públicos o empresariales
-
Verifique que el certificado sea válido y no esté vencido.
-
Asegúrese de que la cadena completa de certificados (incluidas las CA intermedias) esté instalada correctamente en el servidor BioStar X.
-
Rendimiento lento
Síntomas:
-
Procesamiento de eventos retrasado en Milestone XProtect.
-
Uso alto de CPU o de red en los servidores Milestone XProtect o BioStar X.
Soluciones:
-
Ajuste el sondeo para equilibrar la carga
-
Aumente el Event polling interval (ms) para reducir la frecuencia de sondeo y la carga del servidor.
-
Reduzca el Event polling max count si el procesamiento de lotes grandes de eventos causa demoras.
-
-
Verifique la latencia de red y el ancho de banda
-
Asegúrese de que la latencia entre los servidores Milestone XProtect y BioStar X esté dentro de los límites aceptables para su implementación.
-
Si es necesario, trabaje con el equipo de red para optimizar el enrutamiento, el ancho de banda o la calidad de servicio (QoS) para el tráfico de control de acceso.
-
Aparece el mensaje emergente de error "No access control plug-ins are available..."
Síntoma:

Crear integración del sistema de control de acceso
- No hay complementos de control de acceso disponibles. Verifique que los plugins estén instalados en el servidor de eventos y que el servicio Event Server esté en ejecución.
Solución:

-
Haga clic con el botón derecho en el icono Milestone Event Server de la barra de tareas.
-
Seleccione Reiniciar servicio de Event Server y luego reinicie Milestone Event Server, Management Client y Smart Client para confirmar que el error se resolvió.
Preguntas frecuentes
¿Cuántos dispositivos puede manejar el plugin?
Por lo general, el plugin admite más de 1,000 dispositivos por instancia, según el hardware del servidor, el rendimiento de la base de datos y la capacidad de la red. Para implementaciones muy grandes, considere hacer pruebas de rendimiento y escalar con varias instancias si es necesario.
¿Puedo usar varios servidores de BioStar X?
Cada instancia del plugin MIPAccessControl se conecta a un solo servidor de BioStar X. Para integrar varios servidores de BioStar X, configure una instancia independiente del sistema de control de acceso MIPAccessControl en Milestone XProtect para cada servidor.
¿Cuál es la diferencia entre las opciones relacionadas con el sondeo?
El plugin usa sondeo basado en HTTP de la API de BioStar X en intervalos definidos por los ajustes Event polling interval (ms) y Event polling max count. Los intervalos más cortos y los recuentos máximos más altos aceleran la entrega de eventos, pero aumentan la carga en ambos sistemas. Los intervalos más largos y los recuentos más bajos reducen la carga, pero pueden retrasar la visibilidad de los eventos.
¿Cómo actualizo el plugin?
-
Descargue la versión más reciente del instalador del plugin desde su fuente de distribución.
-
En Milestone Management Client, detenga o deshabilite la instancia correspondiente del sistema de control de acceso MIPAccessControl si lo requieren sus procedimientos operativos.
-
Ejecute el nuevo instalador (MilestonePluginSetup.msi) con privilegios de administrador.
-
Reinicie Milestone Management Client y, si es necesario, reinicie los servicios de control de acceso de Milestone XProtect.
¿Puedo personalizar los tipos de eventos?
Las categorizaciones y las asignaciones de eventos que usa el plugin se definen en el archivo de configuración EventTypeCategories.json. Puede ajustar este archivo para personalizar la agrupación y la visualización de los eventos de BioStar X en Milestone XProtect, según su proceso de control de cambios y las pruebas.
¿El plugin es compatible con implementaciones de BioStar X en la nube?
El plugin está diseñado principalmente para instalaciones locales de BioStar X. El uso con BioStar X alojado en la nube depende de la conectividad de red segura, el enrutamiento y la accesibilidad de la API entre el servidor de Milestone XProtect y el entorno de BioStar X.
¿Cómo hago una copia de seguridad de mis ajustes?
La base de datos de configuración de Milestone XProtect almacena los ajustes del plugin, incluidos los ajustes de conexión y asignación. Verifica que estén implementados los procedimientos habituales de copia de seguridad de Milestone XProtect; estas copias de seguridad incluirán los ajustes del plugin MIPAccessControl.