Alcatel-Lucent OmniPCX

Enterprise
Communication Server

SmartCall version 1.0.x

– Installation Guide

Alcatel-Lucent Services for Enterprise

All Rights Reserved © Alcatel-Lucent 2007
Legal notice

Alcatel, Lucent, Alcatel-Lucent and the Alcatel-Lucent logo are trademarks of Alcatel-
Lucent. All other trademarks are the property of their respective owners.

The information presented is subject to change without notice.

Alcatel-Lucent assumes no responsibility for inaccuracies contained herein.

Copyright © 2007 Alcatel-Lucent. All rights reserved.

All Rights Reserved © Alcatel-Lucent 2007 Page 2

 Table of Content

1 INTRODUCTION .................................................................................5

1.1 Intended Readership.............................................................................................................................5

1.2 Applicability Statement .......................................................................................................................5

1.3 Purpose ....................................................................................................................................................5

1.4 Scope ........................................................................................................................................................5

1.5 Application Overview ...........................................................................................................................5

1.6 How to use this document...................................................................................................................6

1.7 Copyrights ...............................................................................................................................................6

1.8 Related Documents ...............................................................................................................................6

1.9 Licensing..................................................................................................................................................7

1.10 Customer Support..............................................................................................................................7

2 UNDERSTAND YOUR APPLICATION ..........................................................8

3 SMARTCALL SERVER - INSTALLATION FOR WINDOWS.................................. 11

3.1 Requirements for installing...............................................................................................................11

3.1.1 Hardware ........................................................................................................................................11
3.1.2 Software .........................................................................................................................................11
3.1.3 Networking .....................................................................................................................................11

3.2 Know your Installation CD .................................................................................................................12

3.3 Installation Process – a quick look ...................................................................................................13

3.4 Installation Details...............................................................................................................................14

3.4.1 General ...........................................................................................................................................14
3.4.2 Installation of Java Development Kit (JDK)..............................................................................15
3.4.3 Installation of Tomcat..................................................................................................................19
3.4.4 Tomcat Configuration ..................................................................................................................25
3.4.5 Deploy the SmartCall Services Web Application......................................................................27
3.4.6 SmartCall Configuration...............................................................................................................31
3.4.6.1 License File ............................................................................................................................31
3.4.6.2 SmartCall Server config.properties Configuration File.........................................32

4 SMARTCALL SERVER - INSTALLATION FOR LINUX ...................................... 40

All Rights Reserved © Alcatel-Lucent 2007 Page 3

4.1 Requirements for Installing...............................................................................................................40

4.2 Installing Procedure ............................................................................................................................40

5 UNINSTALLING THE SMARTCALL SERVER ................................................ 44

6 INSTALLATION - SMARTCALL CLIENT ..................................................... 49

6.1 Requirements for Installing Client Services ..................................................................................49

6.1.1 Hardware ........................................................................................................................................49
6.1.2 Software .........................................................................................................................................49
6.1.3 Networking .....................................................................................................................................49

6.2 Installing the Software .......................................................................................................................50

6.2.1 Silent Installation..........................................................................................................................50
6.2.2 Interactive Installation – a sketch ..............................................................................................50
6.2.3 Interactive Installation – in detail..............................................................................................50
6.2.4 Launching SmartCall.....................................................................................................................56
6.2.5 Configuring the SmartCall Client Application ..........................................................................58
6.2.6 Starting the SmartCall Client Application.................................................................................60
6.2.7 Checking Software Installation ...................................................................................................60
6.2.8 Installing the HTTPS Certificate .................................................................................................61

7 UNINSTALLING THE SMARTCALL CLIENT APPLICATION................................ 62

7.1 Uninstalling through the application ..............................................................................................62

7.2 Through Windows utility....................................................................................................................63

8 APPENDIX ...................................................................................... 64

8.1 Table of Figures ...................................................................................................................................64

All Rights Reserved © Alcatel-Lucent 2007 Page 4

1 Introduction
1.1 Intended Readership

This manual targets System Administrator who also does networking. This is not
relevant to the user of this application

1.2 Applicability Statement

This manual applies to installation of the application: SmartCall in server and

clients. This does not cover actual use of this application.

1.3 Purpose

This guide explains:

• The hardware and software environment that the installation of this

application requires.
• The method of installing the application on server side.
• The method of installing the application on clients.
• Configuration of this application on server side.
• Configuration of this application on clients.

This manual targets at the System Administrator, and provides him with all
necessary information to complete the above tasks.

1.4 Scope

This manual covers all activities necessary for installing the application in a server
and its clients and provides guidelines to configure it. It also covers all necessary
information to create the environment suitable for installing the application.

1.5 Application Overview

The application: SmartCall provides an easy way to set up a phone call. It is

possible to select the number or e-mail address from anywhere in the PC which can
be copied to clipboard, and dial that number using this application. Features of this
application are:

• The Call number can be picked up from various sources

• Various Dialing options like phone number and e-mail address
• Call History is maintained in the application
• Shortcut keys are available for easy dialing

All Rights Reserved © Alcatel-Lucent 2007 Page 5

1.6 How to use this document

This manual has 2 major components. Their names and their location in this manual
are as below:

Installation and Section #3 Installation – SmartCall Server

configuration of Server

Section #4 Uninstalling the SmartCall Server

Installation and Section #5 Installation SmartCall Client

configuration of Client

Section #6 Uninstalling SmartCall Client Application

Based on your purpose, you can select the section and proceed.

In Appendix, you can find Table of Figures. This lists the names of screenshots
used in the body of this manual. Click on any of those listed to move to the section
that displays and explains that screenshot.

Section #2 Understand your application explains the functionality of this

application. This is for your information only.

Rests of the portions are for your general understanding of the application.

1.7 Copyrights

This product is based on software developed by Microsoft.

