Installation instruction B-COMM

Reference Manual Vers. 3.10.0

07/2014
 Copyright by
Kaba GmbH
Albertistrae 3
D-78056 Villingen-Schwenningen
Phone +49 7720/603-0
Fax +49 7720/603-102
[email protected]
www.kaba.com/workforce-management

All rights reserved. The document and its parts are copyrighted. Only Kaba GmbH has the right to
commercialize, market and distribute this document. This document, or any part of it, may not be copied
or reproduced, adapted, arranged, reworked or modified without the prior consent of Kaba GmbH.

All company, trademark or product names are trademarks or registered trademarks of their respective
owners and are protected.

Subject to technical changes without notice!

Order no. 04042060

1 General information................................................................................................................5
1.1 About this manual ...........................................................................................................5
1.2 Validity ............................................................................................................................5
1.3 Addressees.....................................................................................................................5
1.4 Content and purpose ......................................................................................................5
1.5 Modification Log..............................................................................................................5
1.6 Orientation in the manual................................................................................................5
1.7 Remarks with symbols....................................................................................................6

1 Installation ...............................................................................................................................7
1.1 Hardware requirements ..................................................................................................7
1.2 Java and .NET Framework environment ........................................................................7
1.3 ARIOS-components/CardLink ........................................................................................8
1.4 Overview on software requirements ...............................................................................8
1.5 Selecting the "Common" or "Separate" installation type ................................................9
1.5.1 "Common" type of installation ............................................................................9
1.5.2 "Separate" type of installation (predefined data directory).................................9
1.5.3 "Separate" type of installation (selectable data directory)................................10
1.6 Installation examples ....................................................................................................11
1.6.1 Installation example 1: Server and GUI on one computer: ..............................11
1.6.2 Installation example 2: Server and GUI on 2 computers .................................12
1.6.3 Installation example 3: Server and GUI on 2 computers with Java application13
1.7 Installation in Windows operating systems...................................................................14
1.7.1 Selecting the installation routine ......................................................................14
1.7.2 Biometrics: installing Morpho biometrics software ...........................................30
1.7.3 Biometrics: MS Visual Studio Runtime.............................................................38
1.7.4 Checking the data execution prevention (DEP) ...............................................39
1.7.5 Biometrics: B-COMM settings ..........................................................................40
1.7.6 Biometrics: checking the installation ................................................................41
1.8 Installation in Unix/Linux and OS/400 operating systems ............................................42
1.8.1 Biometric enrollment under Linux.....................................................................43
1.9 Additional information about installation .......................................................................44
1.9.1 Update ..............................................................................................................44
1.9.2 Uninstalling B-COMM.......................................................................................44
1.9.3 Uninstalling Morpho software...........................................................................44
1.9.4 Services............................................................................................................45
1.9.5 Ports used in default configuration...................................................................45
1.9.6 Scanning viruses ..............................................................................................46
1.10 Data execution prevention ............................................................................................46
1.10.1 Deactivate the data execution prevention ........................................................46
1.10.2 Activate the data execution prevention again ..................................................47
1.10.3 Defining exceptions of the data execution prevention .....................................47
1.10.4 Reboot..............................................................................................................47

2 Index.......................................................................................................................................48
Reference Manual Vers. 3.10.0 Installation instruction General information
B-COMM

Pos: 1 /Software-Handbcher/B-COMM Java Installation/Allgemeines und einleitende Kapitel @ 6\mod_1268299965438_2.doc @ 23244 @ 12222222 @ 1

1 General information
1.1 About this manual

This manual describes the installation of the Kaba communication software

"B-COMM" under various operating systems.

1.2 Validity

The content of this manual refers to software versions as of release 3.10.0.

1.3 Addressees

The descriptions in this manual are directed towards IT administrators, network

technicians, service personnel and end users. General knowledge in the use of
software installations and network technology is required. The descriptions cannot
substitute a product training.

1.4 Content and purpose

The content of this manual includes the following sections:

General requirements necessary to install the software
Installation under Windows operating systems using the ANT installer
Installation under Unix/Linux/OS/400 operating systems using the ANT installer
Remarks about update/deinstallation of existing B-COMM installations.

1.5 Modification Log

Listed below are the most important changes and additions compared to the last
edition of the B-COMM manual:
Automated handling of the DEP procedures.

1.6 Orientation in the manual

This manual contains the following orientation guides to find specific topics more
easily:
The table of contents at the beginning of the manual gives an overview of all
treated topics.
The header of each page contains the corresponding title of the chapter.
An index in alphabetical order can be found at the end of the manual.

07/2014 Kaba GmbH 5

General information Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

1.7 Remarks with symbols

Please pay special attention to the remarks that are marked with symbols. The
symbols used in this manual have the following meaning:

Remark
Tips and useful information. This information will help you to best use the
product and its functionality.

