Ir para o conteúdo

Instalación

Instalación en un servidor Milestone XProtect con un asistente gráfico de Windows. No requiere instalar dependencias ni ejecutar scripts. El asistente verifica los requisitos antes de modificar el equipo y se detiene indicando el requisito que falta.


Requisitos

Requisito Verificación
Windows Server 2016 o superior (64 bits) automática
Permisos de Administrador automática
.NET Framework 4.7.2 o superior automática
XProtect Management Server, en este servidor o alcanzable por red automática, obligatorio
XProtect Event Server, en este servidor o alcanzable por red automática, obligatorio
Analytics Events habilitado (puerto 9090) automática
Puerto libre para el panel (8097 por defecto) automática
Licencia de la integración para este servidor durante la instalación
Red hacia las cámaras manual

¿Management Server, Event Server y Recording Servers en equipos distintos?

Es un caso soportado: el asistente verifica por red al Management Server y al Event Server cuando no están en el equipo donde instalás. Antes de empezar, mirá Milestone en varios servidores: ahí se explica dónde conviene instalar la integración y qué configurar.

No hace falta instalar ningún runtime. Tanto el asistente como el servicio son autocontenidos; el único requisito del sistema es .NET Framework 4.7.2, que Windows Server ya trae de fábrica desde 2016. Lo necesita el sidecar que habla con el MIP SDK de Milestone, que solo existe para esa plataforma.

No es un plug-in MIP y no requiere licencias extras de Milestone ni de Hikvision. Es un servicio de Windows independiente —un bridge entre la ISAPI de las cámaras y los eventos analíticos de XProtect— que solo necesita su propia licencia, emitida para el servidor donde se instala.

Habilitar Analytics Events

En Management Client → Herramientas → Opciones → Eventos analíticos:

  • ☑ Habilitado
  • Puerto: 9090
  • Seguridad → Eventos permitidos de: Todas las direcciones de red (o la IP del servidor, si preferís restringir)

Si no está habilitado, el asistente lo detecta en el paso de requisitos y indica exactamente dónde activarlo.

La cuenta de servicio

Corre por defecto como NT AUTHORITY\NetworkService, que en una instalación típica de XProtect ya es administradora del VMS. Ese permiso es lo que le permite leer las contraseñas de las cámaras desde la propia configuración de Milestone: dar de alta 100 cámaras no implica cargar 100 credenciales a mano en ningún otro lado.

Si esa cuenta no tiene el rol, elegí otra en Opciones avanzadas → Cuenta del servicio → Otra cuenta (paso de requisitos). La cuenta tiene que pertenecer al rol Administrators de XProtect y tener el derecho de Windows Iniciar sesión como servicio. Si el Management Server está en otro servidor, NetworkService no alcanza: ver Milestone en varios servidores.


Conseguir el paquete

Descargar el instalador SHA-256

Versión actual: última (publicada el —). Qué trae: Novedades.

Es siempre la última versión. La descarga es libre: el paquete no funciona sin una licencia emitida para tu servidor, que se pide durante la instalación (ver La licencia).

Para comprobar que el archivo llegó entero, compará su huella SHA-256 con la publicada:

Get-FileHash .\HikvisionZoneBridge.zip -Algorithm SHA256

El paquete es un .zip con esta estructura:

HikvisionZoneBridge-<versión>\
├── Instalar-HikvisionZoneBridge.exe   asistente de instalación
├── paquete\                        archivos del servicio (no mover ni borrar)
├── LEEME.txt
└── GUIA-DE-USO.md

Si lo recibiste por correo o lo descargaste, desbloquealo antes de descomprimir: Windows marca como no confiable todo lo que viene de internet, y esa marca pasa a cada archivo que se extrae. Clic derecho sobre el .zip → Propiedades → ☑ Desbloquear → Aceptar, o desde PowerShell:

Unblock-File .\HikvisionZoneBridge-0.1.0.zip
Armar el paquete desde el código fuente

Se genera con instalador/empaquetar.sh, que compila el servicio, el sidecar y el asistente, y arma la carpeta y el .zip en un solo paso (Linux, o Windows con Git Bash):

./instalador/empaquetar.sh 0.1.0
# -> instalador/dist/HikvisionZoneBridge-0.1.0.zip