Copyright (C). All rights reserved.
This document gives product names, which can be trademarks, all of them
recognized as such.

1.8 Related Documents

SmartCall - User Guide

All Rights Reserved © Alcatel-Lucent 2007 Page 6

1.9 Licensing

To use SmartCall product , a license file is needed containing :

- license per site for Smart Call Server (linked to XML API Server
license file, see in installation guide)
- license per users for Smart call users

To use Smart Call's "make call" functionality, licenses for XML API
Product are needed :
- One "MyPhone" license per user of SmartCall (*)

*: For IPTouch phones, "IPTouch XML extended Services" licenses can be used
replacing MyPhone ones'.

1.10 Customer Support

Please contact your system administrator or Alcatel-Lucent Business Partner for

support

All Rights Reserved © Alcatel-Lucent 2007 Page 7

2 Understand your application
SmartCall is a Pick and Dial out Application, which can dial out any number that is
copied to the Clip Board of the PC. But this application does not handle incoming
calls.

When you make calls,

• The destination of the call can be:

o A phone number
o An e-mail address. In this case, an LDAP phone book is required.

• The call can be selected from:

o A web page on Internet Explorer
o A Word, Excel or Power Point document
o Any string of characters that can be copied to the clipboard in a
Microsoft window

The following diagram illustrates how this application handles a call:

The application handles the calls made by a user, in the following manner:

• The SmartCall user selects a destination on his/her workstation (a

SmartCall client application must be running in his workstation)
• The SmartCall client sends a request to the SmartCall Server. The
exchanges between SmartCall client and SmartCall server are protected
with the HTTPS (Hypertext Transfer Protocol through Secure Socket Layer )
protocol.
• The SmartCall server checks and processes the request. A LDAP
(Lightweight Directory Access Protocol) requests phone book.

All Rights Reserved © Alcatel-Lucent 2007 Page 8

 • The SmartCall Server sends a request asking a phone call establishment
between the destination set and the SmartCall user set
• The Call Server sets up the requested call

Below diagram gives the architecture of this setup:

All Rights Reserved © Alcatel-Lucent 2007 Page 9

 The sequence diagram is given below:

LINUX / Windows 2003

Smart Call
Call XML API Server
Client OXE
Smart Call LDAP
First time launching

Server
Connection Request

HTTPS Certificate

HTTPS Certificate sign

Number/ E-mail address

Encryption/ Decryption

Data validation status

Dial–out process

E-mail

Number

Formatted number

Call Status

Call Status – Accepted/ Rejected

Call Alerting
Called
Calling
On-Conversation Party
Party

All Rights Reserved © Alcatel-Lucent 2007 Page 10

3 SmartCall Server - Installation for Windows
3.1 Requirements for installing

Below given are minimum requirements, without which, this application will not
function properly. So, before installing this application, please ensure these
minimum requirements are met.

3.1.1 Hardware

Processor 2 GHz speed or above

RAM 1 GB

Disk Space 1 GB

3.1.2 Software

Operating Microsoft Windows 2003 Server

System

Server Tomcat 5.0.28

Environment

XML API 3.0 and above

Framework

3.1.3 Networking

Network 10/100 Mbps Ethernet card

Interface
card

All Rights Reserved © Alcatel-Lucent 2007 Page 11

3.2 Know your Installation CD

In order to install this application, a CD ROM is provided. This CD ROM contains

software for installing in both the Server and Clients.

Following are the contents of this CD:

File Purpose

SmartCall.1.0.x.msi This is a setup file for client side installation of

this application for the windows Operating system.
Location on the CD-ROM: Smartcall - CDROM -
1.0.X\Client.

SmartCallServices.war This is a “war” file that can be deployed as a web

service under the Tomcat application for the Linux
Operating system.
This file is available for different XML API
Framework under the following locations on the
CD-ROM.
Smartcall - CDROM - 1.0.X\Server\API2.2
Smartcall - CDROM - 1.0.X\Server\API3.0
Smartcall - CDROM - 1.0.X\Server\API3.1
Smartcall - CDROM - 1.0.X\Server\API5.0

Alcatel-SmartCall-API 2.2- This is the Smartcall product version 1.0.x working

1.0.x.exe with XML API Framework 2.2 and is a web
application on server side
Location on the CD-ROM: Smartcall - CDROM -
1.0.X\Server.

Alcatel-SmartCall-API 3.0- This is the Smartcall product version 1.0.x working

1.0.x.exe with XML API Framework 3.0 and is a web
application on server side
Location on the CD-ROM: Smartcall - CDROM -
1.0.X\Server.

Alcatel-SmartCall-API 3.1- This is the Smartcall product version 1.0.x working

1.0.x.exe with XML API Framework 3.1 and is a web
application on server side
Location on the CD-ROM: Smartcall - CDROM -
1.0.X\Server.

All Rights Reserved © Alcatel-Lucent 2007 Page 12

 Alcatel-SmartCall-API 5.0- This is the Smartcall product version 1.0.x working
1.0.x.exe with XML API Framework 5.0 and is a web
application on server side
Location on the CD-ROM: Smartcall - CDROM -
1.0.X\Server.

Keystore.zip This file is for security configuration of Tomcat

Location on the CD-ROM: Smartcall - CDROM -
1.0.X\Server.

License.lic The license file for the SmartCall server.

Location on the CD-ROM: Smartcall - CDROM -
1.0.X\Server\License.

Tools directory This directory contains tools that are necessary to

install and configure SmartCall application.
Example: JDK, Tomcat
Location on the CD-ROM: Smartcall - CDROM -
1.0.X\Tools\Windows – for the windows OS
Location on the CD-ROM: Smartcall - CDROM -
1.0.X\Tools\Linux – for the Linux OS

Installation Guide Installation Guide for use by the Administrator

Location on the CD-ROM: Smartcall - CDROM -
1.0.X\Documents\Guides.

