IDOL Video Wittwin ACI Server 8.1 User Guideh30359. Distribution Suite... · ... File System...

IDOL Video™

Wittwin ACI Server™

User Guide

Version 8.1Document Revision 0

20 November 2014

Notice

This documentation is a proprietary product of HP Autonomy and is protected by copyright laws and international treaty. Information in this documentation is subject to change without notice and does not represent a commitment on the part of Autonomy. While reasonable efforts have been made to ensure the accuracy of the information contained herein, HP Autonomy assumes no liability for errors or omissions. No liability is assumed for direct, incidental, or consequential damages resulting from the use of the information contained in this documentation.

The copyrighted software that accompanies this documentation is licensed to the End User for use only in strict accordance with the End User License Agreement, which the Licensee should read carefully before commencing use of the software. No part of this publication may be reproduced, transmitted, stored in a retrieval system, nor translated into any human or computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual or otherwise, without the prior written permission of the copyright owner.

This documentation may use fictitious names for purposes of demonstration; references to actual persons, companies, or organizations are strictly coincidental.

Trademarks and Copyrights

Copyright © 2014 Hewlett-Packard Development Company, L.P. ACI API, Alfresco Connector, Arcpliance, Autonomy Process Automation, Autonomy Fetch for Siebel eBusiness Applications, Autonomy, Business Objects Connector, Cognos Connector, Confluence Connector, ControlPoint, DAH, Digital Safe Connector, DIH, DiSH, DLH, Documentum Connector, DOH, EAS Connector, Ektron Connector, Enterprise AWE, eRoom Connector, Exchange Connector, FatWire Connector, File System Connector for Netware, File System Connector, FileNet Connector, FileNet P8 Connector, FTP Fetch, HTTP Connector, Hummingbird DM Connector, IAS, IBM Content Manager Connector, IBM Seedlist Connector, IBM Workplace Fetch, IDOL Server, IDOL, IDOLme, iManage Fetch, IMAP Connector, Import Module, iPlanet Connector, KeyView, KVS Connector, Legato Connector, LiquidOffice, LiquidPDF, LiveLink Web Content Management Connector, MCMS Connector, MediClaim, Meridio Connector, Meridio, Moreover Fetch, NNTP Connector, Notes Connector, Objective Connector, OCS Connector, ODBC Connector, Omni Fetch SDK, Open Text Connector, Oracle Connector, PCDocs Fetch, PLC Connector, POP3 Fetch, Portal-in-a-Box, RecoFlex, Retina, SAP Fetch, Schlumberger Fetch, SharePoint 2003 Connector, SharePoint 2007 Connector, SharePoint 2010 Connector, SharePoint Fetch, SpeechPlugin, Stellent Fetch, TeleForm, Tri-CR, Ultraseek, Verity Profiler, Verity, VersiForm, WebDAV Connector, WorkSite Connector, and all related titles and logos are trademarks of Hewlett-Packard Development Company, L.P. and its affiliates, which may be registered in certain jurisdictions.

Microsoft is a registered trademark, and MS-DOS, Windows, Windows 95, Windows NT, SharePoint, and other Microsoft products referenced herein are trademarks of Microsoft Corporation.

UNIX is a registered trademark of The Open Group.

AvantGo is a trademark of AvantGo, Inc.

Epicentric Foundation Server is a trademark of Epicentric, Inc.

Documentum and eRoom are trademarks of Documentum, a division of EMC Corp.

FileNet is a trademark of FileNet Corporation.

Lotus Notes is a trademark of Lotus Development Corporation.

mySAP Enterprise Portal is a trademark of SAP AG.

Oracle is a trademark of Oracle Corporation.

Adobe is a trademark of Adobe Systems Incorporated.

Novell is a trademark of Novell, Inc.

Stellent is a trademark of Stellent, Inc.

All other trademarks are the property of their respective owners.

Notice to Government End Users

If this product is acquired under the terms of a DoD contract: Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of 252.227-7013. Civilian agency contract: Use, reproduction or disclosure is subject to 52.227-19 (a) through (d) and restrictions set forth in the accompanying end user agreement. Unpublished-rights reserved under the copyright laws of the United States. Autonomy, Inc., One Market Plaza, Spear Tower, Suite 1900, San Francisco, CA. 94105, US.

20 November 2014

Copyright Notice

Contents

About This Document ................................................................................................................ 5

Documentation Updates................................................................................................................ 5

Related Documentation................................................................................................................. 7

Conventions .................................................................................................................................. 8

Notational Conventions .......................................................................................................... 8

Command-Line Syntax Conventions ...................................................................................... 9

Notices ..................................................................................................................................10

HP Autonomy Product References...............................................................................................10

HP Autonomy Customer Support .................................................................................................10

Contact HP Autonomy..................................................................................................................11

