Cisco Systems OL-10663-02 User Manual
Contents
Configuring Presence Service
Last Updated: November 26, 2007
This module describes presence support in a Cisco Unified Communications Manager Express
(Cisco Unified CME) system.
Finding Feature Information in This Module
Your Cisco Unified CME version may not support all of the features documented in this module. For a
list of the versions in which each feature is supported, see the “Feature Information for Presence Service”
section on page 905.
• Prerequisites for Presence Service, page 885
• Restrictions for Presence Service, page 886
• Information About Presence Service, page 886
• How to Configure Presence Service, page 887
• Configuration Examples for Presence, page 900
• Additional References, page 903
• Feature Information for Presence Service, page 905
Prerequisites for Presence Service
• Cisco Unified CME 4.1 or a later version.
• Cisco Unified IP Phones 7911G, 7941G, 7941GE, 7961G, 7961GE, 7970G, and 7971GE require
firmware load 8.2(1) or a later version.
Cisco Unified Communications Manager Express System Administrator Guide
OL-10663-02
885
Restrictions for Presence Service
Restrictions for Presence Service
• Presence features such as Busy Lamp Field (BLF) notification are supported for SIP trunks only;
these features are not supported on H.323 trunks.
• Presence requires that SIP phones are configured with a directory number (using dn keyword in
number command); direct line numbers are not supported.
Information About Presence Service
To configure presence service in a Cisco Unified CME system, you should understand the following
concept:
• Presence Service, page 886
Presence Service
Configuring Presence Service
A presence service, as defined in RFC 2778 and RFC 2779, is a system for finding, retrieving, and
distributing presence information from a source, called a presence entity (presentity), to an interested
party called a watcher. When you configure presence in a Cisco Unified CME system with a SIP WAN
connection, a phone user, or watcher, can monitor the real-time status of another user at a directory
number, the presentity. Presence enables the calling party to know before dialing whether the called party
is available. For example, a directory application may show that a user is busy, saving the caller the time
and inconvenience of not being able to reach someone.
Presence uses SIP SUBSCRIBE and NOTIFY methods to allow users and applications to subscribe to
changes in the line status of phones in a Cisco Unified CME system. Phones act as watchers and a
presentity is identified by a directory number on a phone. Watchers initiate presence requests
(SUBSCRIBE messages) to obtain the line status of a presentity. Cisco Unified CME responds with the
presentity’s status. Each time a status changes for a presentity, all watchers of this presentity are sent a
notification message. SIP phones and trunks use SIP messages; SCCP phones use presence primitives in
SCCP messages.
Presence supports Busy Lamp Field (BLF) notification features for speed-dial buttons and directory call
lists for missed calls, placed calls, and received calls. SIP and SCCP phones that support the BLF
speed-dial and BLF call-list features can subscribe to status change notification for internal and external
directory numbers.
Figure 53 shows a Cisco Unified CME system supporting BLF notification for internal and external
directory numbers. If the watcher and the presentity are not both internal to the Cisco Unified CME
router, the subscribe message is handled by a presence proxy server.
886
Cisco Unified Communications Manager Express System Administrator Guide
OL-10663-02
Configuring Presence Service
Figure 53 BLF Notification Using Presence
How to Configure Presence Service
SIP
Subscribe
V
Notify
PSTN
IP
IP
IP
IP
Cisco Unified CMECisco Unified CME
Notify
Subscribe
IP
IP
IP
IP
155790
The following line states display through BLF indicators on the phone:
• Line is idle—Displays when this line is not being used.
• Line is in-use—Displays when the line is in the ringing state and when a user is on the line, whether
or not this line can accept a new call.
• BLF indicator unknown—Phone is unregistered or this line is not allowed to be watched.
Cisco Unified CME acts as a presence agent for internal lines (both SIP and SCCP) and as a presence
server for external watchers connected through a SIP trunk, providing the following functionality:
• Processes SUBSCRIBE requests from internal lines to internal lines. Notifies internal subscribers
of any status change.
• Processes incoming SUBSCRIBE requests from a SIP trunk for internal SCCP and SIP lines.
Notifies external subscribers of any status change.
• Sends SUBSCRIBE requests to external presentities on behalf of internal lines. Relays status
responses to internal lines.
Presence subscription requests from SIP trunks can be authenticated and authorized. Local subscription
requests cannot be authenticated.
For configuration information, see the “How to Configure Presence Service” section on page 887.
How to Configure Presence Service
This section contains the following tasks:
• Enabling Presence for Internal Lines, page 888
• Enabling a Directory Number to be Watched, page 889
• Enabling a SCCP Phone to Monitor BLF Status for Speed-Dials and Call Lists, page 891
• Enabling a SIP Phone to Monitor BLF Status for Speed-Dials and Call Lists, page 893
• Configuring Presence to Watch External Lines, page 895
Cisco Unified Communications Manager Express System Administrator Guide
OL-10663-02
887
How to Configure Presence Service
• Verifying Presence Configuration, page 897
• Troubleshooting Presence, page 898
Enabling Presence for Internal Lines
Perform the following steps to enable the router to accept incoming presence requests from internal
watchers and SIP trunks.
Restrictions
• A presentity can be identified by a directory number only.
• BLF monitoring indicates the line status only.
• Instant Messaging is not supported.
SUMMARY STEPS
1. enable
2. configure terminal
Configuring Presence Service
DETAILED STEPS
Command or Action Purpose
Step 1
enable
Example:
Router> enable
Step 2
configure terminal
Example:
Router# configure terminal
Step 3
sip-ua
3. sip-ua
4. presence enable
5. exit
6. presence
7. max-subscription number
8. presence call-list
9. end
Enables privileged EXEC mode.
• Enter your password if prompted.
Enters global configuration mode.
Enters SIP user-agent configuration mode to configure the
user agent.
Example:
Router(config)# sip-ua
Cisco Unified Communications Manager Express System Administrator Guide
888
OL-10663-02
Configuring Presence Service
Command or Action Purpose
Step 4
presence enable
Example:
Router(config-sip-ua)# presence enable
Step 5
exit
Example:
Router(config-sip-ua)# exit
Step 6
presence
Example:
Router(config)# presence
Step 7
presence call-list
Example:
Router(config-presence)# presence call-list
Step 8
max-subscription number
How to Configure Presence Service
Allows the router to accept incoming presence requests.
Exits SIP user-agent configuration mode.
Enables presence service and enters presence configuration
mode.
Globally enables BLF monitoring for directory numbers in
call lists and directories on all locally registered phones.
• Only directory numbers that you enable for watching
with the allow watch command display BLF status
indicators.
• This command enables the BLF call-list feature
globally. To enable the feature for a specific phone, see
the “Enabling a SCCP Phone to Monitor BLF Status for
Speed-Dials and Call Lists” section on page 891.
(Optional) Sets the maximum number of concurrent watch
sessions that are allowed.
• number—Maximum watch sessions. Range: 100 to the
Exits to privileged EXEC mode.
Step 9
Example:
Router(config-presence)# max-subscription 128
end
Example:
Router(config-presence)# end
Enabling a Directory Number to be Watched
To enable a line associated with a directory number to be monitored by a phone registered to a
Cisco Unified CME router, perform the following steps. The line is enabled as a presentity and phones
can subscribe to its line status through the BLF call-list and BLF speed-dial features. There is no
restriction on the type of phone that can have its lines monitored; any line on any IP phone or on an
analog phone on supported voice gateways can be a presentity.
Restrictions
• A presentity is identified by a directory number only.
• BLF monitoring indicates the line status only.
maximum number of directory numbers supported on
the router platform. Type ? to display range.
Default: 100.
OL-10663-02
Cisco Unified Communications Manager Express System Administrator Guide
889
How to Configure Presence Service
SUMMARY STEPS
DETAILED STEPS
Command or Action Purpose
Step 1
enable
Example:
Router> enable
Step 2
configure terminal
Configuring Presence Service
1. enable
2. configure terminal
3. ephone-dn dn-tag
or
voice register dn dn-tag
4. number number
5. allow watch
6. end
Enables privileged EXEC mode.
• Enter your password if prompted.
Enters global configuration mode.
Step 3
Step 4
Example:
Router# configure terminal
ephone-dn dn-tag [dual-line]
or
voice register dn dn-tag
Example:
Router(config)# ephone-dn 1
or
Router(config)# voice register dn 1
number number
Example:
Router(config-ephone-dn)# number 3001
or
Router(config-register-dn)# number 3001
Enters the configuration mode to define a directory number
for an IP phone, intercom line, voice port, or a
message-waiting indicator (MWI).
• dn-tag—Identifies a particular directory number during
configuration tasks. Range is 1 to the maximum number
of directory numbers allowed on the router platform, or
the maximum defined by the max-dn command. Type
? to display range.
Associates a phone number with a directory number to be
assigned to an IP phone in Cisco Unified CME.
• number—String of up to 16 characters that represents
an E.164 telephone number.
890
Cisco Unified Communications Manager Express System Administrator Guide
OL-10663-02
Configuring Presence Service
How to Configure Presence Service
Command or Action Purpose
Step 5
allow watch
Allows the phone line associated with this directory number
to be monitored by a watcher in a presence service.
• This command can also be configured in ephone-dn
template configuration mode and applied to one or
more phones. The ephone-dn configuration has priority
over the ephone-dn template configuration.
Exits to privileged EXEC mode.
Step 6
Example:
Router(config-ephone-dn)# allow watch
or
Router(config-register-dn)# allow watch
end
Example:
Router(config-ephone-dn)# end
or
Router(config-register-dn)# end
Enabling a SCCP Phone to Monitor BLF Status for Speed-Dials and Call Lists
Prerequisites
Restrictions
A watcher can monitor the status of lines associated with internal and external directory numbers
(presentities) through the BLF speed-dial and BLF call-list presence features. To enable the BLF
notification features on an IP phone using SCCP, perform the following steps.
• Presence must be enabled on the Cisco Unified CME router. See the “Enabling Presence for Internal
Lines” section on page 888.
• A directory number must be enabled as a presentity with the allow watch command to provide BLF
status notification. See the “Enabling a Directory Number to be Watched” section on page 889.
BLF Call-List
• Supported only on Cisco Unified IP Phone 7941G, 7941GE, 7961G, 7961GE, 7970G, and 7971GE.
BLF Speed-Dial
• Supported only on Cisco Unified IP Phone 7914, 7931, 7940, 7941G, 7941GE, 7960, 7961G,
7961GE, 7970G, and 7971GE.
Cisco Unified IP Phone 7931
• BLF status is displayed through monitor lamp only; BLF status icons are not displayed.
SUMMARY STEPS
OL-10663-02
1. enable
2. configure terminal
3. ephone phone-tag
4. button button-number{separator}dn-tag [,dn-tag...] [button-number{x}overlay-button-number]
[button-number...]
Cisco Unified Communications Manager Express System Administrator Guide
891
Loading...