NOTICE!
Important information for a proper handling of the product. Ignoring this
Pos: 2 /=====Seitenumbruch===== @ 0\mod32_2.doc @ 444 @ @ 1
information can cause device malfunction.

6 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

Pos: 3 /Software-Handbcher/B-COMM Java Installation/Installationsvoraussetzungen und bersicht @ 6\mod_1268301151166_2.doc @ 23253 @ 1222223332333 @ 1

1 Installation
1.1 Hardware requirements

A successful installation of B-COMM requires the following hardware:

min. 512 MByte RAM (B-COMM only , no OS or additional software)
min. 50 GByte free hard disk memory for the installation of the program
SVGA (resolution 1024x786 pixel)

These indications refer only to the B-COMM installation. This does not include the
memory size required by the Java environment JRE, the operating system and
other applications.
For the running operation, we cannot clearly specify the required memory size as it
depends on several factors. These include:
Booking volume
Installed components
Generation of mirror files
Debug level and others.

1.2 Java and .NET Framework environment

Depending on the intended installation environment, different requirements for the

installation of B-COMM and its components must be fulfilled. This applies in
particular to the required Java JRE version and the .NET Framework, which is
already installed on the target computers.
B-COMM Server: requires minimum JRE 1.5.0.
B-COMM GUI: requires minimum JRE 1.5.0.

NOTICE!
The performance of JRE must match the performance of the corresponding version
of Sun microelectronics.

An installation using the installation routine installBCOMMJava.exe always

requires the .NET Framework 2.0, see chapter 1.7.1. Some additional .NET
Framework versions may be reqiured for certain components, see chapter 1.3 and
1.4.

07/2014 Kaba GmbH 7

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

1.3 ARIOS-components/CardLink

The installation and the use of ARIOS/CardLink components always requires

administrator rights.
The appropriate Microsoft .Net Framework is required for operating ARIOS-
components/CardLink. If necessary, the mentioned frameworks have to be
installed on the target system.
ARIOS with Mifare and CardLink with Legic
.Net Framework of version 3.5 is required, and, additionally,
.Net Framework of version 4.0, and, additionally,
Microsoft Visual C++ 2010 Redistributable Package (32/64 bit).
Make sure to observe the following when creating services under the operating
systems Windows Vista, Windows 7 and Server 2008:
The file WcfService.exe in the B-COMM directory must have administrator
rights (right-click on file Properties Compatibility Execute program as
administrator).
These rights must be set up after installation.

1.4 Overview on software requirements

Important!
The .NET Framework 4.0 version does not completely replace the previous
versions. Therefore, the installation of a single .NET Framework 4.0 is not enough
for certain functions, see table below.

Item .Net .Net .NET Java Visual C++ 2010

2.0 3.5 4.0 JRE 1.5 Redistrb. Package
Installation X A X
using .exe-
files
CardLink with X X X X
Legic
ARIOS X X X X
Biometrics X X X X X

X = minimum required version

A = alternative version
= not to be used

8 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

1.5 Selecting the "Common" or "Separate" installation type

There are three different types of installation for B-COMM:

Common
Separate (predefined data directory)
Separate (selectable data directory).

Which type of installation is used depends on your operating system and the
allocation of rights on the system.

1.5.1 "Common" type of installation

Valid to an unlimited extent for the operating systems:

UNIX/Linux
OS/400
Windows XP
Windows Server 2003.
In this case, both program and configuration files are installed in one common,
selectable target directory. It is specified during installation. Kaba does not
recommend the "Common" type of installation.
This type of installation is not recommended for Windows Vista, Windows 7 and
Windows Server 2008.

1.5.2 "Separate" type of installation (predefined data directory)

Valid to an unlimited extent for the following operating systems:

Windows Vista
Windows 7
Windows XP
Windows Server 2003/2008.
UNIX/Linux
OS/400
Due to particularities when granting access rights under Windows Vista, Windows
7 and Windows Server 2008, a separate installation of program and configuration
files is required. Kaba recommends the "Separate" type of installation for all
mentioned operating systems.
It is defined as default type of installation in setup.
With this version, the configuration files are stored fixed in directory /<current
user name>/Kaba/B-COMM/ (client name, etc.).
The program files (executable files) are stored by default in the directory
...../<program files of the operating system>/Kaba/B-COMM/ with this version.
The directory may be changed during installation.

07/2014 Kaba GmbH 9

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

1.5.3 "Separate" type of installation (selectable data directory)

This is also a "Separate" installation setup.

Valid to an unlimited extent for the following operating systems:
Windows Vista
Windows 7
WIN XP
Windows Server 2003/2008.
UNIX/Linux
OS/400
With this version, the configuration files are stored by default in directory
/<current user name>/Kaba/B-COMM/. The directory may be changed during
installation.
The program files (executable files) are stored by default in the directory
..../<program files of the operating system>/Kaba/B-COMM/ with this version.
The directory may be changed during installation.

This type of installation is especially meant for cluster installations to store the
configuration data, for example, on a mapped directory.

