Instalacin y Configuracin de ZoneMinder, sistema de video vigilancia en Linux..

On 3 enero, 2011, in ubuntu, by Webtense ZoneMinder es un conjunto de aplicaciones de video vigilancia que permiten grabar y monitorizar cmaras IP, CCTV y Webcam conectadas a un equipo con GNU/Linux con soporte Video For Linux (V4L). Est formado de varios componentes y scripts escritos en Perl y PHP (para la interfaz web). Requiere, principalmente, del servidor de base de datos MySQL, servidor Web apache y ffmpeg. Instalacin ZoneMinder no se encuentra en los repositorios de lenny, pero si se encuentra en squeeze desde donde pueden instalarse. Primeramente, se deben instalar los servicios necesarios y algunos otros paquetes para una mejor administracin: # aptitude install apt-listbugs apt-file gpm vim less rcconf openssh-server # aptitude install apache2 libapache2-mod-php5 libapache2-mod-auth-mysql php5 php5-mysql mysql-server mysql-client Luego se instala ffmpeg: # aptitude install ffmpeg A continuacin se instala ZoneMinder: # aptitude install zoneminder Esto instalar ZoneMinder y todas sus dependencias y crear la base de datos zm en MySQL. Configuracin Agregar el usuario www-data al grupo video: # gpasswd -a www-data video Agregar un alias en apache para poder acceder a ZoneMinder desde el servidor web y se reinicia o se recarga la configuracin de apache para que los cambios tengan efecto: # ln -s /etc/zm/apache.conf /etc/apache2/conf.d/zoneminder.conf # /etc/init.d/apache2 restart (o apache2ctl restart) Se configuran los permisos adecuados a /usr/bin/zmfix para que pueda ser ledo y ejecutado por todos los usuarios: # chmod 4755 /usr/bin/zmfix # zmfix -a Se asigna a www-data como el propietario del directorio temporal de ZoneMinder: # chown www-data.www-data /usr/share/zoneminder/temp Editar el archivo "/etc/sysctl.conf" y agregar las siguientes lineas (para 128MB de memoria compartida) kernel.shmall = 134217728 kernel.shmmax = 134217728 Se descarga, descomprime y se copia cambozola al directorio "/usr/share/zoneminder/" para ver el streeming de las cmaras: $ wget http://www.charliemouse.com:8080/code/cambozola/cambozolalatest.tar.gz $ tar -xvzf cambozola-latest.tar.gz # cp cambozola-0.76/dist/cambozola.jar /usr/share/zoneminder/ Luego, se habilita el cliente de streaming cambozola desde las opciones de la consola de administracin de ZoneMinder (Options / Images / OPT_CAMBOZOLA). ZoneMinder usa por default un usuario y contrasea dbil para las query con la base de datos. Por ello, se recomienda cambiar el usuario y contrasea que usa ZoneMinder. Esto se hace editando el archivo "/etc/zm/zm.conf" y modificando las directivas ZM_DB_USER y ZM_DB_PASS: # nano /etc/zm/zm.conf

