Actions

Difference between revisions of "Software House CCURE 9000"

From Zenitel Wiki

m (Setup ICX or AlphaCom)
 
Line 70: Line 70:
 
In an AlphaNet system all ICX/AlphaCom servers must have this same port opened.
 
In an AlphaNet system all ICX/AlphaCom servers must have this same port opened.
  
There are several configuration possibilities, depending in the type and size of C-Cure 9000 system
+
There are several configuration possibilities, depending on the type and size of C-Cure 9000 system
 
*With a single C-Cure 9000 standalone server, all communication between C-Cure 9000 and an AlphaNet is via a single ICX/AlphaCom
 
*With a single C-Cure 9000 standalone server, all communication between C-Cure 9000 and an AlphaNet is via a single ICX/AlphaCom
 
*With multiple C-Cure 9000 standalone servers, each C-Cure 9000 server has its own communication link to an ICX/AlphaCom in an AlphaNet
 
*With multiple C-Cure 9000 standalone servers, each C-Cure 9000 server has its own communication link to an ICX/AlphaCom in an AlphaNet

Latest revision as of 08:37, 14 July 2020

AI.png

Introduction

The Software House CCURE 9000 can be integrated with the ICX system or the AlphaCom system.

The interface is based on a special integration module which is available from Software House. This article assumes that the reader is familiar with setup and operation of C-Cure 9000. Only points which are specific to ICX/AlphaCom and to its connected intercom stations are described.

Licensing

The integration is licensed.

Software House

The Software House license is available from Software House under product code CC9000-AlphaCom

ICX

ICX requires the presence of the appropriate API/OPC license.

  • 1002602306 - ILI-API64 - API License Supporting 64 Stations
  • 1002602309 - ILI-API512 - API License Supporting 512 Stations

With ICX it is possible to purchase a single Product Key which covers all stations connected to all ICX's in a network. ICX licenses can be stacked, i.e. 1x 1002602306 + 2x 1002602309 gives 1088 API licenses which can be used on 2 or more ICXs.

AlphaCom

The AlphaCom requires the presence of the appropriate API/OPC license. Note that every AlphaCom in an AlphaNet requires such a license.

  • 1009649901 - STENTOFON API License Supporting 40 Stations
  • 1009649902 - STENTOFON API License Supporting 80 Stations
  • 1009649903 - STENTOFON API License Supporting 160 Stations
  • 1009649904 - STENTOFON API License Supporting 240 Stations
  • 1009649905 - STENTOFON API License Supporting 320 Stations
  • 1009649906 - STENTOFON API License Supporting 400 Stations
  • 1009649907 - STENTOFON API License Supporting 552 Stations

Installation

This description assumes that C-Cure 9000 has been installed and is running. It is also assumed that C-Cure 9000 has been licensed appropriately.

Prerequisite

The interface module uses .NET 4.6.2. Please make certain that this version of the .NET framework is installed prior to installing the interface module itself.

Server

  • Stop all CrossFire services. To do this, start 'Server Configuration' (Run as administrator), which is available under 'Start menu/Tyco'. Work your way up from the bottom of the list in the TAB 'Services' and wait for each service to have stopped before stopping the next.
  • Once all services have been stopped, exit 'Server Configuration'
  • Install the C-Cure 9000-AlphaCom integration module by running CCURE9000_VS-AlphaCom_Integration.msi and follow the instructions which appear on screen
  • Start all CrossFire services. To do this, start 'Server Configuration' (Run as administrator), which is available under 'Start menu/Tyco'. Work your way down from the top of the list in the TAB 'Services' and wait for each service to have started before starting the next. There will be a new service available: 'AlphaCom Driver Service'. As this is the first time this service is used, it needs to be enabled before it can be started. Check the checkbox 'Enabled'.
  • Once all services for which a license is present have been started, exit 'Server Configuration'

Client

For PC's which only have a C-Cure 9000 client running there is a separate 'Client only' installation file.

  • Install the C-Cure 9000-AlphaCom client integration module by running CCURE9000_VS-AlphaCom_Integration_ClientOnly.msi and follow the instructions which appear on screen

SQL permissions

The AlphaCom integration module creates 3 tables in the database 'ACVSCore'. These tables are:

  • AlphaCom.AlphaComConnection
  • AlphaCom.Intercom
  • AlphaCom.Node

To be able to create these tables, the account which is used by the 'AlphaCom Driver Service' needs to have the appropriate permissions. To check which account is used by the 'AlphaCom Driver Service'

  • Open the 'Services' window
    • Either via 'Computer Management/Services'
    • Or by clicking the 'Start' menu and typing 'Services.msc'
  • Select the line listing 'AlphaCom Driver Service'.
  • The column 'Log On As' lists the account which is used by the service.
    • If wanted, it is possible to change the account; right click the line, select 'Properties' and enter the details of the required account in the TAB 'Log On'