El script necesita el SDK de .NET 8, algo distinto de lo que necesita el servidor donde después se instala el paquete, que no necesita ningún SDK porque todo sale autocontenido. No hay que instalarle el SDK al servidor de destino: alcanza con armar el paquete en cualquier otra máquina que lo tenga y copiar el .zip.


Aviso de Windows al abrir el instalador

Los ejecutables del paquete están firmados con un certificado propio, no con uno de una entidad certificante pública. Al abrirlos, SmartScreen puede mostrar "Windows protegió su PC". Para continuar:

  • Clic en Más información y luego en Ejecutar de todas formas; o
  • antes de descomprimir, clic derecho sobre el zip → Propiedades → Desbloquear (en PowerShell, Unblock-File); o
  • ejecutar como Administrador Confiar-en-la-firma.ps1, incluido en el paquete. El equipo pasa a reconocer la firma y el instalador muestra el nombre del editor. La huella SHA-256 que imprime el script se compara con la que informa el proveedor.

El aviso desaparece por completo solo con un certificado de una entidad certificante pública, que requiere suscripción anual.


Instalación

Copiá la carpeta al servidor de Milestone y ejecutá Instalar-HikvisionZoneBridge.exe. Pide permisos de Administrador al abrirse.

Si aparece \"Windows protegió su PC\"

Es SmartScreen avisando que el ejecutable viene de otra máquina. Hacé clic en Más información → Ejecutar de todas formas. Desbloquear el .zip antes de descomprimirlo evita el aviso.

El asistente tiene siete pasos:

  1. Bienvenida. Qué hace la integración y qué no es.
  2. Aviso legal. Las condiciones de uso; hay que aceptarlas para seguir.
  3. Requisitos. Revisa el servidor y muestra cada punto con ✔ o ✖ y qué hacer si falla. Sin Milestone XProtect no se puede continuar. Desde acá se abren las Opciones avanzadas (ver abajo).
  4. Huella del servidor. El identificador de este servidor y un código QR para pedir la licencia desde el celular (ver La licencia).
  5. Licencia. Adjuntás o arrastrás el archivo licencia.lic. Se valida en el momento: si fue emitida para otro servidor, venció o no corresponde, lo dice antes de instalar nada.
  6. Instalación. Copia los archivos, instala la licencia, configura la conexión con XProtect, crea el servicio, abre el firewall, lo inicia y espera el primer inventario de cámaras. Cada paso muestra su resultado, y el registro completo se puede guardar.
  7. Finalizado. La dirección del panel, la carpeta, los registros, la cantidad de cámaras detectadas y el siguiente paso en Milestone.

El instalador no reinicia servicios de Milestone ni interrumpe la grabación. El único cambio del lado de Milestone son los tipos de evento nuevos, dados de alta por su API de configuración.

HTTPS hacia Milestone

Antes de instalar, el asistente prueba si el Management Server responde por HTTPS (con un certificado que Windows considere confiable) y si el Event Server acepta TLS en su puerto de eventos analíticos, usando el nombre o la IP indicados. Lo que responde por HTTPS se usa cifrado. Si alguno no se alcanza, el asistente lo informa, recomienda usar HTTPS y pide confirmar la conexión por HTTP para continuar. Si no se confirma, la instalación no sigue.

Opciones avanzadas

Opción Por defecto Para qué
Carpeta de instalación C:\Program Files\HikvisionZoneBridge Carpeta destino
Puerto del panel web 8097 Puerto del panel
Dirección del VMS http://localhost Si el Management Server está en otro servidor
Dirección del Event Server localhost Si el Event Server está en otro servidor (nombre o IP)
Puerto de eventos analíticos 9090 Si cambiaste el puerto de Analytics Events
Cuenta del servicio NT AUTHORITY\NetworkService Identidad del servicio
Abrir el puerto en el firewall sí Crear la regla de entrada para el panel

Un detalle que vale la pena saber de antemano: el puerto 8080 suele estar reservado por el Mobile Server en un servidor XProtect típico, aunque nada lo esté usando en el momento. El asistente lo detecta en los requisitos, antes de dejarte con un panel que nunca va a levantar.


Milestone en varios servidores

En instalaciones grandes, el Management Server, el Event Server y los Recording Servers suelen estar en equipos distintos. La integración funciona igual, pero hay que decidir dónde instalarla y configurar cuatro cosas.

Con quién habla la integración