10 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

1.6 Installation examples

1.6.1 Installation example 1: Server and GUI on one computer:

B-COMM Server and B-COMM GUI are installed on one computer. In addition, an
application for data evaluation is installed on the same computer.

RMI BCOMMIO TCP/IP

BCLAN 01 Application Interface

RMI BCOMMIO TCP/IP Application

Application Interface (not written
BCLAN02
in Java)

RMI TCP/IP
B-COMM Server BCOMMHelper

RMI B-COMM GUI

(Configuration
Program)

bcommjava.ini

bclan01.ini

bclan02.ini

Configuration files

Fig. 1: Installation on one computer

An application that was not programmed in Java can communicate with B-COMM
Server with the help of the program module B-COMM Helper.

Please see the B-COMM manual for more detailed information about the program
module B-COMM Helper.

07/2014 Kaba GmbH 11

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

1.6.2 Installation example 2: Server and GUI on 2 computers

B-COMM Server and B-COMM GUI are installed on two different computers. In
addition, an application that is not written in Java is installed on another computer
for data evaluation.

Computer 1 Computer 2

RMI BCOMMIO TCP/IP

BCLAN 01 Application Interface

RMI BCOMMIO TCP/IP Application

BCLAN02 Application Interface (not written
in Java)

B-COMM Server RMI TCP/IP

BCOMMHelper

RMI
Computer 3

B-COMM GUI
(Configuration
program)

bcommjava.ini

bclan01.ini

bclan02.ini

Configuration files

Fig. 2: Installation on two computers

An application that was not programmed in Java can communicate with B-COMM
Server with the help of the program module B-COMM Helper.
Please see the B-COMM manual for more detailed information about the program
module B-COMM Helper.

12 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

1.6.3 Installation example 3: Server and GUI on 2 computers with Java application

B-COMM Server and B-COMM GUI are installed on several computers. In addition,
an application written in Java is installed on another computer for data evaluation.

Computer 1 Computer 2

RMI BCOMMIO TCP/IP

BCLAN 01 Application Interface

RMI BCOMMIO TCP/IP SWP-Application

BCLAN02 (not written
Application Interface
in JAVA)

RMI
B-COMM Server

RMI

Computer 3

B-COMM GUI
(Configuration-
program)

bcommjava.ini

Computer 4

bclan01.ini B-COMM GUI

(Configuration-
program)

bclan02.ini

Configuration files

Fig. 3: Installation on several computers

An application that was programmed in Java can communicate directly with the
B-COMM Server via RMI. The program module B-COMM Helper is not required in
this case.

Pos: 4 /=====Seitenumbruch===== @ 0\mod32_2.doc @ 444 @ @ 1

07/2014 Kaba GmbH 13

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

Pos: 5 /Software-Handbcher/B-COMM Java Installation/Installation ber ANT-Installer @ 6\mod_1268300302065_2.doc @ 23247 @ 2334444433442323333344323333 @ 1

1.7 Installation in Windows operating systems

Important!
If the biometric functionality shall be installed, the data execution prevention must
be disabled, see chapter 1.10.

1.7.1 Selecting the installation routine

The installation is started by loading an installation routine. The installation routines

are stored on the program CD in directory B-COMM/Setup. The installation routine
to be used depends on
the operating system used and
the presence of a Microsoft .NET Framework 2.0 or higher
The types of installation, "Common" or "Separate", may be selected during
installation; see chapter 1.5

Overview of the installation options

Operating system Common Separate Installation routine
Windows Vista No Yes instBCOMM.exe
Windows 7 No Yes instBCOMM.exe
Windows Server 2008 No Yes instBCOMM.exe
Windows Server 2003 Yes Yes instBCOMM.exe
Windows XP with .NET Yes Yes instBCOMM.exe
Framework 2.0
Windows XP without Yes Yes instBCOMM.cmd
.NET Framework 2.0

Operating systems Vista, WIN7, Server 2008/2003 and Windows XP with .NET
Framework
The installation routine instBCOMM.exe requires .NET Framework version 2.0.
and higher.

Remark
When using WIN7 64 bit together with Java 32 bit, the path to the java.exe file must
be set in the Path environment variable (e.g. C:\Programs\Java\jre7\bin).

14 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

Operating system WIN XP without .NET Framework

If you use operating systems without .NET Framework, the installation routine
instBCOMM.cmd must be used. You need administrator rights for the command
line (StartOpen the command line cmdOpen the context menu via right
mouse button Select Run as administrator).

Fig. 4: Selecting the installation routine.

Remark
If there is an existing .NET Framework, you will find it under StartSystem
ControlSoftware (Example for Windows XP).

After selecting the installation routine by double-click, the installation will start
automatically. The following example refers to the "Separate" installation; we also
recommend it as default installation.

07/2014 Kaba GmbH 15

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

Select the language for installation. It is the language in which the texts are
displayed during setup. Currently, German and English are supported only.
The labeling of the buttons depends on the language of the operating system.
Please confirm by pressing "Next".

