Cisco Unified MobilityManager Administration Guide, Release 1.2
System Configuration

Table Of Contents

System Configuration

Configuring System Parameters

Mobile Connect Settings

Cellular Phone Pickup Settings

Cellular Timer Settings

Auto Update JTAPI File Settings

SNMP Settings

Mobile Voice Access Settings

Cisco Unified CallManager AXL Server Settings

Enabling Data Synchronization

Backing Up and Restoring the Database

Configuring Directory User Settings

Configuring Extension Pattern Settings

Adding a New Extension Pattern

Finding an Existing Extension Pattern

Deleting an Extension Pattern


System Configuration


This chapter describes how to set up parameters for call handling in Cisco Unified MobilityManager. Refer to the these topics to get started:

Configuring System Parameters

Enabling Data Synchronization

Backing Up and Restoring the Database

Configuring Directory User Settings

Configuring Extension Pattern Settings

For information on setting up links to the Cisco Unified CallManager system, see "Getting Started."

Configuring System Parameters

Cisco Unified MobilityManager includes system-level mobility parameters for mobile connection, desktop and cellular phone rules and timers, settings for the JAVA telephony programming interface (JTAPI), and SNMP1 and Mobile Voice Access settings.

Many of the system parameters can also be configured for individual users in the User Information windows. Settings for individual users override the system-level settings assigned in the System Parameters window.


Note For basic Cisco Unified MobilityManager operation, it is not necessary to enter any information or change any of the default settings on the System Parameters page. Modify the settings only as needed to activate or modify desired features.


To configure system parameters, follow these steps:

Procedure


Step 1 From the Cisco Unified MobilityManager administration window, choose System > System Parameters.

The System Parameters Configuration page opens.

Step 2 Use the Restart Cisco Unified MobilityManager button if Cisco Unified MobilityManager services have been stopped and you need start them again.

Step 3 Keep the default setting of Yes for the Gateway Early Media field. This field is sometimes used for troubleshooting.

Step 4 Choose Mobile Connect settings as described in Table 3-1.

Step 5 In the Maximum Wait Time for Desktop Phone Pickup field, enter the maximum delay in milliseconds that is permitted before the user must pick up the desktop phone. If the specified time is exceeded, the call is disconnected. The range is 5000-60000 milliseconds, and the default is 10000 milliseconds.

Step 6 Choose cellular phone pickup settings as described in Table 3-2.

Step 7 Choose cellular timer settings as described in Table 3-3.

Step 8 Choose settings for automatic update of JTAPI, as described in Table 3-4.

Step 9 Choose SNMP settings, as described in Table 3-5

Step 10 Choose Mobile Voice Access settings as described in Table 3-6.

Step 11 Enter Cisco Unified CallManager AXL server settings as described in Table 3-7.

Step 12 Click Save.


Related Topics

Mobile Connect Settings

Cellular Phone Pickup Settings

Cellular Timer Settings

Auto Update JTAPI File Settings

SNMP Settings

Mobile Voice Access Settings

Cisco Unified CallManager AXL Server Settings

Mobile Connect Settings

Table 3-1 describes the Mobile Connect settings available on the System Parameters screen.

Table 3-1 Mobile Connect Settings 

Field
Description

Enable Caller ID Override

Choose Yes if you want the caller ID display to show a number other than the ID of the call initiator. Choose No to show the ID of the call initiator. The default is No.

Caller ID Override Number

Enter the telephone number to display for caller ID. Maximum field length is 20 characters; individual characters can take the values 0-9 or A-D. If the field is blank, then the display indicates that there is not caller ID.

If Enable Caller ID Override is disabled, then this field is inactivated.

Enable Mobile Connect Feature

Choose Yes to activate Mobile Connect features. If you choose No, then the other fields in this window are ignored. The default is Yes.

Enable Delay Before Ringing Cellular Phone

Choose Yes to introduce a delay before causing the remote device (cellular phone) to ring when an incoming call is received. By introducing a delay, the desktop phone maintains priority status for receiving incoming calls. Choose No to have no delay introduced. The default is No.