Chapter 1 Introduction ................................................................................................................................. 13

Wittwin ACI Server .......................................................................................................................13

Video Sources and Logical Cameras ....................................................................................14

Storage Buffers .....................................................................................................................15

Send Video to Other Components ........................................................................................16

Display Online Help .....................................................................................................................16

Chapter 2 Install and Configure Wittwin................................................................................................ 17

Install Wittwin ..............................................................................................................................17

System Requirements ...........................................................................................................18

Install Wittwin ........................................................................................................................18

Configure Wittwin ........................................................................................................................19

Configure a Wittwin ACI Server ............................................................................................20

Configure the Storage Pool Configuration File ......................................................................21

Configure the Recording Settings in the Storage Database ..................................................22

Configure the Number of Available Inputs .............................................................................23

Wittwin ACI Server User Guide 3

• • • •••

Contents

4

Sample Database Configurations ............................................................................................... 23

Many Logical Cameras to One Storage Area ....................................................................... 24

One Logical Camera to One Storage Area ........................................................................... 25

Event Recording Example .................................................................................................... 27

Event Recording - Record Still Images from Analytics ......................................................... 29

Customize Logging ..................................................................................................................... 32

Chapter 3 Start and Stop Wittwin ............................................................................................................ 35

Start and Stop Wittwin ................................................................................................................ 35

Index ............................................................................................................................................... 37

Wittwin ACI Server User Guide

• • • •••

About This Document

This document is for users of Wittwin. It describes how to install and configure Wittwin.

Documentation Updates

Related Documentation

Conventions

HP Autonomy Product References

HP Autonomy Customer Support

Contact HP Autonomy

Documentation Updates

The information in this document is current as of Wittwin ACI Server version 8.1. The content was last modified 20 November 2014.

You can retrieve the most current product documentation from the HP Autonomy Knowledge Base on the Customer Support Site.

A document in the Knowledge Base displays a version number in its name, such as IDOL Server 7.5 Administration Guide. The version number applies to the product that the document describes. The document may also have a revision number in its name, such as IDOL Server 7.5 Administration Guide Revision 6. The revision number applies to the document and indicates that there were revisions to the document since its original release.

HP Autonomy recommends that you periodically check the Knowledge Base for revisions to documents for the products your enterprise is using.


• • • •••

About This Document

6

To access HP Autonomy documentation

1. Go to the HP Autonomy Customer Support site:

https://customers.autonomy.com/

2. Select Login.

3. Type the login credentials that you were given, and then select Login.

The Customer Support Site opens.

4. Select Knowledge Base.

The Knowledge Base Search page opens.

5. Either search or browse the Knowledge Base

To search the knowledge base: In the Search box, type a search term or phrase, and then select Search.

Documents that match the query display in a results list.

To browse the knowledge base: Select one or more of the categories in the Browse list. You can browse by:

Repository. Filters the list by Documentation produced by technical publications, or Solutions to Technical Support cases.

Product Family. Filters the list by product suite or division. For example, you could retrieve documents related to the iManage, IDOL, Virage or KeyView product suites.

Product. Filters the list by product. For example, you could retrieve documents related to IDOL Server, Virage Videologger, or KeyView Filter.

Version. Filters the list by product or component version number.

Type. Filters the list by document type. For example, you could retrieve Guides, Help, Packages (ZIP files), or Release Notes.

Format. Filters the list by document format. For example, you could retrieve documents in PDF or HTML format. Guides are typically provided in both PDF and HTML format.

6. To open a document, select its title in the results list.

To download a PDF version of a guide, open the PDF version, select the Download icon in the PDF reader, and save the PDF to another location.

To download a documentation ZIP package, select Get Documentation Package under the document title in the results list. Alternatively, browse to the desired ZIP package by selecting either the Packages document Type or the ZIP document Format from the Browse list.


• • • •••

https://customers.autonomy.com


HP Autonomy welcomes your comments.

To send feedback on HP Autonomy documentation

send e-mail to [email protected]

provide:

full document title with version and revision number

location: heading, a snippet of text or screen capture

your comments

your contact information in the event we need clarification


The following documents provide more details on Wittwin.

Wittwin Reference

The Wittwin Reference describes the configuration parameters and actions that you can use with Wittwin.


• • • •••

About This Document

8

Conventions

The following conventions are used in this document.

Notational ConventionsThis document uses the following conventions.

Convention Usage

Bold User-interface elements such as a menu item or button. For example:

Select Cancel to halt the operation.

Italics Document titles and new terms. For example:

For more information, see the IDOL Server Administration Guide.

An action command is a request, such as a query or indexing instruction, sent to IDOL Server.

monospace font File names, paths, and code. For example:

The FileSystemConnector.cfg file is installed in C:\Program Files\FileSystemConnector\.

