55.1. VS resource

Videosurveillance stores on additional hard disk the videos obtained from one or more RVS cameras. The video is then viewable and manageable using a standard browser. It also manages alarms that in addition to record the videos can send email, SMS, as well as a phone call using DISA service.

The ABILIS can simultaneously record images from several RVS cameras. The recorded frames are displayed through a web page. Since the recording device is contained inside the router, it seamlessly links to all available networks.

Prerequisites:

The RVS devices are dynamically created or removed through the Rio/Rvs configuration web interface, and they appears in Abilis as RVS-x resources.

55.1.1. Activating the VS resource

Add the resource to the Abilis system with the following command.

[09:08:14] ABILIS_CPX:a res:vs

COMMAND EXECUTED

The VS resource may already exist in the system, but may not yet be active, and set the working directory and the storage size (in megabytes)

[09:10:00] ABILIS_CPX:s act res:vs

COMMAND EXECUTED

[09:12:00] ABILIS_CPX:s p res:vs act:yes storage-wdir:D:\vs\ storage:10

COMMAND EXECUTED

[15:20:51] ABILIS_CPX:save conf

COMMAND EXECUTED

[15:20:51] ABILIS_CPX:warm start
[Caution]Caution

After adding or setting the VS active, or having set the working directory or the storage size you must restart the Abilis to make the resource running. Use the command save conf and restart Abilis (i.e. With warm start command)

[Warning]Warning

The first time the VS is configured and Abilis rebooted the VS driver prepares the hard disk to handle the surveillance file. The VS driver will stay unavailable up this task is completed, so PLEASE WAIT the VS driver to become enable again, you can check it in the web interface or in VS diagnostics.

[Note]Note

Set the STORAGE parameter accordingly so that there is sufficient recording space for all cameras.

[15:21:01] ABILIS_CPX:d p vs

RES:Vs ------------------------------------------------------------------------
Run    DESCR:Video_Surveillance
       LOG:DS         ACT:YES  max-rvs:4   max-cam:4   max-live:4   TOS:0-N
       wdir:C:\APP\VS\
       storage-wdir:e:\vs\
       -- Camera "SYS" values -------------------------------------------------
       STORAGE:8 GiB           REC-MAXAGE:14            IDLE-REC-INTERVAL:60
       MIN-ALARM-DURATION:180   MAX-ALARM-DURATION:600   ALARM-HOLDOFF:600
       LIVE-REC-DURATION:600
       -- Notifications -------------------------------------------------------
       NOTIFY-ON-ERROR:NONE
       -- Mail ----------------------------------------------------------------
       MAIL-FROM:AUTO (vs@abilis_cpx__)
       MAIL-TO:
       -- SMS -----------------------------------------------------------------
       SMS-CDO:#
       -- Disa Voice Call -----------------------------------------------------
       DISA-USER:#                       DISA-SERVICE:#
       DISA-CDO:#                        DISA-CGO:#

[15:22:14] ABILIS_CPX:sys disk info

Logical drive(s) information:

Drv Disk   Label         FS      Free space      Used space      Total space
    Interface            Sectors per block       Cluster size    Bootable
-------------------------------------------------------------------------------
C:  HD-12                FAT32   172 MiB         309 MiB         482 MiB
    AHCI                                         4,096 bytes     YES
-------------------------------------------------------------------------------
D:  HD-13                FAT32   298 MiB         195 MiB         494 MiB
    AHCI                                         4,096 bytes     YES
-------------------------------------------------------------------------------
E:  HD-14  vs-store      FAT32   2571 MiB        73728 MiB       76300 MiB
    AHCI                                         65,536 bytes    NO
-------------------------------------------------------------------------------

55.1.2. VS resource parameters

Use the command d p vs to show the parameters of the resource and use the command d p vs ? to display the meaning of the parameters.

[10:42:19] ABILIS_CPX:d p vs

RES:Vs ------------------------------------------------------------------------
Run    DESCR:Video_Surveillance
       LOG:DS         ACT:YES  max-rvs:6   max-cam:6   max-live:6   TOS:0-N
       wdir:c:\app\vs\
       storage-wdir:e:\vs\
       -- Camera "SYS" values -------------------------------------------------
       STORAGE:60 GiB           REC-MAXAGE:NOMAX         IDLE-REC-INTERVAL:60
       MIN-ALARM-DURATION:20    MAX-ALARM-DURATION:60    ALARM-HOLDOFF:5
       LIVE-REC-DURATION:60
       -- Notifications -------------------------------------------------------
       NOTIFY-ON-ERROR:NONE
       -- Mail ----------------------------------------------------------------
       MAIL-FROM:AUTO (vs@abilis_cpx__)
       MAIL-TO:
       -- SMS -----------------------------------------------------------------
       SMS-CDO:#
       -- Disa Voice Call -----------------------------------------------------
       DISA-USER:#                       DISA-SERVICE:#
       DISA-CDO:#                        DISA-CGO:#