ZM_DB_USER=nuevouser ZM_DB_PASS=nuevopasswd Una vez modificado se crea el usuario con su password en MySQL: $ mysql -uroot -p GRANT all ON zm.* to nuevouser@localhost IDENTIFIED BY 'nuevopasswd'; exit; Otra configuracin que se puede modificar es la ruta donde se guardarn los eventos e imgenes (quiz otro disco duro) modificando el enlace simblico para que apunte a la nueva ruta: # rm /usr/share/zoneminder/events # rm /usr/share/zoneminder/images # rm /usr/share/zoneminder/temp # mkdir /ruta/nueva/images # mkdir /ruta/nueva/events # mkdir /ruta/nueva/temp # ln -s /ruta/nueva/images /usr/share/zoneminder/images # ln -s /ruta/nueva/events /usr/share/zoneminder/events # ln -s /ruta/nueva/temp /usr/share/zoneminder/temp # chown www.data.www.data -R /ruta/nueva/ Si ya se han agregado monitores, antes de eliminar los enlaces simblicos hay que parar el servicio de ZoneMinder. Una vez creados los enlaces simblicos se mueve el contenido de los directorios "/var/cache/zoneminder/" a la nueva ruta y se arranca el servicio ZoneMinder. IMPORTANTE: Cuando se actualiza ZoneMinder mediante el sistema de paquetes, se eliminarn los enlaces que se acaban de crear y se crearn los que vienen por default. Por lo que hay que repetir los pasos, pero ANTES hay que tener mucho CUIDADO en mover los eventos de "/ruta/nueva/events" fuera de dicha ruta porque de lo contrario se eliminarn todos los eventos cuando se inicie ZoneMinder. Conceptos e Informacin interesante - Un monitor es la configuracin de una cmara ya sea para monitorizar o grabar imgenes. Una vez configurado, si se hace de manera correcta, se habilita y la cmara es accesible se mostrar de color verde, de lo contrario se mostrar de color rojo o anaranjado. - La consola de ZoneMinder es la interfaz Web - Un evento es el registro generado por una cmara cuando se graban imgenes. - Por default, cada 10 minutos (puede modificarse) se genera un nuevo evento que contiene las imgenes de la grabacin. - Las imgenes de los eventos se guardan en la carpeta "events/" - Los filtros sirven para mostrar determinados eventos en base a parmetros configurables (fecha, causa, porcentaje en disco, id del monitor, etc). Viene incluido un filtro por default llamado PurgeWhenFull que elimina de manera automtica los eventos antiguos cuando el disco duro llega al porcentaje configurado. Configuracin de las Opciones (Options) desde la consola de ZoneMinder Se accede a estas opciones desde el link "options" en la consola principal de ZoneMinder. Si se realizan varias modificaciones se recomienda reiniciar ZoneMinder para evitar inconsistencia o perdida de datos. Se recomienda modificar al menos las siguientes opciones: + En la pestaa "System": - La opcin LANG_DEFAULT permite modificar el idioma. Se cambia al idioma al espaol (es_ar). Gran parte no est traducido al espaol, para continuar traduciendo hay que editar el archivo "/usr/share/zoneminder/lang/es_ar.php". - La opcin OPT_USE_AUTH debe marcarse para permitir autenticacin de usuarios. Al guardar pedir usuario y contrasea que por defecto son admin/admin. Tambin aparecer una pestaa llamada "Users" desde la cual se puede modificar la clave del usuario admin y crear nuevos usuarios con los permisos deseados. + En la pestaa Paths (Enlaces) se pueden modificar las rutas donde se almacenaran imgenes, sonidos etc. DIR_EVENTS dejar events DIR_IMAGES dejar images