monospace bold Data typed by the user. For example:

Type run at the command prompt.

In the User Name field, type Admin.

monospace italics Replaceable strings in file paths and code. For example:

user UserName


• • • •••

Conventions

Command-Line Syntax ConventionsThis document uses the following command-line syntax conventions.

The use of punctuation—such as single and double quotes, commas, periods—indicates actual syntax; it is not part of the syntax definition.

Convention Usage

[ optional ] Brackets describe optional syntax. For example:

[ -create ]

| Bars indicate “either | or” choices. For example:

[ option1 ] | [ option2 ]

In this example, you must choose between option1 and option2.

{ required } Braces describe required syntax in which you have a choice and that at least one choice is required. For example:

{ [ option1 ] [ option2 ] }

In this example, you must choose option1, option2, or both options.

required Absence of braces or brackets indicates required syntax in which there is no choice; you must type the required syntax element.

variable

<variable>

Italics specify items to be replaced by actual values. For example:

-merge filename1

(In some documents, angle brackets are used to denote these items.)

... Ellipses indicate repetition of the same pattern. For example:

-merge filename1, filename2 [, filename3 ... ]

where the ellipses specify, filename4, and so on.


• • • •••

About This Document

10

NoticesThis document uses the following notices:

HP Autonomy Product References

This document references the following HP Autonomy products.

Video Input Service (VIS)

HP Autonomy Customer Support

HP Autonomy Customer Support provides prompt and accurate support to help you quickly and effectively resolve any issue you may encounter while using HP Autonomy products. Support services include access to the Customer Support

CAUTION A caution indicates an action can result in the loss of data.

IMPORTANT An important note provides information that is essential to completing a task.

NOTE A note provides information that emphasizes or supplements important points of the main text. A note supplies information that may apply only in special cases—for example, memory limitations, equipment configurations, or details that apply to specific versions of the software.

TIP A tip provides additional information that makes a task easier or more productive.


• • • •••

Contact HP Autonomy

Site (CSS) for online answers, expertise-based service by HP Autonomy support engineers, and software maintenance to ensure you have the most up-to-date technology.

To access the Customer Support Site

go to https://customers.autonomy.com

The Customer Support Site includes:

Knowledge Base: The CSS contains an extensive library of end user documentation, FAQs, and technical articles that is easy to navigate and search.

Case Center: The Case Center is a central location to create, monitor, and manage all your cases that are open with technical support.

Download Center: Products and product updates can be downloaded and requested from the Download Center.

Resource Center: Other helpful resources appropriate for your product.

To contact HP Autonomy Customer Support by e-mail or phone

go to http://www.autonomy.com/work/services/customer-support

Contact HP Autonomy

You can contact HP Autonomy by e-mail at [email protected].

For office addresses, and other contact information, visit www.autonomy.com.


• • • •••

http://www.autonomy.com/work/services/customer-support

https://customers.autonomy.com

About This Document

12
• • • •••

CHAPTER 1 IntroductionThis section provides an introduction to Wittwin.

Wittwin ACI Server

Display Online Help

Wittwin ACI Server

Wittwin is an ACI Server that records and streams video.

Wittwin receives compressed video, audio, and metadata from the Video Input Service (VIS). Wittwin can simultaneously write the video to circular buffers (storage areas on disk), and stream both the live input and recorded data to other applications.

In response to requests from other applications, Wittwin can save video from a circular buffer to a file, and also stream this content. Wittwin can also record still images sent from a Video Stream Distributor (VSD) ACI Server.


• • • •••

Chapter 1 Introduction

14

Video Sources and Logical CamerasWittwin records video, audio, and metadata through logical cameras.

A logical camera takes data from the input, processes the data, and writes it to a circular buffer. You can customize each logical camera to perform a specific task. For example, event recording logical cameras record only when an alarm is triggered by an analytics component such as iSAS. When no alarms occur, the video is discarded.

You can configure multiple logical cameras for each video input. The benefit of having multiple logical cameras is that you can save the video from each camera in a separate buffer. Multiple logical cameras are often used for HP Surveillance setups.

In Figure 1, a single video input maps to two logical cameras. The Continuous Recording camera records continuously. The Event Recording camera records data only when an event occurs (for example when an alarm is triggered by an analytics component such as iSAS or ANPR).

You can also use a logical camera to capture video frames sent from analytics components (such as Commander, iSAS, or Face Recognition), and write these frames to a circular buffer. In this scenario, the logical camera does not take data from the video source.

Figure 1 A single input and multiple logical cameras


• • • •••

Wittwin ACI Server

If you are using Wittwin within an IDOL Video setup, it is unlikely that you need multiple logical cameras. Most IDOL Video setups require only continuous recording. It is possible to disable two of the three logical cameras and the remaining camera can be configured for continuous recording.