Delay Before Ringing Cellular Phone

If you choose Yes for Enable Delay Before Ringing Cellular Phone, enter the time delay. The range is 1000-300000 milliseconds, and the default is 4000 milliseconds.


Related Topics

Cellular Phone Pickup Settings

Cellular Timer Settings

Auto Update JTAPI File Settings

SNMP Settings

Mobile Voice Access Settings

Cisco Unified CallManager AXL Server Settings

Cellular Phone Pickup Settings

Table 3-2 describes the cellular phone pickup settings that determine rules regarding pick-up of the cellular phone on an incoming call.

Table 3-2 Cellular Phone Pick-Up Settings 

Field
Description

Enable Cellular Phone Pickup

Choose Yes to permit a call to be switched from the desktop phone to a remote extension (cellular phone) while the call is taking place. The default is Yes.

Enable Maximum Cellular Phone Pickup Timer

Choose Yes to set the maximum waiting time for the cellular phone to answer when a call is switched from the desktop phone. The default is No.

Maximum Wait Time for Cellular Phone Pickup (msec)

If you choose Yes for Maximum Wait Time for Cellular Phone Pickup, enter the maximum number of milliseconds that is permitted to pass before the cellular phone must be picked up when a call is switched from the desktop phone. If the remote device does not answer in the specified time, the call is disconnected. The range is 1000-300000 milliseconds, and the default is 20,000 milliseconds.


Related Topics

Mobile Connect Settings

Cellular Timer Settings

Auto Update JTAPI File Settings

SNMP Settings

Mobile Voice Access Settings

Cisco Unified CallManager AXL Server Settings

Cellular Timer Settings

Table 3-3 describes the cellular timer settings that control rings and timing for cellular phone pickup.

Table 3-3 Cellular Timer Settings 

Field
Description

Enable Maximum Cellular Phone Ring Timer

Choose Yes to set timing intervals for calls switched from the desktop phone to cellular phone. The default is No.

Maximum Cellular Phone Ring Timer

If you choose Yes for Enable Maximum Cellular Phone Ring Timer, enter the maximum length of time the cellular phone rings before being disconnected. This value is measured from the end of the interval determined by the Delay Before Ringing Cellular Phone Field. (See Table 2-1.) The range is 10000-300000 milliseconds, and the default is 19000 milliseconds.

The timer should be set to be less than the No Answer Ring Duration timer configured for that line in Cisco Unified CallManager. For further information, see the Cisco Unified CallManager Administration Guide.

Enable Minimum Cellular Phone Ring Timer

Choose Yes to set the minimum timing for the cellular phone to ring for incoming calls and switching from the desktop phone to cellular phone. The default is Yes.

Minimum Cellular Phone Ring Timer

If you choose Yes for Minimum Cellular Phone Ring Time, enter the minimum time that must pass before the cellular phone can be answered. If an attempt is made to answer the cellular phone before this time passes, then the call is dropped (it is assumed that cellular phone voice mail has picked up the call). The range is 1000-10000 milliseconds, and the default is 1500 milliseconds.

Note If you experience dropped inbound calls in cell phones that are configured as remote destinations, try adjusting them to suit your cell phone requirements for voice mail.


Related Topics

Mobile Connect Settings

Cellular Phone Pickup Settings

Auto Update JTAPI File Settings

SNMP Settings

Mobile Voice Access Settings

Cisco Unified CallManager AXL Server Settings

Auto Update JTAPI File Settings

Table 3-4 describes the Auto Update JTAPI file settings that control updating of the JAVA telephony programming interface used for communications between Cisco Unified MobilityManager and Cisco Unified CallManager. Use the JTAPI file settings to configure automatic synchronization of the JTAPI versions. If you enable the automatic update, then the version of JTAPI is updated automatically to match that of Cisco Unified CallManager.

The jtapi.jar file from Cisco Unified CallManager 4.1.3 is bundled in the Cisco Unified MobilityManager software distribution. If you are using a different version of Cisco Unified CallManager, you need to configure the JTAPI file settings as described in this section.


