Optimus XELLIP SERV MAX User manual

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 1 of 189 603-0052 D

49412 SAUMUR

France

CASTELServeur

User Manual

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 2 of 189 603-0052 D

49412 SAUMUR

France

Summary

Presentation .................................................................................................. 8

Reference documents .......................................................................................... 8

General Description ............................................................................................. 8

Features............................................................................................................... 8

Client/Server application ......................................................................................................... 8

IP communication on IP network ............................................................................................. 9

Data security .......................................................................................................................... 9

« System.xml » file .............................................................................................. 9

Database access ..................................................................................................................... 9

VDUC Communication settings............................................................................................... 10

VDUC Auto Update at reconnection time ................................................................................ 10

Default language for application ............................................................................................ 10

Recording parameters ........................................................................................................... 10

Trace parameters ................................................................................................................. 11

HTML parameters ................................................................................................................. 11

Communication with CASTELAcces application parameters ...................................................... 12

Communication with CASTELSuperviseur application parameters ............................................. 12

SQL scripting with the agenda ............................................................................................... 13

Application data save parameters .......................................................................................... 13

Macro-relation templates parameters ..................................................................................... 13

Reserved CASTEL ................................................................................................................. 14

CASTELServeur Web Pages ......................................................................... 15

Authentication ................................................................................................... 15

Home page ........................................................................................................ 15

Users management ..................................................................................... 17

Features............................................................................................................. 17

Features group .................................................................................................. 19

User profile ........................................................................................................ 21

Users.................................................................................................................. 24

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 3 of 189 603-0052 D

49412 SAUMUR

France

Material Management ................................................................................. 27

Material Configuration ....................................................................................... 27

Material Tree ..................................................................................................... 27

VDIP Network .................................................................................................... 29

Add a domain ....................................................................................................................... 30

Domain Management ............................................................................................................ 31

Add a VDUC ......................................................................................................................... 32

Add a « VDUC Evo » ............................................................................................................. 33

Add a XellIP workstation or door panel................................................................................... 35

Adding a XELLIP server ......................................................................................................... 37

Time configuration ................................................................................................................ 38

Configuration .............................................................................................. 40

The Functions .................................................................................................... 40

Functions Visualisation ...................................................................................... 40

Function detailed view .......................................................................................................... 41

Adding/Modifying a Function ............................................................................ 42

Adding/Modifying a state ....................................................................................................... 42

Function commands .......................................................................................... 43

General SIP Configuration ................................................................................. 43

Configuration general to all workstations and door panels ....................................................... 44

SIP servers configuration ...................................................................................................... 46

General configuration for all XELLIP agents ...................................................... 47

The phone users ................................................................................................................... 48

The directory ........................................................................................................................ 48

Code / Local Access .............................................................................................................. 49

Schedule configuration .......................................................................................................... 51

XELLIP servers................................................................................................... 52

The general parameters ........................................................................................................ 52

DialPlan ............................................................................................................................... 54

XELLIP Extensions ................................................................................................................ 54

Call Groups .......................................................................................................................... 56

Paging groups ...................................................................................................................... 56

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 4 of 189 603-0052 D

49412 SAUMUR

France

External systems ............................................................................................... 57

Inter Connection between two SIP systems ............................................................................ 57

Connection type selection...................................................................................................... 58

The external servers ............................................................................................................. 59

External Clients .................................................................................................................... 60

External call rules ................................................................................................................. 61

External Extensions ............................................................................................................... 62

The VDUC .................................................................................................... 64

VDUC Management ............................................................................................................... 64

VDUC Parameters ................................................................................................................. 65

VDUC configuration .............................................................................................................. 65

Bus RS485 ........................................................................................................................... 66

Logical devices ..................................................................................................................... 67

VDUC local configuration ................................................................................... 67

SIP Configuration.................................................................................................................. 67

VDUC Evo ..................................................................................................... 71

VDUC Evo material configuration ...................................................................... 71

VDUC Evo « Management » .................................................................................................. 71

VDUC Evo « Configuration » .................................................................................................. 72

VDUC EVO « Parameters » .................................................................................................... 73

Local Interfaces configuration ................................................................................................ 73

Bus RS485 ........................................................................................................................... 73

Logical devices ..................................................................................................................... 76

XELLIP workstations and door panels ........................................................ 78

Material configuration ....................................................................................... 78

« Management » Tab ............................................................................................................ 78

« Configuration » Tab ........................................................................................................... 79