Destino Cómo Para qué
Event Server TCP, puerto 9090 Enviar los eventos analíticos
Management Server MIP SDK, a la Dirección del VMS Inventario de cámaras y sus credenciales
Cámaras Hikvision HTTP directo (ISAPI) Leer las analíticas por zona
SQL Server opcional, ver más abajo Respaldo del mapeo de zonas
Recording Servers ninguna conexión —

Los Recording Servers no necesitan nada instalado ni configurado: la integración conoce las cámaras a través del Management Server, y les habla directamente a ellas, no al Recording Server que las graba.

Dónde instalarla

Una sola instancia por sistema XProtect. Cada instancia lee todas las cámaras del sistema, no solo las de un Recording Server, así que con dos instancias cada evento llegaría duplicado. Por lo mismo, no va una por Recording Server.

Situación Instalala en
Todo en un servidor Ese servidor
Event Server separado, y llega a las cámaras El servidor del Event Server: el puerto 9090 queda local y no hace falta tocar firewall ni direcciones permitidas
El servidor del Event Server no llega a las cámaras (red de cámaras aislada) Un equipo que sí llegue: un Recording Server de esa red o una máquina virtual dedicada. Se apunta por red al Event Server y al Management Server

Lo que más tráfico mueve es hacia las cámaras, no hacia el Event Server, por eso el criterio es dónde llegan mejor las cámaras. La licencia se emite para el servidor donde instalás la integración, no para el Management Server.

Antes de instalar, comprobá desde ese servidor que llega a todo lo necesario:

Test-NetConnection servidor-eventos -Port 9090
Test-NetConnection servidor-vms     -Port 80
Test-NetConnection 10.0.0.21        -Port 80     # una cámara cualquiera

Qué configurar

1. En el asistente

En el paso de requisitos, Opciones avanzadas:

  • Dirección del VMS: la del Management Server, por ejemplo http://servidor-vms.
  • Dirección del Event Server: su nombre o IP. localhost es el propio equipo.
  • Puerto de eventos analíticos: 9090, salvo que lo hayas cambiado.

Cuando las direcciones son de otro equipo, el asistente no busca los servicios de XProtect localmente: comprueba que el Management Server y el Event Server respondan por red. Si no responden, no deja continuar y dice cuál falló.

2. En el Event Server

  • Habilitá los eventos analíticos (ver Habilitar Analytics Events).
  • En Seguridad → Eventos permitidos de, agregá la IP del servidor donde instalaste la integración (o dejá Todas las direcciones de red).
  • Permití el puerto 9090/TCP de entrada en el firewall de Windows de ese servidor.

3. La cuenta del servicio

Con el Management Server en otro equipo, NetworkService accede por red como la cuenta del propio equipo (DOMINIO\SERVIDOR$), que normalmente no es administradora de XProtect. Usá una cuenta de dominio dedicada:

  1. En el asistente: Opciones avanzadas → Cuenta del servicio → Otra cuenta (DOMINIO\svc-hkzb y su contraseña).
  2. Dale el derecho Iniciar sesión como servicio en el servidor de la integración.
  3. En Management Client → Seguridad → Roles → Administrators → Usuarios y grupos, agregala.
Sin dominio

El asistente no cubre este caso. El servicio admite un usuario básico de XProtect con rol de administrador, configurado a mano en appsettings.json (MipHelper:Usuario y MipHelper:Password). La contraseña queda en texto plano: usalo solo si no hay dominio, y limitá el acceso a la carpeta de instalación.

4. Respaldo en SQL (opcional)

El servicio guarda una copia del mapeo de zonas en SQL Server, además de mapeo-slots.json. Usa localhost con la cuenta del servicio. Si el servidor de la integración no tiene SQL Server, no falla: registra una advertencia y sigue con mapeo-slots.json.

Para guardar la copia en el SQL de XProtect, o para apagarla, editá RespaldoSql en appsettings.json y reiniciá el servicio. La cuenta necesita permiso para crear la base HikvisionZoneBridge:

"RespaldoSql": {
  "Habilitado": true,
  "ServidorYAuth": "Server=servidor-sql;Trusted_Connection=True;TrustServerCertificate=True;"
}

Si después cambia la topología

Las direcciones quedan en appsettings.json, en EventServer:Host, EventServer:Puerto y MipHelper:UriDelVms. Si movés el Event Server o el Management Server, editalas ahí y reiniciá el servicio HikvisionZoneBridge.


La licencia

