Document ID: 77811
Updated: Apr 16, 2007
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.
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:
- Configure Partitions and Calling Search Spaces in Unified CallManager
- Create a CTI Route Point
- Add the IPMA Service to the Unified CallManager IP Phone Services
- Configure IPMA Service
- Associate Manager and Assitant to IPMA
- Configure Phones
- Install Assistant Console
- Restart Cisco Tomcat Service
- Restart the IPMA Service in Unified CallManager
In order to configure partitions and Calling Search Spaces in Unified CallManager, complete these steps:
- Create the Manager and IPMA partitions as shown in
- 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).
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:
- Choose Device > CTI Route Point > Add a New CTI Route Point.
The CTI Route Point Configuration page appears.
- Choose SanJose_CSS_M from the Calling Search Space drop-down list.
In order to add IPMA service to the Unified CallManager IP phone services, complete these steps:
- Choose Feature > Cisco IP Phone Services> Add a New IP Phone Service.
- 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:
In order to configure the IPMA Service, complete these steps:
- Choose Service > Service Parameters.
The Service Parameters Configuration page appears.
- Choose Cisco IP Manager Assistant from the Service drop-down list.
- In the General Parameters area, enter values for these parameters:
- CTI Manager (Primary) IP Address
- Route Point Device Name for Proxy Mode
- 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
- 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.)
- Click the Update button located at the top of the page.
In order to associate the Manager and Assistant users to IPMA, complete these steps:
- Under CallManager, choose User > Global Directory, and search
for the user that will become the Manager and the user that will become the
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).
- Check these check boxes:
- Enable CTI Application Use
- Enable CTI Super Provider
- Call Park Retrieval Allowed
- Enable Calling Party Number Modification
- On the User Configuration page, click Cisco IPMA.
- Complete these steps in order to configure the Manager:
- If the Manager will use Extension Mobility, check the Mobile Manager
- Add Assistants as necessary.
- Choose intercom lines from the Intercom Line drop-down list.
- 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.
- If the Manager will use Extension Mobility, check the Mobile Manager check box.
- 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:
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
In order to install Assistant Console, type this URL from the Assistant desktop:
Where IPMA_server is the IP address of the IPMA server.
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:
Where IPMA_server is the IP address of the IPMA server.
Once theTomcat application is launched, you must restart the Cisco IPMA Service.
In order to restart the IPMA Service from Unified CallManager, complete these steps:
- Choose Application > Cisco CallManager Serviceability > Tools
> Service Activation.
- Choose the server, and then uncheck the Cisco IP Manager Assistant
- Click Update.
In order to test IPMA, complete these steps:
- Start the Assistant Console, and log in with the assistant user ID. In this
example, the assistant user ID is csmith.
- Click Settings in order to verify that the correct server IP address
- Click Save.
The IPMA Logon page appears.
- Click Login.
The Cisco IPMA Assistant Console appears.
- Click the Divert All check box in order to divert all calls on the
Note: You can complete this step from the Manager phone as well. Press the More button, and then press Divert All.
- Place a call to the Manager directory number, 5001.
The Assistant phone should ring on the proxy line, 5011.
- 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.
- 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.
The Cisco Support Community is a forum for you to ask and answer questions, share suggestions, and collaborate with your peers.
Refer to Cisco Technical Tips Conventions for information on conventions used in this document.