User Guide User Guide to be used by users on the client side.

Location on the CD-ROM: Smartcall - CDROM -
1.0.X\Documents\Guides.

3.3 Installation Process – a quick look

Below is a brief on steps to install the application:

a. Ensure that in the Smart call server, Tomcat is installed and is operational
b. Make sure that XML API version 3.0 or higher is installed and configured.
c. The LDAP (Lightweight Directory Access Protocol) directory of Windows users,
containing the telephone numbers of callers, should be running.
d. Install the SmartCall application by running the file: Alcatel-SmartCall-API 3.0-
1.0.x.exe, located in the CD.
e. Configure the SmartCall application’s parameters.

All Rights Reserved © Alcatel-Lucent 2007 Page 13

3.4 Installation Details

3.4.1 General

The SmartCall Server application must be installed and configured. The SmartCall
application server is deployed in the Tomcat application server. This is why it is
essential that Tomcat be in operation on this server. The SmartCall server also
requires an XML API Server configured and in operation. It must include My Phone
Web Services licenses to start any call. To each SmartCall user must correspond an
XML API user, with the MyPHONE (Web Service) right enabled. Ensure that the user
must have Administrator Rights for the installation of Smartcall.

SCREENSHOT 1 – MYPhone Web Service Access

The link between the SmartCall client and the SmartCall server is via HTTPS and is
based on a basic authentication. This link is achieved via an Internet Explorer
component. This component must be configured to ignore Proxy parameters. It is
important to make the SmartCall server accessible for SmartCall clients according to

All Rights Reserved © Alcatel-Lucent 2007 Page 14

 the HTTPS protocol without proxy. Calls set with the SmartCall application are
Normal calls. The SmartCall application does not allow:

- Private calls (calls in private charging mode)

- Business calls (calls in business charging mode)
- Correlator calls (calls with an associated data)

The MS-Office Add-in, which adds an item to the popup menu, is compatible with
versions:

- MS-OFFICE 2000 Standard (Word, Excel, PowerPoint).

- MS-OFFICE 2003 Professional (Word, Excel, PowerPoint, Outlook).

3.4.2 Installation of Java Development Kit (JDK)

1. The JDK is available on the CD-ROM under Smartcall - CDROM - 1.0.X\ Tools\
Windows\Jdk.

2. Double click on the File name jdk-1_5_0_04-X-win.exe to proceed the

installation of JDK

3. Select the option “I accept the terms in the license agreement” and click “Next”.

All Rights Reserved © Alcatel-Lucent 2007 Page 15

4. Click on “Next” to continue the Installation process with the default location and
options.

All Rights Reserved © Alcatel-Lucent 2007 Page 16

5. The above screen is for information only.

6. During the process of JDK installation, the installation of Java Runtime Environment
will begin.

7. Click “Next” to begin the installation of JRE (Java Runtime Environment) with the
default location and components.

All Rights Reserved © Alcatel-Lucent 2007 Page 17

8. Select the browsers for which JRE to be installed and click “Next”.

All Rights Reserved © Alcatel-Lucent 2007 Page 18

9. This screen is for information only.

10. Click on “Finish” to complete the Installation of JDK.

3.4.3 Installation of Tomcat

1. The Tomcat server is available on the CD-ROM under Smartcall - CDROM -

1.0.X\Tools\Windows\Tomcat.

2. Double click on the File name jakarta-tomcat-5.0.28.exe to proceed the

installation of Tomcat Server.

All Rights Reserved © Alcatel-Lucent 2007 Page 19

3. Click “Next” on the screen above to begin the Installation.

All Rights Reserved © Alcatel-Lucent 2007 Page 20

4. Click on “I Agree” to continue with the Installation.

5. Click “Next” to proceed with the default options.

All Rights Reserved © Alcatel-Lucent 2007 Page 21

6. Click “Next” on the screen above, to install the Tomcat in the default location.

All Rights Reserved © Alcatel-Lucent 2007 Page 22

7. Enter a password for the “admin” user on the screen above and Click “Next”.

8. The path of the JRE (java runtime environment) is displayed by default. Choose a
different path if the location is other than the default location. Then click “Install” to
start the installation process.

All Rights Reserved © Alcatel-Lucent 2007 Page 23

9. This screen is for information only.

All Rights Reserved © Alcatel-Lucent 2007 Page 24

10. On the screen above, the options “Run Apache Tomcat” and “Show Readme” are
checked by default. Click “Finish” to complete the Installation of Tomcat server.

11. The tomcat server is started and the readme file is opened.

3.4.4 Tomcat Configuration

1. To install Tomcat, see the Tomcat documentation or point #3.4.3 Installation of

Tomcat given earlier in this manual.
Tomcat must be compiled with SSL.
Caution:
Check that java configuration is accurate. Check more particularly that system
environment variables have been configured.
For instance, with the JDK provided on the CD-Rom default installation:
CLASSPATH=C: \j2sdk1.5\lib; C:\j2sdk1.5\jre\lib; C:\j2sdk1.5\lib\tools.jar
JAVA_HOME=C:\j2sdk1.5

2. Stop Tomcat

3. Enable Basic Authentication:

Add a user to the Tomcat authentication system:

Directory: C: \Program Files\Apache Software Foundation \Tomcat

5.0\conf\

File: tomcat-users.xml

Add a user: <user username=”smartcall” password=”alcatel”

roles=”admin,manager”/>

Note 1:
The attribute username= « smartcall » may have the value name=
« smartcall » depending on the Tomcat version used.
Values for the attributes username and password are case-sensitive.

4. Enable HTTPS

Configure HTTPS in Tomcat (5.0):

a. Open the file: C: \Program Files\ Apache Software Foundation

\Tomcat 5.0\conf \server.xml