Meaning of the most important parameters:

LOG

Logging functionalities activation/deactivation.

ACT

Runtime VS activation/deactivation.

max-rvs

Maximum number of Rvs devices [1..16].

max-cam

Maximum number of Rvs cameras shareable between all Rvs devices [0..80].

max-live

Maximum number of LIVE sessions [1..80].

TOS

Type Of Service octet or Differentiated Services Field (DS):

  • ' p-t', i.e. PRECEDENCE and TOS values, where 'p' can be [0..7] and 't' can be [N=None, D=Min. Delay, T=Max. Throughput, R=Max. Reliability, C=Min. Monetary Cost];

  • 'bbbbbb', i.e. DS value bit by bit, where 'b' can be [0, 1].

wdir

Directory where helper files are saved. Full path with drive letter ['C'..'Z'] terminated by '\'. Max 128 chars. Spaces require double quotes (E.g. "C:\My dir\").

storage-wdir

Working directory where the storage is saved. Full path with drive letter ['C'..'Z'] terminated by '\'. Max 128 chars. Spaces require double quotes (E.g. "C:\My dir\").

STORAGE

Size in GiB of the camera storage [8..4000 GiB] The value must be multiple of 4 GiB, or will it be rounded down.

REC-MAXAGE

Images older than this value are deleted [NOMAX, 0, 1..365 day]. When 0, the recording is disabled and only LIVE view is available. When NOMAX, images are kept up to the storage limit.

IDLE-REC-INTERVAL

Time interval between images capture during non-alarm periods (idle) [1..3600 s].

MIN-ALARM-DURATION

Minimal duration of high frequency recording when the alarm condition is detected [10..3600 s] It will be extended up to MAX-ALARM-DURATION if the alarm condition is detected again during the ALARM-DURATION period.

MAX-ALARM-DURATION

Maximal duration of an alarm event [10..3600 s].

ALARM-HOLDOFF

If an alarm is terminated by MAX-ALARM-DURATION an holdoff is introduced before the next alarm is allowed [0..3600 s].

LIVE-REC-DURATION

The maximum duration of LIVE mode recording [10..3600 s].

NOTIFY-ON-ERROR

Desired notification on storage or device errors [NONE, MAIL, SMS, DISA-CB]. Values can be joined using ',' (comma).

MAIL-FROM

Sender of alarm e-mail. "SYS" or "AUTO" or a valid e-mail address.

  • SYS: the mail sender configured in CXGEN 'MAIL-SENDER' is used;

  • AUTO: a fixed value is used (e.g. vs@<cp-prompt>);

  • e-mail address: max 128 ASCII characters. Space not allowed.

MAIL-TO

External or internal alarms e-mail recipient(s). Max 128 ASCII characters. Space not allowed.

SMS-CDO

Outgoing called number for SMS. # or max 20 digits optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes or the name of an IN list between single quotes (e.g. 'mylist')

DISA-USER

Name of an existing CtiDisa user for DISA CallBack. # or max 16 ASCII characters. Space not allowed. If the user is not configured, the (!) mark is displayed beside the name.

DISA-SERVICE

Name of an existing CtiDisa service for DISA CallBack. # or max 16 ASCII characters. Space not allowed. If the service is not configured, the (!) mark is displayed beside the name.

DISA-CDO

Outgoing called number for DISA CallBack. # or max 20 digits optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes. See also HELP ISDN ATTRIBUTES.

DISA-CGO

Outgoing calling number for DISA CallBack. # or max 20 digits optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] and/or PI [a, r, m, q] and/or SI [y, v, w, z] attributes. See also HELP ISDN ATTRIBUTES.

The following command allows the administrator to change the configuration of the resource:

s p vs parameter:value...

[Caution]Caution

To activate the changes made on the upper case parameters, execute the initialization command init res:vs; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. With warm start command).

55.1.2.1. VS STORAGE

Set the STORAGE parameter accordingly so that there is sufficient recording space for all cameras.

[15:21:01] ABILIS_CPX:d p vs

RES:Vs ------------------------------------------------------------------------
Run    DESCR:Video_Surveillance
       LOG:DS         ACT:YES  max-rvs:4   max-cam:4   max-live:4   TOS:0-N
       wdir:C:\APP\VS\
       storage-wdir:e:\vs\
       -- Camera "SYS" values -------------------------------------------------
       STORAGE:8 GiB           REC-MAXAGE:14            IDLE-REC-INTERVAL:60
       MIN-ALARM-DURATION:180   MAX-ALARM-DURATION:600   ALARM-HOLDOFF:600
       LIVE-REC-DURATION:600
       -- Notifications -------------------------------------------------------
       NOTIFY-ON-ERROR:NONE
       -- Mail ----------------------------------------------------------------
       MAIL-FROM:AUTO (vs@abilis_cpx__)
       MAIL-TO:
       -- SMS -----------------------------------------------------------------
       SMS-CDO:#
       -- Disa Voice Call -----------------------------------------------------
       DISA-USER:#                       DISA-SERVICE:#
       DISA-CDO:#                        DISA-CGO:#