Note The JTAPI automatic update takes effect only after Cisco Unified MobilityManager is restarted.


Table 3-4 Auto Update JTAPI File Settings 

Field
Description

Enable Auto Update JTAPI file

Choose Yes to enable automatic update of the JAVA telephony settings. The default is No. If your Cisco Unified MobilityManager server is connected to Cisco Unified CallManager 5.0, choose Yes.

Always Update JTAPI File

Choose Yes to always update the JTAPI file when Cisco Unified MobilityManager restarts. The default is No. If your Cisco Unified MobilityManager server is connected to Cisco Unified CallManager 5.0, choose Yes.

Auto Update JTAPI Server Name or IP Address

If you choose Yes for automatic update of the JTAPI file, enter the name or IP address of the server that will provide the automatic update. There is no default.

Use Secured Auto JTAPI Update

Choose Yes to add security to the automatic JTAPI update. The default is No.

Auto Update JTAPI Server Path

Enter the absolute path or URL the JTAPI server: The default path is http://<Cisco Unified CallManagerserver>/CCMPluginsServer

If your Cisco Unified MobilityManager server is connected to Cisco Unified CallManager 5.0, the default path is /plugins.

You do not need to enter anything in this field if the default path is to be used.

Auto Update JTAPI Server File Name

Enter the name of the automatic update file on the server. The default is jtapi.jar. You do not need to enter anything in this field if the default file is to be used.

Auto Update JTAPI Local File Name

Enter the name of the local automatic update file. The default is jtapi.jar. You do not need to enter anything in this field if the default file is to be used.


Related Topics

Mobile Connect Settings

Cellular Phone Pickup Settings

Cellular Timer Settings

SNMP Settings

Mobile Voice Access Settings

Cisco Unified CallManager AXL Server Settings

SNMP Settings

Table 3-6 describes the SNMP settings.

Table 3-5 SNMP Settings

Field
Description

SNMP Target IP Address

Enter the IP address for the system that will receive SNMP traps.

SNMP Target Port Number

Enter the SNMP port number. The default port is 162.

SNMP Community String

Enter the code for the SNMP grouping for Cisco Unified MobilityManager.

SNMP Version

Choose SNMP version V1 or V2C from the pull-down list box.


Related Topics

Mobile Connect Settings

Cellular Phone Pickup Settings

Cellular Timer Settings

Auto Update JTAPI File Settings

Cisco Unified CallManager AXL Server Settings

Mobile Voice Access Settings

Table 3-6 describes the settings for Mobile Voice Access.

Table 3-6 Mobile Voice Access Settings

Field
Description

Mobile Voice Access Numbers

Enter the phone number for Mobile Voice Access. Maximum field length is 200 characters; individual characters can take the values 0-9 or A-D. Use commas to enter multiple numbers.

Mobile Voice Access User Lock Out Timer (min)

Enter the number of minutes a user is prevented from using Mobile Voice Access after providing incorrect entries three times in succession. This applies to incorrect PIN or remote destination entries. The range is 0-1440 minutes, and the default is 15 minutes.

Enable System Remote Access

Choose yes to enable the system remote access feature or no to disable the feature.

Note In order for an individual user to be able to take advantage of system remote access, this field must be set to yes, and the Enable User Remote Access field in the Cisco Mobile Connect User Configuration window must also be set to yes for the individual user. See the "Adding a New User Account" section.

System Remote Access Blocked Numbers

Enter any phone numbers that you want to prohibit users from calling using Mobile Voice Access. Maximum field length is 200 characters; individual characters can take the values 0-9 or A-D. Use commas to enter multiple numbers.

System Remote Access Call Take Back Timer (sec)

Enter the number of seconds after which the Mobile Voice Access session times out. The range is 120-180 seconds, and the default is 120 seconds.


Related Topics

Mobile Connect Settings

Cellular Phone Pickup Settings

Cellular Timer Settings

Auto Update JTAPI File Settings

SNMP Settings

Cisco Unified CallManager AXL Server Settings

Cisco Unified CallManager AXL Server Settings