b. Remove comments by deleting the markers <!-- and --> in the section:
<Connector port=”8443” maxThreads=”150”
minSpareThreads=”25” maxSpareThreads=”75”
enableLookups=”false” disableUploadTimeout=”true”
acceptCount=”100” debug=”0” scheme=”https” secure=”true”
clientAuth=”false” sslProtocol=”TLS” />

c. Save the .keystore file in the root directory of the Windows user launching the
tomcat.exe process.

All Rights Reserved © Alcatel-Lucent 2007 Page 25

 The .keystore file is included in the file \server\keystore.zip of the CD-ROM.

Note 2:

To find the proper location for this file, once the https section of the server.xml
file has been configured:

i. Start Tomcat

The trace file C:\Program Files\Apache Software Foundation

\Tomcat 5.0 \logs \stdout.log include an error indicating that Tomcat
has not found the .keystore file.

The error indicates the directory in which the file has been searched.

ii. Stop Tomcat

iii. Save the .keystore file in the adequate directory.

5. Copy the tools.jar available from the Java installation path to the “\common\lib”
folder of the Tomcat installation path.

If the JDK and Tomcat are installed on the default location then tools.jar is available
at the following location: C:\jdk1.5.0\lib

It has to be copied to the following location of the Tomcat. C:\Program Files\Apache

Software Foundation\Tomcat 5.0\common\lib

6. Test the starting of Tomcat

Launch Tomcat in the Windows services

SCREENSHOT 2 - Tomcat Windows Service Status Example

a. Check trace files in the Tomcat logs directory: (C:\Program Files\Apache

Software Foundation\Tomcat 5.0\logs)

All Rights Reserved © Alcatel-Lucent 2007 Page 26

 Example:

When Tomcat start-up is correct, the file stdout.log ends in:

20 sept. 2006 17:52:25 org.apache.coyote.http11.Http11Protocol

start

INFO: Launching of Coyote HTTP/1.1 sur http-8080

20 sept. 2006 17:52:26 org.apache.coyote.http11.Http11Protocol

start

20 sept. 2006 17:52:26 org.apache.coyote.http11.Http11Protocol

start

INFO: Launching of Coyote HTTP/1.1 sur http-8443

20 sept. 2006 17:52:27 org.apache.jk.common.ChannelSocket init

INFO: JK2: ajp13 listening on /0.0.0.0:8009

20 sept. 2006 17:52:27 org.apache.jk.server.JkMain start

INFO: Jk running ID=0 time=20/100 config=C:\Program

Files\Apache Software Foundation\Tomcat
5.0\conf\jk2.properties

20 sept. 2006 17:52:27 org.apache.cataline.startup.Catalina

start

INFO: Server startup in 26379 ms

(Lines in bold are the important lines)

Important:

Tomcat must be in auto-start in MS-Windows services.

3.4.5 Deploy the SmartCall Services Web Application

1. Stop Tomcat

2. Launch the installation executable for the Web Application: Alcatel-SmartCall-

API 3.0-1.0.x.exe for an XML Framework API 3.0. The installation wizard
welcome window displays as below:

All Rights Reserved © Alcatel-Lucent 2007 Page 27

 SCREENSHOT 3 - SMARTCALL Welcome screen

3. Click Next. The License Agreement window displays:

All Rights Reserved © Alcatel-Lucent 2007 Page 28

 SCREENSHOT 4 - License Agreement acceptance screen.

4. Select button against: “I accept the terms in the license

agreement.” Click Next. The installation folder selection window displays:

All Rights Reserved © Alcatel-Lucent 2007 Page 29

 SCREENSHOT 5 - Installation Folder Selection Window

5. Click Install. The installation process commences. During this time, the
following window displays to show the progress of installation:

All Rights Reserved © Alcatel-Lucent 2007 Page 30

 SCREENSHOT 6 - Installation Progress

6. Once the installation process completes the screen changes to inform the
completion of installation. In that screen, click Finish. When the Web
Application is deployed in Tomcat, it adds the following menu:

Start > Programs > Alcatel > SmartCallServices >Config.properties.

3.4.6 SmartCall Configuration

3.4.6.1 License File

After SmartCallServices installation (see Deploy the SmartCall Services Web

Application):

1. Copy the specific license file: licence.lic to the Tomcat SmartCallServices

directory.

Example:

C:\Program Files \Apache Software Foundation\ Tomcat

5.0\webapps\SmartCallServices

2. Modify this file to retain only the line beginning with SERVER (Example : SERVER
otuc.mycompany.com 00170854F828 27000)

All Rights Reserved © Alcatel-Lucent 2007 Page 31

 3. On the OTUC server, add the SmartCall license in the alcotuc.lic file. The
directory path is given in your OTUC installation documentation.

4. At the end of the file alcotuc.lic add the lines previously removed from the
licence.lic file, without the line beginning with : VENDOR

Example of lines to keep: : FEATURE MYWINDOWSHOOKMAKECALL ALCFIRM

1.0 permanent uncounted \ HOSTID=ANY NOTICE=”Production
Licence” SIGN=”0170 6457 9EB0 \ 345D EECB 3FD0 9F36 FF28 F5DB
FFFF 9603 5ECA 0000 31EB 2FDA \ 7C63 8515 8BF0 DAAD 4ECB
FFFF).

5. Check the content alcotuc.lic file after modification on OTUC:

/Alcatel/FlexLM/lmreread

6. Check the MYWINDOWSHOOKMAKECALL license is available on OTUC:

/Alcatel/FlexLM/lmstat -a

3.4.6.2 SmartCall Server config.properties Configuration File

The config.properties file contains the configuration for the

SmartCallServices servlet.

Caution:
The fields of this file are case-sensitive.

To modify this file, proceed in any of the following manner:

- Manual modification:

a. Stop Tomcat

b. Open the parameter file for the SmartCall server.

File format: parametername=parametervalue. This file is at the root