Fig. 5: Program installation: Language selection

Read the license agreement.

Confirm by pressing Accept.

Fig. 6: Program installation: Accepting the license agreement.

16 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

The following screen shows additional information for setup. Please read these
notes carefully.
Confirm by pressing Next.

Fig. 7: Program installation: Additional setup information

Select the type of installation.

Make the appropriate selection for your installation. This selection influences the
components that will be installed.
Confirm by pressing Next.

Fig. 8: Program installation: Selecting the type of installation.

07/2014 Kaba GmbH 17

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

Select the type of installation. You may choose between

Common and
Separate (predefined data directory) and
Separate (selectable data directory).
You will find more detailed information about the types of installation in chapter 1.5
and in the mask itself. The default value and this installation example refer to the
type of installation "Separate (predefined data directory)".
Make your selection and confirm by pressing "Next".

Fig. 9: Program installation: Selecting the type of installation.

Select the target directory for the program files. The default target directory is
<program files of the operating system>/Kaba/B-COMM Java.
Accept the default value or enter your own path. As the Installer will not memorize
the directory selected for installation, the default directory is also proposed during
an update. In this case, enter the desired target directory when updating.
Confirm by pressing Next.

Fig. 10: Program installation: Selecting the directory for the program files.

18 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

If you selected the Separate Directories-Selectable Data Directories option, the

following screen appears. Select here the target directory for the configuration files.
The default target directory is
<Current user name>/Kaba/B-COMM Java.
Accept the default value or enter any path. As the Installer will not memorize the
directory selected for installation, the default directory is also proposed during an
update. In this case, enter the desired target directory when updating.
Confirm by pressing Next.

Fig. 11: Program installation: Selecting the directory for the configuration files.

Select the B-COMM components that will be installed.

The number of components and whether they may be selected or not depends on
the type of installation (default: Typical) and the operating system.
Make your selection and confirm by pressing "Next".

Fig. 12: Program installation: Selecting the components.

07/2014 Kaba GmbH 19

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

The use of biometric functions integrated in B-COMM requires the installation of

the Morpho software kit. This function runs only under Windows operating systems.
The installation of Morpho software kit is automatically started after having installed
B-COMM provided the corresponding check box has been ticked.
A detailled description of the installation process can be found in chapter 1.7.2.

Remark
The installation routine of Morpho needs about 1 minute for loading. Do not start
or cancel any other function during this time. The installation procedure
explained in this document must be strictly adhered to!

Make your selection and confirm by pressing "Next".

Fig. 13: Program installation: Selecting Sagem Morphokit for biometric functions.

Read the hints concerning ARIOS and confirm by pressing "Next".

Fig. 14: ARIOS hints

20 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

When updating an existing B-COMM installation, an information screen is

displayed. It informs about how any existing files on the target system will be
treated.
Confirm by pressing Next.

Fig. 15: Program installation: Information for updates.

Under the Windows operating systems, you may select whether you want to create
shortcuts to individual B-COMM components in the start menu.
The shortcuts may be created for the following components:
B-COMM Server
B-COMM GUI
B-COMM ServiceManager
B-COMM Starter
B-COMM TerminalStatus

Make your selection and confirm by pressing "Next".

Fig. 16: Program installation: Selecting the start menu shortcuts.

07/2014 Kaba GmbH 21

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

Select special settings

Operating systems Windows 7 or Windows Vista

Fig. 17: Selecting the special settings Windows 7 or Windows Vista

The menu for special settings differs depending on the operating system used.
Use of the DCC web services
This function is necessary for the operating systems
WIN 7 and
Windows Vista and
Windows XP
in cases
the user does not have any administrator rights and
the CardLink programming device 1364 (for Legic badges) or
1460 (for Mifare badges) is to be used.

Windows 7 and Windows Vista procedure

1. If the check box is ticked, a user group named DccService will be
generated automatically during installation.
2. The Dcc web service URL will be registered automatically and
permanently.
3. The corresponding users must be included manually in the
DccService user group after installation.
This allows the users to obtain the necessary rights.

22 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

Adding users to the Dcc service group manually for WIN 7 and Windows
Vista
Search for local in the start menu search field. In this way, the correct link to Edit
local users and groups is displayed.
Select the Edit local users and groups menu.

Fig. 18: Opening the Edit local users and groups menu

Fig. 19: Editing the DccService group

07/2014 Kaba GmbH 23

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

Under Groups, you will find the DccService group created by the Installer.
Double click to open the following window.

Fig. 20: Adding users to the DccService group

Click Add... to select the users for whom use of the DccService is intended.
Press OK to confirm.
Press OK to close the DccService properties dialogue.
If the option is activated in the Properties->Compatibility->Execute program as
administrator context dialog of the WcfService.exe file in the B-COMM program
directory, this option must be deactivated again.
After this action, the new user rights must be activated by logging the user off and
on again.