[15:22:14] ABILIS_CPX:sys disk info

Logical drive(s) information:

Drv Disk   Label         FS      Free space      Used space      Total space
    Interface            Sectors per block       Cluster size    Bootable
-------------------------------------------------------------------------------
C:  HD-12                FAT32   172 MiB         309 MiB         482 MiB
    AHCI                                         4,096 bytes     YES
-------------------------------------------------------------------------------
D:  HD-13                FAT32   298 MiB         195 MiB         494 MiB
    AHCI                                         4,096 bytes     YES
-------------------------------------------------------------------------------
E:  HD-14  vs-store      FAT32   2571 MiB        73728 MiB       76300 MiB
    AHCI                                         65,536 bytes    NO
-------------------------------------------------------------------------------

The default value of STORAGE is 40 GiB, and if you have an HDD of 80 GiB, you will the possibility to activate by default only 2 RVS in the normal state. The third RVS, in this case, will display in diagnostic LIVE-ONLY.

[14:27:29] ABILIS_CPX:d d rvs-3

RES:Rvs-3 ---------------------------------------------------------------------
       Ufficio_3                                                     
       STATE:UP                   MAC:B8-27-EB-86-F1-3B   IPRES:Ip-2
       RemAdd-RemPort:192.168.166.120-41414
       HW-DESCR:Raspberry Pi 3 Model B Rev 1.2            HW-ID:r3-1.2
       CURRENT-IMAGE:5.1          FACTORY-IMAGE:5.000     BOARD:0.0
       - Digital Input Lines State --------------------------------------------
        1.. 4| ON  ON  ON  ON  
       ------------------------------------------------------------------------
       - Digital Output Lines State -------------------------------------------
        1.. 4| off off off off 
       ------------------------------------------------------------------------
       - Cameras diagnostics --------------------------------------------------
       CAM:  State:    LIVE: LIVE-REC: ALARM-REC: STORED-ALARMS: STORED-LIVE:
       ------------------------------------------------------------------------
       Cam-1 LIVE-ONLY 0     NO        NO         0              0
       ------------------------------------------------------------------------

The same error "LIVE-ONLY" will be displayed in other problems with storage, if the disk is full, or the HDD doesn't work, or bad configuration.

Type the following command to see if the storage is configured.

[14:49:16] ABILIS_CPX:d vs storage

Storages: 0

---------+-------+--------+----------------------------------------------------
 RES     | CAM   | Orphan | Size
---------+-------+--------+----------------------------------------------------
                              *** NO STORAGE ***                               
                           *** NO STORAGE FOUND ***                            

If you have this error, please verify if the storage-wdir is configured. In a normal situation the previous command must display storages:

[15:49:35] ABILIS_CPX:d vs storage

Storages: 2

---------+-------+--------+----------------------------------------------------
 RES     | CAM   | Orphan | Size
---------+-------+--------+----------------------------------------------------
 Rvs-1   | Cam-1 |        | 40,959 MiB
 Rvs-2   | Cam-1 |        | 40,959 MiB

A useful command is the following:

[14:50:54] ABILIS_CPX:d rvs-1 log

CURRENT EVENTS LOG MASK: DFT (ERR+INFO)


Current Local Time: Thursday 29/08/2019 15:03:21 (UTC+02:00)

Date   Time   Event Event detail
------ ------ ----- ------------------------------------------------------
280819 201758 Info  STORAGE INITIALIZATION STARTED FOR CAMERA:1
280819 201758 Info  STORAGE INITIALIZATION FAILED CAMERA:1
280819 201758 Info  STORAGE INITIALIZATION FAILED CODE:working directory not 
                    configured

In this situation, verify the storage-wdir parameter.

If the disk is full and not enough free space you will see the following error:

[14:50:54] ABILIS_CPX:d rvs-1 log

CURRENT EVENTS LOG MASK: DFT (ERR+INFO)


Current Local Time: Thursday 29/08/2019 15:03:21 (UTC+02:00)

Date   Time   Event Event detail
------ ------ ----- ------------------------------------------------------
290819 150905 Info  STORAGE INITIALIZATION STARTED FOR CAMERA:1
290819 150905 Info  STORAGE INITIALIZATION FAILED CAMERA:1
290819 150905 Info  STORAGE INITIALIZATION FAILED CODE:not enough free space 
                    to setup the camera

In this case, verify the STORAGE parameter.

[Note]Note

If you can't resolve the issue with storage, please consult Abilis support ().