Storage BuffersWittwin records data to circular buffers (storage areas on disk, where the oldest data in the buffer is discarded to make space for new data). You set the size of each buffer, in megabytes, which determines how long content is stored.

If you are using a system which requires multiple Wittwin ACI Servers, they can be configured to use a shared storage pool.

Figure 2 Using a shared storage pool for Wittwin recordings

With a shared storage pool, any Wittwin ACI Server can access any storage buffer. Recordings can be stored centrally and can be accessed by any Wittwin. This allows requests to be distributed between multiple Wittwin ACI Servers.


• • • •••

Chapter 1 Introduction

16

Send Video to Other ComponentsYou can configure Wittwin to stream data to other Autonomy components. Wittwin supports Real-time Transport Protocol (RTP), RTP Control Protocol (RTCP), User Datagram Protocol (UDP), both multicast and unicast. Wittwin is compatible with media players which conform to these protocols, such as VLC and Quicktime, as well as Virage Media Player.

Display Online Help

You can display the Wittwin Reference (online help) by sending an action to Wittwin from your Web browser. The Wittwin Reference describes the configuration parameters and actions that you can use with Wittwin.

To display online help for Wittwin

1. Start Wittwin.

2. Send the following action to Wittwin, from your Web browser:

http://host:port/action=help

where,

For example:

http://localhost:15000/action=help

The online help opens.

host The host name or IP address of the machine where Wittwin is running.

port The Wittwin ACI port, as specified in the configuration file. The default ACI port for Wittwin is 15000.


• • • •••

CHAPTER 2 Install and Configure WittwinThis section describes how to install and configure Wittwin.

Install Wittwin

Configure Wittwin

Sample Database Configurations

Customize Logging

Install Wittwin

This section describes how to install Wittwin.


• • • •••

Chapter 2 Install and Configure Wittwin

18

System RequirementsThe following table lists the minimum requirements for Wittwin:

Install WittwinTo install Wittwin, follow these steps.

To install Wittwin

1. Run the Wittwin installation wizard.

The Welcome dialog box opens.

2. Click Next.

The Choose Destination Location dialog box opens.

3. To install Wittwin to the default location, click Next. To install Wittwin to a different folder, click Browse and select the folder. Then, click Next.

The Start Installation dialog box opens.

4. Click Next.

The Wittwin ACI Server is installed.

5. Click Finish.

6. In the Wittwin installation folder, open the configuration file WittwinAciServer.cfg and specify the details of your license server. You must set the following parameters:

Operating System Install Wittwin on a Microsoft Windows Server operating system:

Windows Server 2008

Windows Server 2003

Memory 1 GB

Storage Storage requirements depend on the duration and quality of the video streams, and the number of streams recorded.

Video Source You must have a video source (such as the Video Input Service), unless you are using media files.

LicenseServerHost The host name or IP address of the machine that hosts your License Server.

LicenseServerACIPort The ACI port of your License Server.


• • • •••

Configure Wittwin

7. Save and close the configuration file.

Configure Wittwin

Wittwin is configured by editing the following configuration files and databases:

Wittwin ACI Server configuration file. Each Wittwin has a configuration file that specifies a unique identifier for the Wittwin ACI Server, and the location of the storage pool configuration file.

Storage Pool configuration file. The Storage Pool configuration file specifies the location of a storage database for each Wittwin ACI Server. The unique identifier of each Wittwin ACI Server is mapped to the location of the storage database for that server.

Storage Database. The Storage Database is an SQLite database which defines the recording settings, including:

The logical cameras to use to record the video.

The location and size of the circular buffers where the data is stored.

The use of the storage pool configuration file means that every Wittwin ACI Server can access its own storage database, and read the storage database of other Wittwin ACI servers. This means that any Wittwin can read any circular buffer and extract data written to disk by another Wittwin.

To configure Wittwin, complete the following procedures:

Configure a Wittwin ACI Server

Configure the Storage Pool Configuration File

Configure the Recording Settings in the Storage Database


• • • •••


20

Configure a Wittwin ACI ServerTo configure a Wittwin ACI Server, follow these steps.

To configure a Wittwin ACI Server

1. Open the Wittwin installation folder (the default location is C:\Autonomy\WittwinAciServer).

2. Open the WittwinAciServer.cfg configuration file.

3. In the configuration file, find the [STORAGE] section.

4. In the [STORAGE] section, use the ID parameter to specify a unique identifier for this Wittwin ACI Server.

5. In the [STORAGE] section, use the Pool parameter to specify the location of the Storage Pool Configuration file. For example:

Pool=\\myserver\pool\storagepool.cfg

6. (Optional) Customize the remaining parameters in the configuration file. These parameters specify the ACI port of the Wittwin ACI Server, and specify settings for video distributed from Wittwin. For more information about the parameters that you can configure, refer to the Wittwin Reference.