Using FTP on WIN7 and Vista

This function is required for the operating systems
WIN 7 and
Windows Vista
if Java JRE 1.7 is used
This configuration may result in problems regarding FTP transfers. This function
switches off the FTP filter of the firewall.

24 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

Select special settings

Operating systems Windows XP

Fig. 21: Selecting the special settings Windows XP

Windows XP procedure
1. If the check box is ticked, a DccService user group will be generated
automatically during installation.
2. The Dcc web service URL must be registered manually and
permanently by means of a tool.
See description in the following step-by-step instructions, items 1 - 9.
3. The corresponding users must be included manually in the
DccService user group after installation.
This allows the users to obtain the necessary rights.
See description in the following step-by-step instructions,
items 10 - 11.

The DccService for limited users under Windows XP is executed from the
installation CD by means of a tool. This HttpNamespaceManager.exe tool must
be copied to the local drive if necessary.
The tool requires at least .Net-Framework 3.0 as program environment.

07/2014 Kaba GmbH 25

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

Permanent registration of the DccService URL for the DccService

user group under Windows XP (1)

1. Select the This tool can be found on the B-COMM

HttpNamespaceManager. installation CD in the
exe tool. \B-COMM\Tools\HttpNamespaceManager
directory. This HttpNamespaceManager.exe tool
must be copied to the local drive if necessary.
2. Following the call, the
following window is
displayed:
Http Namespaces

3. Click <Add>. The

following input mask
appears:
Enter URL

4. Enter the following URL

with the exact number
of characters:
http://+:8010/DccService/
Save by clicking <OK>.
5. After saving the URL, the
following window is
displayed:
Permissions

26 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

Permanent registration of the DccService URL for the DccService user

group under Windows XP (2)

6. Click <Add>. The following input

window is displayed:
Add User or Group

7. Enter the name of the defined

group with the exact number of
characters:
DccService
Save by clicking <OK>.

8. After clicking <OK> and confirming

the next program message, the
group is displayed in the upper part
of the window. You can now set the
desired rights in the lower part of
the window.
At least the right GenericExecute
must be set.

9. After confirming with <OK>, the

DccService will be correctly
registered with its Namespace and
the users assigned to the
DccService group will be able to
use it.

10. The setup created automatically a Call via: Start => Control Panel=>
new DccService user group. Administration => Computer Management,
then System => Local users and groups.
11. Add the user or users with limited Add the user(s) via the New user context
rights to the user group. menu (right mouse button).

07/2014 Kaba GmbH 27

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

Continuation of the installation

B-COMM does not have any uninstall program. You may remove B-COMM simply
by deleting the created directories and shortcuts.
This information will be displayed on a separate screen.
Confirm by pressing Next.

Fig. 22: Program installation: Information on uninstalling.

Setup is started by clicking on the "Install" button.

Fig. 23: Program installation: Starting setup.

28 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

This dialog shows the installation progress. The currently processed component is
indicated by a green dot.

Fig. 24: Program installation: Installation progress.

You will get more details about the installation progress in the details mask.

Fig. 25: Program installation: Displaying details about the installation progress.

A message confirms that the installation has been completed successfully. The
installation is completed.

07/2014 Kaba GmbH 29

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

1.7.2 Biometrics: installing Morpho biometrics software

NOTICE!
Before installing make sure that
all older versions have been uninstalled completely from the target system
plugged-in Morpho dongles have been unplugged before installing
no reader (MSO 300 or MSO 1300) is plugged in.

The installation of Morpho biometrics software is automatically started after having

installed B-COMM provided the corresponding check box has been ticked.
Remark
The following description refers to the installation of the biometrics software and
the drivers offered by Morpho. Therefore, the included masks and their contents
are not under the control of Kaba GmbH.

The installation routine of Morpho needs about 1 minute for loading. Do not start
or cancel any other function during this time. The installation procedure
explained in this document must be strictly adhered to!

1.7.2.1 Requirements and purpose of use for biometrics software

The biometrics software from Morpho is required for enrolling finger templates
using the readers
MSO 300 (from firmware version 8.04) or
MSO 1300

The following operating systems are supported:

Windows XP, 32-bit, SP2 or higher
Windows XP, 64-bit, SP1 or higher
Windows Vista, 32-bit and 64-bit, SP1 or higher
Windows 7 32-bit and 64-bit

Remark
When installing B-COMM under a Windows 64-bit systen, also the 64-bit Java JRE
should be used.

30 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

1.7.2.2 Biometrics: overview of the installation procedure

The installation procedure depends largely on the type and extent of the existing
system environment. The following figure shows an overview of the installation
procedure under different start conditions. Some of the components are installed
automatically.

Fig. 26: Overview of the installation procedure for biometrics software

07/2014 Kaba GmbH 31

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

1.7.2.3 Biometrics: starting the installation