La licencia se emite para cada servidor, identificado por su huella: un valor que se calcula a partir del identificador de Windows y del nombre del equipo. No depende de la licencia de Milestone, así que no cambia si agregás cámaras o renovás el Care/SUP.

  1. En el paso Huella del servidor, escaneá el código QR con la cámara del celular. Se abre el correo a [email protected] con la huella y el nombre del servidor ya cargados.
  2. Completá la empresa y un contacto técnico, y envialo.
  3. Te respondemos con el archivo licencia.lic emitido para ese servidor.
  4. Adjuntalo en el paso Licencia.

Por qué conviene el QR

Los servidores de video rara vez tienen un programa de correo configurado, y copiar a mano una huella de 64 caracteres es fácil de errar. Con el QR la huella viaja exacta, sin tipear nada.

Si no tenés un celular a mano, la huella también se puede copiar, guardar en un archivo (que ya trae los campos para completar) o enviar con Enviar por correo, si el servidor tiene un programa de correo.

Podés cerrar el asistente mientras esperás la licencia: al volver a abrirlo, la huella es la misma.

Cambio de servidor o reinstalación de Windows. La huella cambia y la licencia anterior deja de valer en el servidor nuevo. Pedí una nueva con la huella nueva; es un trámite de minutos.


Qué queda instalado

C:\Program Files\HikvisionZoneBridge\
├── HikvisionZoneBridge.exe        servicio principal, autocontenido
├── licencia.lic                licencia de este servidor
├── mapeo-slots.json            qué zona de cada cámara es cada slot
├── logs\                       registros del servicio
├── wwwroot\                    panel web
└── MipHelper\
    └── MipHelper.exe           sidecar para hablar con el MIP SDK

Además: el servicio de Windows HikvisionZoneBridge con arranque automático y reinicio ante caídas, la regla de firewall Hikvision Zone Bridge - Panel, y hasta 20 tipos de evento nuevos en Milestone.

Un archivo que no conviene perder

mapeo-slots.json guarda qué zona física de cada cámara corresponde a cada slot lógico. Si se pierde, los slots se reasignan solos —y las alarmas que ya armaste en Milestone pasan a apuntar a otra zona, sin ningún error que lo avise. El asistente lo conserva en cada actualización; de tu lado, alcanza con incluirlo en el backup habitual del servidor.


Verificación

El paso final del asistente ya informa cuántas cámaras Hikvision detectó. Para ver el detalle por zona:

Invoke-RestMethod https://localhost:8097/api/camaras | ForEach-Object {
    "$($_.nombre) [$($_.estado)]"
    $_.zonas | ForEach-Object { "  slot $($_.slot) <- $($_.espacio) $($_.indiceEnCamara)  $($_.tipoDeEvento)" }
}
CAM-01 [EnLinea]
  slot 1 <- Area 1   Hikvision Intrusion_1
  slot 2 <- Area 2   Hikvision Intrusion_2
  slot 1 <- Linea 1  Hikvision Line Crossing_1

Y en el panel:


Problemas frecuentes

El servicio se detiene apenas arranca — casi siempre es la licencia: el servicio la verifica cada vez que inicia y, si no es válida, se cierra. El motivo exacto queda en licencia-rechazo.log, en la carpeta de instalación (vencida, emitida para otro servidor, archivo modificado). El asistente lo muestra directamente si pasa durante la instalación.

0 cámaras Hikvision detectadas — confirmá que haya hardware Hikvision habilitado en el Recording Server. El filtro busca hikvision, hikmicro o hiwatch en el modelo o el nombre; si tus cámaras se llaman distinto, es un parámetro de configuración, no una limitación.

"XProtect rechaza a la cuenta por permisos" (en el registro del servicio: VMO61008: You do not have sufficient permissions) — el servicio funciona, pero no ve ninguna cámara porque su cuenta no está en el rol Administrators de XProtect. Hay tres salidas, y después hay que reiniciar el servicio HikvisionZoneBridge:

  1. Agregar la cuenta al rol en Management Client → Seguridad → Roles → Administrators → Usuarios y grupos. Si el Management Server está en otro equipo, hay que agregar la cuenta del equipo (DOMINIO\NOMBRE-DEL-PC$).
  2. Usar un usuario básico de Milestone con rol de administrador. Se elige en el asistente, en Opciones avanzadas → Acceso a XProtect, donde el botón Probar conexión comprueba el usuario antes de instalar. También se puede cargar a mano en appsettings.json (MipHelper.Usuario y MipHelper.Password). La clave queda en ese archivo, que el asistente deja legible solo para administradores y para el servicio.
  3. Instalar con otra cuenta de Windows que ya sea administradora de XProtect (Opciones avanzadas → Cuenta del servicio).