Related Topics

“Configure the Storage Pool Configuration File” on page 21

“Configure the Recording Settings in the Storage Database” on page 22

NOTE If you are using a single Wittwin, you do not need to modify the configuration file or storage pool configuration file.

The default configuration file points to the storage pool configuration file that is installed in the Wittwin installation directory (storagepool.cfg). This file points to the storage database (SystemConfDB.dbs) in the same folder.

IMPORTANT If your storage pool is on another machine on the network, you must ensure that Wittwin can access that machine.


• • • •••

Configure Wittwin

Configure the Storage Pool Configuration FileThe storage pool configuration file specifies the location of a storage database for each of your Wittwin ACI Servers.

A storage pool configuration file (storagepool.cfg) is installed in the Wittwin installation folder. You can use this file as a template to build your own configuration.

An example storage pool configuration file might look like this:

STORAGE_POOL_COUNT=2StorageID= wittwinserver01;DBLOCATION= \\databases\Virage1;StorageID= wittwinserver02;DBLOCATION= \\databases\Virage2;

where,

In this example:

wittwinserver01 loads the SystemConfDB.dbs database from\\databases\Virage1.

wittwinserver02 loads the SystemConfDB.dbs database from\\databases\Virage2.

If either Wittwin needs to read data from a circular buffer, they can read the storage database of the other Wittwin.

Related Topics

“Configure a Wittwin ACI Server” on page 20

“Configure the Recording Settings in the Storage Database” on page 22

STORAGE_POOL_COUNT The total number of storage databases configured in the storage pool configuration file.

StorageID The identifier for a Wittwin Server (as specified in the Wittwin ACI Server configuration file).

DBLOCATION The location of the SystemConfDB.dbs configuration database for the Wittwin ACI Server specified by StorageID.

IMPORTANT If the database you specify for a Wittwin ACI Server does not exist, that Wittwin does not start.


• • • •••


22

Configure the Recording Settings in the Storage DatabaseThe Storage Database is an SQLite database that specifies the recording settings for a Wittwin ACI Server (for example, the number of logical cameras to use, the settings for each logical camera, and the size and location of the circular buffers).

To modify the settings stored in the database, you can use a command-line window or the SQLite manager.

The settings that are most frequently changed are:

Number of inputs. The default storage database can be used with up to 16 video inputs. You cannot set the number of inputs to be larger than 16.

update WITTWIN_SYSTEM_TABLE set NoOfPhysicalCameras=8;

For information about changing the database to recognise up to 32 or 64 inputs, see “Configure the Number of Available Inputs” on page 23.

Number of logical cameras. Video inputs can map to one or multiple logical cameras. For example, to map one logical camera to each video input:

update WITTWIN_SYSTEM_TABLE set NoOfLogicalCameras=NoOfPhysicalCameras;

Mapping of the logical cameras to storage areas. Multiple logical cameras can use the same storage area, or one logical camera can use its own storage area. To set all logical cameras to use the same storage area:

update WITTWIN_LOGICAL_CAMERA_TABLE set StorageArea=0;

Storage area sizes. Storage areas are circular buffers. The size required is dependant on the bitrate of the video input. For example,

update WITTWIN_SYSTEM_STORAGE_TABLE set StorageAreaSizeinMB=10000;

Index path. The path where the index files are stored. The index files contain the Coordinated Universal Time (UTC) and filename of the videos for retrieval. For example,

update WITTWIN_SYSTEM_STORAGE_TABLE set INDEX_LOCATION='\\storageServer\storageFolder\area0' where StorageAreaIndex=0;

Video path. The path where the video and audio files are stored. For example,

NOTE The default Storage Database (SystemConfDB.dbs) can be used with up to 16 video inputs. If you need to record more than 16 inputs, see “Configure the Number of Available Inputs” on page 23.


• • • •••


update WITTWIN_SYSTEM_STORAGE_DISKS_TABLE set DiskPath='\\storageServer\storageFolder\area0' where StorageAreaIndex=0;

For example settings for the most common configurations, see “Sample Database Configurations” on page 23.

Related Topics

“Video Sources and Logical Cameras” on page 14

Configure the Number of Available InputsWhen Wittwin starts, it loads all of the databases defined in the storage pool configuration file (to force Wittwin to reload the databases, restart Wittwin or run the ReloadStoragePool action).

The default database can handle a maximum of 16 inputs.

The other databases that are available, SystemConfDB32.dbs, and SystemConfDB64.dbs, can handle a maximum of 32 or 64 inputs, respectively. If you need more than 16 inputs, you can rename the database files.

If you require more than 64 inputs, contact Autonomy Customer Support.

To change the default number of inputs

1. Rename the default database file (SystemConfDB.dbs) to SystemConfDB16.dbs.