Before finishing the B-COMM installation, the mask for Morpho biometrics software
installation is automatically displayed provided the corresponding check box has
been ticked when installing B-COMM. This mask includes the actual biometrics
software and drivers for Microsoft Visual Studio.
The selection and installation of the individual components depends on the system
environment and must be specified for each single case; please see the figure in
chapter 1.7.2.2.

1.7.2.4 Biometrics: installation start

The following chapters explain every single component of the biometric

functionality in the order of their installation. It depends on the configuration of the
target system, which components are to be installed in a certain installation.
Please confirm by pressing "Next".

Fig. 27: Biometrics installation: Installation start

32 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

Make sure no older version of Morpho enrollment software is installed on your

system. Hints for deinstallation of Morpho enrollment software can be found in
chapter 1.9.3.
Setup is started by clicking on the "Install" button.

Fig. 28: Biometrics installation: Uninstall hint for Morpho enrollment software.

The installation progress is logged.

Fig. 29: Biometrics installation: This dialog shows the installation progress.

07/2014 Kaba GmbH 33

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

The licensing dialog of Morpho enrollment software starts automatically.

Please confirm with Next.

Fig. 30: Welcome screen for Sagem Scurit Licence Manager

Selection of the installation folder.

The predefined folder must not be changed!

Fig. 31: Selecting the installation directory

34 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

Please confirm with Next.

Fig. 32: Confirming the installation of Sagem Scurit Licence Manager

The installation of the license files ist finished after a short delay time.
Please confirm with Close.
The installation of the drivers starts automatically.

Fig. 33: Sagem Scurit Licence Manager installation finished

07/2014 Kaba GmbH 35

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

1.7.2.5 Biometrics: installation procedure for MorphoSmart drivers 32-/64 bit

During the biometrics software installation, the drivers for the biometric readers are
installed first.
Follow the instructions on the screen during the installation.

Fig. 34: Welcome screen for driver installation

Selection of the installation folder.

The predefined folder must not be changed!

Fig. 35: Selecting the installation directory

36 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

Please confirm with Install.

Fig. 36: Starting the installation

The installation of the driver files ist finished after a short delay time.
Please confirm with Finish.
The installation of the Microsoft Visual Studio runtime starts automatically.

Fig. 37: Driver installation finished

07/2014 Kaba GmbH 37

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

1.7.3 Biometrics: MS Visual Studio Runtime

Microsoft Visual Studio 2005 must be installed if not existing on the target system.
The software is necessary for visualization of the fingerprints during the enrollment
process.
The installation starts automatically. Its just a short installation procedure without
any feedback messages.
Due to technical reasons the screenshots are in German.

Fig. 38: Welcome screen of MS-Visual Studio.

Fig. 39: Installation of MS Visual Studio finished.

38 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

1.7.4 Checking the data execution prevention (DEP)

As final step of the installation of the biometric features, a check of the data
execution prevention status is performed.
Background
In various Windows operating systems, a data execution protection is
implemented. By default, the DEP is activated in several operating systems, e.g.
Windows Vista and Windows 7. The check of the data execution prevention status
is used to determine the active status of the DEP on the target system and its
settings.

Abb. 40: Check of the data execution protection

Check result
The check result is displayed as so-called DEP level in a certain mask. Depending
on the result, the actions to be taken are displayed as well.

Check result Meaning/Action

DEP level = 1 DEP level 1 means, the template enrollment software
cannot be operated. The DEP must be deactivated or
exceptions must be defined, see chapter 1.10.3.
DEP level = 2 DEP level 2 means, the template enrollment software
can be operated.
DEP level = 3 DEP level 3 means, the template enrollment software
can be operated, if exceptions are defined, see
chapter 1.10.3.

07/2014 Kaba GmbH 39

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

1.7.5 Biometrics: B-COMM settings

After having installed all biometric components, make the required settings in
B-COMM.

Plug biometric reader into USB port

Start B-COMM Java Server and GUI

Make biometrics settings and save

Fig. 41: Overview biometrics settings

1. Plug the biometric reader in the USB interface of the computer.

2. Start B-COMM server and B-COMM GUI.
3. At least one client must be defined and activated. If not, a client must be created
first and activated (clicking it).
4. Click on the "Global settings" menu item in the "Biometrics-Configuration" menu
5. Make the settings required for biometrics:
- Configuration with regard to template processing
- Selection of Sagem software version (with this installation, always version 4).
6. Save by clicking on "OK" and close.

Fig. 42: Biometrics settings in B-COMM

40 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

1.7.6 Biometrics: checking the installation

Its functionality can be checked by loading the enrollment dialog.

1. Start B-COMM server and B-COMM GUI
2. Click on the "Tenplate enrollment" menu item in the "Biometrics" menu
3. Open the Capture dialog in the mask
4. The biometric reader must be addressed (LEDs are lit)
5. A fingerprint must be visible when putting on the finger and the visibility is not
disabled via the relating parameter.
If no finger is vivible, please check the checkbox Suppress pictures during
enrollment in the menu Biometrics -> Client-specific settings ->Template handling.