of the Web Application.

Example:

C:\Program Files\Apache Software Foundation \Tomcat

5.0\webapps\SmartCallServices\config.properties

c. Modify the file as needed (see below)

- Modification via the graphical interface

a. Start Tomcat

b. Open the page:

https://localhost:8443/SmartCallServices/webAdmin

All Rights Reserved © Alcatel-Lucent 2007 Page 32

 by clicking the config.plroperties item in the menu:

Start > Programs > Alcatel > SmartCallServices

An authentication window opens.

SCREENSHOT 7 - Access to webAdmin authentication window

c. Enter a Tomcat user with the admin role, (e.g. the user created for the
"SmartCall/alcatel" application). The following page is displayed.

All Rights Reserved © Alcatel-Lucent 2007 Page 33

 SCREENSHOT 8 - config.properties File Access Example

d. Modify the values of the config.properties file (see below)

e. Click Save to validate modification

The possible modifications are the following:

− Coupling Windows login name and XML API login name to define the caller. To
ensure that when launching the call the Windows login of the client set is the
same as the XML API Server login, see the configuration field:

Launch the call according to Windows login, identical to

XML API login, without going through LDAP

windowusertootucuser=yes

All Rights Reserved © Alcatel-Lucent 2007 Page 34

 If the value for this field is yes, then SmartCall will launch the call, considering
the Windows login is equal to the XML API Server login, rather than use the
caller's telephone number in the LDAP directory.

If not, SmartCall will use the telephone number of the caller corresponding to
his/her Windows login in the LDAP directory to launch the call for this number.

− LDAP Options to retrieve the telephone number according to the Windows

login:

SmartCall looks for the current Windows user telephone number in two
cascaded directories and in each of them according to two criteria.

Launch the call according to the Windows login, identical to the XML api login,
without going through LDAP

windowusertootucuser=no

First LDAP server including the telephone number for the Windows user

serverLdapUid0=eccps2

Port for this LDAP server

portLdapUid0=389

Root DN for this LDAP server

rootLdapUid0=ou=alcatel,o=nmc

Login to this LDAP server

loginLdapUid0=cn=manager,o=nmc

Password to this LDAP server

pwdLdapUid0=secret

First search selection criterion in this LDAP server

searchCriteriaUid0=uid

Second search selection criterion in this LDAP server

searchCriteriabisUid0=

Name of the field where telephone numbers are saved

telephoneNumberCriteriaUid0=telephoneNumber

Second LDAP server including the telephone number for the Windows user

All Rights Reserved © Alcatel-Lucent 2007 Page 35

 serverLdapUid1=ldap.proserv.alcatel.com

Port for this LDAP server

portLdapUid1=389

Root DN for this LDAP server

rootLdapUid1=ou=Users,dc=proserv,dc=alcatel,dc=com

Login to this LDAP server

loginLdapUid1=

Password to this LDAP server

pwdLdapUid1=

First search selection criterion in this LDAP server

searchCriteriaUid1=uid

Second search selection criterion in this LDAP server

searchCriteriabisUid1=

Name of the field where telephone numbers are saved

TelephoneNumberCriteriaUid1=telephoneNumber

− LDAP options to call a number from an email

LDAP Server to find the telephone number of the called party from an email

serverLdapMail=frmail33.netfr.alcatel.fr

Root DN for this LDAP server

rootLdapMail=ou=fr,o=Alcatel

Port for this LDAP server

portLdapMail=389

Login to this LDAP server

loginLdapMail=

Password to this LDAP server

pwdLdapMail=

All Rights Reserved © Alcatel-Lucent 2007 Page 36

 Name of the field where telephone numbers are saved

telephoneNumberCriteriaMail=telephoneNumber

SCREENSHOT 9 - LDAP Tree Example

− Replacing characters with two tables

The first table contains regular expressions. They are replaced in the number
by the value of the second table with the same index as this regular expression
in the first table.

replacecar=\\+; ;-
replacecarWith=00;;0

− Adding a prefix to a number for trunk group seize

Trunk group seize is performed by adding the prefix "numberadded" to the

number dialed. This addition is done according to the number of digits in the
number to dial.

Prefix added to the telephone number to seize the trunk

group

All Rights Reserved © Alcatel-Lucent 2007 Page 37

 numberadded=0

Minimal length of the telephone number so this prefix can

be added to seize the trunk group

numberadded_limit=20

− Prefix replacement option

Replacement of network prefix by local prefixes. (each number in

networkprefix by the number of the same position in the list for localprefix).

prefixereseau=003329814;003315566;003339067;029814;015566;039067

prefixelocal=4;6;7;4;6;7

Additional information on Prefix replacement

The Number Processing is done as explain below

Apply to the number the replacement (replacecar,replacecarWith) where

replacecar is a list of regulars expression separate by ";" and replacecarWith is
a list of values that replace each of the replacecar expression.
replacecar=\+;\s*;0
replacecarWith=00;;0
This means:

+ will be replaced by 00 Space,Tab will be replaced by EmptyString

0 will be replaced by 0 (this is to let SmartCall recognize the second
parameter of eplacecarWith, which is empty)

. After that the SmartCall remove () and the values in these ()

. After the same replacement as (replacecar,replacecarWith) is done with
(prefixereseau,prefixelocal)

This is there that the SmartCall is able to change the number to an

internal prefixe.. Add the numberadded prefix to the number, if the number of
digit is > of numberadded_limit

The SmartCall only use these mecanism to change the number. After that, the
API and the OXE process the generated number with their configuration

− Computer telephony coupling options

XML API Server

server=serv-tsa.bst.bsf.alcatel.fr

XML API Server port

All Rights Reserved © Alcatel-Lucent 2007 Page 38

 otucport=8080

XML API user with administrator rights

user=admin

Password for this user

passwd=admin