Table 3-7 describes the Cisco Unified CallManager AXL Server settings required for communication with Cisco Unified CallManager.

Table 3-7 Cisco Unified CallManager AXL Server Settings 

Field
Description

Cisco Unified CallManager Version

Enter the software version number for Cisco Unified CallManager. Example: 4.1

Cisco Unified CallManager AXL Server Name or IP Address

Enter the host name or IP address of the Cisco Unified CallManager AXL server.

Cisco Unified CallManager AXL User Name

Enter the user name for administrator access to the Cisco Unified CallManager AXL server.

Cisco Unified CallManager AXL User Password

Enter the password for administrator access to the Cisco Unified CallManager AXL server.


Related Topics

Mobile Connect Settings

Cellular Phone Pickup Settings

Cellular Timer Settings

Auto Update JTAPI File Settings

SNMP Settings

Mobile Voice Access Settings

Enabling Data Synchronization

To synchronize the Cisco Unified MobilityManager database with current runtime memory, follow these steps:

Procedure


Step 1 Choose System > Data Synchronization.

Step 2 Click Start Now.

Step 3 Click OK to confirm that you want to begin the data synchronization process.


Related Topics

Configuring System Parameters

Backing Up and Restoring the Database

Backing Up and Restoring the Database

You can back up and restore the remote system information for Cisco Unified MobilityManager using an SFTP server.

To set backup and restore parameters, follow these steps:

Procedure


Step 1 Choose System > Backup and Restore.

The Backup and Restore screen opens.

Step 2 In the Host Name or IP Address field, enter the appropriate information to identify the backup server.

Step 3 Enter the User ID and password for the backup server.

Step 4 Enter the password again in the Confirm Password field.

Step 5 In the File Path field, enter the location to store or retrieve the backup files.

Step 6 Click Start Backup Now to begin backing up the database to the specified location, or click Start Restore Now to begin restoring from the specified file.

Step 7 After restoring the remote system information, perform data synchronization according to the procedure in "Enabling Data Synchronization" section.


Related Topics

Configuring System Parameters

Enabling Data Synchronization

Configuring Directory User Settings

Directory user settings are required for connection to the directory server that Cisco Unified CallManager uses. For a working connection, you must configure the directory user settings for Cisco Unified MobilityManager to be identical to those in the Cisco Unified CallManager in which directory services are configured. If the settings are not correctly configured, users cannot log in to the User pages or change their user profiles. The directory services information is stored in the DirectorySevices.ini file, which is located in the Cisco Unified CallManager c$\dcdsrvr directory.


Note If your Cisco Unified CallManager installation uses Active Directory or Netscape directory, then refer to the Cisco Customer Directory Configuration Plugin Guide for Cisco Unified CallManager. The file DirectoryConfiguration.ini will be created after the Directory User Settings page is configured, and this file should be the same as the file in Call Manger \dcdsrvr directory.


To configure directory user settings, follow these steps:

Procedure


Step 1 Choose System > Directory User Settings.

Step 2 Enter values for each field in this window that are identical to those configured for Cisco Unified CallManager, as shown Table 3-8.

Step 3 Click Save.


Table 3-8 Directory User Settings 

Field
Description

Directory Administrator Host Name or IP Address

Enter the directory services hostname or IP address.

Directory Administrator Host Port Number

Enter the port number that is configured in the DirectoryConfiguration.ini file.

Example: If you are using the Data Connection Directory (DC-Directory) in Cisco Unified CallManager, then enter 8404.

Directory Administrator DN

Enter the directory number for the administrator login that is configured in the DirectoryConfiguration.ini file.

Example: If you are using the Data Connection Directory (DC-Directory) in Cisco Unified CallManager, then enter cn=Directory Manager, o=cisco.com.

Directory Administrator Password

Enter the password used to log into Directory Services.

Confirm Directory Administrator Password

Reenter the password used to log into Directory Services.

Cisco Directory Administrator DN

Enter the number for the directory administrator that is configured in the DirectoryConfiguration.ini file.

Example: If you are using the Data Connection Directory (DC-Directory) in Cisco Unified CallManager, then enter o=cisco.com.