2. Rename SystemConfDB32.dbs (32 inputs) or SystemConfDB64.dbs (64 inputs) to SystemConfDB.dbs.

3. You must configure the recording settings in the new database. See “Configure the Recording Settings in the Storage Database” on page 22.

4. Restart Wittwin, or run the ReloadStoragePool action. For more information about this action, refer to the Wittwin Reference.


This section contains example procedures that show how to configure the Wittwin storage database.

Many Logical Cameras to One Storage Area

One Logical Camera to One Storage Area

Event Recording Example


• • • •••


24

Event Recording - Record Still Images from Analytics

Many Logical Cameras to One Storage AreaThis example shows how to configure many logical cameras to write data to one storage area. This means that all the data from the logical cameras is written at once, reducing the number of times data is recorded to the physical hard drive of the storage area.

This setup can be used when all inputs are to be recorded for the same duration (the size of the storage area defines the buffer length).

To set up a many-to-one mapping

1. In the Wittwin installation folder, open the SystemConfDB.dbs database with the sqlite.exe utility.

A command-line window opens.

2. Set the number of inputs. Using the default database, you can have up to 16 inputs:


3. Set the number of logical cameras to be the same as inputs. This means that each input has one logical camera.


4. Set the number of circular buffer storage areas.

update WITTWIN_SYSTEM_TABLE set NoOfStorageAreas=1;

5. Map the logical cameras to the storage area.


• • • •••


update WITTWIN_LOGICAL_CAMERA_TABLE set StorageArea=0;

6. Set the size of the storage area (in megabytes)

update WITTWIN_SYSTEM_STORAGE_TABLE set StorageAreaSizeinMB=10000;

7. Set the index location of the storage area.

update WITTWIN_SYSTEM_STORAGE_TABLE set INDEX_LOCATION='\\storageServer\storageFolder\area0';

8. Set the disk (video file) path. This can be different to the index location.

update WITTWIN_SYSTEM_STORAGE_DISKS_TABLE set DiskPath='\\storageServer\storageFolder\area0' where StorageAreaIndex=0;

One Logical Camera to One Storage AreaThis example shows how to configure one storage area for every logical camera. This configuration is useful when you have only one input per Wittwin that consists of high-quality video. The input from that Wittwin is then saved to one location, which may be a disk of its own or may be a storage pool in a section dedicated to that Wittwin.

To set up a one-to-one mapping



2. Set the number of inputs. Using the default database, you can have up to 16 inputs:



• • • •••


26

3. Set the number of logical cameras to be the same as inputs. This means that each input has one logical camera.


4. Set the number of circular buffer storage areas to be the same as the number of logical cameras.

update WITTWIN_SYSTEM_TABLE set NoOfStorageAreas=NoOfLogicalCameras;

5. Assign each logical camera to exactly one storage area, ensuring a one-to-one mapping.

update WITTWIN_LOGICAL_CAMERA_TABLE set StorageArea=LogicalCameraNo;

6. Insert new storage areas into the database. The database must have NoOfStorageAreas entries. Note that two storage areas exist by default so two more must be added.

The database entry fields are as follows:

0, (This is always zero)

storageAreaNumber,

'DISKstorageAreaNumber’,

storageAreaSize, (in megabytes)

NoOfDisks

eventsDatabase, (set to blank)

filepath_to_StorageArea,

memoryAllocation,

0 (This is always zero)

