Cisco Unified Communications Manager (CallManager)

Document ID: 77811

Feedback

This series of interactive documents uses a typical head office and branch office in order to demonstrate some common voice network configurations. This interactive diagram allows you to view network configurations:

This image is interactive! Click a component to view configuration and troubleshooting information.

Refer to Unified CallManager Interactive Voice Network Configuration and Troubleshooting Case Study for requirements assumed by this series of interactive documents.

Configure

You can use one of these methods in order to configure IPMA:

• IPMA Configuration Wizard
• Manual configuration

Note: If you install IPMA for the first time, use the IPMA Configuration Wizard. Because the IPMA Configuration Wizard automatically creates partitions and Calling Search Spaces, you must use this method with caution. The manual configuration method is used in this document because the IPMA is installed on top of an existing IP Telephony network in which the Calling Search Spaces and partitions are already configured.

In order to configure IPMA Proxy Line Support, complete these steps:

1. Configure Partitions and Calling Search Spaces in Unified CallManager
2. Create a CTI Route Point
3. Add the IPMA Service to the Unified CallManager IP Phone Services
4. Configure IPMA Service
5. Associate Manager and Assitant to IPMA
6. Configure Phones
7. Install Assistant Console
8. Restart Cisco Tomcat Service
9. Restart the IPMA Service in Unified CallManager

Configure Partitions and Calling Search Spaces in Unified CallManager

In order to configure partitions and Calling Search Spaces in Unified CallManager, complete these steps:

1. Create the Manager and IPMA partitions as shown in this image:
   
   
   
   
2. In addition, you need two Calling Search Spaces (CSS):
   


• A CSS that includes everyone + IPMA
• A CSS that includes everyone + Manager

Note: Since you adopt the Class of Restriction with Line CSS, as per the Dial Plan document, you must utilize the current CSS at the device level (SanJose_CSS and RTP_CSS).

3. In this case, add partition IPMA to both SanJose_CSS and RTP_CSS. Also, you must ensure that the proxy line CSS and the Route Point (which is created later) has access to the Manager partition. In this case, create another partition named SanJose_CSS_M:
   
   

Create a CTI Route Point

In order to allow the CTI Route Point to intercept calls that go to the Manager IP Phone, you must create a directory number that is identical to the directory number for the Manager and place it in the IPMA partition that you created in Step 1.

The Calling Search Space for the CTI Route Point must have access to the Manager Partition, as well as everyone. Create a CTI Route Point, and add a directory number of 5001 (which is identical to the Manager directory number).

In order to create a CTI Route Point, complete these steps:

1. Choose Device > CTI Route Point > Add a New CTI Route Point.

   The CTI Route Point Configuration page appears.
   
   

2. Choose SanJose_CSS_M from the Calling Search Space drop-down list.

Add the IPMA Service to the Unified CallManager IP Phone Services

In order to add IPMA service to the Unified CallManager IP phone services, complete these steps:

1. Choose Feature > Cisco IP Phone Services> Add a New IP Phone Service.
   
   
2. Create the IPMA service under Cisco IP Phone Services in CallManager as shown in this image:
   
   

Note: The exact url for the IPMA service is:

http://171.69.103.225/ma/servlet/MAService?cmd=doPhoneService&Name=#DEVICENAME#

Configure IPMA Service

In order to configure the IPMA Service, complete these steps:

1. Choose Service > Service Parameters.
   
   The Service Parameters Configuration page appears.
   
   
   
   
2. Choose Cisco IP Manager Assistant from the Service drop-down list.
   
   
   
   
3. In the General Parameters area, enter values for these parameters:
   
   
   • CTI Manager (Primary) IP Address
   • Route Point Device Name for Proxy Mode
     
     
4. In the Clusterwide Parameters (Parameters that apply to all areas) area, enter values for these parameters:
   
   
   • Cisco IPMA Server (Primary) IP Address
   • Cisco IPMA Server (Backup) IP Address
     
     
5. In the Clusterwide Parameters (IPMA Device Configuration Defaults for Proxy Mode), enter values for these parameters:
   
   
   • Manager Partition
   • All User Partition
   • IPMA Calling Search Space (This calling search space must include Everyone plus Manager.)
   • Manager Calling Search Space (This calling search space must include Everyone plus IPMA.)
     
     