Type of CTI “MYPHONE” Server licenses to use XMLPhone

licenses.

typecall=MYPHONE

All Rights Reserved © Alcatel-Lucent 2007 Page 39

4 SmartCall Server - Installation for Linux
4.1 Requirements for Installing

Requirements for installing for Linux Server is same as that of Windows Server, as
given under point #3.1 Requirements for Installing. The only difference is that, the
Operating System should be: Linux ES 4.0 Update 3, instead of Microsoft Windows
2003 Server.

4.2 Installing Procedure

For installing SmartCall application in a Linux Server, follow the steps given below:

1. Ensure if the following software are installed in the Linux server:

a. RedHat Enterprise Linux version 4.0 or above

2. Install JVM (Java Virtual Machine) with SSL (Secure Socket Layer)(java-1.5.0-
bea*)
[Key in:
up2date --install java-1.5.0-bea*]

3. Install Tomcat5
[Key in:
up2date --install tomcat5-5.5.9-1jpp_5rh tomcat5-
jasper-5.5.9-
1jpp_5rh tomcat5-servlet-2.4-api-5.5.9-1jpp_5rh
tomcat5-admin-
webapps-5.5.9-1jpp_5rh.noarch]

4. Configure Tomcat5

a. Modify the file:

/etc/tomcat5/tomcat5.conf
[Key in:
JAVA_HOME="/usr/lib/jvm/java-bea"]

b. Copy the .keystore file from the installation CD

[Key in:
cd /tmp
unzip /media/cdrom/Server/keystore.zip
mv .keystore /usr/share/tomcat5/]

5. Configure the https section of the tomcat file /etc/tomcat5/server.xml, by

removing the comment tag from the https section. The changes will have to be
as below:

Existing code:

All Rights Reserved © Alcatel-Lucent 2007 Page 40

 <!-- Define a SSL HTTP/1.1 Connector on port 8443 -->
<!--
<Connector port="8443" maxHttpHeaderSize="8192"
maxThreads="150" minSpareThreads="25"
maxSpareThreads="75"
enableLookups="false"
disableUploadTimeout="true"
acceptCount="100" scheme="https"
secure="true"
clientAuth="false" sslProtocol="TLS" />
-->

Change the above code to:

<!-- Define a SSL HTTP/1.1 Connector on port 8443 -->

<Connector port="8443" maxHttpHeaderSize="8192"
maxThreads="150" minSpareThreads="25"
maxSpareThreads="75"
enableLookups="false"
disableUploadTimeout="true"
acceptCount="100" scheme="https"
secure="true"
clientAuth="false" sslProtocol="TLS" />

6. Put the SmartCallServices.war file in the tomcat webapps folder

[Key in:
/media/cdrom/server/API <version of your Alcatel XML API
system>
cp SmartCallServices.war /usr/share/tomcat5/webapps/]

7. From services interface, check Tomcat5 service to be run at start up. That
screen is given below:

All Rights Reserved © Alcatel-Lucent 2007 Page 41

 SCREENSHOT 10 – Configuring Tomcat5 to run at startup

8. Install OpenLdap Server package. To do this,

a. Open Application Add/Remove program

b. Select the package: Openldap-servers.
c. From Servers, select Network Servers.

The following screenshot illustrates this:

All Rights Reserved © Alcatel-Lucent 2007 Page 42

 SCREENSHOT 11 – Installing OpenLdap Server package

9. Configure Ldap Server. To do so,