INSERT INTO WITTWIN_SYSTEM_STORAGE_TABLE VALUES(0,2,'DISK2',1000,0,'','\\server\video\area2\index',23,0);INSERT INTO WITTWIN_SYSTEM_STORAGE_DISKS_TABLE VALUES(0,2,0,'\\server\video\area2\');

NOTE The storage areas are numbered starting from zero. So the first storage area is number 0, the second storage area is 1, and so on.


• • • •••


INSERT INTO WITTWIN_SYSTEM_STORAGE_TABLE VALUES(0,3,'DISK3',1000,0,'','\\server\video\area3\index',23,0);INSERT INTO WITTWIN_SYSTEM_STORAGE_DISKS_TABLE VALUES(0,3,0,'\\server\video\area3\');

7. Set the index location for the default two storage areas (where N is the number of the storage area, starting from zero).

update WITTWIN_SYSTEM_STORAGE_TABLE set INDEX_LOCATION='\\storageServer\storageFolder\areaN';

8. Set the disk (video file) path for the two default storage area entries.

update WITTWIN_SYSTEM_STORAGE_DISKS_TABLE set DiskPath='\\storageServer\storageFolder\areaN' where StorageAreaIndex=N;

9. Decrease the memory allocation for the storage areas. The MemAlloc value is the power of two, so a MemAlloc=23 is 223 bytes, or 8MB.

update WITTWIN_SYSTEM_STORAGE_TABLE set MemAlloc=23;

Event Recording ExampleThis example shows how to configure one background storage (continuous recording) camera and one event-triggered storage camera for each physical camera (video input).

This example is for a 16-camera configuration and makes use of the default configuration. By default, the storage database is configured with logical cameras 0-15 and 16-31 mapped to physical cameras 0-15.


• • • •••


28

This example uses two storage areas, the first for the background recordings, and the second, larger, area for event-triggered recordings. By default there are two storage areas, so we only need to modify the locations and size.

To modify the settings in the database



2. Reduce the number of Logical Cameras from the default of 48 to 32:

update WITTWIN_SYSTEM_TABLE set NoOfLogicalCameras=32;

3. Convert the video motion detect (VMD) logical cameras in the default configuration to storage logical cameras:

update WITTWIN_LOGICAL_CAMERA_TABLE set LogicalCameraType='STORAGE' where LogicalCameraNo>15;

4. Set the size, index location, and path of the continuous recording storage area:

update WITTWIN_SYSTEM_STORAGE_TABLE set StorageAreaSizeinMB=10000 where StorageAreaIndex=0;

update WITTWIN_SYSTEM_STORAGE_TABLE set INDEX_LOCATION='\\storageServer\storageFolder\background' where StorageAreaIndex=0;

update WITTWIN_SYSTEM_STORAGE_DISKS_TABLE set DiskPath='\\storageServer\storageFolder\background' where StorageAreaIndex=0;

5. Set the size, index location and the path of the event recording storage area:


update WITTWIN_SYSTEM_STORAGE_TABLE set INDEX_LOCATION='\\storageServer\storageFolder\events' where StorageAreaIndex=1;

update WITTWIN_SYSTEM_STORAGE_DISKS_TABLE set DiskPath='\\storageServer\storageFolder\events' where StorageAreaIndex=1;

6. Disable background recording for logical cameras 16-31:

update WITTWIN_LOGICAL_CAMERA_HOURLY_SETTINGS_TABLE set Enabled=0 where LogicalCameraNo>15;

7. Map this set of logical cameras (cameras 16-31) to the events storage area:

update WITTWIN_LOGICAL_CAMERA_TABLE set StorageArea=1 where LogicalCameraNo>15;


• • • •••


8. (Optional) If pre-event recording is required for the event-triggered cameras, complete the following steps:

a. Enable pre-event recording:

update WITTWIN_LOGICAL_CAMERA_TABLE set PreEventEnabled=1 where LogicalCameraNo>15;

b. You can choose the amount of video that is held in Wittwin’s memory for pre-event recording. For example, to save 30 seconds of video in memory:

update WITTWIN_LOGICAL_CAMERA_TABLE set PreEventDurationinSeconds=30;

c. (Optional) To change the frame rate of the video that is held in memory for pre-event recording, use the following command. This example saves the video in memory at 5 frames per second. To modify the frame rate, you must have some knowledge of the input video stream, because reduced frame rates work only with I frames / IDRs.

update WITTWIN_LOGICAL_CAMERA_TABLE set PreEventCaptureRateFPS=5;

Event Recording - Record Still Images from AnalyticsThis example shows how to configure one background storage camera and one event-triggered storage camera per physical camera, plus one storage camera to receive still images of the event sent from analytics components (such as Face Recognition, ANPR, or iSAS).

NOTE The amount of video that is actually saved during pre-event recording depends on the event that is triggered. This is configured in the analytics component (for example iSAS).


• • • •••


30

The logical camera that receives still images from the analytics components must be configured so that it does not process any video from the physical camera (the video input).

This example is for a 16 camera configuration and makes use of the default configuration. By default, the database is configured with logical cameras 0-15, 16-31 and 32-47 mapped to physical cameras 0-15. (Logical cameras 0, 16, and 32 are mapped to physical camera 0, logical cameras 1,17, and 33 are mapped to physical camera 1, and so on).

This example uses two storage areas, the first for the background recordings, and the second, larger, area for event-triggered recordings and the still images. By default there are two storage areas, so we only need to modify their locations and size.

To modify the settings in the database



2. Convert the video motion detect (VMD) logical cameras in the default configuration to storage logical cameras, to store events and the still images from the analytics components.

update WITTWIN_LOGICAL_CAMERA_TABLE set LogicalCameraType='STORAGE' where LogicalCameraNo>15;

3. Set the size, index location and the disk (video file) path of the background storage area:


• • • •••



update WITTWIN_SYSTEM_STORAGE_TABLE set INDEX_LOCATION='\\storageServer\storageFolder\background' where StorageAreaIndex=0;

update WITTWIN_SYSTEM_STORAGE_DISKS_TABLE set DiskPath='\\storageServer\storageFolder\background' where StorageAreaIndex=0;

4. Set the size, index location and the disk (video file) path of the event recording storage area:


update WITTWIN_SYSTEM_STORAGE_TABLE set INDEX_LOCATION='\\storageServer\storageFolder\events' where StorageAreaIndex=1;

update WITTWIN_SYSTEM_STORAGE_DISKS_TABLE set DiskPath='\\storageServer\storageFolder\events' where StorageAreaIndex=1;

5. Turn off background recording for storage cameras 16-47:

update WITTWIN_LOGICAL_CAMERA_HOURLY_SETTINGS_TABLE set Enabled=0 where LogicalCameraNo>15;

6. Map this set of storage cameras to the events storage area:

update WITTWIN_LOGICAL_CAMERA_TABLE set StorageArea=1 where LogicalCameraNo>15;

7. (Optional) If pre-event recording is required for the event-triggered cameras, complete the following steps:

a. Enable pre-event recording:

update WITTWIN_LOGICAL_CAMERA_TABLE set PreEventEnabled=1 where LogicalCameraNo>15 and LogicalCameraNo<32;

b. You can choose the amount of video that is held in Wittwin’s memory for pre-event recording. For example, to save 30 seconds of video in memory:

update WITTWIN_LOGICAL_CAMERA_TABLE set PreEventDurationinSeconds=30;

c. (Optional) To change the frame rate of the video that is held in memory for pre-event recording, use the following command. This example saves the

NOTE The amount of video that is actually saved during pre-event recording depends on the event that is triggered. This is configured in the analytics component (for example iSAS).


• • • •••


32

video in memory at 5 frames per second. To modify the frame rate, you must have some knowledge of the input video stream, because reduced frame rates work only with I frames / IDRs.

update WITTWIN_LOGICAL_CAMERA_TABLE set PreEventCaptureRateFPS=5;

Customize Logging

The default folder for Wittwin log files is C:\Autonomy\WittwinAciServer\logs\. By default, Wittwin generates the following log files:

You can customize logging by modifying the logging configuration parameters in the Wittwin configuration file.

To customize logging

1. Open the Wittwin configuration file in a text editor.

2. Find the [Logging] section. (If the configuration file does not contain a [Logging] section, create one).

3. Under the [Logging] section heading, create a list of the log streams you want to set up using the format N=LogStreamName. List the log streams in consecutive order, starting from 0 (zero). For example:

[Logging]0=ApplicationLogStream1=ActionLogStream

4. Create a new section for each of the log streams you defined. Each section must have the same name as the log stream. For example:

[ApplicationLogStream][ActionLogStream]

5. Specify the settings you want to apply to each log stream in the appropriate section. You can specify the type of logging to perform (for example, full logging), whether to display log messages on the console, the maximum size of log files, and so on. For example:

[ApplicationLogStream]

action.log Logs actions and related messages.

application.log Logs application messages.

stream.log Logs all messages related to streaming.


• • • •••

Customize Logging

logfile=application.loglogtypecsvs=applicationloghistorysize=50logtime=truelogmaxsizekbs=1024loglevel=full

[ActionLogStream]logfile=action.loglogtypecsvs=actionloghistorysize=50logtime=truelogmaxsizekbs=1024loglevel=full


7. Restart Wittwin for your changes to take effect.

Related Topics

“Start and Stop Wittwin” on page 35.


• • • •••


34
• • • •••

CHAPTER 3 Start and Stop WittwinThis section describes how to start and stop Wittwin.

Start and Stop Wittwin

Start and Stop Wittwin

After you have configured Wittwin, you can start the service. To start or stop Wittwin, use the following procedure.

To start or stop the Wittwin ACI Server

1. Open the Windows Services dialog box.

a. Open the Windows Control Panel in large icons view.

b. Click Administrative Tools.

c. Double-click Services.

2. In the services list, click Virage Wittwin ACI Server.

3. Click Start or Stop.


• • • •••

Chapter 3 Start and Stop Wittwin

36

TIP If Wittwin does not start, check the application log (by default, logs/application.log). Also ensure that you have a valid license and your license server is specified correctly in the Wittwin configuration file. If Wittwin does not find a valid license, a message will appear in the file license.log.


• • • •••

Index

C

configure

Wittwin ACI Server 22

samples 23

L

logical cameras 14, 22

S

shared storage pool 15

storage area 22

storage pool 15

system requirements

Wittwin ACI Server 18

W

Wittwin ACI Server

configuration 22

sample configurations 23

system requirements 18


• • • •••

Index

38
• • • •••

IDOL Video Wittwin ACI Server 8.1 User Guideh30359. Distribution Suite... · ... File System...

Documents

Transcript of IDOL Video Wittwin ACI Server 8.1 User Guideh30359. Distribution Suite... · ... File System...