Fig. 43: Testing the functionality of the biometric reader

07/2014 Kaba GmbH 41

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

1.8 Installation in Unix/Linux and OS/400 operating systems

The installer must run under the Root user account!

The installation under Unix/Linux or OS/400 operating systems requires a run
capable Java Runtime of version 1.5.0 or higher. Start and progress of the
installation under these operating systems depend on whether
the operating system has a graphical interface and
Java Runtime is found by the Installer.

The starts summarized in the following are valid for installations in which the
Installer finds Java JRE without problems.
Operating system Common Separate Installation routine
Unix/Linux with Yes Yes instBCOMM.sh
graphical interface
The installation is menu-guided,
similar to installation in
Windows operating systems.
Unix/Linux without Yes Yes instBCOMMConsole.sh
graphical interface
The installation is text-based.
OS/400 Yes Yes Enter the following in the
command interface:
java -jar"B-COMM-installer.jar"
text
The installation is text-based.

Fig. 44: Selecting the installation routine.

If Java Runtime is not automatically found by the Installer (an error message is
prompted), the path must be specified when starting the installation.

Unix/Linux with graphical interface

[Java path] java jar B-COMM-installer.jar

42 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

Unix/Linux without graphical interface

[Java path] java jar B-COMM-installer.jar text
The Installer is started mandatorily in text mode.

OS/400 (always without graphical interface)

[Java path] java jar B-COMM-installer.jar text
The Installer is started mandatorily in text mode.

1.8.1 Biometric enrollment under Linux

When using the Sagem enrollment functions under Linux operating systems, the
following hints must be observed.
Supported Linux distributions
Slackware 13.37
Slackware 13.37/64 mit multiLib
CentOS 5.7. SDL_TTF and SDL_image must be installed manually.
CentOS 5.7/64. SDL_TTF und SDL_image must be installed manually.
Ubuntu 10.04
openSuSE 11.4

Other Linux distributions only on request!

For every used Linux distribution the following libraries are necessary. Note: Even
for the 64 bit operating systems the 32 bit versions of the libraries must be used!

Necessary libraries for the enrollment function

libusb
libSDL
libSDL_TTF
libSDL_image
libpcsclite

07/2014 Kaba GmbH 43

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

1.9 Additional information about installation

1.9.1 Update

B-COMM installation files are used both for new installations and for updating
existing installations. If it is necessary to update any existing B-COMM installation,
you may do so by starting a new setup. The existing configurations are taken
without changes and used with the new version.
Before you update this software, please consider the following:
A running B-COMM software must be terminated before updating. All running
B-COMM services must be stopped.
As the Installer will not memorize the directory selected for installation, the
default directory is also proposed during an update. In this case, enter the
desired target directory when updating.
We recommend to deinstall all Sagem and Morpho components via the system
control menu of the computer before updating them. Doing this way you avoid to
run the installation routine twice (deinstallation and updating). This affects the
following components:
MorphoSmart SDK
MorphoKit x.x.x
Morpho Morphosmart USB Drivers
Morpho Scurit Licence Protection

1.9.2 Uninstalling B-COMM

The installation of B-COMM does not create any entries in the Windows registry.
For uninstalling, just delete the B-COMM directories and any existing shortcuts in
the start menu.

1.9.3 Uninstalling Morpho software

For uninstalling the Morpho biometric software, the data execution prevention must
be deactivated.

44 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

1.9.4 Services

Make sure to observe the following when creating services under the operating
systems Windows Vista, Windows 7 and Server 2008:
The wrapper file in the B-COMM directory must have administrator rights (right-click
on file Properties Compatibility Execute program as administrator). The
following wrapper files are available:
32-bit operating systems: wrapper-windows-x86-32.exe
64-bit operating systems: wrapper-windows-x86-64.exe

Automatic detection of devices reqiures the following services to be started:

UPnP-Device Host
SSDP-Discovery

1.9.5 Ports used in default configuration

In the default configuration, B-COMM uses the ports listed below:

1.9.5.1 TCP ports

Port (decimal) Port (hex) Used for

20-21 14-15 FTP
22 16 SFTP
23 17 Telnet
80 50 Web services
1099-1100 44B-44C RMI
1101 44D RMI port for GUI
1102 44E RMI port for CardLink stream in GUI
3000 BB8 Remote Console
3001 BB9 Helper
3004 BBC AVISO
3005 BBD Application interface for partner
applications

1.9.5.2 UDP ports

Port (decimal) Port (hex) Used for

1900 76C SSDP for One click installation
30464-30703 7700-77EF Terminal communication
30720-30959 7800-78EF Biometrics
30976 7900 UPnP

07/2014 Kaba GmbH 45

Installation Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

1.9.6 Scanning viruses

Performance losses may occur if virus scans of B-COMM directories take place in
a running system.
It is recommended to exclude the B-COMM data directories from an automatic
virus scan.

