Setting up Devices for Prime Collaboration Provisioning

From DocWiki

Revision as of 05:28, 14 November 2013 by Sheps (Talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Contents

Preparing End Systems

In Prime Collaboration Provisioning, the physical resources (end systems that deliver voice and messaging services) are modeled as Processors.

Few examples of physical resources modeled as processors are:

  • Cisco Unified Communications Manager or Cisco Unified Communications Manager Express system is modeled as a Call Processor
  • Cisco Unity & Cisco Unity Express are modeled as Unified Message Processor
  • Cisco Unity Connection voicemail/unified messaging system is modeled as Unified Message Processor
  • Cisco Unified Presence Processor is modeled as Presence Processor

Using Prime Collaboration Provisioning, an administrator creates and configures these various processors. After the processors have been configured, all configuration and interaction with the end systems is handled by Provisioning.

Some minimal configuration maybe required on some end systems before you can use them with Prime Collaboration Provisioning. This section describes the preconfiguration steps required for Cisco Unified Communications Manager, Cisco Unified Communications Manager Express, Cisco Unity systems, Cisco Unity Connection, and Cisco Unity Express.

Cisco Unified Communications Manager Preconfiguration Dependencies

The Cisco Unified Communications Manager is the software-based, call-processing component of the Cisco IP telephony solution, and is part of Cisco Architecture for Voice, Video and Integrated Data (AVVID).

The additional data, voice, and video services are unified messaging, multimedia conferencing, collaborative contact centers, and interactive multimedia response systems. These additional services interact with the IP telephony solution through Cisco Communications Manager's open telephony application programming interface (API). In addition to Cisco Media Convergence Server (MCS), Cisco unified communication manager can also be installed in Unified Computing System (UCS).

No specific preconfiguration is generally required on the Cisco Unified Communications Manager for Prime Collaboration Provisioning. However, the following conditions should already have been met during a normal installation or upgrade. These conditions are noted here as installation dependencies for creating a Call Processor in Prime Collaboration Provisioning:

  • Install Cisco Unified Communications Manager.
  • If Cisco Unity is used in this configuration, configure the Cisco Unified Communications Manager voicemail ports.
  • Create a user and password with administrator privileges that can be used by Provisioning Manager to access Cisco Unified Communications Manager. The requirements of the user and password vary depending on whether multilevel administration access (MLA) is enabled (see Table 1-1).
Note: All interactions with Cisco Unified Communications Manager and Prime Collaboration Provisioning are through the AVVID XML Layer APIs (AXL/SOAP).
Determining the Media Server Account to Use for Cisco Unified Communications Manager Access

To enable Prime Collaboration Provisioning to access a Cisco Unified Communications Manager, you must supply the username and password for an account on the media server.

The account you should use depends upon the Cisco Unified Communications Manager version. It may also depend on whether MLA is enabled for the Cisco Unified Communications Manager. Table 1-1 lists the options.

Table 1-1 Accounts Required to Access Cisco Unified Communications Manager
Cisco Unified Communications
Manager Version
on Media Server
MLA Enabled
or Disabled for Cisco
Unified Communications
Manager
Required Account
7.x, or 8.x
N/A

A Unified Communications Manager user who is assigned a role with the privilege to use the AXL Database API resource in the Cisco Call Manager AXL Database application.

Standard AXL API Access is one of the predefined roles in Unified Communications Manager that has this privilege.

















Cisco Unified Communications Manager Express Preconfiguration Dependencies

Cisco Unified Communications Manager Express is a solution, embedded in Cisco IOS Software, that provides call processing for Cisco Unified IP Phones.

Similar to Cisco Unified Communications Manager, Cisco Unified Communications Manager Express is modeled in Prime Collaboration Provisioning as a Call Processor. The only difference from an administrative aspect is that it is represented by a different type of Call Processor.

Prime Collaboration Provisioning requires that the Cisco Unified Communications Manager Express be installed on a supported platform with the appropriate Cisco IOS Software version and Cisco Unified Communications Manager Express load.

Before you can create a Call Processor based on a Cisco Unified Communications Manager Express in Prime Collaboration Provisioning, you must:

  • Disable the auto-allocation of directory numbers. Do this through the Cisco IOS interface.
  • Disable the ephone auto-registration. You must do this through for Cisco Unified Communications Manager Express 4.0 or later.

If you have changed the Rivest, Shamir, and Adelman (RSA) key pair for Secure Shell Version 2 (on the router where Cisco Unified Communications Manager Express resides) to a length less than 512 bits, you must reconfigure the RSA key back to a length equal to or greater than 512 bits. For information on configuring the RSA keys in Secure Shell Version 2, see your router's documentation.

Disabling the Auto-Allocation of Directory Numbers and Ephone Auto-Registration

Perform the following configurations through the Cisco IOS interface.


1. Verify that auto-allocation is enabled.

$ telnet 172.19.50.247

Trying 172.19.50.247...

Connected to 172.19.50.247.

Escape character is '^]'.

User Access Verification

Password:

CCME-1>enable

Password:

CCME-1#show telephony

CONFIG (Version=3.0)

=====================

Cisco Communications Manager Express

ip source-address 172.19.50.247 port 2000

max-ephones 24

max-dn 100

max-conferences 4

max-redirect 5

time-format 12

date-format mm-dd-yy

keepalive 30

timeout interdigit 10

timeout busy 10

timeout ringing 180

web admin system name root password cisco

web admin customer name cisco password cisco

edit DN through Web: enabled.

edit TIME through web: enabled.

Log (table parameters):

max-size: 150

retain-timer: 15

(password): abcd

create cnf-files version-stamp 7960 Jan 15 2004 16:48:05

auto assign 1 to 100 type 7960 cfw 5001 timeout 30

local directory service: enabled.

xml schema http://gkar.cisco.com/schema/axlsoap.xsd

In this case, auto-allocation is on, as shown by the auto assign line.

2. To disable auto-allocation, run the following command at the enable prompt:

CCME-1#config term

Enter configuration commands, one per line. End with CNTL/Z.

CCME-1(config)#telephony-service

CCME-1(config-telephony)#no auto assign 1 to 100 type 7960 cfw 5001 timeout 30

CCME-1(config-telephony)#no auto-reg-ephone
Note: The no auto-reg-ephone command is required for Cisco Unified Communications Manager Express 4.0 or later.
CCME-1(config-telephony)#exit

CCME-1(config)#exit CCME-1#show telephony

3. To verify that the change has taken effect, run another show telephony command.

The auto assign line should no longer appear.

4. Run a write memory command, which will write the changes out to the system's nonvolatile memory in case of a reboot.


How Prime Collaboration Provisioning Manages Communications Manager Express

Cisco Unified Communications Manager Express uses the following configlets to synchronize and provision phones for subscribers:

  • ephone-dn—Manages directory numbers.
  • ephone—Manages phones and assigns directory numbers to lines on one or more phones.

Alone, neither configlet contains all the information about a subscriber. When provisioning occurs, Provisioning Manager uses the following to store subscriber information:

  • The description command in the ephone configlet is used to store the subscriber ID, first name, last name, and department in the following format:

description CUPMUsers: subscriber ID: ephone tag: last name, first name: department

  • The description command in the ephone-dn configlet is used to store the subscriber ID in the following format:

description CUPMUsers: subscriber ID

The Cisco Unified Communications Manager Express description field for ephone-dn is limited to 30 characters for Cisco Unified Communications Manager Express 8.0, and 40 characters for earlier supported versions. The character limit includes the CUPMUsers prefix and the subscriber ID (combined).

  • The name command in the ephone-dn configlet is used to store the first name and last name in the following format:

name first namelast name

Note: The Cisco Unified Communications Manager Express ephone-dn name field is limited to 30 characters. If the subscriber's first 
and last names (combined) exceed that limit, you may get an error.
  • The username command in the ephone configlet is used to store the subscriber ID.

Prime Collaboration Provisioning is able to synchronize back the phones, lines, directory numbers and subscriber information from an existing Cisco Unified Communications Manager Express that was not provisioned using Provisioning Manager.

However, depending on how the subscriber information was entered in the ephone and ephone-dn configlets, Prime Collaboration Provisioning may not be able to fully construct the subscriber information and consequently identify shared Lines or Phones.

Cisco Unity and Cisco Unity Connection System Preconfiguration Dependencies

Before you can create a Unified Message Processor based on Cisco Unity in Prime Collaboration Provisioning, you must:

  • Install and configure the message store using Microsoft Exchange 2000, 2003, or 2007.
  • Configure an integration with one corresponding Cisco Unified Communications Manager.
  • Define Class of Service and Subscriber templates.
  • Create an SQL Server user and password that can be used by Provisioning Manager to access the SQL Server database on Cisco Unity. The SQL Server user requires access to both the Cisco Unity and master databases.
  • Verify the TCP/IP port used by Cisco Unity. This port number is required when you create a Unified Message Processor.

Before you can create a Unified Message Processor based on Cisco Unity Connection in Prime Collaboration Provisioning, you:

  • Configure an integration with one corresponding Cisco Unified Communications Manager.
  • Define Class of Service and Subscriber templates.
  • The Connection Access Layer must be running (for all versions of Unity Connection). For Unity Connection 7.1.3 and higher, the Connection REST Service must also be running. The default settings must have these services running.
  • Configure IMAP in Cisco Unity Connection. This is required so that Provisioning Manager can provision email and Unified Messaging Services in Cisco Unity Connection. IMAP configuration is only required for Unified Messaging deployments. You do not have to configure IMAP for voicemail-only deployments.
Note: To configure IMAP on the Cisco Unity Connection system, go to System Settings > External Services > Add New, 
and fill in all the fields required to add external services.
Creating an SQL Server User and Password for Cisco Unity

1. On the Cisco Unity system, choose Start > SQL Server > Enterprise Manager.

The Enterprise Manager window appears.

2. In the navigation tree, choose Microsoft SQL Servers > SQL Server Group > (local) (Windows NT).

3. Right-click (local) (Windows NT) and select Properties.

The SQL Server Properties (Configure) window appears.

4. Click the Security tab.

5. Under Authentication, select SQL Server and Windows.

6 In the navigation tree under (local) (Windows NT), choose Security > Logins.

7 Create a new login. Do the following:

a. Right-click Logins.

The SQL Server Login Properties - New Login window appears.

b. Enter a name for the login.

c. Select SQL Server Authentication.

d. Select UnityDb.

e. Click the Database Access tab.

f. Select both the UnityDb and themaster database.

g. For both databases, select the following roles: db_owner, db_datareader, and db_datawriter.

h. Reboot the SQL server.



Verifying the TCP/IP Port Used by Cisco Unity



1. On the Cisco Unity system, choose Start > SQL Server > Enterprise Manager.

The Enterprise Manager appears.

2. From the menu, click Action. Then select Properties.

The SQL Server Properties (Configure) dialog box appears.

3. In the General tab, click Network Configuration.

The SQL Server Network Utility window appears.

4. Select TCP/IP, then click Properties.

In the window that appears, the default TCP/IP port is displayed. You will need to know this port number when you create a Unified Message Processor.


Cisco Unity Express Preconfiguration Dependencies

Before you can create a Unified Message Processor based on Cisco Unity Express in Provisioning Manager, you must do the following:

  • If you have changed the RSA key pair for Secure Shell Version 2 (on the router where Cisco Unity Express resides) to a length less than 512 bits, you must reconfigure the RSA key back to a length equal to or greater than 512 bits. For information on configuring the RSA keys in Secure Shell Version 2, see your router's documentation.
  • Determine the Service Engine Interface number for Cisco Unity Express. The Service Engine Interface number is required when adding a Cisco Unity Express to Provisioning Manager.
Determining the Service Engine Interface Number for Cisco Unity Express

The Service Engine Interface number is located on the router that hosts Cisco Unity Express.


1. Log into the router that hosts Cisco Unity Express.

2. Run the command show running-config.

In the resulting output, look for the following:

Interface Service-Engine 2/0

In this example, 2/0 is the Service Engine Interface number.



Rating: 0.0/5 (0 votes cast)

Personal tools