Directory Type

Enter Default, ADS, or NDS, as configured in the DirectoryConfiguration.ini file.


Related Topics

Accessing Cisco Unified MobilityManager Administration

Configuring CallManager Links

Configuring Extension Pattern Settings

Extension patterns provide direct inward dialing (DID) information. If a call is placed from an internal extension to an extension configured for Mobile Connect, and then a remote destination picks up the call, the default treatment is for the caller ID to show only the internal extension. Using extension patterns, you can instruct the system to display the fully qualified PSTN number.

Adding a New Extension Pattern

To add a new extension pattern, follow these steps:

Procedure


Step 1 From the Cisco Unified MobilityManager administration window, choose System > Extension Patterns.

Step 2 Enter values for each field in this window that are identical to those configured for Cisco Unified CallManager, as shown Table 3-9.

Step 3 Click Save.


Table 3-9 Extension Pattern Settings 

Field
Description

Name

Enter the name that identifies the extension pattern setting.

Description

(Optional) Enter a text description for the extension pattern.

Number Begins With

Enter the digits at the beginning of the extension pattern.

Examples:

For 25xxx, enter 2 or 25.

For 9025xxx, enter 9, 90, 902,or 9025.

Number of Digits

Enter the total number of internal extension digits configured in Cisco Unified MobilityManager.

Examples:

For 25xxx, enter 5.

For 9025xxx, enter 7.

Total Digits to be Removed

Enter the total number of digits to be removed from the configured extension.

Examples:

For 25xxx, you enter 0, no digit is removed. If you enter 1, the pattern is 5xxx.

For 9025xxx, if you enter 0, the pattern is 9025xxx. If you enter 1, the pattern is 025xxx. If you enter 2, the pattern is 25xxx.

Prefix with Pattern

(Optional) Enter the prefix that the system will use with the extension after the system removes the specified number of digits.

Examples:

For 25xxx, if the prefix is 40890 and the total number of digits to be removed is 0, the final pattern is 4089025xxx.

For 9025xxx, if the prefix is 408 and total number of digits to be removed is 0, the final pattern is 4089025xxx.

For 9025xxx, if the prefix is 408 and the total number of digits to be removed is 1, the final pattern is 408025xxx.

For 9025xxx, if the prefix is 408 and the total number of digits to be removed is 2, the final pattern is 40825xxx.


Related Topics

Finding an Existing Extension Pattern

Deleting an Extension Pattern

Finding an Existing Extension Pattern

To find an existing extension pattern, follow these steps:

Procedure


Step 1 From the Cisco Unified MobilityManager administration window, choose System > Extension Patterns.

The Find and List Cisco Mobile Connect Extension Patterns window opens.

Step 2 From the first drop-down list box, choose the search field.

Step 3 From the second drop-down list box, choose one of the following criteria:

begins with

contains

ends with

is exactly

is empty

is not empty

Step 4 Specify the appropriate search text, if applicable, and click Find. You can also specify how many items to display per page.


Note To find all matching records in the database, click Find without entering any search text. To refine a search that was just completed, choose Search Within Results before clicking Find.


Step 5 From the list of records, click the item that matches your search criteria.

The window displays the item that you choose.


Related Topics

Adding a New Extension Pattern

Deleting an Extension Pattern

Deleting an Extension Pattern

To delete an extension pattern, follow these steps:

Procedure


Step 1 From the Cisco Unified MobilityManager administration window, choose System > Extension Patterns.

Find the extension pattern patterns that you want to remove. See "Adding a New Extension Pattern" section.

Step 2 Use either of the following methods to delete records:

From the list of records:

a. Use the check boxes to select specific records, or click Select All to choose all records.

b. Click Delete Selected.

c. Click OK to confirm.

From an open record:

a. Click Delete.

b. Click OK to confirm.


Related Topics

Adding a New Extension Pattern

Finding an Existing Extension Pattern

1 SNMP supports includes SNMP version 1, version 2c, and version 3 with multiple alarm/syslog recipients, setting of syslog read/write attributes, and periodic alarms.