PATH_ZMS No estoy seguro, por ah le que se modificaba por "/cgi-bin/zms", pero no estoy seguro, pues por default es "/cgi-bin/nph-zms". PATH_LOGS Ruta donde se guardaran los logs. Recomiendo cambiar por "/var/log/zm" (por default trae /tmp) + En la pestaa "Web" WEB_RESIZE_CONSOLE Desmarcarlo + En la pestaa "Images" OPT_CAMBOZOLA marcarlo PATH_CAMBOZOLA cambozola.jar (donde fue guardado anteriormente) STREAM_METHOD Dejar jpeg, aunque no se si haya diferencia si se cambia por "mpeg", pues cuando lo hice no note ninguna diferencia. PATH_FFMPEG Dejar /usr/bin/ffmpeg Creacin de usuarios + En la pestaa "Users" (Usuarios). Para que aparezca esta pestaa debe marcarse la opcin "OPT_USE_AUTH" desde la pestaa "System". - Se modifica el password de admin dando clic en el nombre del usuario. Se recomienda no eliminar la cuenta admin al menos hasta que sea creada otra cuenta con todos los permisos. - Se crean ms cuentas de usuario. Pueden crearse usuarios con los permisos siguientes: Lenguaje para esa cuenta de usuario en particular Stream (permite ver video en vivo de las cmaras Events (permite ver o modificar o eliminar eventos) Control (permite controlar cmaras) Monitors (permite ver y editar monitores) System (determina si el usuario puede ver o modificar las configuraciones del sistema. Como la de usuarios o del sistema completo) Ancho de banda Restringir a determinados monitores Configuracin de monitores Pueden configurarse varios monitores por cmara y cada monitor tiene su propia configuracin. A continuacin se explican las principales: >> Pestaa General + Source Type: Indica el tipo de cmara. Si la cmara est conectada localmente por USB, hay que elegir "Local". Function: Indica la manera en que actuar. La opciones son las siguientes. Monitor.- Se usa para monitorizar una cmara sin que genere eventos (no graba nada) Modect.- Deteccin de movimiento. Se analizan todas las imgenes y cuando se detecta movimiento se generan eventos. Record.- Genera eventos de manera continua, grabando en todo momento haya o no deteccin de movimiento Mocord.- Es la combinacin de Modect y Record. Nodect.- No detecta. + Enable: Se marca si se desea habilitar el monitor. + Linked Monitors: Permite seleccionar otros monitores. Puede usarse para forzar a todas las cmaras a grabar cuando en dicho monitor se detecte movimiento + Maximum FPS: Permite limitar el nmero mximo de fotos que se guardarn de dicha cmara an cuando esta permita un FPS mayor. Esta opcin permite aligerar la carga del servidor sobre todo cuando se tengan varias cmaras configuradas. ZoneMinder no puede modificar el stream mjpeg que le pasan las cmaras IP. Algunas cmaras IP permiten modificar dicho FPS directamente en su configuracin. Para usar esta caracterstica (FPS) debe usarse el mtodo "jpeg" en lugar de "mjpeg" (En la consola de Zm: Options, Images, STREAM_METHOD). + Alarm Maximum FPS : Permite sobreescribir el "Maximum FPS" cuando algo ocurra (como deteccin de movimiento) >> Pestaa Source Las opciones variaran segn el Tipo de Origen configurado en la pestaa General. Para una cmara conectada localmente, las opciones seran: En la pestaa General.- Source Type: Local. Function: Monitor o lo que desee

En la pestaa Source.- Device Path: /dev/video0 o el dispositivo segn sea el caso. Capture Method: Video for Linux version 2. Device Format: PAL. Capture Palette: YUYV. Puede ver la lista de Hardware soportado incluyendo cmaras IP con sus configuraciones especificas en esta pgina. Para la cmara IP D-Link DCS-2102 (que no viene incluida en la lista y cuando quise agregarla no pude porque necesitaba loguearme y las veces que intente registrarme no pude hacerlo) la configuracin es la siguiente para el protocolo RTSP: Source Type: ffmpeg Source Path: rtsp://usuario:password@IPCamara/play2.sdp >> Pestaa Misc + Event Prefix: Prefijo del nombre de los eventos. + Section Length: longitud de los eventos en segundos. Es recomendable que el valor sea entre 300 y 900 segundos (5 y 15 min). Por default son 600 segundos (10 minutos) Agregar o modificar zonas Por cada monitor que se crea, se genera automticamente una zona. Una zona sirve para indicar que zona (rea) de la toma se utilizar para generar eventos. Se puede acceder o agregar zonas desde la consola principal de ZoneMinder en la columna "Zones". + Name: Etiqueta de la zona + Type: Active: Es la que se usa ms frecuentemente y es definida por default con los monitores recin creados. Indica que la zona accionar una alarma en cualquier evento que ocurra dentro de la zona (dentro de los puntos). Inclusive: Este tipo de zona puede usarse para activar su alarma solo cuando otra zona activa ha activado su alarma. Por ejemplo, si se desea monitorizar un cuarto en el cual hay una puerta, puede usarse una zona "Active" que cubra el rea de la puerta y otra zona "Inclusive" que cubra el resto del cuarto. Exclusive: Las alarmas sern accionadas solamente en esta zona si no se han accionado ningunas alarmas ya en zonas activas. Preclusive: Inactive: Este tipo de zona es lo opuesto a la zona activa. En este tipo de zonas no se reportarn nunca las alarmas. Puede usarse para zonas que no se deseen supervisar. + Presets: contiene una lista predefinida de algunas configuraciones comunes de la zona. + Units: Detalla si los siguientes opciones de configuracin sern en porcentaje o en pixeles. Es recomendable usar el porcentaje inicialmente hasta comprender. + Alarm Colour: + Alarm Check Method: AlarmPixels o FilteredPixels + Min/Maximum Pixel Threshold: + Filter Width/Height: Se recomienda un numero pequeo (3 o 5) + Zone Area: + Min/Maximum Alarmed Area: valor de porcentaje o de pixeles mnimos de cambios (que se deben igualar o superar) para que entre la alarma. El mximo no debe ser excedido o se cancela la alarma Un valor mnimo adecuado puede ser entre 10 o 30 si hay poca o mucha luz. + Min/Maximum Filtered Area: + Min/Maximum Blob Area + Min/Maximum Blobs Ver monitores Para ver lo que est ocurriendo en un monitor hay que dar clic en el nombre del monitor ubicado en la columna "Name" desde la consola de ZoneMinder. Se abrir una ventana con el monitor y en la parte de abajo se listarn los ltimos 10 eventos ocurridos en ese monitor. Filtrado de eventos - En la consola principal de ZoneMinder se muestran varias columnas en las cuales se muestran el total de eventos de los monitores filtrados por hora, da, semana y mes. - En la consola principal hay un botn llamado "Filters" que al dar clic en l nos muestra una ventana en la cual podemos crear nuestros propios filtros o modificar los existentes. Por default viene un filtro que elimina los

eventos sin archivar cuando el espacio en disco duro llegue al %85. - Los filtros constan de una o ms condiciones que de cumplirse se aplican las acciones configuradas (ejecutar un comando personalizado, archivar, crear un video y/o eliminar los eventos) a los eventos involucrados. - Para crear un filtro basta con elegir una(s) condicin(es), especificar un valor y elegir la(s) accin(es) a aplicar. - Los filtros automatizados se ejecutan en Perl y se analizan por fecha, por ello es importante usar en los campos tipo fecha formatos compatibles con PHP y Perl. Un ejemplo valido en ambos mtodos es usar -3 day o similar. - Un tipo de filtro especial es "Disk Blocks" y "Disk Percent" que no estn relacionados con los eventos pero si con la particin del disco duro donde estn almacenados los eventos. Estos permiten especificar una cantidad de uso de disco duro en bloques o en porcentaje devuelto por el comando "df" (se refiere a cantidad de espacio del disco duro usado y no el libre). - Para asegurarse de que se apliquen los cambios se recomienda reiniciar el servicio de ZoneMinder. Ejemplo de un filtro que elimina eventos sin archivar que tengan ms de 30 das de haber sido creados: [ ] and [< less than> -30 day] (otra opcin es la siguiente lnea que cambia "day" por "days") [ ] and [< less than> -30 days] Limit to first 5 results only Delete all matches Antes de guardar o ejecutar un filtro es recomendable dar clic en el botn "Submit" para checar que eventos se ven afectados con el filtro para evitar cometer errores y eliminar eventos indeseados. Ver eventos Para acceder a los eventos se hace desde la consola principal de ZoneMinder dando clic en la columna que muestra el total de eventos del monitor deseado filtrado por hora, da, semana o mes. Se abrir una ventana que lista los eventos de dicho monitor. En esta ventana hay un link llamado "Show Timeline" que abre una ventana nueva que muestra los eventos en una linea del tiempo en forma grfica. Stills es til si el stream no funciona o no est soportado o se desea acceder a una foto en particular. Cuando se accede a un evento particular, en la ventana hay varias opciones que permiten cambiar de nombre al evento, eliminarlo, editarlo (comentar sobre el mismo), exportarlo (para ser descargado), archivarlo, acceder a los frames (fotos individuales), crear un video (en mpeg) del evento. Tambin hay un link llamado "Stills" (fotos) que se diferencia de "Frames" en que muestra thumbnails de las imgenes individuales del evento y al darle clic se abre la imagen en su tamao normal. En cambio Frames lista las fotos mostrando el tiempo en el que ocurri. Archivar un evento significa que ser guardado y no se mostrar en los listados normales de eventos. Es til para guardar eventos que son importantes o que se desean proteger para que no sean borrados con los filtros automticos. Una vez que el evento es archivado no puede eliminarse o desarchivarse accidentalmente cuando se estn viendo los eventos no archivados. La opcin que genera videos usa el codificador ffmpeg y por default los videos tienen la misma duracin que el evento: pero pueden ajustarse antes de generar el video. Una vez generado el video podr verse directamente, descargarse al equipo local y eliminarse del servidor una vez que no se requiera. El proceso de generacin del video MPEG puede tardar algunos minutos. LOGS Como ya se coment, desde las opciones de consola de ZoneMinder en la opcin PATH_LOGS se puede especificar la ruta donde se guardaran algunos logs. Sin embargo una gran cantidad de logs se guardan en el archivo "/var/log/messages", para separar los logs de Zoneminder hay que editar el archivo "/etc/sysctl.conf" y agregar al inicio del archivo las siguientes lneas: # Save ZoneMinder messages to zm.log local1.* /var/log/zm/zm.log Esto guardar los logs de Zoneminder etiquetados con local1 en "/var/log/zm/zm.log". Sin embargo esto no garantiza que todos los mensajes de ZoneMinder vayan a zm.log pudindose escapar algo a "/var/log/messages". Otra informacin interesante Si apache se colgara despus de cierto tiempo por la cantidad de conexiones que se levantan y se tuviera que reiniciar el servicio a cada rato, sera necesario modificar lo siguiente en el archivo "/usr/share/zoneminder/ajax/stream.php": if ( $numSockets === false ) Por:

if ( $numSockets === false || $numSockets < 1 ) Configurar cmara D-Link DCS-2102 + Protocolo: RTSP (por el puerto 554) Source Type: ffmpeg Source Path: rtsp://usuario:passwd@IP/play2.sdp Si se tiene configurado un firewall en el equipo, hay que abrir los siguientes puertos para que funcione la cmara: 554 por tcp y udp 5000-5020 udp FUENTE: Documentacin oficial de ZoneMinder