Con usuario básico, ServerNotFoundMIPException o un error vacío — Milestone pide https para autenticar usuarios básicos, y solo lo acepta si el certificado del Management Server es de confianza en el equipo. Con una dirección http:// (por ejemplo http://localhost) el servicio lo permite solo; en el asistente es la casilla Permitir conexión sin cifrar (http). Con https://, la dirección debe ser el nombre que figura en el certificado (no localhost) y el certificado tiene que ser confiable en ese equipo. Si usás http con un servidor remoto, usuario y contraseña viajan sin cifrar: preferí https con un certificado válido.

El instalador falla al "Iniciar el servicio" — Windows le da 30 segundos a un servicio para arrancar, y tras copiar los archivos, un antivirus o un disco lento pueden pasarse. Desde la 0.1.5 el instalador reintenta solo y, si no puede, muestra la causa. Si aun así falla, no lo vuelvas a ejecutar: cada corrida recopia los archivos y vuelve a empezar en frío. Esperá un minuto y ejecutá, como Administrador:

Start-Service HikvisionZoneBridge

Si el servicio queda en marcha y el panel abre en https://localhost:8097, la instalación está completa.

Con el Event Server en otro servidor, no llegan eventos — el asistente solo puede comprobar que el puerto responda, no la lista de direcciones permitidas. En el Event Server, revisá Eventos analíticos → Seguridad → Eventos permitidos de y que figure la IP del servidor de la integración.

Los eventos salen pero no aparecen en Milestone — se van a ver marcados como rechazados en la bitácora del panel, con el motivo exacto. Casi siempre es uno de dos: el tipo de evento todavía no existe (un reinicio del servicio los vuelve a crear), o la cámara ya no existe en Milestone.

La cámara aparece "Fallida" — probá la conectividad HTTP hacia la cámara desde el propio servidor con PowerShell, no con curl. El curl que trae Windows Server 2022 tiene un problema conocido con la autenticación Digest de estas cámaras (falla silenciosamente, sin devolver nada), y hace parecer un problema de credenciales que no lo es.


Actualización y desinstalación

Actualizar es ejecutar el asistente de la versión nueva: detecta la instalación anterior, la detiene, actualiza los archivos conservando el mapeo de zonas y vuelve a iniciar el servicio. Te va a pedir adjuntar la licencia otra vez; sirve la misma licencia.lic mientras no hayas cambiado de servidor.

Tu configuración se conserva. El asistente no pisa el appsettings.json instalado: deja una copia con fecha (appsettings.json.bak-AAAAMMDDHHMMSS) y le agrega solo las opciones nuevas que traiga la versión, con su valor por defecto. Los ajustes que hayas hecho a mano (antirrebote, eventos de fin, respaldo SQL, usuario del VMS…) quedan como estaban. Las direcciones y puertos de Opciones avanzadas aparecen precargados con los que ya tenías.

Para desinstalar, abrir Aplicaciones instaladas de Windows y elegir Hikvision Zone Bridge, o ejecutar Desinstalar-HikvisionZoneBridge.exe de la carpeta de instalación. El desinstalador pide confirmación y pregunta si se borran también la configuración y los datos:

  • Sin borrar datos (opción por defecto): se quitan el servicio, el icono de la bandeja, la regla de firewall, el certificado del panel y los programas. Quedan en la carpeta appsettings.json y sus copias, mapeo-slots.json, la licencia, el certificado del panel y los registros, para reinstalar más adelante.
  • Borrando datos: se elimina la carpeta de instalación completa. Hay una segunda confirmación, porque no se puede deshacer.

El mapeo de zonas (mapeo-slots.json) es lo que no conviene perder: si se borra, los slots se reasignan y las alarmas ya armadas en Milestone pueden apuntar a otra zona. Va en los backups.

El desinstalador no modifica Milestone, porque las reglas que ya se armaron dependen de ese contenido. Para quitar también los tipos de evento, borrar los que empiezan con Hikvision en Management Client → Reglas y eventos → Eventos analíticos. La base de respaldo HikvisionZoneBridge en SQL Server tampoco se borra.