XELLIP equipment configuration ............................................................................................ 80

Local interfaces “configuration” Tab ....................................................................................... 80

XELLIP equipment Local Configuration ............................................................. 81

SIP Configuration.................................................................................................................. 81

Call Management .................................................................................................................. 84

Functions Keys / Buttons ....................................................................................................... 85

Lift configuration .................................................................................................................. 85

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 5 of 189 603-0052 D

49412 SAUMUR

France

Profiles Management ............................................................................................................ 86

The phone users ................................................................................................................... 92

Codes / Local Access ............................................................................................................. 92

XELLIP Servers ............................................................................................ 93

Server Management .......................................................................................... 93

Server Configuration ......................................................................................... 93

RS485 Devices Management ...................................................................... 95

VDIP device parameters ........................................................................................................ 95

VDIP device Configuration ..................................................................................................... 96

Aperio lock parameters ......................................................................................................... 97

Aperio lock configuration ....................................................................................................... 97

Interfaces Management .............................................................................. 99

Reader Parameters ............................................................................................................... 99

Reader Configuration ........................................................................................................... 100

Table of correspondence between the card types and type of badge in CASTELServeur ........... 101

Aperio reader parameters ..................................................................................................... 103

Aperio reader configuration .................................................................................................. 104

Input Parameters ................................................................................................................. 104

Input Configuration .............................................................................................................. 106

Output Parameters .............................................................................................................. 107

Output Configuration ........................................................................................................... 108

VDUC Audio Interface Parameters ........................................................................................ 109

VDUC Audio Interface Configuration ..................................................................................... 110

XELLIP Audio Interface Parameters ....................................................................................... 111

XELLIP audio interface configuration ..................................................................................... 115

Commands associated to an audio interface .......................................................................... 118

Configure an audio interface’s associated command............................................................... 119

VDUC Video Interface Parameters ......................................................................................... 120

VDUC Video interface configuration ...................................................................................... 121

XELLIP Video Interface Parameters ....................................................................................... 122

XELLIP Video interface configuration ..................................................................................... 123

Phone Line interface Parameters .......................................................................................... 124

Phone Line interface Configuration ....................................................................................... 124

Software Interface Parameters ............................................................................................. 125

Software Interface Configuration .......................................................................................... 126

Display Interface ................................................................................................................. 126

Keyboard Interface .............................................................................................................. 127

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 6 of 189 603-0052 D

49412 SAUMUR

France

Equipment Connections ............................................................................ 129

Serial Port Management ........................................................................... 130

Serial Port parameters..................................................................................... 130

Serial Port Configuration ................................................................................. 131

Serial Messages Display .................................................................................. 132

Visualisation/Configuration of a message ....................................................... 133

Action/Command on the serial port ................................................................ 134

VDMP Management ................................................................................... 136

VDMP Peripheral .............................................................................................. 136

Audio Channels Configuration ......................................................................... 137

Behaviour .................................................................................................. 139

Relations management ............................................................................. 140

Relations Visualisation .................................................................................... 140

Listing the relation by material element ................................................................................. 140

Detailed visualisation of a relation ......................................................................................... 141

Adding/Modifying a Relation ........................................................................... 142

Choosing the type of relation ................................................................................................ 142

Definition/edition of a relation .............................................................................................. 142

Simple logical event definition .............................................................................................. 145

Material element selection .................................................................................................... 147

Advanced logical event definition .......................................................................................... 148

Numerical event definition .................................................................................................... 149

Scheduled relation definition ................................................................................................ 151

Actions Definition ................................................................................................................. 152

Configure a call on VDUC ..................................................................................................... 154

Configure a call on XELLIP agents ......................................................................................... 157

Macro-relations management ................................................................... 160

Macro-relations visualisation .......................................................................... 160

Visualisation of a macro-relation ..................................................................... 161

Macro-relation configuration ........................................................................... 162

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 7 of 189 603-0052 D

49412 SAUMUR

France

Macro-relation duplication .............................................................................. 162

Exporting a macro-relation .............................................................................. 163

Using Macro-Relation templates ..................................................................... 164

Legal holidays configuration ..................................................................... 165

Legal holidays list ............................................................................................ 165

Legal holiday creation .......................................................................................................... 166

Legal holiday remove ........................................................................................................... 167

Legal holiday modification .................................................................................................... 168

Legal holidays group list ....................................................................................................... 169

Legal holidays group modification ......................................................................................... 170

Functions scheduling ............................................................................................................ 171