6. Click the Update button located at the top of the page.

Associate the Manager and Assistant Users to IPMA

In order to associate the Manager and Assistant users to IPMA, complete these steps:

1. Under CallManager, choose User > Global Directory, and search for the user that will become the Manager and the user that will become the Assistant.
   
   
   
   Note: This examples assumes that users already exist and that the correct device or phone is associated with the user. The user names for this example are John Doe (Manager) and Carolyn Smith (Assistant).
   
   
2. Check these check boxes:
   
   
   • Enable CTI Application Use
   • Enable CTI Super Provider
   • Call Park Retrieval Allowed
   • Enable Calling Party Number Modification
     
     
   
   
   
3. On the User Configuration page, click Cisco IPMA.
   
   
   
   
4. Complete these steps in order to configure the Manager:
   
   
   1. If the Manager will use Extension Mobility, check the Mobile Manager check box.
      
   2. Add Assistants as necessary.
      
   3. Choose intercom lines from the Intercom Line drop-down list.
      
   4. Choose the lines that will be controlled by IPMA.

   
   
   Note: You can also use automatic configuration in order to configure these parameters. However, you must first configure all the required values under the Service Parameters section, which adds the necessary softkey templates to your phones. This example demonstrates how to manually configure these parameters to ensure they are correct. Refer to Cisco IP Manager Assistant With Proxy Line Support  for more information.
   

5. In order to configure the Assistant parameters, choose User > Global Directory, and then search for the user that will become the Assistant. Similarly, configure the Assistant parameters as follows:
   
   

Configure Phones

The phone configurations are critical to the functionality of IPMA. The directory number for the Manager (5001) must be placed in the Manager partition created earlier in this procedure. In addition, the Calling Search Spaces for the Manager and the Assistant must have the correct Calling Search Space assigned to their devices. Otherwise, IPMA will not function properly.

For more information about phone configurations, see Introduction or refer to these documents:

• Phone Configuration (San Jose) Interactive Voice Network Configuration Example
• Phone Configuration (RTP) Interactive Voice Network Configuration Example

Install Assistant Console

In order to install Assistant Console, type this URL from the Assistant desktop:

http://<IPMA_server>/ma/Install/IPMAConsoleInstall.jsp

Where IPMA_server is the IP address of the IPMA server.

Restart Cisco Tomcat Service

Once everything is configured, you must restart the IPMA Service from the Tomcat application or through the Cisco CallManager Serviceability interface.

In order to launch the Tomcat application, type this URL:

http://<IPMA_server>/manager/list

Where IPMA_server is the IP address of the IPMA server.

Once theTomcat application is launched, you must restart the Cisco IPMA Service.

Restart the IPMA Service in Unified CallManager

In order to restart the IPMA Service from Unified CallManager, complete these steps:

1. Choose Application >  Cisco CallManager Serviceability > Tools > Service Activation.
   
   
2. Choose the server, and then uncheck the Cisco IP Manager Assistant check box.
   
   
   
   
3. Click Update.

Verify

In order to test IPMA, complete these steps:

1. Start the Assistant Console, and log in with the assistant user ID. In this example, the assistant user ID is csmith.
   
   
   
   
2. Click Settings in order to verify that the correct server IP address appears.
   
   
   
   
3. Click Save.
   
   The IPMA Logon page appears.
   
   
4. Click Login.
   
   The Cisco IPMA Assistant Console appears.
   
   
   
   
5. Click the Divert All check box in order to divert all calls on the Manager phone.
   
   Note: You can complete this step from the Manager phone as well. Press the More button, and then press Divert All.
   
   
6. Place a call to the Manager directory number, 5001.
   
   The Assistant phone should ring on the proxy line, 5011.
   
   
7. On the Manager phone, press Softkey (Intercept).
   
   The Manager phone should pick up the call. If the Manager phone does not pick up the call, repeat the steps in this procedure in order to verify your configuration.
   
   Note: One of the most common reasons that the Manager phone does not intercept a call is because the calling search space is incorrect at the Assistant phone. The Assistant phone must include a calling search space that points to Everyone and the Manager.
   
   
8. Verify that your CTI Route Point is active.
   
   
   
   Note: If the CTI Route Point is not active, verify that your CTI Manager Service is running. See Restart the IPMA Service in Unified CallManager for more information.