Use 'Microsoft SQL Server Management Studio' to assign the appropriate permissions to the account. The 'AlphaCom Driver Service' must either have 'sysadmin' permissions to the database instance or 'db_owner' permissions to the 'ACVSCore' database.

  • Open SQL Server Management Studio
  • Connect to the appropriate database instance
  • Expand 'Security', then expand 'Logins'
  • Right-click the account which is used by 'AlphaCom Driver Service' then select 'Properties'; make certain that at least one of the two bullet points below are met
  • Select the 'Server Roles' page and verify whether the 'sysadmin' role is set
    • If the 'sysadmin' role is not set, consider whether to set it; note that this gives all permissions on the database instance; if the 'sysadmin' role is not appropriate use the option in the bullet point below
  • Select the 'User Mapping' page; select the 'AVCSCore' database and ensure a checkmark is placed in the column 'Map' then checkmark the 'db_owner' role
    • No 'Default Schema' should be required but if needed select 'dbo'

Setup ICX or AlphaCom

The communication with ICX or AlphaCom is through port 61112 or 61113. Make certain that one of these ports has been opened in the 'Filter page' in the Web interface. In an AlphaNet system all ICX/AlphaCom servers must have this same port opened.

There are several configuration possibilities, depending on the type and size of C-Cure 9000 system

  • With a single C-Cure 9000 standalone server, all communication between C-Cure 9000 and an AlphaNet is via a single ICX/AlphaCom
  • With multiple C-Cure 9000 standalone servers, each C-Cure 9000 server has its own communication link to an ICX/AlphaCom in an AlphaNet
  • In an C-Cure 9000 Enterprise system each so-called SAS-server has its own communication link to an ICX/AlphaCom in an AlphaNet

AlphaCom with software prior to version 11.5.3.5 only offers the possibility to connect to 2 standalone or SAS servers. As from the software version 11.5.3.5 AlphaCom in an AlphaNet supports the possibility to connect to 10 standalone or SAS servers, as the ports 61112/61113 on each server are now independent of each other.

Setup C-Cure 9000

Setup of the ICX/AlphaCom connection in C-Cure 9000 is done in the C-Cure 9000 Administration Workstation. Note that some of the descriptions in the text below are dependent on choices which are made during setup, it may therefore be that the actual system being used operates slightly differently.

  • Click on 'Hardware' to view the hardware tree
    Hardware

  • If no appropriate hardware folder exists yet, right click on the top of the tree structure 'Hardware' and create a new hardware folder. Rename it, for instance 'Zenitel'. If an appropriate hardware folder already exists, skip this step
    Hardware folder

  • Right click on the Hardware folder and select 'AlphaCom connection/New'.
  • In the new dialog, enter the IP-address and port number of the ICX/AlphaCom to which C-Cure 9000 should connect.
  • When 'Automatically Populate Devices' is enabled, C-Cure 9000 will connect to the ICX/AlphaCom/AlphaNet and populate the tree with all nodes and intercom stations.
  • Click 'Save and Close'
AlphaCom connection


Note that in a partitioned system it is possible to select to which partition and hardware folder within that partition the ICX/AlphaCom connection shall be assigned to. It is possible to at a later stage move the ICX/AlphaCom connection to another partition and hardware folder by simply selecting the appropriate settings from the drop down lists under the TAB 'Partition and Folder'.

Auto populate


When 'Automatically Populate Devices' is disabled, neither nodes nor intercom stations will be discovered. It is also possible to only disable auto-discovery for intercom stations connected to a specific node. Right click on the node and select 'Edit' to access the node information.


Node information


C-Cure 9000 Enterprise

A C-Cure 9000 Enterprise system consists of a MAS (Master Application Server) and 1 or more SAS's (Satellite Application Server). Each SAS must have its own connection to the AlphaNet (max 10 such connections are possible). The MAS will collect all device information from all to it connected SAS's. In such an Enterprise system it may be advisable to:

  • Enable auto-population
  • Disable auto-population once all devices have been discovered and delete those devices which are not relevant for the particular SAS

This will prevent the MAS from showing the same device multiple times.

Intercom properties

Intercom properties can be changed.

Assign an operator to an intercom

  • Click on AlphaCom Intercoms
    AlphaCom Intercoms

  • Click on the right arrow next to 'Intercom Station' - A new TAB listing all discovered intercom stations will be opened.
    Select intercom

  • Click and then right click on an intercom, select Edit
  • From the drop down list select the Windows login appropriate for the operator who will use the 'Monitoring Workstation' application on 'this' computer

The selected operator will receive call requests to his intercom on the screen of the Monitoring Workstation application. Call requests can be answered directly from the call request list. The operator can also select other intercom stations to call at will.

Triggers

In the 'Triggers' TAB of the intercom station property editor it is possible to assign actions on intercom station state changes:

  • Intercom Online/Idle
  • Call Request
  • Station in a call
  • Fault

Note that Offline is not a state which can occur (although it is listed), as this will be reported and shown as Fault.