Functions scheduling behaviour principles ............................................................................. 171

Function scheduling modification .......................................................................................... 173

Adding/Modifying a schedule ................................................................................................ 174

Perform an action command ..................................................................... 175

Events Recording management ................................................................ 176

Recording Items .............................................................................................. 176

Recording – List of events ............................................................................... 179

Recording – Real Time ..................................................................................... 179

Recording – Purge ........................................................................................... 180

Recording – Purge File .................................................................................... 182

Recording – Purge File + remove .................................................................... 182

Scheduling management .......................................................................... 185

Scheduling tasks .............................................................................................. 185

Data Application Management .................................................................. 189

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 8 of 189 603-0052 D

49412 SAUMUR

France

P

R

E

S

E

N

T

A

T

I

O

N

Reference documents

This document makes reference several times to other software or material elements of the

VDIP system architecture. For more details about these components, please refer to the

appropriate documents:

VDUC module documentation

VDIP peripheral device documentation

CASTELAcces documentation

CASTELSuperviseur documentation

VDIPMedia documentation

XELLIP stations documentation

XELLIP servers documentation

VDUC Evo documentation

General Description

CASTELServeur can manage a VDIP system composed of CASTEL equipment such as

VDUC (with the configured peripherals) or XELLIP workstations and servers. The main

features available are:

VDIP system configuration:

o Configure the material behaviour

o Perform commands on the material

o Configure system users

o Configure a recording parameters

o Configure scheduling task in an agenda. (Database cleaning, material time

update)

o Save/Restore a full database configuration

Bridge between material devices and “satellite” softwares (CASTELAcces and

CASTELSuperviseur) for:

o Ask for material information (state, release, etc…),

o Send/Receive configuration data,

o Perform remote commands,

o Receive events

VDIP Users management: The “satellite” softwares use CASTELServeur to

manage users and their rights.

Features

Client/Server application

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 9 of 189 603-0052 D

49412 SAUMUR

France

CASTELServeur is a client/server web application developed in Java language with the

latest web technologies.

Its installation requires a database (SQL Server, Oracle, etc…) and a web server

(Apache/Tomcat). (See Installation section for more details)

Once the installation is done, a user can access the software from any PC connected on the

network by using a simple web navigator as Internet Explorer, Netscape, Firefox or else.

IP communication on IP network

Communication between CASTELServeur and the managed equipments is performed on a

standard IP network and does not require any specific wiring.

Data security

Exchanges between CASTELServeur and VDIP system devices (VDUC or XELLIP

equipments) are encrypted in order to provide communication privacy over the network.

RC4, a symmetric key stream cipher is used.

SSL, a cryptographic protocol is used for communications between a web client and

CASTELServeur.

« System.xml » file

« System.xml » is the application configuration file. This file is found under “Program

Files/CASTELSuite/Tomcat6/webapps/CASTELServeur/conf”.

To open it, please launch « Start Programs CASTELSuite 

CASTELServeurSystem.xml ».

It allows the user to configure the following items:

Database access

The following XML element is concerned:

<bdd>

<factory>ausy.utils.data.SqlServerDataSourceFactory</factory>

<factoryOracle>ausy.utils.data.OracleDataSourceFactory</factoryOracle

>

<nom>XnetWebServeur</nom>

<instance>XnetWebServeur</instance >

<adresse>localhost</adresse>

<pass>CASTELvdip49</pass>

</bdd>

Only the bold fields can be modified:

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 10 of 189 603-0052 D

49412 SAUMUR

France

1. factory: Rename <factory> tab by <factoryMSDE> and <factoryOracle> by

<factory> for an Oracle configuration as VDIP works with <factory> tag.

2. adresse : IP Address used by the PC that holds the database,

3. port: TCP/IP port number used by database to provide a client communication with

the TCP/IP network protocol. (default 1433),

4. user and pass : Login and password used to connect to the database.

VDUC Communication settings

The following part is implicated:

<class>com.castel.xnet.xnetipcomm.XNetIPComm</class>

<rc4key>CASTEL</rc4key>

</modcom>

Only the bold fields can be modified:

1. rc4key: Value of the encryption key used to crypt the data exchanged with the

VDUCs. WARNING: if you change this value, you must also modify this value in the

VDUCs, the XELLIP equipments and the VDIPMedia installations.

VDUC Auto Update at reconnection time

The following part is implicated:

</material>

Only the bold fields can be modified:

1. VDUCAutoUpdateOnReconnection:

a. « true » indicates that the configuration of the equipment will be controlled on

reconnection and will be updated automatically if incorrect.

b. « false » indicates that the equipment will not be updated at reconnection.

The configuration will anyway be checked and the differences will be indicated

in the web pages.

Default language for application

The following part is implicated:

</language>

Please specify the default language:

1. fr : French

2. en : English

Recording parameters

The following part is implicated:

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 11 of 189 603-0052 D

49412 SAUMUR

France

</historyparam>

Only the bold fields can be modified:

1. nbdays: This parameter allows the user to define the maximum number of days

events should be kept in the database when a “database cleaning” task occurs in the

agenda. The older events are cleaned and eventually stored in archive purge files

depending on the “XML file filing” parameter.

Example: If nbdays equals 1 and if a « Cleaning database » task is scheduled in the

night of the 5

th

and 6

th

of January, all events occurred the 5

th

are kept and all older

events are removed from the database.

2. filedepth: This parameter is used to define the maximum number of days xml purge

file should be kept on the hard disk. When a « database cleaning » task occurs, all

older purge files will be removed

Example: If « filedepth » equals 365 and if a « Cleaning database » task is scheduled in

the night of the 5

th

and 6

th

of January 2006, all xml files whose creation date is older

than 5 January 2005 are definitively removed.

Trace parameters

The following part is implicated:

<trace>

<mode>FILE,CONSOLE</mode>

<nb_logs>2</nb_logs>

<path>C:\Program Files\CASTELSuite\Server_log</path>

</trace>

Only the bold fields can be modified:

1. nb_logs: Maximum number of log files to keep. Beyond this value, the older files are

removed from the hard disk.

2. size : Maximum size of log files in bytes.

3. path: Directory used for log files.

HTML parameters

The following part is implicated:

<webui>

</session>

<table>

<nb_rows>40</nb_rows>

</table>

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 12 of 189 603-0052 D

49412 SAUMUR

France

</scrollable>

</webui>

Only the bold fields can be modified:

1. session:timeout : specify the number of minutes the application maintains a user's

session information since the last page request (-1 for no timeout)

2. table:nb_rows : indicate the number of rows by page for the web page displaying a

list of data

3. scrollable:height: Not used in CASTELServeur.

Communication with CASTELAcces application parameters

The following part is implicated:

</AccessConfigData>

Only the bold fields can be modified:

1. RealTimeUpdating:

a. True: All configuration data changes performed with CASTELAcces are

transmitted in a real-time mode to the VDUC modules.

b. False: All configuration data changes performed with CASTELAcces are saved

in the CASTELAcces database and the VDIP material is not updated. A

complete configuration update will be necessary to update the VDUC.

2. Secured:

a. True: The VDUC guarantee that all supervised movement detected within a

card reader (authorized or not) will be sent to CASTELServeur in order to

guarantee the recording of each access. If the network is disconnected, the

events will be kept in VDUC memory and then transmitted at network

recovery.

b. False: The VDUC looses an access that occurs during a network

disconnection.

3. Blocking : (used if Secured = true)

a. True: If the VDUC memory is full, all access is denied.

b. False: If the VDUC memory is full, the access is authorized but not recorded.

4. RelationManagement :

a. True: When an access point is created/modified/removed, a specific relation

in CASTELServeur is associated with this access point.

b. False: No specific relation is associated with an access point in CASTELAcces.

Communication with CASTELSuperviseur application parameters

The following part is implicated:

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 13 of 189 603-0052 D

49412 SAUMUR

France

</SupervisorConfigData>.

Only the bold fields can be modified:

1. Secured :

c. True : The VDUC guarantees that all events detected will be sent to

CASTELSuperviseur in order to guarantee the recording of each defaults or

alarms or another events. If the network is disconnected, the events will be

kept in VDUC memory and then transmitted at network recovery.

d. False : The VDUC looses an access that occurs during a network

disconnection.

SQL scripting with the agenda

The following part is implicated:

<SQLFile1>D:\Program

Files\CASTELSuite\SQLScript\Fichier1.txt</SQLFile1>

</agenda>

Only the bold fields can be modified:

1. SQLFile1: File containing the SQL scripts to be executed.

Application data save parameters

The following part is implicated:

<path>C:\Program Files\CASTELSuite\Datasave</path>

</datasave>

Only the bold fields can be modified:

1. path : Directory where database should be saved.

2. maxfile : Maximum files number to be kept on the directory.

Macro-relation templates parameters

