Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 526-4100
Customer Order Number: DOC-7812959=
Text Part Number: 78-12959-01
Page 2
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT
NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT
ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR
THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION
PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO
LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE
PROVIDED “AS IS” WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED
OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL
DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR
INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.
AccessPath, AtmDirector, Browse with Me, CCIP, CCSI, CD-PAC, CiscoLink, the Cisco Powere d Network logo, Cisco Systems Networking
Academy, the Cisco Systems Networking Academy logo, Fast Step, Follow Me Browsing, FormShare, FrameShare, GigaStack, IGX, Internet
Quotient, IP/VC, iQ Breakthrough, iQ Expertise, iQ FastTrack, the iQ Logo, iQ Net Readiness Scorecard, MGX, the Networkers logo, Packet,
RateMUX, ScriptBuilder, ScriptShare, SlideCast, SMARTnet, TransPath, Unity, Voice LAN, Wavelength Router, and WebViewer are trademarks of
Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, Discover All That’s Possible, and Empowering the Internet Generation, are
service marks of Cisco Systems, Inc.; and Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCNA, CCNP, Cisco, the Cisco Certified
Internetwork Expert logo, Cisco IOS, the Cisco IOS logo, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Enterprise/Solver,
EtherChannel, EtherSwitch, FastHub, FastSwitch, IOS, IP/TV, LightStream, MICA, Network Registrar, PIX, Post-Routing, Pre-Routing, Registrar,
StrataView Plus, Stratm, SwitchProbe, TeleRouter, and VCO are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and
certain other countries.
All other trademarks mentioned in this document or Web site are the property of their respective owners. The use of the word partner does not imply
a partnership relationship between Cisco and any other company. (0106R)
The Cisco CallManager Extended Services Administrator’s Guide provides
instructions for installing, configuring and administering
Cisco CallManager Extended Services. This document will help you to:
• Understand Cisco CallManager Extended Services and how its applications
work.
• Perform product installation.
• Perform initial configuration.
• Perform ongoing administration tasks.
• Troubleshoot problems with the applications.
The Cisco CallManager Extended Services Administrator’s Guide is written for
a server administrator or network administrator who is responsible for
implementing Cisco CallManager Extended Services. No programming skills are
required.
This warning symbol means danger. You are in a situation that could cause
bodily injury. Before you work on any equipment, you must be aware of the
hazards involved with electrical circuitry and familiar with standard
practices for preventing accidents.
Obtaining Documentation
The following sections provide sources for obtaining documentation from
Cisco Systems.
World Wide Web
You can access the most current Cisco Systems documentation on the World Wide
Web at the following sites:
• http://www.cisco.com
• http://www-china.cisco.com
• http://www-europe.cisco.com
Documentation CD-ROM
78-12959-01
Cisco documentation and additional literature are available in a CD-ROM
package, which ships with your product. The Documentation CD-ROM is updated
monthlyand may be more current than printed documentation. The CD-ROM
package is available as a single unit or as an annual subscription.
Cisco Systems documentation is available in the following ways:
• Registered Cisco Direct Customers can order Cisco Product documentation
from the Networking Products MarketPlace:
http://www.cisco.com/cgi-bin/order/order_root.pl
• Registered Cisco.com users can order the Documentation CD-ROM through
the online Subscription Store:
http://www.cisco.com/go/subscription
• Nonregistered CCO users can order documentation through a local account
representative by calling Cisco corporate headquarters (California, USA) at
408 526-7208 or, in North America, by calling 800 553-NETS(6387).
Documentation Feedback
If you are reading Cisco product documentation on the World Wide Web, you can
submit technical comments electronically. Click Feedback in the toolbar and
select Documentation. After you complete the form, click Submit to send it to
Cisco.
You can e-mail your comments to bug-doc@cisco.com.
xiv
To submit your comments by mail, for your convenience many documents contain
a response card behind the front cover. Otherwise, you can mail your comments
to the following address:
Cisco Systems, Inc.
Document Resource Connection
170 West Tasman Drive
San Jose, CA 95134-9883
Cisco provides Cisco.com as a starting point for all technical assistance.
Customers and partners can obtain documentation, troubleshooting tips, and
sample configurations from online tools. For Cisco.com registered users,
additional troubleshooting tools are available from the TAC website.
Cisco.com
Cisco.com is the foundation of a suite of interactive, networked services that
provides immediate, open access to Cisco information and resources at anytime,
from anywhere in the world. This highly integrated Internet application is a
powerful, easy-to-use tool for doing business with Cisco.
Cisco.com provides a broad range of features and services to help customers and
partners streamline business processes and improve productivity. Through
Cisco.com, you can find information about Cisco and our networking solutions,
services, and programs. In addition, you can resolve technical issues with online
technical support, download and test software packages, and order Cisco learning
materials and merchandise. Valuable online skill assessment, training, and
certification programs are also available.
Customers and partners can self-register on Cisco.com to obtain additional
personalized information and services. Registered users can order products, check
on the status of an order, access technical support, and view benefits specific to
their relationships with Cisco.
Obtaining Technical Assistance
To access Cisco.com, go to the following website:
http://www.cisco.com
Technical Assistance Center
The Cisco Technical Assistance Center (TAC) website is available to all
customers who need technical assistance with a Cisco product or technology that
is under warranty or covered by a maintenance contract.
If you have a priority level 3 (P3) or priority level 4 (P4) problem, contact TAC
by going to the TAC website:
http://www.cisco.com/tac
P3 and P4 level problems are defined as follows:
• P3—Your network performance is degraded. Network functionality is
noticeably impaired, but most business operations continue.
• P4—You need information or assistance on Cisco product capabilities,
product installation, or basic product configuration.
In each of the above cases, use the Cisco TAC website to quickly find answers to
your questions.
To register for Cisco.com, go to the following website:
http://www.cisco.com/register/
If you cannot resolve your technical issue by using the TAC online resources,
Cisco.com registered users can open a case online by using the TAC Case Open
tool at the following website:
http://www.cisco.com/tac/caseopen
Contacting TAC by Telephone
If you have a priority level 1(P1) or priority level 2 (P2) problem, contact TAC
by telephone and immediately open a case. To obtain a directory of toll-free
numbers for your country, go to the following website:
Cisco CallManager Extended Services bring valuable IP telephony capabilities to
a Cisco CallManager deployment. These new extended services significantly
differentiate Cisco’s IP Telephony solution from features provided with
traditional PBX systems.
Cisco CallManager Extended Services consist of two features:
Cisco CallManager Extension Mobility and Cisco CallManager AutoAttendant.
Use this document if you are running Cisco CallManager Extended Services with
Cisco CallManager pre-3.3(2) and Cisco Customer Response Application
(Cisco CRA) 2.2 and later.
NoteWith Cisco CallManager 3.3(2) and later, the Cisco CallManager
Extension Mobility application and the Cisco CallManager
Extension Mobility service in Cisco CallManager provide the
extension mobility functionality. The feature no longer requires the
Cisco CRA engine. If you are using Extension Mobility and AutoAttendant
with Cisco CallManager 3.3(2) and later, see the Cisco CallManager Features and Services Guide at the following URL:
http://www.cisco.com/univercd/cc/td/doc/product/voice/c_callmg/index.htm
• Components of Cisco CallManager Extended Services, page 1-6
Cisco CallManager Extension Mobility Overview
The Cisco CallManager Extension Mobility feature allows users within a
Cisco CallManager cluster to configure any Cisco IP Phone7960/7940 as their
own, temporarily, by logging in to that phone. Once logged in, the phone adopts
the user’s personal phone number(s), speed dials, services links and other
user-specific properties. After logout, the phone adopts the original user profile.
With Cisco CallManager Extension Mobility, several employees can share office
space on a rotational basis instead of having a designated office.This approach is
commonly used in work environments such as sales offices and consulting firms
where employees do not routinely conduct business in the same place or keep the
same hours every day.
Administrators can program the login service, an XML-based authentication
service, for a variety of uses, including duration limits on phone configuration and
login authorization for particular phones. Programming is done in
Cisco CallManager Service Parameters Configuration.
The user interface to the login service is accessed through the Services button on
Cisco IP Phone Models 7960 or 7940. The user enters login information in the
form of a UserID and a Personal Identification Number (PIN). The
Login Application receives the XML-over-HTTP request and verifies the
information against the Cisco IP Telephony Directory (see Figure 1-1). The
phone is reconfigured automatically with the individual user device profile
information.
The user logs out by pressing the Services button and selecting logout. After the
user logs out, Cisco CallManager sends the original user profile to the phone and
restarts the phone.
The Cisco Customer Response (CR) Platform provides the components required
to run Cisco CallManager Extended Services. The Cisco CR platform provides a
multimedia (voice/data/Web) IP-enabled customer care application environment.
The Cisco CR Platform uses Voice over IP (VoIP) technology, so your telephony
network can share resources with your data network.
Cisco CallManager Extended Services uses four main components of the
Cisco Customer Response Platform:
• Gateway—Connects the enterprise IP telephony network to the Public
Switched Telephone Network (PSTN) and to other private telephone systems
such as Public Branch Exchange (PBX).
• Cisco CallManager Server—Provides the features required to implement IP
phones, manage gateways, provides failover and redundancy service for the
telephony system, and directs Voice over IP (VoIP) traffic to the
Cisco Customer Response Application (Cisco CRA) system.
• Cisco IP Telephony Directory—Stores configuration information and
Cisco CRA application scripts in a LDAP directory. The subdirectory that
stores Cisco CRA scripts is called the repository. Storing application scripts
and configuration information in an LDAP directory allows you to load
application scripts on any Cisco CRA engine in the network. The repository
keeps one backup version of each script for recovery purposes. You can
revert to the previous version if necessary.
1-6
• Cisco CRA Server—Contains the Cisco CRA Engine that runs Cisco CRA
applications. Cisco CRA applications comprise a series of steps,
implemented as Java Beans packaged in .jar files.
This section describes how to install Cisco CallManager Extended Services on a
Cisco Media Convergence Server (Cisco MCS) or on a Cisco certified server:
Before you begin the installation of Cisco CallManager Extended Services,
ensure that you have met hardware and software requirements and configured
Windows 2000 components. Check the “Hardware Requirements” section on
page 2-2 and the “Software Requirements” section on page 2-2 before you
Cisco CallManager Extended Services run on the Cisco Media Convergence
Server (Cisco MCS) platform or a customer-provided Cisco-certified server such
as the Compaq DL320 and DL380 and the IBM-330 and IBM-340.
Cisco recommends that you can install Cisco CallManager Extended Services
co-resident on the same server as Cisco CallManager.
Hardware requirements for a co-resident server configuration of
Cisco CallManager Extended Services are:
• The installation of Cisco CallManager Extended Services requires 275MB.
• Running Cisco CallManager Extended Services requires 512MB for the
Cisco MCS 7820 series (7820, 7822, and 7825) and 1GB for the Cisco MCS
7930 series (7930 and 7935).
Software Requirements
Cisco CallManager Extended Services requires the following software
components to operate:
Step 10At this point, the installation checks for the presence of Cisco CallManager 3.1.
If Cisco CallManager Release 3.1 is not present, you are prompted to upgrade to
Cisco CallManager Release 3.1.The installation of Cisco CallManager
Extended Services will not continue until Cisco CallManager Release 3.1 is
present.
Step 11Confirm your installation selection by clicking Ye s .
The system displays a message asking where the Cisco CallManager Database is
located.
Step 12To install Cisco CallManager Extension Mobility on the same server as
Cisco CallManager, select This Server.
To install Cisco CallManager Extension Mobility on a different server from
Cisco CallManager, select A Different Server and enter the server’s hostname,
and a username and password.
Step 13Click Next.
Step 14At the CiscoWorks2000 Syslog Configuration screen you can elect to configure
the CiscoWorks2000 Syslog collector.
If you have a CiscoWorks2000 server on your network, you can click the
Configure CiscoWorks2000 Syslog Collector check box to install the
CiscoWorks Syslog Collector module on this computer. If you click this check
box, enter the location of your CiscoWorks2000 server.
Installing Cisco CallManager Extended Services
78-12959-01
If you do not have a CiscoWorks 2000 server on your network, do not click the
Configure CiscoWorks 2000 Syslog Collector check box.
Step 15At the Ready to Install Cisco CallManager Extended Services window, click
Next.
The system takes approximately 10 minutes to install Cisco CallManager
Extended Services.
Step 16The installation blanks the administrator password. Re-enter the password as
shown here:
a. Enter the new password to be used for the MCS or Cisco certified server.
Click Okay.
b. Enter the new password to be used for the SQL Server. Click Okay.
Upgrading Cisco CallManager AutoAttendant or Re-installing Cisco CallManager
Extended Services
To upgrade to Cisco CallManager Extended Services from an earlier version of
Cisco CallManager AutoAttendant, or to re-install the current version of
Cisco CallManager Extended Services, perform the following steps:
Rules for Configuring Cisco CallManager Extension Mobility
Managing Device Profiles
A device profile is made up of a set of attributes (services and/or features)
associated with a particular device. Device profiles include name, description,
phone template, add-on modules, directory numbers, subscribed services, and
speed dial information.
You can think of the device profile as a device which is not yet physically
embodied. It has all the properties of a device except those which are explicitly
tied to a device, like MAC address or directory URL, for example.
When a device profile has been loaded onto a device, that device adopts the
attributes of that device profile. A device can adopt a device profile when there is
no user logged in (that is, when a device is first initialized and when a user logs
out) or when a user logs in.
There are two types of device profiles: autogenerated device profiles and user
device profiles.
An autogenerated device profile generates when you update the phone settings
and choose a current setting to generate an autogenerated device profile. An
autogenerated device profile represents a snapshot of an existing device’s
configuration.
The autogenerated device profile associates with a specific phone to be the logout
device profile. That is, when a logout command for a device is received, this is the
profile loaded onto a device.
An autogenerated device profile cannot be associated with a user. An
autogenerated device profile can only be loaded onto a device when there is no
user logged in. You can modify the autogenerated device profile, but not delete it.
User Device Profile
You can assign a user device profile to a user so that when a user logs in or out of
a device, the corresponding user device profile is loaded onto that device. Devices
can adopt user device profiles when a user logs into a device or when there is no
user logged in.You can modify, or delete a user device profile in the Cisco
CallManager administration pages.
When a user logs in, the current configuration of a device is replaced by a
particular user device profile.
When a user logs out, the current configuration of a device (the user default device
profile) is replaced by the logout profile.
Cisco CallManager Extension Mobility supports only one login at a time on a
device. Subsequent logins will fail.
You cannot log out of a device which does not have anyone logged in.
Configuration Examples
This section describes different scenarios using Cisco CallManager
Extension Mobility:
• Scenario 1: All Users have Cisco CallManager Extension Mobility, page 3-3
• Scenario 2: Mixed Configuration, page 3-4
• Scenario 3: Mixed Configuration, page 3-4
Rules for Configuring Cisco CallManager Extension Mobility
Scenario 1: All Users have Cisco CallManager Extension Mobility
In a typical Cisco CallManager Extension Mobility scenario, all employees are
users of Cisco CallManager Extension Mobility. The users are configured to have
a default device profile and they do not control their individual phones. They must
log into a phone before they can use it as their extension.
Employees have access to common devices, such as lobby phones, conference
room phones, and cubicle phones that are meant to be shared.
When users go to the Cisco Phone User Options web pages to change their
services or speed dials, they can select only their default device profiles from the
“Select a device to configure” drop-down menu. Any changes users make to their
services follows them to any phone they log into.
NoteIn this scenario, users cannot modify settings for an individual phone.
Rules for Configuring Cisco CallManager Extension Mobility
Scenario 2: Mixed Configuration
In this configuration, each user has a phone assigned to him. Each user has a
device profile too which follows him on every device he logs into. Each user has
access to common devices, such as lobby phones, conference room phones, and
cubicle phones that are meant to be shared.
NoteIn this scenario, no one is allowed to use anyone else’s phone.
This is a recommended configuration.
Scenario 3: Mixed Configuration
In this scenario, some employees may have a regular desk phone and other users
can log into this phone.
This is not a recommended configuration for Cisco CallManager
Extension Mobility for the following reasons.
When a device is configured for Cisco CallManager Extension Mobility, a
snapshot of that device is taken which is used as a profile after a user logs off that
device.
With Cisco CallManager Extension Mobility enabled on Tom’s personal
extension, Tom goes to his Cisco Phone User Options web pages to configure
services. He has two options from the “Select device to configure” drop-down
menu: the device (the office phone) he controls or the Default Device Profile.
• If Tom selects his office phone and it is a device which a user controls, Tom
can add services such as speed dials or Cisco stock price display. If Dick logs
into that phone, Dick’s default device profile is loaded onto that phone. When
Dick logs off, the snapshot profile, without the speed dials and Cisco stock
price display, is loaded on the phone.
• If Tom selects his Default Device Profile from the “Select device to
configure” down-down menu, the changes that he makes to this profile will
appear only on the phone on which he logs into immediately after making the
change and not on the device he controls.
To avoid problems deploying Cisco CallManager Extension Mobility, be sure to
follow these configuration rules:
• If you want to enable all phones within your Cisco CallManager cluster for
Cisco CallManger Extension Mobility, you must not allow the users to
control these devices. That is, when a user goes to the Cisco IP Phone User
Options web page to change his services, he can only select “Default Device
Profile” from the “Select a device to configure” drop-down list. He cannot
modify the settings for an individual phone.
• If there is a device which a particular user controls, for example, his office
phone, you must not allow anyone else to log into that device.
NoteThe administrator can change the services for a phone in the
Cisco CallManager Administration page. After making the changes, if he
updates on the main page (not the pop up menu) the administrator is prompted
to reset the phone for the changes to take affect. Then, the new snapshot is
stored as the logout profile.
Rules for Configuring Cisco CallManager Extension Mobility
78-12959-01
NoteIt is recommended that each user of Cisco CallManager Extension Mobility
log into his phone at the beginning of the work day. This ensures that his
default device profile is loaded on his phone. He can make changes to this
profile and it will follow him where he logs in.
Setting the Service Parameters in the CallManager Service Parameters
Configuration page allows you to define the maximum login time and the multi
login behavior for Cisco CallManager Extension Mobility.
Maximum Login Time
At the Enforce Maximum Login Time, setTrue or False. True indicates you wish
to define a maximum login time.
At the Maximum Login Time field, enter the maximum login time. This is a
system-wide maximum time specified for logins. After this time, the system
automatically logs out the device.
NoteThe automatic logout service is used for all logins if a system maximum login
time is specified. Each login will then have an automatic logout set up for the
maximum duration.
Procedures for Configuring Cisco CallManager Extension Mobility
Multi Login Behavior
78-12959-01
At the Multi Login Behavior field, select one of the following options:
• Multiple Logins Allowed: A user can log into more than one device at a time.
• Multiple Logins Not Allowed: The second and subsequent login attempts
after a user logs in once successfully will fail.
• Auto Logout: When a user logs into a second device, they are automatically
logged out of the first device.
• The default value is Multiple Logins Not Allowed.
Procedures for Configuring Cisco CallManager Extension Mobility
A new Service Parameters Configuration page displays.
Figure 3-12 shows the Service Parameters screen, with the service parameter
information entered.
Figure 3-12 Setting the Service Parameters
78-12959-01
Step 4
At the Login Service Enabled field, select True to enable the user login service.
The default value is True. Selecting false disables the user login service.
Step 5At the Enforce Maximum Login Time, setTru e or False.
If you select True, the service logs a user out of a device automatically after a
maximum login time.
The default value is False.
Step 6At the Maximum Login Time field, enter the maximum login time
(Hours:Minutes) from 1 to 168:00 (one minute to one week).
The default value is 8:00 (8 hours).
Procedures for Configuring Cisco CallManager Extension Mobility
Step 8The following prompt appears: The Directory Number has been assigned to the
current device. Click OK to return to the current device.
Click OK.
Step 9The page refreshes back to the User Device Profile Configuration page for this
device profile.
On the User Device Profile Configuration page, select Update service.
Step 10To update services, select the service which you added in the “Adding the Logout
Service” section on page 3-21.
Step 11Click Continue.
Step 12Click Subscribe.
Related Topics:
• Adding the Logout Service, page 3-21
• Associating a User Device Profile to a User for Cisco CallManager
Extension Mobility, page 3-28
Associating a User Device Profile to a User for Cisco CallManager
Extension Mobility
A User Device Profile is associated in the same way that physical devices are
associated, starting with the User Global Directory. To associate a user device
profile to a user for Cisco CallManager Extension Mobility, follow these steps:
Procedure
Step 1On the Cisco CallManager Administration page, choose
User > Add a New User.
Step 2At the Add a New User screen, enter the first name (for example, jean), last name
(for example, brody), and UserID (for example, jbrody).
Step 3At the User Password and Confirm Password fields, enter a password of your
choice.
Step 4At the PIN field, enter a numeric Personal Identification Number (PIN) of your
Procedures for Configuring Cisco CallManager Extension Mobility
At the Phone Configuration page, enter the Media Access Control (MAC) address
of the phone.
NoteThe MAC address of the phone can be found on the back of the unit on the
label next to the word MAC. It can also be found by using the Settings button
on the Phone (79XX), then selecting Network Configuration. Under 3 MAC
Address, the phone’s MAC address appears.
Step 5Fill in the remaining parameters as required.
Step 6Click Insert when you are finished.
Step 7You will see a pop-up prompt: The phone has been inserted in the database. Would
you like to add a directory number for line 1 of the phone now.
Click OK.
The Directory Number Configuration page displays.
Step 8Enter the DN of the phone you are configuring at the Directory Number field.
Step 9Click Insert.
Step 10Click Update.
Step 11You will see a pop-up prompt: Reset the phone to have the changes take effect.
Click OK.
Step 12Proceed to the “Subscribing to the Cisco CallManager Login Service” section on
page 3-32.
Subscribing to the Cisco CallManager Login Service
To subscribe to the Cisco CallManager Login Service, follow these procedures:
Procedures for Configuring Cisco CallManager Extension Mobility
Step 4Click Subscribe. Close the window.
Step 5On the Cisco CallManager Phone Configuration page, scroll down to the bottom
of the page. Click the check box to Enable Extension Mobility Feature (see
Figure 3-16).
Figure 3-16 Enabling Extension Mobility
Step 6
At the Log Out Profile field, select Use Current Device Settings.
This creates an Autogenerated Device Profile as the default device profile. When
a logout is executed, the current configuration (the User Device Profile) is
replaced by the Autogenerated Device Profile (the default device profile).
See the “Rules for Configuring Cisco CallManager Extension Mobility” section
on page 3-1 for information about configuring device profiles.
Step 7The remaining fields show the current device information regarding the login
status of the device: Log in UserID; Log In Time; Log Out Time.
Step 8Click Update.
Related Topics:
• Configuring the Cisco IP Phones for Cisco CallManager Extension Mobility,
page 3-30
• Preparing the User for Cisco CallManager Extension Mobility, page 3-35
Procedures for Configuring Cisco CallManager Extension Mobility
Setting up Anonymous Access on IBM-340 platforms
If you are configuring Cisco CallManager Extended Services on an IBM-340
platform, make sure that the system is set to allow anonymous access to the Login
Service web site. If your system is not set to allow anonymous access, you may
encounter a Login Server Connection Error when attempting to log in to the
phone.
To allow anonymous access, set the IIS to control the password. Perform the
following steps:
Procedure
Step 1On the Cisco CallManager server, choose
Start > Programs > Administrative Tools > Internet Services Manager.
Step 2Expand the tree on the left side of the page: machine name > Default Web
Site > LoginService
Step 3Right click LoginService in the left pane and select Properties.
Step 4Click the Directory Security tab.
Step 5Under Anonymous access and authentication control, click the Edit button.
3-34
Step 6Make sure that Anonymous access is checked. Click Edit for the account used
for anonymous access.
Step 7Verify that “Allow IIS to control password” is checked.
This section provides information about configuring Cisco CallManager and the
Cisco Customer Response Application Engine (Cisco CRA Engine) in
preparation for deploying your Cisco CallManager AutoAttendant
(Cisco CallManager AA).
Perform the following procedures to configure your Cisco CallManager AA:
1. Configuring Cisco CallManager for Cisco CallManager AutoAttendant,
page 4-2
2. Configuring the Cisco CRA Engine for Cisco CallManager AutoAttendant,
Configuring Cisco CallManager for Cisco CallManager AutoAttendant
Configuring CiscoCallManager for
Cisco CallManager AutoAttendant
Before you can use Cisco CallManager AutoAttendant (Cisco CallManager AA),
you must configure Cisco CallManager. The following steps illustrate the basic
configuration principles and describe a simple configuration to test your
installation.
1. Adding CTI Route Points in Cisco CallManager, page 4-2
2. Adding CTI Ports in Cisco CallManager, page 4-3
3. Creating a Cisco CallManager User for Cisco CallManager AutoAttendant,
page 4-4
Adding CTI Route Points in Cisco CallManager
To add a CTI route point in Cisco CallManager for Cisco CallManager
AutoAttendant (Cisco CallManager AA), perform the following steps:
Configuring Cisco CallManager for Cisco CallManager AutoAttendant
Step 6In the Device Pool field, select the device pool for this CTI route point. If no other
pool has been created, select Default.
Step 7Click Insert.
Step 8In the left pane of the CTI Route Point Configuration window, click
Line 1-click to add.
Step 9In the Directory Number field, enter the directory number for this CTI route point.
This is the number that users will dial to reach this CTI route point (for example,
4000).
Step 10Click Insert and Close. Now you need to add CTI ports to Cisco CallManager.
Adding CTI Ports in Cisco CallManager
All CTI ports in a CTI port group must have consecutive directory numbers. For
example, if you want four CTI ports in a particular CTI port group, and the first
is number 9001, the rest of the ports will automatically be configured 9002
through 9004.
78-12959-01
To add CTI ports in Cisco CallManager, perform the following steps:
Configuring Cisco CallManager for Cisco CallManager AutoAttendant
Step 6Use the Device Pool drop-down arrow to select the device pool for this CTI port.
If there is no other pool, select Default.
Step 7Click Insert.
Step 8In the left pane of the Phone Configuration window, click Line1-clicktoadd.
Step 9In the Directory Number field, enter the directory number of this CTI port (for
example, 4001).
NoteCTI port groups must contain sequential CTI port directory numbers.
Step 10Click Insert and Close.
You can continue to add ports using consecutive numbers. After you have added
and configured CTI ports for Cisco CallManager AA, configure a
Cisco CallManager user for the Cisco CallManager AA.
Creating a Cisco CallManager User for
Cisco CallManager AutoAttendant
To create a Cisco CallManager user for Cisco CallManager AutoAttendant
(Cisco CallManager AA), perform the following steps:
Configuring Cisco CallManager for Cisco CallManager AutoAttendant
Step 3In the Add a New User page, enter the first name (for example, JTAPI), last name
(for example, User), and UserID (for example, JTAPIUser).
Step 4Enter a password of your choice in the User Password and Confirm Password
fields.
Step 5At the PIN field, enter a numeric Personal Identification Number (PIN) of your
choice. Confirm the PIN number.
Step 6Click the Enable CTI Application Use check box.
CautionWhen you create a Cisco CallManager user for
Cisco CallManager AA, you must click the
Enable CTI Application Use check box on the Cisco CallManager
Add a New User page. If you do not click the Enable CTI Application Use check box, the Cisco CRA Engine will be unable
to receive calls from Cisco CallManager.
Step 7Click Associate Devices.
Step 8In the User Devices Assignment Window, check the boxes associated with the
Device Name fields.
In order to use the examples provided here, check the following items.
78-12959-01
• AA_RP
• CTI_Port1
• CTI_Port2
Step 9Make sure the No Primary Extension radio button is selected.
Configuring the Cisco CRA Engine for Cisco CallManager AutoAttendant
Configuring the CiscoCRA Engine for
Cisco CallManager
Once you have configured Cisco CallManager for Cisco CallManager
AutoAttendant, configure the Cisco Customer Response Application
(Cisco CRA) Engine to communicate with Cisco CallManager and the
Cisco IP Telephony Directory. To do this, perform the following procedures:
1. Configuring Directory Information, page 4-6
2. Configuring the JTAPI Subsystem on the Cisco Customer
Response Application Engine, page 4-9
3. Adding a CTI Port Group, page 4-10
4. Adding a New Cisco CallManager AutoAttendant, page 4-10
AutoAttendant
Configuring Directory Information
The Cisco IP Telephony Directory server stores two types of information used by
your Cisco Customer Response Application (Cisco CRA) Engine. First, it stores
directory information, which includes CTI port and routing configurations.
Second, it contains the repository subdirectory, which stores the applications you
create with the Cisco CRA Engine.
If your Cisco IP Telephony solution includes one application server and one
Cisco IP Telephony directory, the directory configuration information will be the
same for both the directory and the repository.
4-6
It is also possible for the application server to receive directory information from
one Cisco IP Telephony Directory and application script from a repository on
another server. In this scenario, the directory and repository would have different
configurations.
Configuring the Cisco CRA Engine for Cisco CallManager AutoAttendant
For efficient management of resources, each type of configuration is stored as a
profile on the Cisco IP Telephony Directory server. In the event of a system failure
or reallocation of application servers, you can upload a directory profile from the
Cisco IP Telephony Directory to a replacement application server.
NoteDirectory profiles can only be used by one application server at a
time.
Repository profiles can be used to centralize the storage of application script.
Unlike directory profiles, repository profiles may be shared by more than one
application server.
To configure Directory information on the application server, perform the
following steps:
Procedure
Step 1Connect to the Application Administration web server by using the following
URL:
http://servername/AppAdmin
78-12959-01
where servername is the DNS name or IP address of your application server.
If you are using the computer that is running the application server, you can
connect to the web pages by choosing:
Configuring the Cisco CRA Engine for Cisco CallManager AutoAttendant
Step 7Click Update to enter your changes.
If you clicked the Use a Different Repository Profile check box, the repository
configuration window appears. Complete these fields with the configuration
information appropriate for your repository directory.
Configuring the JTAPI Subsystem on the Cisco Customer
Response Application Engine
After you complete the directory configuration, you must configure the JTAPI
subsystem on the Cisco Customer Response Application Engine
(Cisco CRA Engine). The Cisco CRA Engine uses the JTAPI subsystem to send
and receive calls from Cisco CallManager.
To configure the JTAPI Subsystem, perform the following steps:
Procedure
78-12959-01
Step 1At the Application Administration Main Menu, click the JTAPI link in the
Options column.
Step 2In the CallManager field, enter the IP address or DNS name of the Cisco MCS
running Cisco CallManager.
Step 3In the Username field, enter the Cisco CallManager UserID you defined in
“Creating a Cisco CallManager User for Cisco CallManager AutoAttendant”
section on page 4-4 (for example, JTAPIUser).
Step 4Enter the password you defined for this UserID in the Password field.
NoteCTI port groups must contain sequential CTI port directory numbers.
Step 6Click Update.
Adding a New Cisco CallManager AutoAttendant
When you have configured the appropriate subsystem on the Cisco Customer
Response Application (Cisco CRA) Engine, you can use one of the sample scripts
to create an application and start the Cisco CRA Engine.
Configuring the Cisco CRA Engine for Cisco CallManager AutoAttendant
To add a new Cisco CallManager AutoAttendant, perform the following steps:
Procedure
Step 1Connect to the Application Administration web server by using the following
URL:
http://servername/AppAdmin
where servername is the DNS name or IP address of your Cisco CRA Engine.
Step 2At the Application Administration Main Menu, click the Telephony Application
link in the Options column.
Step 3Click the Add New Application link on the Application page.
Step 4At the Application Configuration page, use the drop-down arrow to select the
aa.aef script. The system populates the Script Name field with “aa.aef.” Click
Next.
Step 5Enter a name for the application in the Application Name field.
Step 6At the Application Parameters Configuration page, provide the CTI route point
for this Application (for example, 4000).
78-12959-01
Step 7In the Maximum Number of Sessions field, enter the number of CTI ports you
added in Cisco CallManager. If you are using the provided sample values, enter 4.
Step 8In the OperExtn field, enter the extension of the phone that will be used by the
human operator and click Update.
Step 9Select Main Menu > Engine.
Step 10On the Engine page, click Start.
When the Engine status is
service
, the Cisco CallManager AA is functional. You can call into the
running and the subsystems indicate they are in
Cisco CallManager AA by dialing the directory number of the CTI route point
you added to Cisco CallManager. If you are using the provided sample values, dial
By default, Cisco CallManager AA plays back a prerecorded welcome prompt
and spells out user names. You can customize your Cisco CallManager AA by
adding your own welcome prompt and recordings of your users’ spoken names:
• Configuring an Instance of Cisco CallManager AutoAttendant, page 4-12
• Configuring Prompts, page 4-13
Configuring an Instance of Cisco CallManager AutoAttendant
To configure an existing Cisco CallManager AutoAttendant
(Cisco CallManager AA), perform the following steps:
Procedure
Step 1Select Applications from the application administration main menu.
4-12
Step 2Select the instance of Cisco CallManager AA that you wish to configure and click
Next.
Step 3You can make the following configuration changes:
• Application Name—the name of the application.
• CTI Route Point—the number used to reach this application.
• Maximum Number of Sessions—the maximum number of sessions possible
for this application.
• Enabled—whether the application is enabled or not.
• operExtn—the extension of the phone that will be used by the human
operator.
• welcomePrompt—the prompt used as the welcome prompt for
Cisco CallManager AA. See the “Configuring the Welcome Prompt” section
on page 4-15 for information about how to upload prompts.
The Media Configuration page also allows you to upload new prompts to the
Cisco CRA Engine, modify existing prompts, and configure the UDP port.
The following topics are included:
• General Media Configuration, page 4-13
• Recording the Welcome Prompt, page 4-14
• Configuring the Welcome Prompt, page 4-15
• Uploading a Spoken Name, page 4-16
• Uploading a Batch of Spoken Names, page 4-17
General Media Configuration
The General Media Configuration page shows the two directory paths that the
Cisco CRA Engine uses to store System and User prompts, and the Starting UDP
Port field.
Customizing Cisco CallManager AutoAttendant
78-12959-01
The prompt path information shown on the General Media Configuration page is
for your information only. You cannot modify these paths. System prompts are
general-use type prompts, and many are included with Cisco CRA. (You may also
record your own). User prompts are the prompts you create for specific
applications.
The Starting UDP port field is used to specify the first UDP port for sending and
receiving UDP data. Cisco Customer Response Applications uses the User
Datagram Protocol (UDP) protocol to send and receive media packets over the IP
network. The Starting UDP port field is pre-populated with a default value. The
default value for this field corresponds to the normal configuration for Cisco
networking equipment and ensures the highest possible audio quality for calls to
Cisco Customer Response Applications.
You can record prompts for Cisco CallManager AA on any computer using
Microsoft Sound Recorder. Save the prompt as a .wav file in CCITT (µ -law)
8kHz, 8-bit, Mono format. (You can use another audio application to record the
welcome prompt if it supports this format.)
To record a prompt using Microsoft Sound Recorder, perform the following steps:
Procedure
Step 1Select the following option from the Windows Start menu:
To upload Cisco CallManager AutoAttendant (Cisco CallManager AA) spoken
names in your users' voices, upload the corresponding .wav files into the
Directory:
Procedure
Step 1Ask users to record their names in the manner prescribed in the “Recording the
Welcome Prompt” section on page 4-14, and to save their files as userId.wav,
where userId is their user name.
Step 2Using the Cisco application server computer (this process cannot be done
remotely), connect to the spoken name web page with the following URL:
http://servername/SpokenNameUpload
where servername is the DNS name or IP address of your application server.
You can also choose Start > Programs > Cisco IP IVR > SpokenNameUpload.
Step 3Click the Change button and click OK.
Step 4Click the Browse button to locate the spoken name wav file you would like to
upload. The Choose file navigation window appears.
Step 5When you have located the appropriate file, click Open.
If you need to upload a large number of spoken names at once, use the
SpokenNameBulkUpload.bat utility, provided on the application server. To
upload a batch of spoken names, perform the following steps:
Procedure
Step 1Ask users to record their names in the manner prescribed in the “Recording the
Welcome Prompt” section on page 4-14, and to save their files as userId.wav,
where userId is their user name.
Step 2Collect these files in a directory on the Cisco application server computer.
Step 3Upload the contents of the local directory to your Cisco IP Telephony Directory
using the following DOS command:
SpokenNameBulkUpload directory true|false
where directory is the directory on your hard drive where the .wav files are
located.
Use the true|false parameter to choose to replace existing spoken names in the
Cisco IP telephony directory or not:
Customizing Cisco CallManager AutoAttendant
78-12959-01
• true—replaces any spoken name .wav files in the directory with spoken name
.wav files of the same name.
• false—does not replace spoken name .wav files in the directory with spoken
This section provides information about managing the Cisco CallManager
Extended Services after you have configured the services.Topics include:
• Managing the Cisco CRA Engine, page 5-1
• Using Cisco CRA Real-time Reporting, page 5-8
• Using Cisco CRA Historical Reporting, page 5-13
Managing the CiscoCRA Engine
When you click the Engine link on the Application Administration main menu,
the system displays the Engine Control page.
The Engine Control displays the state of the Cisco Customer Response
Application (Cisco CRA) Engine and the Cisco CRA subsystems. It also allows
you to start and stop the application engine. You may need to stop the application
engine for system changes or upgrades or for troubleshooting purposes.
CHAPTER
5
78-12959-01
Use the links on the Engine Control page to perform the following operations:
• Starting and Stopping the Cisco CRA Engine, page 5-2
You can use the Cisco Customer Response Application (Cisco CRA)
Administration web pages to start and stop the Cisco CRA Engine. You can also
control the Cisco CRA Engine from the service panel in the Administrative Tools
portion of the Windows NT control panel.
To start and stop the application engine from your web browser, perform the
following steps.
Procedure
Step 1Access the Application Administration main menu, by entering the following
URL in the Location field of your browser:
http://<servername>/AppAdmin
where servername is the Domain Name Service (DNS) name or IP address of your
application server.
Alternatively, if you are on the application server computer, you can choose
To modify the engine parameters for the profile you have chosen, perform the
following steps:
Procedure
Step 1Select Engine > Configure from the Application Administration main menu.
The system displays the Engine Configuration page.
Step 2To configure the engine, enter the appropriate values in the fields described in
Table 5-1.
Table 5-1Engine Configuration
Field Description
RMI Port NumberThe port number used by the engine to serve remote
Maximum Number of
Executed Steps
Maximum Number of
Concurrent Sessions
Managing the Cisco CRA Engine
method invocation (RMI) requests.
Do not change the default value.
This is the maximum number of steps any script is
allowed to execute before the engine terminates the
application. It is intended to prevent a script from
running “infinitely” long.
Maximum number of concurrent tasks. If a call
arrives while all sessions are running, it is delayed
until a session is free.
Trace files are logs that record application engine activity. You can use the trace
file to identify system or application script problems. Because recording all
information about engine activity can create a file that is large and difficult to
read, you can specify to the trace file which items you want to record.
This section describes how you perform the following tasks:
• Configuring the Trace File, page 5-4
• Setting Trace Level Options, page 5-5
• Viewing Trace Files, page 5-7
Configuring the Trace File
To configure the Trace File options, perform the following steps:
Number of Trace FilesThe number of trace files to rotate.
Trace File SizeThe maximum size (in bytes) of the
Step 3Click Update to save your changes.
Setting Trace Level Options
Managing the Cisco CRA Engine
When the last file is reached, the trace
file re-starts from “1”. If the engine is
restarted, tracing is re-started in the
first file.
trace file. After the file reaches this
size, the system moves to the next file.
78-12959-01
The Trace Configuration page also provides a series of check boxes that set the
trace level for various engine activities. The trace levels are as follows:
• Debug—most verbose, to be used primarily for debugging and
troubleshooting.
• Informational—describes the transition state (for example,. system start,
system stop)
• Notification—notifies the user that something has happened (for example,.
maximum number of sessions exceeded)
• Warning—notifies the user of error conditions that can be recovered from and
that do not result in loss of service
Two groups of trace level activity options; active and inactive. You can make
changes to the parameters of the active options without restarting the Application
Engine, and the trace file will reflect your changes. The inactive options require
that you restart the application engine to reflect any changes you made.
Table 5-4 lists the inactive Trace level options activities that can be monitored.
Table 5-4InactiveTrace Level options
Field or optionDescription
CCNUSER_STEPSExtension Mobility Steps
DB_STEPSDatabase Steps
DOCUMENT_STEPS Document Steps
ICM_STEPSIntelligent Call Management
IO_STEPSInput/Output Steps
IVR_STEPSIVR Steps
JAVA_STEPSJava Steps
LIB_DIRECTORYDirectory Library
MESSAGING_STEPSMessaging Steps
STEP_AAAutoAttendant Steps
WEB_STEPSWeb Steps
XML_STEPSXML Steps
Managing the Cisco CRA Engine
(ICM) Steps
Viewing Trace Files
After you have selected the trace file options that you want to record, restart the
Cisco CRA Engine (if you have modified inactive trace file options). After you
observe enough engine activity to provide useful data, you can download and view
the contents of the new trace file.
To view trace files, click Trace files on the Engine Control page. To display the
trace file, click on a filename.
The Cisco IP Telephony system provides a real-time reporting utility,
implemented as a Java applet communicating with the application server through
remote method invocation (RMI). You can use this utility to generate reports on
application activity.
This section covers the following topics:
• Installing the Real-time Reporting Tool, page 5-8
• Applying the Real-time Reporting Tool, page 5-9
Installing the Real-time Reporting Tool
To use Cisco CRA real-time reporting from a computer other than the application
server, you need to install the application by performing the following steps:
Procedure
5-8
Step 1Access the Application Administration main menu, by entering the following
URL in the Location field of your browser:
http://<servername>/AppAdmin
where servername is the Domain Name Service (DNS) name or IP address of your
application server.
The system displays a dialog box requiring your Cisco Customer
Response Application (Cisco CRA) administrator username and password.
Step 2Enter your Cisco CRA administrator name and password and click OK.
Step 5Specify a target directory for the installer and click Save.
After the download completes, double-click CiscoCRA2_1Reporting.exe and
follow the prompts.
You can connect to the reporting windows by entering the URL of the application
server in your browser window.
CautionYou must always use a valid host name or IP address. You cannot use the
alias localhost, even when running the browser locally on the application
server.
Applying the Real-time Reporting Tool
To start the real-time reporting utility, click Real-Time Reporting on the
Application Administration main menu.
Using Cisco CRA Real-time Reporting
The system displays the Application Administration Reporting page. You can use
this page to generate a variety of reports on the activity of your application engine.
Maximum number of tasks that can run at the same time.
Time when data collection started. The system resets
automatically at midnight.You can manually reset the
statistics by choosing Reset Stats from the Tools Menu.
Restarting the application server will also reset the
statistics.
Number of tasks completed without problems
(exceptions).
unhandled exceptions.
handled. The system designates a task as handled if the
application has reached the Session Handled step.
application. If the Cisco IP Telephony application does not
include a Session Handled step, the system counts all tasks
associated with that application as abandoned. This also
happens when someone who has called in to an application
hangs up before the Session Handled step executes.
task. The application name is the name of the application
definition (.aef) file.
task (configured route point directory number).
Resetting Statistics
The system automatically resets the accumulated statistics every day at 12:00 AM
(by the application server system clock). You can also manually reset the statistics
by choosing: Tools > Reset Stats on the Reporting page.
To create a printable version of a report, perform the following steps:
Procedure
Step 1Choose the Report you want to print from the Reports menu on the Reporting
page.
Step 2Choose Tools > Open Printable
The system opens a printable version of the report in a new browser window.
Step 3Choose Print from the File menu to print the report.
Using Cisco CRA Historical Reporting
In addition to viewing Real Time reports, you can view accumulated Cisco
Customer Response Application (Cisco CRA) activity in historical reports. The
historical reports record the same parameters that are used in the real time
reporting feature.
78-12959-01
When you enable historical reporting, the system automatically saves reports as
.csv files to the Cisco CRA server hard disk. You can open the .csv files with a
spreadsheet program like Microsoft Excel.
The system saves a report of IP IVR activity to the Cisco CRA server hard disk
every 24 hours. The file is named with the date of the recorded activity using the
following convention:
servername.year.month.day.csv
where servername is the Domain Name Service (DNS) name of your application
server.
To view a historical report, perform the following steps.
Procedure
Step 1Access the Application Administration main menu, by entering the following
URL in the Location field of your browser:
http://<servername>/AppAdmin
where servername is the Domain Name Service (DNS) name or IP address of your
application server.
Alternatively, if you are on the application server computer, you can choose