a. Extract the folder: /opt/smartcall
[Key in:
cd /
tar -zxvf
/media/cdrom/Tools/Linux/optsmartcall.tgz]
b. Copy le ldap managing script
[Key in:
cp /opt/smartcall/Ldap/openldap/ldap /etc/init.d/]
10. From services interface, check ldap service to be run at start up.
11. Start the LDAP (It can be done on the services interface):
[Key in:
service ldap start]
12. Try the LDAP service
[Key in:
cd /opt/smartcall/LdapBrowser./lbe.sh]
13. Configure the SmartCall Server
[Key in:
http://localhost:8443/SmartCallServices/webAdmin]

All Rights Reserved © Alcatel-Lucent 2007 Page 43

5 Uninstalling the SmartCall Server

1. Stop Tomcat Service

2. Launch the Uninstall program, following the below given path:

Start
Programs
Alcatel
SmartCallServices-API3.1-1.0.x
Uninstall

SCREENSHOT 12 - Path to initiate uninstalling SmartCall Server

3. This opens the welcome screen for uninstalling SmartCall Server as below:

All Rights Reserved © Alcatel-Lucent 2007 Page 44

 SCREENSHOT 13 - Welcome screen to commence uninstalling SmartCall Server

4. As instructed in this screen, stop Tomcat Services, if it is running. Then click

Next.

All Rights Reserved © Alcatel-Lucent 2007 Page 45

 SCREENSHOT 14 - Uninstalling from location

5. The above screen informs you the location from which it would uninstall the files.
Click Uninstall.

All Rights Reserved © Alcatel-Lucent 2007 Page 46

 SCREENSHOT 15 - Uninstalling in progress

6. This screen displays the progress of uninstalling process. For more details, click on
the Show details button. In the inset, you can find a dialog box requesting
confirmation for deleting SmartCall log files. Click Yes in this box.

All Rights Reserved © Alcatel-Lucent 2007 Page 47

 SCREENSHOT 16 - Uninstalling complete

7. The uninstalling process is now complete. But some files cannot be uninstalled
unless you reboot the system. To reboot immediately, select the radio button
against Reboot now. If you select the other radio button, it will not reboot
immediately. All the files will be uninstalled only when you reboot it later. Click
Finish to close this screen.

8. Uninstall Tomcat

Note:

To update SmartCall, you must uninstall the current version without uninstalling Tomcat
and "Deploy the SmartCallServices Web Application" of the new version.

All Rights Reserved © Alcatel-Lucent 2007 Page 48

6 Installation - SmartCall Client
To access the SmartCall feature, the SmartCall client application must be installed on the
user's workstation. This installation consists of the following activities in the client
system:

1. Software installation
2. SmartCall client application configuration
3. HTTPS certificate installation

Note: You can do this client installation, only after completing installation and
configuration of this application in the Server. For details on this, please refer to the
previous section in this guide.

6.1 Requirements for Installing Client Services

6.1.1 Hardware

Processor 2 GHz speed or above

RAM 1 GB

Disk Space 1 GB

Sound card Yes

6.1.2 Software

Operating System Microsoft Windows XP SP 2

Microsoft Windows Vista

Rights Administrator

6.1.3 Networking

Network Interface 10/100 Mbps Ethernet card

card

All Rights Reserved © Alcatel-Lucent 2007 Page 49

6.2 Installing the Software

The SmartCall.x.x.x.msi file contains the SmartCall client application.

Note: x.x.x represents the release identification, for example: SmartCall.1.0.9.msi.

There two possible ways to install the software:

 Silent installation: Suitable for administrators using an automatic software

deployment tool

 Interactive installation: To customize installation

6.2.1 Silent Installation

1. Open a standard Windows Command tool, e.g.:

Start > Programs > Accessories > Command

2. Enter the command: <path name> \ smartcall.x.x.x.msi /qn

6.2.2 Interactive Installation – a sketch

1. Open Windows Explorer

2. Navigate and select the SmartCall.x.x.x.msi file

3. Right click and select Install

4. Follow the instructions

6.2.3 Interactive Installation – in detail

The interactive installation is self explanatory. However, for your clear visualization of
the process, their screenshots are given below, with explanations.

1. Run the file: SmartCall.x.x.x.msi. This opens the following screen.

All Rights Reserved © Alcatel-Lucent 2007 Page 50

 SCREENSHOT 17 – Interactive Installation startup

2. The above screen is for copyright information only. Click Next in this screen.

All Rights Reserved © Alcatel-Lucent 2007 Page 51

 SCREENSHOT 18 – Interactive Installation startup

3. This screen displays License Agreement. By default, I Do Not Agree button is

highlighted. Click on I Agree button. This makes the Next button active.

4. Click Next in this screen.

All Rights Reserved © Alcatel-Lucent 2007 Page 52

 SCREENSHOT 19 – Folder selection

5. This screen is for you to indicate the location for installing the files. It also
provides information on free space availability in all the drives you have.
Based on this information, you can specify the location.

All Rights Reserved © Alcatel-Lucent 2007 Page 53

 6. In the above screenshot, the first figure is the one that shows up. Against the
field: Folder, the default location displays automatically. You can use the
Browse button nearby to change the location. To aid you in deciding about
the drive in which you can install the files, the box below is given. This box
informs you of the free space availability in each drive. If you need more
information on this, click on the button below. This opens a new
screen that is pointed to by the curved arrow. Click OK to close the new
screen. After entering the location, click Next.

SCREENSHOT 20 – Installation Commencement screen

7. From this screen, you can start copying the installation files to the folder you
have specified. Click Next to continue.

All Rights Reserved © Alcatel-Lucent 2007 Page 54

 SCREENSHOT 21 – Installation Progress bar

• This is the progress bar showing the progress of installation process.

All Rights Reserved © Alcatel-Lucent 2007 Page 55

 SCREENSHOT 22 – Installation successfully completed

• This screen indicates completion of installation process. But SmartCall is

not yet ready for use. To start using, you should launch this application.

6.2.4 Launching SmartCall

To launch SmartCall, follow the steps below:

1. Click on the button.

All Rights Reserved © Alcatel-Lucent 2007 Page 56

 SCREENSHOT 23 – Launching SmartCall

2. From the list that opens, select:

Alcatel
Smartcall
Smartcall

3. Screen as given in screenshot #21 flashes for a while for your information and
then disappears. Now you can see the SmartCall icon displayed in the system
tray, as given below:

SCREENSHOT 24 - SmartCall Icon in system tray

All Rights Reserved © Alcatel-Lucent 2007 Page 57

 4. The arrow mark in the above screenshot points to the SmartCall icon. Right
click on this icon. It displays the following menu:

SCREENSHOT 25 - Menu

5. In this menu, select: Main window of Alcatel SmartCall

6. This opens the screen as given in screenshot #21. Using this screen, you can
configure SmartCall to suit your preference.

Once the configuration is over, SmartCall is ready for use.

6.2.5 Configuring the SmartCall Client Application

Below is the configuration screen:

SCREENSHOT 26 – Configuration screen

You can do the configuration by giving your preferences in the fields in this screen. The
table below explains the various fields in this screen:

All Rights Reserved © Alcatel-Lucent 2007 Page 58

 Field Explanation

Name This is the user’s login name, automatically picked by the application.
You cannot change it.

SmartCall @ Here you can key in the IP address of your SmartCall Server or key in its
name.

Port This is the name of the port that connects the system to the SmartCall
server

Lang This is for setting interface language. The options available are:

o DE0: German

o ES0: Spanish

o FR0: French

o GEA: English

o IT0: Italian

The interface language can be changed without restarting application.

Hot key You can program any function key to call the number you have selected.
Give the number of the function key here. For example, give ‘2’ here.
Then key in a number in notepad, select it and press F2 key. This
application calls that selected number

Speed Key If you select ‘Control’ here, then when you press control key and right
click, SmartCall’s menu displays. If you select ‘Both,’ SmartCall’s menu
displays when you use either Control or Shift key in combination with
right mouse.

Phone If you have 2 terminals connected to your system, then you can use this.
Number First and Second refer to the second terminals you have. Based on your
selection here, SmartCall uses the selected terminal to make calls.

All Rights Reserved © Alcatel-Lucent 2007 Page 59

 Field Explanation

Auto copy on If you tick this box, then:

move over
traybar’s icon When you select a number and move mouse over SmartCall icon in system
tray, that number gets copied into SmartCall.

Single click If you tick this box, then: When you single click on the SmartCall icon in
on traybar system tray, it dials the last dialed number. If this box is not ticked,
icon to call then you will have to double click the SmartCall icon to dial the last
dialed number.

Ok To save and exit this screen

Cancel To exit this screen without saving entries.

Quit Closes the application after getting your confirmation

Once this configuration is over, the SmartCall application is ready to use.

6.2.6 Starting the SmartCall Client Application

By default, the SmartCall application is launched at user login. However, this Windows
facility can be disabled. The user can start the SmartCall application by double clicking
the SmartCall.exe file. By default the SmartCall.exe file is located at:
C:/program files/alcatel/smartcall.

6.2.7 Checking Software Installation

When the SmartCall client application is started, the SmartCall icon is available in the
system tray. That is illustrated below. The arrow points to that icon.

SCREENSHOT 27 - Example of Traybar with the SmartCall Icon

All Rights Reserved © Alcatel-Lucent 2007 Page 60

6.2.8 Installing the HTTPS Certificate

SmartCall client/server exchanges are secured through HTTPS. The HTTPS protocol is
based on certificates. For the SmartCall application, the certificate is established by the
Alcatel-Lucent authority. Typically, the Alcatel-Lucent authority is not a trusted
authority. The following Security Alert window can be displayed at the first SmartCall
server connection:

SCREENSHOT 28 - Security Alert and Certificate Window

To install the certificate, click the Install Certificate button of the Certificate window
and follow the instructions on the screen. When the certificate is installed, the Alcatel
authority is recognized as trusted authority and the

Security Alert window is no longer displayed.

All Rights Reserved © Alcatel-Lucent 2007 Page 61

7 Uninstalling the SmartCall Client Application
You can uninstall this application in following 2 ways:

• Uninstalling through the application

• Through Windows utility

7.1 Uninstalling through the application

To uninstall through this method, follow the below given path:

Start
Alcatel Lucent
Smartcall
Uninstall SmartCall

The below screenshot illustrates this

SCREENSHOT 29 – To uninstall the application

To proceed further, you will have to give your confirmation in the dialog box given
below:

All Rights Reserved © Alcatel-Lucent 2007 Page 62

 SCREENSHOT 30 – Prompting for confirmation

Click Yes in this box. This would initiate the uninstalling process. The screen below
displays the progress of this process.

SCREENSHOT 31 – Progress bar showing uninstalling process

Once this process completes, the application is successfully uninstalled. A screen

would display to confirm completion of this process

7.2 Through Windows utility

To uninstall the smartcall Client Application through Windows utility:

1. Stop the SmartCall application, if running. To do this, right click on the

SmartCall icon in the system tray, and select Quit.

2. Open the Control Panel window (Start > Settings > Control Panel)

3. Open the Add/Remove Programs window

4. Select the Alcatel SmartCall program

5. Click the Remove button

All Rights Reserved © Alcatel-Lucent 2007 Page 63

8 Appendix
8.1 Table of Figures

SCREENSHOT 1 – MYPhone Web Service Access .................................................... 14

SCREENSHOT 2 - Tomcat Windows Service Status Example ....................................... 26
SCREENSHOT 3 - SMARTCALL Welcome screen........................................................ 28
SCREENSHOT 4 - License Agreement acceptance screen. ........................................ 29
SCREENSHOT 5 - Installation Folder Selection Window ............................................ 30
SCREENSHOT 6 - Installation Progress............................................................... 31
SCREENSHOT 7 - Access to webAdmin authentication window ................................... 33
SCREENSHOT 8 - config.properties File Access Example .......................................... 34
SCREENSHOT 9 - LDAP Tree Example................................................................. 37
SCREENSHOT 10 – Configuring Tomcat5 to run at startup ......................................... 42
SCREENSHOT 11 – Installing OpenLdap Server package............................................ 43
SCREENSHOT 12 - Path to initiate uninstalling SmartCall Server................................ 44
SCREENSHOT 13 - Welcome screen to commence uninstalling SmartCall Server .............. 45
SCREENSHOT 14 - Uninstalling from location ....................................................... 46
SCREENSHOT 15 - Uninstalling in progress .......................................................... 47
SCREENSHOT 16 - Uninstalling complete ............................................................ 48
SCREENSHOT 17 – Interactive Installation startup .................................................. 51
SCREENSHOT 18 – Interactive Installation startup .................................................. 52
SCREENSHOT 19 – Folder selection ................................................................... 53
SCREENSHOT 20 – Installation Commencement screen ............................................ 54
SCREENSHOT 21 – Installation Progress bar.......................................................... 55
SCREENSHOT 22 – Installation successfully completed............................................. 56
SCREENSHOT 23 – Launching SmartCall .............................................................. 57
SCREENSHOT 24 - SmartCall Icon in system tray ................................................... 57
SCREENSHOT 25 - Menu ................................................................................ 58
SCREENSHOT 26 – Configuration screen.............................................................. 58
SCREENSHOT 27 - Example of Traybar with the SmartCall Icon .................................. 60

All Rights Reserved © Alcatel-Lucent 2007 Page 64

SCREENSHOT 28 - Security Alert and Certificate Window ......................................... 61
SCREENSHOT 29 – To uninstall the application ..................................................... 62
SCREENSHOT 30 – Prompting for confirmation ...................................................... 63
SCREENSHOT 31 – Progress bar showing uninstalling process ..................................... 63

All Rights Reserved © Alcatel-Lucent 2007 Page 65

 www.alcatel-lucent.com

All Rights Reserved © Alcatel-Lucent 2007 Page 66