The following part is implicated:

<path>C:\Program Files\CASTELSuite\MR_Models</path>

</ MacroRelation >

Only the bold fields can be modified:

1. path: Directory where the macro-relations templates are stored (when loading the

list or when adding a new one).

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 14 of 189 603-0052 D

49412 SAUMUR

France

Reserved CASTEL

The following part is implicated:

</QueueSize>

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 15 of 189 603-0052 D

49412 SAUMUR

France

C

A

S

T

E

L

S

E

R

V

E

U

R

W

E

B

P

A

G

E

S

Authentication

 This page provides the identification process to the CASTELServeur application

 This page is reachable by launching a client session with « Start Programs

CASTELSuite CASTELServeurCASTELServeur » or by entering the following

address in any web navigator: “https:// « Server name»/ CASTELServeur

 Enter your login and password then confirm your entry. First, the login and password

should have been configured in CASTELServeur. Use the manufacturer default

identification “castel/castel” for the first use.

 Login and password are mandatory. The password will appear in a hidden way

(****) in order to ensure confidentiality.

Home page

 This page is the home page of CASTELServeur application. It shows:

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 16 of 189 603-0052 D

49412 SAUMUR

France

 One horizontal menu bar providing access to all CASTELAcces

features,

 One head bar

Displaying the feature title,

Providing a quick link to previous page,

Providing a button to print the current screen

Providing a button to access the help page of the current

feature

 This page is reachable from the following menu

Home/Home

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 17 of 189 603-0052 D

49412 SAUMUR

France

U

S

E

R

S

M

A

N

A

G

E

M

E

N

T

All VDIP software applications (CASTELServeur, CASTELAcces and CASTELSuperviseur)

allow a user to use a collection of features available from a menu or by a simple mouse click

on a specific link displayed on the web page.

CASTELServeur allows the user to configure an access rights restriction strategy depending

on a profile associated to a user.

If a user’s profile doesn’t allow a specific feature, this feature will not appear in the menu

and no links for this feature will be displayed.

This feature restriction can be performed with 4 concepts:

 Features

 Features group

 User profile

 User

The user management feature in CASTELServeur is provided for all other “satellite”

softwares as CASTELAcces and CASTELSuperviseur. All CASTELAcces or CASTELSuperviseur

users must be first declared in CASTELServeur for being authorized.

Features

 This page allows a user to visualize all features available. These features depend on

the number of VDIP software installed and on the licence purchased.

Explanation: CASTELServeur allows the user to use elements like users, user profiles,

feature groups, scheduling tasks, material events, etc…

 On each elements, a user can perform several actions like:

 Display the list of these elements

 Visualise an element

 Modify the element

 Remove the element

Definition: A feature is the association of an element and an action.

The features are divided in 3 families:

1. CASTELServeur features

Example: CASTELServeur: User - Remove

2. CASTELAcces features

Example: CASTELAcces: Personal cards - Create

3. CASTELSuperviseur features

Example: CASTELSuperviseur: Alarms - History

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 18 of 189 603-0052 D

49412 SAUMUR

France

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 19 of 189 603-0052 D

49412 SAUMUR

France

Features group

Associate directly features to user profile will be too complicate as there are many features.

CASTELServeur allows a user to gather a list of features in an entity called “features

group”. These groups will be associated to profiles.

Feature group list

 This page shows the features group list with the following detail:

 Feature group label.

 Each column can be sorted in Ascending or Descending order by clicking on the

column header list.

 The list items are displayed depending on the number of rows by page to be

displayed (see system.xml file configuration parameters). To access a particular page,

you must click on the specific page number displayed on the list footer.

 This page is reachable from the following menu

Users/Feature groups

 The creation , view , modification and remove actions are reachable by

associated links.

CASTELServeur User Manual – Version 3.6.X 19/06/2013

CASTEL SA – ZI St Lambert Page 20 of 189 603-0052 D

49412 SAUMUR

France

Features group – Modification

 This page shows a specific features group with the following detail:

 The feature group name,

 A checkbox associated to a list of feature. If checked, the feature is

included in the group.

 A particular checkbox called “All Features” that allows the selection of

all features in one click.

 The list items are displayed depending on the number of rows by page to be

displayed (see system.xml file configuration parameters). To access a particular page,

you must click on the specific page number displayed on the list footer.

 This page is available by clicking on button displayed on the

Features group list

page.

Page is loading ...

Optimus XELLIP SERV MAX User manual

Related papers

Other documents