It is possible to attach one or multiple actions to a state, for example showing a camera viewer when there is a call or call request.

Trigger on intercom status change



State images

The intercom icon has default images for each state. In the TAB 'State images' it is possible to assign a new image to a state. Simply double click on an existing image and browse to the new image file.

Maps

Intercom icons can be placed in a map.

  • Follow the normal procedure to define a map and place an icon on a map
  • Select Type: Intercom Station
  • Select Object: Select the actual intercom to be placed on the map

Events and actions

Just as it is possible to link an intercom state change to an action in another to C-Cure 9000 connected subsystem, is it also possible to trigger an action in ICX/AlphaCom.

Defining an action in ICX or AlphaCom

  • Define an event in a connected subsystem to which an ICX or AlphaCom action must be linked.
  • In the trigger TAB of the connected subsystem select 'Activate Event'
  • Underneath the table with defined events and actions a entry box 'Event' will appear.
  • Click on the down arrow to the right of the entry box and select 'New'
  • A new dialog to define the action will appear', Select the TAB 'Action'
  • Click 'Add'
  • From the drop down list under 'Action' select 'Intercom Send ASCII Command'; 2 new fields will appear at the bottom of the dialog
  • Select an Intercom from the dropdown list labeled 'Intercom'. This selection is not used at all, so the selected intercom is not relevant; the C-Cure 9000 software makes this selection necessary.
  • Enter a command in Simple Link Layer format in the field 'Command String'; Example: $ALRM L84 N!1
    Action in ICX /AlphaCom

  • Enter all fields as appropriate in all other TABs

Dynamic view

To be able to show a list of intercom stations in the Monitoring Workstation application it is necessary to define a 'Dynamic View'.

  • Select 'Data Views'
    Data View

  • Select 'Dynamic View' and click 'New'
    Dynamic View

  • In the new dialog enter details as shown in the picture below. There are several checkboxes and other fields that can be changed/edited, use these as appropriate for your system setup
    Intercom View

Operation

Operation is normally done from the Monitoring Workstation application.

All intercom station status changes are shown in the 'Activity viewer'.

Activity Viewer


To show a map, select Maps in the Explorer Bar. This will bring up a Status List, containing all defined maps. Select and right click a map, select 'Popup view' to show the map including all in it defined icons in a new window.

Working with intercom stations

To show the list of defined intercom stations, select 'Dynamic Views' in the Explorer Bar. In the new dialog select 'Intercom View' (assuming that this view has been defined, see above), right click it and select 'Popup view'.
In this list it is now possible to double click on an entry after which a popup view will open. It is possible to open multiple popup views.

The popup view for the intercom station which is associated with the Monitoring Workstation contains a 'Pending Call Queue'. Call requests can be selected in this view and answered by clicking the 'Accept Call' button.

Operator station popup


Popup views of other intercom stations only show general information and the status of the station. When the Monitoring Workstation is associated with an operator intercom there is in addition a button 'Place Call', which changes to 'End Call' in case there is an established connection.

Substation popup


Maps

To show a map, select Maps in the Explorer Bar. This will bring up a Status List, containing all defined maps.

Select and right click a map, select 'Popup view' to show the map including all in it defined icons in a new window.

Map with intercom icon


The appearance of the intercom icon is status dependent. Click on the icon to bring up the intercom popup view.
LIMITATION: There is a bug in C-Cure 9000, v2.60. Statuses of intercoms other than 'Idle' are not displayed correctly in the map. This will be rectified in C-Cure 9000, v2.60 SP1. Please refer to Software House for a release date of this service pack.

Versions

Each C-Cure 9000 version requires its own version of the driver, although there are no functional differences in the integration between C-Cure 9000 and AlphaCom

  • C-Cure 9000, v2.50 - Current driver version 2.53
  • C-Cure 9000, v2.60 - Current driver version 2.60

Installation issues

A few issues have been identified which can cause the integration not to work as expected, or to display an error message on trying to define the connection to ICX or AlphaCom. The following points can be checked and tried to rectify the problem.

  • Check whether the CCure9000 server has the correct permissions to create tables in the database ACVSCore, see paragraph SQL permissions above.
  • Check whether the 'Connection String' for ICX/AlphaCom is defined correctly.
    • Start 'Server Configuration Application' and select the TAB 'Database'.
    • Select the entry 'Stentofon.NextGenConnectedProgram.AlphaCom.Objects' and check whether the entry in the column 'Connection String' points to a valid SQL instance and database.
  • Possibly the CrossFire services were not stopped correctly when the integration module was installed, see paragraph Server above
    • Start the ‘Server Configuration Application’ (Run as administrator)
    • In the TAB ‘Services’ stop all services, from the bottom up
    • Close the configuration application
    • Uninstall the AlphaCom integration module
    • Install the AlphaCom integration module
    • Start the ‘Server Configuration Application’ (Run as administrator)
    • In the TAB ‘Services’, start all services, from the top down