Professional Documents
Culture Documents
EN - Traka Asset Management Plugin Guide 3.1
EN - Traka Asset Management Plugin Guide 3.1
EN - Traka Asset Management Plugin Guide 3.1
Document information
Chapter 2: Release notes
What's new in version 3.1 . . . . . . . . . . . . . . . . . . 10
Released documents for Traka Asset Management plugin 3.1 . . . . . . . . . 10
Known issues . . . . . . . . . . . . . . . . . . . . . 11
Limitations . . . . . . . . . . . . . . . . . . . . . . 12
Product compatibility . . . . . . . . . . . . . . . . . . . 13
System requirements . . . . . . . . . . . . . . . . . . . 14
License options . . . . . . . . . . . . . . . . . . . . 15
Supported devices . . . . . . . . . . . . . . . . . . . . 16
Supported features . . . . . . . . . . . . . . . . . . . . 17
Custom events added by the Traka Asset Management plugin . . . . . . . . . . 18
Chapter 7: Managing cardholders
Glossary . . . . . . . . . . . . . . . . . . . . . . . 80
Related Topics
What's new in version 3.1 on page 10
Integration overview on page 5
The following software and services from ASSA ABLOY must be running on a single Traka server for the
integration with Security Center.
• Traka Integration Engine: A software that provides read and write access to Traka devices and data. It is
required to forward state change events to Security Center.
• (Optional) Traka Real-Time Update Service (RTUS): A service that communicates the state change of
iFobs to the Traka Integration Engine. Without RTUS, it can take Traka Web 30 seconds to 20 minutes to
communicate an iFob event.
• Traka Web: The administration software for the Traka system. It includes the Business Engine and the
Communication Engine.
Related Topics
Integration overview on page 5
Integration overview
You can integrate a Traka system into Security Center using the Traka Asset Management plugin by following
a sequence of steps.
26 You have mature Traka and Security Center Choose one of these methods:
systems.
1. Delete all of the users from the Traka system.
Your personnel already have Traka user accounts 2. Add your Security Center cardholders to
and a Security Center cardholder accounts. access rules that are assigned to assets in
Traka asset groups.
You want to manage your personnel's access to
assets and doors in Security Center. OR
1. Import the Traka users. You now have
duplicate cardholders.
2. Move the credentials from the old Security
Center cardholder to the new Traka
cardholder.
3. Deactivate the old Security Center cardholder.
Related Topics
Integration overview on page 5
Related Topics
What is the Traka Asset Management plugin? on page 2
Integration overview on page 5
Traka Asset Management Plugin Guide 3.1 New English, French TechDoc Hub, installation
package
Related Topics
Integration overview on page 5
Known issues
The Traka Asset Management plugin 3.1 includes the following known issues.
2298137 3.1 If changes were made in the Events page of the plugin role while the Traka
monitoring task is open, the changes are not dynamically updated.
Workaround: To see the updated list of events in the Events filter, close the
Traka monitoring task, and then reopen it.
2415413 3.1 If a Traka service is restarted on the Traka Integration Engine server, you must
deactivate, and then reactivate the Traka Asset Management plugin role on the
Security Center server.
2416456 3.0 Federation™ is unsupported. On a federated host, you can receive Traka events,
but the Traka entities (cabinets and iFobs) cannot be monitored.
2434069 3.1 In the Traka Asset Management plugin role's Events page, if you re-select a
custom event that was previously deleted, the history of events for the original
custom event are deleted.
Workaround: Avoid clearing the custom event check box.
2492240 3.1 When access rules are assigned to assets (iFobs) in Security Center, the
attached schedules are ignored by the Traka system because schedules are not
synchronized.
Workaround: To control access to assets (iFobs) based upon day and time, in
Traka Web, create Access Schedules and assign them to the user’s profile or an
iFob attached to a key or an asset.
Related Topics
Integration overview on page 5
Limitations
The Traka Asset Management plugin 3.1 includes the following known limitations.
2417249 3.1 The Traka Integration Engine responds to synchronization requests within 30
to 45 seconds.
2426980 3.1 When the configuration of a Traka cabinet or iFob is changed in Traka Web,
such as renaming the device, the change only become visible in Security Center
after the plugin role is restarted.
Workaround: To see the changes made to a Traka device, deactivate the Traka
Asset Management plugin role, and then activate it.
Related Topics
Integration overview on page 5
Product compatibility
To be eligible for technical support, you must install the plugin with versions of Security Center and third-
party software that are certified or supported by design.
For the latest compatibility information, see Supported plugins in Security Center on the Genetec™ TechDoc
Hub.
As a minimum, the Traka Asset Management plugin 3.1 requires Security Center 5.7 SR3.
Related Topics
Integration overview on page 5
System requirements
To ensure that the Traka Asset Management plugin 3.1 performs as expected, the plugin must be installed on
a computer that meets the recommended specifications for Security Center.
Refer to the server requirements and client workstation requirements topics in the Security Center system
requirements.
Related Topics
Integration overview on page 5
License options
Before installing the plugin, you must update your Security Center license to include a certificate for the
plugin. To update your license, contact us and provide the part numbers listed in this topic.
GSC-1P-KeyCabinetBase
This package is the base • Synergis™ Professional or Enterprise
license for a single Traka Asset • Omnicast™ Professional or Enterprise
Management plugin.
• Genetec™ Advantage System
You need one license per Security Maintenance Agreement (SMA)
Center Directory.
ASSA ABLOY
To synchronize your TRAKA cabinets with Security Center, you need the following license from Assa Abloy.
Does your Security Center license include all the options you need?
In addition to a certificate for your plugin, ensure that your Security Center license includes all the options
you expect to use in Security Center. For example, if you integrated a system that has visitors, you need the
Visitors option in Security Center. If an option is missing, an error message is displayed when the server tries
to create or modify the entity related to that option.
For a list of available license options, see "License options" in the Security Center Administrator Guide.
Related Topics
Integration overview on page 5
Supported devices
Security Center supports the following Traka system products.
You can integrate any Traka Touch cabinet that the Traka Web software supports; including:
• Intelligent locker cabinets
• Key management cabinets, series L, M, S, and V.
Related Topics
Integration overview on page 5
Supported features
Discover the features that are supported by Security Center for an integration with Traka system.
For a list of features supported by your plugin, download the feature comparison PDF from the TechDocs
Hub.
Feature comparison for key cabinet plugins
Related Topics
Integration overview on page 5
Related Topics
Integration overview on page 5
Selecting Traka events to monitor on page 36
Supported reports and tasks on page 67
Upgrading
To upgrade to Traka Asset Management plugin to version 3.1, you must uninstall earlier versions, and then
install the new version.
Required privileges
For administrators to install and configure the plugin in Config Tool, and for operators to monitor the Traka
system in Security Desk, the correct user privileges must be granted to their user accounts.
Administrators have access to all privileges. However, if you create a user account from the Provisioning
template, and you want this user to add and configure your plugin, that user needs the following Security
Center privileges.
View license Allows the user to view the software license. CT Admin
View role properties Allows the user to view role properties. CT Admin
Modify role properties Allows the user to modify role properties. CT Admin
View server properties Allows the user to view server properties. CT Admin
Modify custom field Allows the user to add, modify, and delete custom CT Admin
definitions field definitions and custom data types.
Modify custom events Allows the user to add, modify, and delete custom CT Admin
events.
Modify event-to-actions Allows the user to add, modify, and delete event- CT Admin
to-actions.
Search for all "access control" privileges. Go through the list and grant or deny access as required for each
user.
The Traka Asset Management plugin uses cameras and video. Search for all "video" privileges. Go through
the list and grant or deny access as required for each user.
The Traka Asset Management plugin is used to manage assets. Search for all "asset" privileges. Go through
the list and grant or deny access as required for each user.
Related Topics
Integration overview on page 5
Related Topics
Integration overview on page 5
5 Click Backup/Restore ( ), choose the location for backup files, enable automatic backups at least once
per week, and then click OK.
For more information, see "Backing up databases" in the Security Center Administration Guide.
6 Click Apply.
Related Topics
Integration overview on page 5
5 To change the priority of a server, select it from the list, and click the or buttons to move it up or
down the list.
6 If you want the primary server to retake control after it is restored from a failover, select the Force
execution on highest priority server option.
To minimize system disruption, the role remains on the secondary server after a failover occurs, by
default.
7 Ensure that the role is not connected to a database on the local machine.
You can determine that the database server is local to your machine if the name of the Database server
starts with "(local)". If it does, rename the database server to match the remote server you prepared in
advance for your plugin role.
a) Back up your plugin role database and restore it on a server that is not hosting your plugin role.
b) Enable remote access to the plugin role database you restored.
c) Change the Database server to the server hosting your plugin role database.
For example, REMOTESERVER\SQLEXPRESS.
8 Click Apply.
5 On all routers, switches, and network devices, unblock the TCP ports (inbound and outbound) that are
used to communicate with the plugin. The default ports are:
• TCP 10700 for the Traka Integration Engine
• TCP 10800 for events
6 If Security Center and the Traka Integration Engine are in different networks or subnets, configure the
routers and firewalls to allow communication; including: enable the routing protocol on each network's
routers, and configure network address translation.
7 Confirm that the Traka system server can communicate with the Security Center server where the plugin
will be installed, using the Ping command, Telnet, etc.
8 Make sure that the Traka cabinets and Traka Web server are set to the same time zone as the Security
Center Directory server.
4 Click OK.
5 Click Apply.
4 In the Traka users imported into Security Center as cardholders section, configure the following:
• Card format: The format of the cards supported by the card reader on the Traka cabinets. If cabinets
do not have card readers, and Traka users only enter a PIN, create a custom card format for the PIN,
and select it here.
• Facility code: Assigns a default facility code to a cardholder's Traka credential, which are created
when the Traka users are synchronized with Security Center cardholders. The facility code is a number
from 0 to 9999. In multi-tenant deployments or multiple sites managed by separate Traka servers, it is
possible to have duplicate card numbers. The facility code ensures that all card numbers are unique.
• Cardholder group: The default cardholder group to which imported Traka users are assigned.
5 If a keypad ID is not used to open a cabinet, in the Custom card format list, select None.
6 If a keypad ID is used to open a cabinet, in the Custom card format list, select the custom card format
created for Traka.
7 Click Apply.
4 To show a Traka event in the Traka monitoring task of Security Desk, in the Traka monitoring column,
select the check box.
NOTE: Changes to the Traka monitoring task are is open, the events filter is not updated. To see the
updated list of events in the Events filter, close the Traka monitoring task, and then reopen it.
5 To associate a Traka event to a Security Center alarm, in the Alarm column, click , and then choose a
single alarm.
6 To associate a Traka event to a Security Center custom event, in the Custom event column, select the
check box.
NOTE: If you want to monitor a Traka event in the Monitoring task, you must select a custom event.
CAUTION: Clearing and then re-selecting the custom event check box results in a loss of data.
When you clear the Custom event check box, the custom event is deleted, and the history of events
remains in the database, so you can generate reports of past events.
However, If you re-select the custom event, a new custom event is created, and the event history for the
original custom event is deleted from the database.
7 Click Apply.
Related Topics
Custom events added by the Traka Asset Management plugin on page 18
Monitoring Traka events using the Monitoring task on page 72
Investigating asset activity using the Traka report on page 70
Monitoring assets using the Traka monitoring task on page 68
4 Click Apply.
5 Click Test connection to confirm that the plugin role can communicate with the Traka Integration Engine.
6 If you get a message that the plugin is unable to communicate with the Traka Integration Engine, do the
following:
a) Deactivate the plugin role.
b) Activate the plugin role.
c) Wait a few minutes, then test the connection again.
Related Topics
Unable to connect to Traka service on page 78
3 Enter the number of rows and columns to match the physical layout of receptor strips in the cabinet.
Example
The M series cabinet shown below has 2 rows and 10 columns.
3 In the Relationships section of the Identity tab, click Cameras, and then click .
4 In the Search dialog box, click the camera to assign to the cabinet, and then click Select.
5 Click Apply.
The camera is listed in the Relationship section. If you linked a camera to a cabinet, that camera is also
added to all of the iFobs related to that cabinet.
When an event or alarm is triggered for the Traka entity, you can view the related video in the Monitoring and
Alarm monitoring tasks.
4 Click Save.
The new group is added to the Groups page, and is immediately exported to the Traka system.
If your personnel have a Traka user account and a Security Center cardholder account, and you want to
manage all access from Security Center using a single cardholder account, follow one of these procedures:
1. Delete all of the users from the Traka system, then add your Security Center cardholders to access rules
that are assigned to assets in Traka groups.
2. Import Traka users in Security Center. You now have duplicate cardholders: the new Traka cardholders
and the old Security Center cardholders. Move the credentials from the old cardholders to the new Traka
cardholders. Deactivate the old cardholders.
1. If you have existing Security Center cardholders that you want to give access to assets in Traka cabinets,
assign the Security Center cardholder to a Traka access rule.
2. If you have a new employee that you want to give access to cabinets, create a Traka cardholder in Security
Center.
3. If you want to grant cardholders access to assets without using access rules, assign iFobs to a Security
Center cardholder.
Change the first and last name of a Change name of the Traka The change is synchronized
Traka cardholder. cardholder in Security Center. immediately and automatically.
Change the keypad ID of a Traka In the Credential management The change is synchronized
cardholder. task of Security Center, remove immediately and automatically.
the credential of the old keypad
ID, and replace it with a new
credential.
Change the PIN of a Traka In Config Tool, from the Credential In Security Center, the change is
cardholder. management task, change the PIN synchronized immediately and
in the credential. automatically.
In TrakaWeb, changes to PINs are
not pushed to Security Center.
Deactivate a Traka cardholder. In Security Center, from the The change is synchronized
Cardholder management task, immediately and automatically.
deactivate the cardholder.
Permanently deactivate a lost or In Security Center, do one of the The change is synchronized
stolen card. following: immediately and automatically.
• Remove the cardholder
from all access rules that are
assigned to Traka groups.
• Remove the credential from
the Traka cardholder.
Temporarily deactivate an access In Security Center, from the The change is synchronized in
card or PIN. Cardholder management task, immediately and automatically.
deactivate the cardholder.
Delete a Traka cardholder from In Config Tool, delete the The change is synchronized
Security Center. cardholder account. immediately and automatically.
IMPORTANT: It is not Deleting cardholders also deletes
recommended to delete their activity trail and related audit
cardholders. The best practice is to logs.
deactivate a cardholder so that the
history of events is kept.
4 Select the Traka users the you want to manage in Security Center.
TIP: To select all of the users in the list, slide Select all to ON.
6 (Optional) Click the Linked to a cardholder button ( ) to open the cardholder in the Access control task.
7 (Optional) Verify that the cardholder:
• Has the credentials for their Traka PIN and Traka Keypad ID (if required).
• is assigned to the default Traka import group.
• First name, Last name: The first name and the last name of the user.
• Active date: The date the user's credential becomes active. When active, the credential can be used to
open cabinets.
• Expiry date: The date the user's credential expires (deactivated). When expired, the credential can no
longer be used to open cabinets.
• Card number: The user's access key card number. The length and format of the card number depends
on the type of credential selected for the Traka cardholders and Traka users on the Properties page.
• Keypad ID: A code number that a user must enter on a cabinet keypad to open the cabinet. The code
is unique to each user. If your cabinets don't require a keypad ID (code), leave this field empty. The
keypad ID is defined in the Traka system, and is a number from 1 to 9999.
• PIN: A personal identification number that identifies the user. The user must enter the number on the
cabinet keypad to open the cabinet. If your users don't require a PIN, leave this field empty. The PIN is
defined in the Traka system, and is a number from 1 to 9999.
4 Click Save.
5 When you are prompted to create a cardholder, choose one of the following:
• No: Creates the user in the Traka system. This user is not linked to a Security Center cardholder. The
Traka user is identified by the orange user icon ( ).
• Yes: Creates the user in the Traka system and a matching cardholder in Security Center. The Traka
cardholder is identified by the blue cardholder icon ( ).
NOTE: If an existing cardholder has the same name as the new one, you will have two cardholders
with the same name, but different account information. You can move the credentials to the new Traka
cardholder, and then deactivate the old account. By deactivating the old cardholder account, you keep
the history of events.
The new user is listed in the Traka users page and created in the Traka system.
6 If users are missing from the list, wait a minute, then click Refresh list.
7 To add the Traka user as a Security Center cardholder, select the user.
The cardholders in the rule are granted access to the selected group of assets (iFobs). If a cardholder in a rule
is not linked to a Traka user, a new Traka user account is created and linked.
6 Click Save.
7 When you receive the confirmation message: The iFobs permissions were updated, click OK.
• The cardholder is added to the list and identified by a blue person icon.
• A user by the same name is created in the Traka system.
c) In the dialog box, enter a unique and descriptive name for the rule.
d) Click Add doors ( ), and select the doors.
e) Click Save.
The deny-access rule is added to the list of deny-access rules.
4 Click Apply.
• When a Traka cardholders takes the asset, that cardholder is added to the deny-access rule.
• While this cardholder has the asset, access to the doors specified in the deny-access rule are denied.
• If the cardholder returns the asset to the wrong receptor, the deny-access rule is still in effect.
• When the cardholder returns the asset to the correct receptor in the cabinet, the cardholder is removed
from the deny-access rule, and the cardholder can open the doors.
The Traka Asset Management plugin adds two tasks to Security Desk:
• Traka monitoring
• Traka report
The following reports are available for use with the Traka Asset Management plugin. These reports are
available from the Security Desk Tasks page.
• Access rule configuration
• Credential configuration
Monitoring tasks
• Alarm monitoring
• Maps
• Monitoring
Related Topics
Custom events added by the Traka Asset Management plugin on page 18
Monitoring assets using the Traka monitoring task on page 68
Investigating asset activity using the Traka report on page 70
Monitoring Traka events using the Monitoring task on page 72
•
Red key: The iFob and attached asset are in the cabinet, but in the wrong receptor slot.
•
No key: The iFob and attached assets are not in the cabinet.
3 If a cabinet is missing, open Config Tool, and make sure the cabinet was imported, and that it is described
correctly.
To investigate recent activity at the cabinet:
1 In the Events filter list, select the type of events you want to see.
Events are displayed chronologically in the event list.
2 If an event type is not listed in the Events filter, do one of the following:
a) Close the Traka monitoring task, and then reopen it.
b) Open the plugin role's Events page, select the event you expected to see in the Traka monitoring
column.
3 To find a specific event: scroll through this list or use the Traka report task to generate a report.
4 To see the video of an event, use the Traka report.
Related Topics
Supported reports and tasks on page 67
Selecting Traka events to monitor on page 36
Related Topics
Supported reports and tasks on page 67
Selecting Traka events to monitor on page 36
The selected Traka cabinets and their iFobs (assets) are added to the entity browser.
To see the current status of the assets in a Traka cabinet:
1 From the Security Desk home page, open the Monitoring task.
2 Search for a Traka cabinet.
4 In the entity browser, expand the cabinet to show the iFobs it contains.
The contents of the cabinet are shown. The color of the key indicates the state of the iFob.
•
Yellow key : The iFob and attached assets are in the cabinet, and in the correct receptor slot.
•
Red key: The iFob and attached asset are in the cabinet, but in the wrong receptor slot.
•
No key: The iFob and attached assets are not in the receptor slot of the cabinet.
5 To see the video of the cabinet, expand an iFob, and then double-click the related camera.
Related Topics
Supported reports and tasks on page 67
Selecting Traka events to monitor on page 36
Cause
The plugin is not installed on your Security Desk workstation.
Solution
You must install the Traka Asset Management plugin on your workstation to see the Traka monitoring task
and the Traka report task.
Related Topics
Downloading and installing the plugin on page 22
4. Make sure that the service and the plugin are communicating on the same port. Click the Web Service
tab, and confirm that the Service port number listed here matches the port listed in the URL entered in
the plugin role's Properties page.
Related Topics
Connecting to the Traka system on page 38
Glossary
add-on An add-on is a software package that adds tasks, tools, or
specific configuration settings to Security Center systems.
Card and PIN Card and PIN is an access point mode that requires a
cardholder to present their card, and then enter a personal
identification number (PIN).
Cardholder access rights Cardholder access rights is a type of maintenance task that
reports on which cardholders and cardholder groups are
granted or denied access to selected areas, doors, and
elevators.
plugin role A plugin role adds optional features to Security Center. A plugin
role is created by using the Plugin role template. By default, it is
represented by an orange puzzle piece in the Roles view of the
System task. Before you can create a plugin role, the software
package specific to that role must be installed on your system.
Traka Asset Management The Traka Asset Management plugin integrates Traka users,
cabinets, and iFobs into Security Center.
Traka report Traka report is an investigative task in Security Desk. You can use
it to investigate Traka user activities at the cabinets and assets
(iFobs).
Additional resources
If you require additional resources other than the Genetec™ Technical Assistance Center, the following is
available to you:
• Forum: The Forum is an easy-to-use message board that allows clients and employees of Genetec Inc. to
communicate with each other and discuss many topics, ranging from technical questions to technology
tips. You can log on or sign up at https://gtapforum.genetec.com.
• Technical training: In a professional classroom environment or from the convenience of your own office,
our qualified trainers can guide you through system design, installation, operation, and troubleshooting.
Technical training services are offered for all products and for customers with a varied level of technical
experience, and can be customized to meet your specific needs and objectives. For more information, go
to http://www.genetec.com/support/training/training-calendar.
Licensing
• For license activations or resets, please contact GTAC at https://gtap.genetec.com.
• For issues with license content or part numbers, or concerns about an order, please contact Genetec™
Customer Service at customerservice@genetec.com, or call 1-866-684-8006 (option #3).
• If you require a demo license or have questions regarding pricing, please contact Genetec™ Sales at
sales@genetec.com, or call 1-866-684-8006 (option #2).
Please contact GTAC at https://gtap.genetec.com to address any issue regarding Genetec™ appliances or any
hardware purchased through Genetec Inc.