49.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.

49.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] AAD_MOLD_UFF:_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-RCPT:
       -- SMS -----------------------------------------------------------------
       SMS-CDO:#
       -- Disa Voice Call -----------------------------------------------------
       DISA-USER:#                       DISA-SERVICE:#
       DISA-CDO:#                        DISA-CGO:#

[15:22:14] CPX_ANTEK-PBX: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
-------------------------------------------------------------------------------

49.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-RCPT:
       -- 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-RCPT

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).