1.10 Data execution prevention

Only necessary, if the biometric components shall be installed.

Various Windows operating systems are equipped with a data execution
prevention function. In some of these operating systems (e. g. Windows Vista or
Windows 7), this function is activated by default and must therefore be deactivated
manually in some cases prior to the installation procedure.
Because the deactivation of the data execution prevention requires a system
reboot, the deactivation should take place in the beginning of the installation
procedure.

1.10.1 Deactivate the data execution prevention

Caution
Incompatibilities between computer hardware and operating system.
After deactivating the data execution prevention the computer may be unable to
boot.
Before deactivating the data execution prevention please make sure if relating hints
do exist or contact the hardware manufacturer.
This problem is not caused by any Kaba product or system!

1. Requires administrator rights (StartOpen the command line cmdOpen the

context menu via right mouse button Select Run as administrator).
2. Open the command box StartExecute
3. Launch the following command: bcdedit /set nx AlwaysOff
4. Confirm with OK
5. Reboot the system

46 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Installation
B-COMM

1.10.2 Activate the data execution prevention again

If the data execution prevention shall be reactivated after finishing the installation
completely, some exceptions must take place. The reactivation can be done via
the command box again:
1. Requires administrator rights (StartOpen the command line cmdOpen the
context menu via right mouse button Select Run as administrator).
2. Open the command box StartExecute
3. Launch the following command: bcdedit /set nx OptOut.
4. Confirm with OK.
5. Reboot the system.
6. Define the exceptions of the data execution prevention.

1.10.3 Defining exceptions of the data execution prevention

The following files must be excepted from the data execution prevention:
templ_conv.exe (B-COMM directory)
SagemSecurite_Licence_Protection.exe (\SagemSecurite\LicenceProtection)
SagemSecurite_Licence_Manager.exe (\SagemSecurite\LicenceProtection)

1. The exceptions take place in the following menu (Windows 7):

StartControl panelSystem and SecuritySystemAdvanced system
settingsSystem Properties maskAdvanced tabPerformance
SettingsPerformance OptionsData execution prevention.
Activate the Turn on DEP for all programs and services except those I select
checkbox. Use the Add button to add the files named above.
2. Save
3. Reboot the system

1.10.4 Reboot

After a successful installation a reboot of the system shall take place.

A reboot is mandatory if a Morpho reader MSO 300 is used!

Pos: 6 /=====Seitenumbruch===== @ 0\mod32_2.doc @ 444 @ @ 1

07/2014 Kaba GmbH 47

Index Reference Manual Vers. 3.10.0 Installation instruction
B-COMM

=== Ende der Liste fr Textmarke Inhalt ===

Pos: 1 /Technische Dokumentation/berschriften/1/Kontaktadressen @ 0\mod_1157456130628_6.doc @ 3353 @ 1

2 Index

A Installation in Unix/Linux and OS/400 operating

systems.......................................................... 42
About this manual .................................................5
Installation in Windows operating systems ........ 14
Additional information about installation .............44
J
Addressees...........................................................5
Java environment................................................. 7
ARIOS-components..............................................8
L
B
Linux operating system
Biometrics
Installation hints.............................................. 42
installation procedure ......................................31
Supported distributions for enrollment ........... 43
installation procedure of MS Visual Studio ....38
Linux operating systems
installing Morpho biometrics software.............30
Libraries for use with enrollment .................... 43
installing Sagem biometrics software..............20
settings in B-COMM ........................................40 O

C Orientation in the manual..................................... 5

CardLink ...............................................................8 P

Content and purpose ............................................5 Ports, TCP ......................................................... 45

D Ports, UDP ......................................................... 45

Ports, used in default configuration ................... 45
Data execution prevention..................................46
data execution prevention, deactivation of .........46 R

data execution prevention, defining exceptions .47 Reboot ............................................................... 47

data execution prevention, reactivating ..............47 Requirements and purpose of use for biometrics
software ......................................................... 30
Data execution protection...................................39
DCC web service ................................................22 S

H Selecting the "Common" or "Separate" installation

type .................................................................. 9
Hardware requirements ........................................7
Selecting the installation routine ........................ 14
I Services ............................................................. 44
Installation.............................................................7 Switching off the FTP filter for the firewall ......... 24
Installation example 1 T
Server and GUI on one computer ...................11
TCP ports........................................................... 45
Installation example 2
Type of installation
Server and GUI on 2 computers .....................12
Common........................................................... 9
Installation example 3
Separate with predefined data directory .......... 9
Server and GUI on 2 computers with Java
application ...................................................13 U

Uninstalling B-COMM ........................................ 44

48 Kaba GmbH 07/2014

Reference Manual Vers. 3.10.0 Installation instruction Index
B-COMM

UPD ports ...........................................................45 V

Update ................................................................44 Validity ................................................................. 5
Virus scans ........................................................ 46

07/2014 Kaba GmbH 49