Table Of Contents
Installing and Uninstalling Cisco Unified Provisioning Manager
Preparing to Install Provisioning Manager
Preparing the Server
Preparing End Systems
Ports that Provisioning Manager Uses
Gathering Information to Provide During Installation
Installing Provisioning Manager
Adding the Provisioning Manager Home Page to the Internet Explorer Trusted Sites Zone
Uninstalling Provisioning Manager
Cleaning Up a Failed Installation
Installing and Uninstalling Cisco Unified Provisioning Manager
This chapter describes installing Cisco Unified Provisioning Manager.
It includes:
•
Preparing to Install Provisioning Manager
• Installing Provisioning Manager
• Uninstalling Provisioning Manager
Preparing to Install Provisioning Manager
The information in this section helps you to deploy Provisioning Manager in your network. Do the following before you install Provisioning Manager:
•Make sure that hardware and software requirements for the server are met. (See Server Requirements, page 1-2.)
•Preparing the Provisioning Manager server for installation. (See Preparing the Server.)
•Configure end systems so that Provisioning Manager can obtain correct information from them. ( Preparing End Systems.)
•Determine whether your existing applications are already using ports that Provisioning Manager uses. (Existing applications should not use the ports that Provisioning Manager requires.) See Ports that Provisioning Manager Uses.
•Gather information that you might need to provide during the Provisioning Manager installation. (See Gathering Information to Provide During Installation.)
Preparing the Server
This section describes procedures that you may need to perform to prepare your server for installing Provisioning Manager on it.
Configuring Single CPU Mode
Provisioning Manager requires that your system only runs on one CPU. If you purchased a dual processor system, you must configure your system to run on only one of the CPUs. Perform the following:
Step 1 On the Provisioning Manager system, on the Windows desktop right-click My Computer.
Step 2 Select Properties.
Step 3 Select the Advanced tab.
Step 4 Under Startup and Recovery, click Settings.
Step 5 Click Edit. The boot.ini file opens.
Step 6 In the file, add "/ONECPU" in line that starts with "multi(0)disk(0)rdisk(0)partition(1)\WINDOWS=..."
Step 7 Restart the system.
Step 8 Verify that the system is running on only one CPU:
a. Open a command prompt.
b. In the command prompt, enter systeminfo.
c. In the information that is displayed, you should see the following:
Processor(s): 1 Processor(s) Installed.
[01]: x86 Family 6 Model 13 Stepping 8 GenuineIntel ~2128 Mhz
This indicates that only one processor is running.
Enabling the Full 4 GB RAM
On 4 GB system, Windows only detects 3.5 GB of RAM even though your system has 4 GB installed. If you want to choose the medium or large installation when installing Provisioning Manager, you must first enable all 4 GB of RAM on the system. Do the following:
Step 1 On the Provisioning Manager system, in Windows right-click My Computer.
Step 2 Select Properties.
Step 3 Select the Advanced tab.
Step 4 Under Startup and Recovery, click Settings.
Step 5 Click Edit. The boot.ini file opens.
Step 6 In the file, add "/PAE" in line starting with "multi(0)disk(0)rdisk(0)partition(1)\WINDOWS=..."
Step 7 Restart the system.
Preparing End Systems
In Provisioning Manager, the physical resources (end systems that deliver voice and messaging services) are modeled as Processors. For example, a Cisco Unified CallManager or Cisco Unified CallManager Express system is modeled as a Call Processor and a Cisco Unity, Cisco Unity Express, or Cisco Unity Connection voicemail/unified messaging system is modeled as a Unified Message Processor.
Using Provisioning Manager, 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 Manager.
Some minimal configuration is required on the end systems before you can use them with Provisioning Manager. This section describes the preconfiguration steps required for Cisco Unified CallManager, Cisco Unified CallManager Express, Cisco Unity systems, Cisco Unity Connection, and Cisco Unity Express.
Cisco Unified CallManager Preconfiguration Dependencies
The Cisco Unified CallManager 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).
Additional data, voice, and video services such as unified messaging, multimedia conferencing, collaborative contact centers, and interactive multimedia response systems interact with the IP telephony solution through Cisco CallManager's open telephony application programming interface (API). Cisco CallManager is installed on the Cisco Media Convergence Server (MCS).
No specific preconfiguration is generally required on the Cisco Unified CallManager for Provisioning Manager. However, the following conditions should already have been met during a normal installation or upgrade, and are noted here as installation dependencies for creating a Call Processor in Provisioning Manager:
•Install Cisco Unified CallManager.
•Ensure that the Cisco Unified CallManager service and Internet Information Service (IIS) (at minimum) are running on the Cisco Unified CallManager.
•If Cisco Unity is used in this configuration, configure the Cisco Unified CallManager voicemail ports.
•Configure Cisco Unified CallManager to not allow autoregistration of phones, which indicates that the Cisco Unified CallManager can assign phone numbers. When Provisioning Manager is deployed, this functionality exists within Provisioning Manager.
•Create a user and password with administrator privileges that can be used by Provisioning Manager to access Cisco Unified CallManager. The requirements of the user and password vary depending on whether multilevel administration access (MLA) is enabled (see Table 2-1). Following are the requirements:
–If MLA is enabled, a username and password of a multilevel administration access account with full access to the Standard Serviceability Functional Group is required.
–If MLA is not enabled, then the username or password of an account with administrative privilege is needed.
Note All interactions with Cisco Unified CallManager and Provisioning Manager are through the AVVID XML Layer APIs (AXL/SOAP).
Determining the Media Server Account to Use for Cisco Unified CallManager Access
To enable Provisioning Manager to access a Cisco Unified CallManager, you must supply the username and password for an account on the media server. The account to use depends upon the Cisco Unified CallManager version and might also depend on whether MLA is enabled for the Cisco Unified CallManager. Table 2-1 lists the options.
Table 2-1 Username and Password for Accessing the Cisco Unified CallManager
Cisco Unified CallManager Version on Media Server
|
MLA Enabled
or Disabled for Cisco Unified CallManager
|
Required Account
|
4.x
|
Enabled
|
Multilevel administration access account with either full access or read-only access to the Standard Serviceability Functional Group.
|
Disabled
|
Valid Windows 2000 administrator account on the media server.
|
Cisco Unified CallManager 4.x with More than 500 Users
Cisco Unified CallManager 4.x has a default search results limit of 500 for listing users. If you have more than 500 users, you must increase the setting for "Maximum Search Results" on the Cisco Unified CallManager.
Step 1 On the Cisco Unified CallManager server, start DC Directory Administrator.
Step 2 Log in using Directory Manager with the Cisco Unified CallManager password.
Step 3 Click the cisco.com node. Admin, CCN, Groups and Users should appear.
Note If these do not appear select View > Zoom To Admin Node.
Step 4 Click CCN.
Step 5 Select systemProfile. On the right, you should see Hoteling Profile and System Profile.
Step 6 Double-click System Profile.
Step 7 Select the CCM Configuration tab.
Step 8 Click Modify.
Step 9 Change Maximum Search Results to a value higher than the number of users that you expect to have (maximum supported is 30,000).
Step 10 Click OK.
Step 11 You can verify your changes by doing the following:
a. Open Internet Explorer and log into Cisco Unified CallManager.
b. Select User > Global Directory, then click Search. This lists all users. You should not receive any warning messages if you get more than 500 results.
Cisco Unified CallManager Express Preconfiguration Dependencies
Cisco Unified CallManager Express is a solution, embedded in Cisco IOS Software, that provides call processing for Cisco IP phones.
Like Cisco Unified CallManager, Cisco Unified CallManager Express is modeled in Provisioning Manager as a Call Processor. The only difference from an administrative aspect is that it is represented by a different type of Call Processor.
Provisioning Manager requires that the Cisco Unified CallManager Express be installed on a supported platform with the appropriate Cisco IOS Software version and Cisco Unified CallManager Express load.
Provisioning Manager requires the following preconfiguration be performed on Cisco Unified CallManager Express:
•Disabling of auto-allocation of directory numbers. This is done through the Cisco IOS interface.
•Disabling of ephone auto-registration. This is only required for Cisco Unified CallManager Express 4.0.
These are done through the Cisco IOS interface.
Step 1 First, 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 CallManager 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.
Step 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 only required for Cisco Unified CallManager 4.0.
CCME-1(config-telephony)#exit
CCME-1(config)#exit
CCME-1#show telephony
Step 3 To verify that the change has taken effect, run another show telephony command. The auto assign line should no longer appear.
Step 4 Run a write memory command, which will write the changes out to the system's nonvolatile memory in case of a reboot.
How Provisioning Manager Manages CallManager Express
Cisco Unified CallManager Express uses two main commands to provision phones for end subscribers:
•telephony ephone-dn—Manages directory numbers.
•telephony ephone—Assigns directory numbers to lines on one or more phones.
Both commands allow subscriber information to be associated to the directory number or the line. Provisioning Manager uses these native abilities in Cisco Unified CallManager Express to store and synchronize subscriber information.
Provisioning Manager is able to synchronize back the phones, lines, directory numbers, and subscriber information from an existing Cisco Unified CallManager Express. Depending on how the subscriber information was used in the telephony ephone and telephony ephone-dn commands, Provisioning Manager is able to fully construct a user account for that subscriber. Provisioning Manager supports shared lines and directory numbers while doing this.
When provisioning, Provisioning Manager uses the description command in the ephone configlet to hold the subscriber name and department information. Provisioning Manager also uses the name command in the ephone-dn configlet to hold the subscriber's first and last names.
Note The Cisco Unified CallManager Express ephone-dn name field is limited to 30 characters. If the subscriber's first and last name (combined) exceed that limit, you may get an error.
Cisco Unity and Cisco Unity Connection System Preconfiguration Dependencies
Before you can create a Unified Message Processor (based on Cisco Unity or Cisco Unity Connection) in Provisioning Manager, you must do the following:
•Install and configure the message store using Microsoft Exchange 2000 or 2003. (Required for Cisco Unity only.)
•Configure an integration with one or more corresponding Cisco Unified CallManager systems.
•Create a SQL Server user and password that can be used by Provisioning Manager to access the SQL Server database on Cisco Unity or Cisco Unity Connection. The SQL Server user requires access to both the Cisco Unity (or Cisco Unity Connection) and master databases. See Creating a SQL Server User and Password for Cisco Unity or Cisco Unity Connection.
•Verify the TCP/IP port used by Cisco Unity or Cisco Unity Connection. This port number is required when you create a Unified Message Processor.
•Define Class of Service and Subscriber templates.
Creating a SQL Server User and Password for Cisco Unity or Cisco Unity Connection
Step 1 On the Cisco Unity (or Cisco Unity Connection) system, select Start > SQL Server > Enterprise Manager. The Enterprise Manager window appears.
Step 2 In the navigation tree, select Microsoft SQL Servers > SQL Server Group > (local) (Windows NT).
Step 3 Right-click (local) (Windows NT) and select Properties. The SQL Server Properties (Configure) window appears.
Step 4 Click the Security tab.
Step 5 Under Authentication, select SQL Server and Windows.
Step 6 In the navigation tree under (local) (Windows NT), select Security > Logins.
Step 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 for the default database.
e. Click the Server Roles tab.
f. Select the check box for each role.
g. Click the Database Access tab.
h. Select both the UnityDb and the master database.
i. For both databases, select all the database roles, giving access to all the roles.
j. Reboot the SQL server.
Verifying the TCP/IP Port Used by Cisco Unity or Cisco Unity Connection
Step 1 On the Cisco Unity system, select Start > SQL Server > Enterprise Manager. The Enterprise Manager appears.
Step 2 From the menu, click Action. Then select Properties. The SQL Server Properties (Configure) dialog box appears.
Step 3 In the General tab, click Network Configuration. The SQL Server Network Utility window appears.
Step 4 Select TCP/IP, then click Properties.
Step 5 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 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.
Step 1 Log on to the router that hosts Cisco Unity Express.
Step 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.
Ports that Provisioning Manager Uses
Before installing Provisioning Manager, make sure that the appropriate ports are available.
Table 2-2 lists the ports that need to be open on the Provisioning Manager system. Table 2-3 lists the ports that need to be open on the firewall between Provisioning Manager and the device.
Table 2-2 Ports Used on the Provisioning Manager System
Port Numbers
|
Service Name/Protocols
|
1098
|
JBoss RMI activation.
|
1099
|
JBoss JNDI.
|
1602
|
Network Interface and Configuration Engine (NICE). This is configurable during the advanced installation process.
|
4444
|
JBoss RMI/JRMP.
|
4445
|
JBoss pooled invoker.
|
5432
|
PostgreSQL database. This is configurable during the advanced installation process.
|
8008
|
JBoss Application Sever. This is configurable during the advanced installation process.
|
8009
|
AJP Connector.
|
8083
|
JBoss Webservice.
|
8093
|
JBoss UILServerILService.
|
80
|
HTTP/Apache Web Server. This is configurable during the advanced installation process.
|
Table 2-3 Ports Used to Communicate with Other Devices
Port Numbers
|
Service Name/Protocols
|
Application
|
80
|
HTTP/Apache Web Server
|
Cisco Unified CallManager.
|
443
|
HTTPS
|
Cisco Unified CallManager 4.x.
|
8443
|
HTTPS
|
Cisco Unified CallManager 5.0.
|
22
|
SSH
|
Cisco Unified CallManager Express and Cisco Unity Express.
|
23
|
Telnet
|
Cisco Unified CallManager Express and Cisco Unity Express.
|
1433
|
MS SQL
|
Cisco Unity and Cisco Unity Connection.
|
Gathering Information to Provide During Installation
You might need to supply the following information while you are installing Provisioning Manager:
•For a simple installation, you will need to have the following:
–A license file, or you can choose to use the evaluation version.
–Password for the administrator user.
•For an advanced installation, what you need depends on your installation. The following list contains information you may need to have:
–A license file, or you can choose to use the evaluation version.
–A port number for the Apache web server.
–A port number for the PostgreSQL database.
–Hostname or IP address for the systems that can connect to the PostgreSQL database.
–Username and password for the Windows user that the PostgreSQL database uses.
–Username and password for the PostgreSQL administrator.
–The JBoss application server name.
–The port number for the JBoss application server.
–Username and password for the application database user.
–Password for the administrator user.
–Port number for the NICE service.
Installing Provisioning Manager
The installation process takes approximately 60 minutes to complete.
Follow these guidelines when installing Provisioning Manager:
•Provisioning Manager requires a dedicated system; do not install it on a system with:
–Third-party management software (such as HP OpenView or NetView).
–Cisco Secure Access Control Server (ACS).
–Any Cisco applications other than those that are documented to be able to coexist with Provisioning Manager 1.0.
•If installing on a system with Cisco Security Agent, before installing Provisioning Manager disable Cisco Security Agent.
•Do not install on any of your voice application servers or on a Cisco Unified CallManager server.
•Verify that the system date and time are set properly.
•To speed up installation, disable all virus-scan software while installing.
Step 1 Make sure your system meets these prerequisites:
•Required (or desired) operating system upgrades have been performed.
•Required service packs are installed.
For system requirements, see Server Requirements, page 1-2.
Step 2 Close all open or active programs. Do not run other programs during the installation process.
Step 3 As the local administrator, log in to the machine on which you will install the Provisioning Manager software, and insert the Cisco Unified Provisioning Manager CD-ROM into the CD-ROM drive. The Cisco Unified Provisioning Manager 1.0 window opens.
Note If the CD-ROM is already in the CD-ROM drive and you stopped the installation process to close programs or if Autostart is disabled, click cupm1.0-setup.exe to restart the process.
Step 4 Click Install. The Welcome window appears.
Step 5 Click Next. The Software License Agreement window appears.
Step 6 Accept the Software License Agreement and then click Next.
Step 7 In the Destination Directory window, click Next to accept the default installation directory.
Note Do not install Provisioning Manager under any directory where the directory name contains a space (for example, Program Files).
Step 8 Select the appropriate sizing for your Provisioning Manager installation.
Note The options that appear depend on the amount of memory that your system has.
Step 9 Click Next.
Step 10 Choose an installation type, Simple or Advanced:
•Select Simple, and click Next.
a. Select one of the following, and then click Next:
–If you have a license file for this product, specify its location—Browse to enter the location.
–Select this option to evaluate the product—You can complete the installation and then register the license file later.
b. Click Next.
c. Enter a password for the administrator user.
d. Click Next.
e. Select the appropriate time zone, then click Next. The Summary page appears.
f. Click Install.
•Select Advanced, and click Next. The advanced installation has two distribution options. The first, all of Provisioning Manager (application and database) installed on one system. The second, the Provisioning Manager application and database installed on separate systems. This scenario requires that you enter the IP address of the two systems.
a. Choose the components:
–Database—Installs the Provisioning Manager database only.
–CUPM—Installs the Provisioning Manager application only.
Note If you choose to install the database and the application on separate systems, Provisioning Manager is not completely installed until both the database and application are installed.
When you install the database on a separate machine, at the end of the installation you will receive a message that states Provisioning Manager was installed successfully. But only the database is installed on that system.
b. Click Next.
c. Enter a port number for the Apache web server, then click Next.
d. Enter a port number for PostgreSQL database, then click Next.
e. (Optional) Enter a hostname or IP address for the systems that can connect to the PostgreSQL database, then click Next. This is required if the database or the application is being installed on a separate system.
f. Enter a username and password for the Windows user, then click Next.
Note If the username already exists on the system, the password entered must be the current password for that user.
g. Enter a username and password for the PostgreSQL administrator, then click Next.
h. Select one of the following, and then click Next:
–If you have a license file for this product, specify its location—Browse to enter the location.
–Select this option to evaluate the product—You can complete the installation and then register the license file later.
i. Enter the JBoss application server name, then click Next.
j. Enter the port number for the JBoss application server, then click Next.
k. Enter the username and password for the application database user, then click Next.
l. Enter a password for the Provisioning Manager administrator user, then click Next.
m. Enter a port number for the NICE service, then click Next.
n. Select the appropriate time zone, then click Next. The Summary page appears.
o. Click Install.
Note If an error message appears, similar to the following:
C:\CUPM\httpd\conf\httpd.conf exists on this system and it has been modified since instllation. Do you want to remove this file?
The installation failed. Before trying to install Provisioning Manager again, you must clean up the system. See Cleaning Up a Failed Installation.
Step 11 Eject the CD-ROM.
Note Store the CD-ROM in a secure, climate-controlled area for safekeeping.
Step 12 Click Finish.
Step 13 After the installation completes, verify that Provisioning Manager is installed correctly by accessing the Provisioning Manager login page. From the Windows desktop, select Start > Programs > Cisco Unified Provisioning Manager > Log in to Cisco Unified Provisioning Manager.
Note If Enhanced Security is enabled on the Windows 2003 system, you must add the Provisioning Manager home page to the Internet Explorer Trusted Sites Zone. You will not be able to access the Cisco Unified Provisioning Manager home page until it is added to the trusted sites. See Adding the Provisioning Manager Home Page to the Internet Explorer Trusted Sites Zone.
Adding the Provisioning Manager Home Page to the Internet Explorer Trusted Sites Zone
If Enhanced Security is enabled on the Windows 2003 system, you must perform the following procedure before you can access the Provisioning Manager home page.
Step 1 Open Provisioning Manager and select Start > Programs > Cisco Unified Provisioning Manager.
Step 2 From the File menu, select Add this site to.
Step 3 Click Trusted Sites Zone.
Step 4 In the Trusted Sites dialog box, click Add to move the site to the list.
Step 5 Click Close.
Step 6 Refresh the page to view the site from its new zone.
Step 7 Check the Status bar of the browser to confirm that the site is in the Trusted Sites Zone.
Uninstalling Provisioning Manager
Caution You must use the Provisioning Manager uninstallation program to remove Provisioning Manager from your system. If you try to remove the files and programs manually, you can seriously damage your system.
Step 1 Close all applications that are using Provisioning Manager files.
Step 2 As the local administrator, log in to the system on which Cisco Unified Provisioning Manager is installed.
Step 3 To start the uninstallation process, from the Windows desktop select Start > Programs > Cisco Unified Provisioning Manager > Uninstall Cisco Unified Provisioning Manager.
Step 4 Click Next to begin uninstalling.
A window appears, listing the components selected for uninstallation.
Step 5 Click Uninstall.
Messages showing the progress of the uninstallation appears.
Step 6 A message appears, reminding you that the cupmuser (Windows user) directory and the CUPM installation folder must be removed manually. Click Next.
Note The default Windows user name provided during installation is cupmuser. If you changed it during installation, the Windows user name may be different.
Step 7 Click Finish.
Step 8 If you want to reboot the system, select Yes, restart my computer, then click Finish.
Step 9 Manually delete the following folders from the Provisioning Manager system:
•The CUPM installation folder. If you selected the default location during installation, it is C:\CUPM.
•The Documents and Settings\cupmuser folder.
Cleaning Up a Failed Installation
If Provisioning Manager did not install correctly, you must first clean up the system before trying to install Provisioning Manager again.
After a failed installation, do the following:
•Delete the CUPM installation folder. If you selected the default location during installation, it is C:\CUPM.
•Delete the Documents and Settings\cupmuser folder.
•Remove the Windows user; cupmuser (cupmuser is the default name provided during installation). The Windows user name can be different, if you changed it during installation.
