New and Changed Information for Cisco Unified Communications Manager 8.0(x)
Bulk Administration
Downloads: This chapterpdf (PDF - 409.0KB) The complete bookPDF (PDF - 11.5MB) | Feedback

Bulk Administration Tool

Table Of Contents

Bulk Administration Tool

Extension Mobility Cross Cluster

Using EMCC Templates

Finding an EMCC Template

Creating a New EMCC Template

Deleting EMCC Templates

Field Descriptions for a BAT EMCC Template

Inserting EMCC Devices

Updating EMCC Devices

Deleting EMCC Devices

New Fields in Bulk Administration

Import/Export Updates


Bulk Administration Tool


This chapter contains information on the following topics:

Extension Mobility Cross Cluster

New Fields in Bulk Administration

Import/Export Updates

Extension Mobility Cross Cluster

Cisco Unified Communications Manager Bulk Administration (BAT) gives the administrator a fast and efficient way to insert, update, or delete Extension Mobility Cross Cluster (EMCC) in batches, rather than performing individual updates through Cisco Unified Communications Manager Administration.

The following topics provide information about how to use BAT to work with EMCC templates and other IP telephony devices:

Using EMCC Templates

Inserting EMCC Devices

Updating EMCC Devices

Deleting EMCC Devices

Using EMCC Templates

Use BAT EMCC templates to define the common EMCC attributes to add a group of new EMCC. Prior to creating the template, make sure EMCC settings have already been configured in Cisco Unified Communications Manager Administration. You cannot create new settings in BAT.

Use these topics to work with BAT EMCC templates:

Finding an EMCC Template

Creating a New EMCC Template

Deleting EMCC Templates

Field Descriptions for a BAT EMCC Template

Finding an EMCC Template

Because you might have several EMCC templates, Cisco Unified Communications Manager lets you locate specific templates on the basis of specific criteria. Use the following procedure to locate templates.


Note During your work in a browser session, your find/list search preferences are stored in the cookies on the client machine. If you navigate to other menu items and return to this menu item, or if you close the browser and then reopen a new browser window, your Cisco Unified Communications Manager search preferences are retained until you modify your search.


Procedure


Step 1 Choose Bulk Administration > EMCC > EMCC Template.

The EMCC Template Find and List window displays. Use the two drop-down list boxes to search for a template.

Step 2 From the first Find EMCC Template where drop-down list box, choose one of the following criteria:

Template Name

Description

From the second Find EMCC Template where drop-down list box, choose one of the following criteria:

begins with

contains

is exactly

ends with

is empty

is not empty

Step 3 Specify the appropriate search text, if applicable, and click Find.


Tip To find all EMCC Templates that are registered in the database, click Find without entering any search text.


A list of discovered templates displays.

Step 4 From the list of records, click the device name that matches your search criteria.

The window displays the EMCC template that you choose.


Creating a New EMCC Template

Use the following procedure to create an EMCC template.

Procedure


Step 1 Choose Bulk Administration > EMCC > EMCC Template.

The EMCC Template Find and List window displays.

Step 2 Click Add New. The EMCC Template Configuration window displays.

Step 3 Enter the EMCC settings that this batch has in common. See Table 4-1 for field descriptions.

Step 4 After you have entered all the settings for this EMCC template, click Save.

This creates the template.

Step 5 After creating the template, set a default template from the Insert page. You can access the Insert page through Bulk Administration > EMCC > Insert/Update EMCC.


Deleting EMCC Templates

You can delete BAT templates when you no longer require them. Use this procedure to delete a template.

Procedure


Step 1 Find the EMCC Template that you want to delete, by using the procedure in "Finding an EMCC Template" section.

Step 2 In the EMCC Template Configuration window, verify that this is the template that you want to delete and click Delete.


Note You can also delete the EMCC template from the EMCC Template Find and List window. Check the check box next to the template that you want to delete and click Delete Selected.


A message displays that asks you to confirm the delete operation.


Note The template that is set as the default EMCC template cannot be deleted from the system. You can find the default EMCC template from the Insert/Update EMCC page or from the Delete EMCC page. You can also find it from the EMCC Template Find List page. On the Find List page, no check box displays against the default template.


Step 3 To delete the template, click OK. The template name disappears from the list of EMCC templates list on the Find and List EMCC Templates window.


Caution If you submit a job that uses a particulate EMCC template and if you delete the template, the job also gets deleted.


Field Descriptions for a BAT EMCC Template

Table 4-1 provides descriptions of all possible fields that display when you are adding an EMCC template.

Some fields display the values that were configured in Cisco Unified Communications Manager Administration.

In the BAT user interface, field names that have an asterisk require an entry. Treat fields that do not have an asterisk as optional.

Table 4-1 Field Descriptions for an EMCC Template 

Field
Description
Device Information

Template Name

Enter the name for the template.

Description

Enter a description for the EMCC template that you want to create. The description can include up to 50 characters in any language, but it cannot include double-quotes ("), percentage sign (%), ampersand (&), back-slash (\), or angle brackets (<>).

Device Pool

Choose the device pool for this EMCC.

For devices, a device pool defines sets of common characteristics, such as region, date/time group, Cisco Unified Communications Manager group, and calling search space for auto-registration.

SIP Profile

Choose the default SIP profile or a specific profile that was previously created. SIP profiles provide specific SIP information for the phone such as default telephony event payload type, registration and keepalive timers, media ports, Iris, and dynamic DNS server addresses.

Common Device Configuration

Choose the common device configuration to which you want this EMCC assigned. The common device configuration includes the attributes (services or features) that are associated with a particular user. You configure the Common device configurations in the Common Device Configuration window. See Common Device Configuration for more information.

To see the common device configuration settings, click the View Details link.

Common Phone Profile

From the drop-down list box, choose a common phone profile from the list of available common phone profiles.



Note To continue configuring the EMCC template, go to the "Creating a New EMCC Template" section.


Inserting EMCC Devices

To add EMCC devices to the Cisco Unified Communications Manager database, use the following procedure.


Note Be aware that before you insert EMCC devices, you must have a valid EMCC template set as default. To set the default template, see the update EMCC section.


Procedure


Step 1 Choose Bulk Administration > EMCC > Insert/Update EMCC.

The Insert/Update EMCC Configuration window displays.

Step 2 Make sure that the Insert EMCC Devices radio button is selected.

Step 3 Enter the number of devices in the Number of EMCC Devices to be added field.

Step 4 In the Job Information area, enter the Job description.

Insert EMCC Devices is the default description.

Step 5 To insert the EMCC devices immediately, click the Run Immediately radio button. Click Run Later to insert the devices at a later time.

Step 6 To create a job for inserting the EMCC devices, click Submit.

Step 7 To schedule and activate this job, use the Job Scheduler option in the Bulk Administration main menu.


Updating EMCC Devices

To update EMCC configuration, use the following procedure:

Procedure


Step 1 Choose Bulk Administration > EMCC > Insert/Update EMCC.

The Insert/Update EMCC Configuration window displays.

Step 2 Select the Update EMCC Devices radio button.

Step 3 To set the default template, choose an EMCC template from the Default EMCC Template drop-down list box.

Step 4 Select the Reset radio button to reset all devices, select Don't Reset if you do not wish to reset all devices.

Step 5 In the Job Information area, enter the Job description.

Update EMCC Devices is the default description.

Step 6 To update the EMCC records immediately, click the Run Immediately radio button. Click Run Later to update the records at a later time.

Step 7 To create a job for updating the EMCC devices, click Submit.

Step 8 To schedule and activate this job, use the Job Scheduler option in the Bulk Administration main menu.


Deleting EMCC Devices

You can use BAT to delete EMCC devices in bulk. Use the procedures to delete EMCC devices.

Procedure


Step 1 Choose Bulk Administration > EMCC > Delete EMCC.

The Delete EMCC Configuration window displays.

Step 2 Enter the number of devices to that you wish to delete in the Number of EMCC Devices to be deleted field.

Step 3 In the Job Information area, enter the Job description.

Delete EMCC is the default description.

Step 4 To delete the EMCC devices immediately, click the Run Immediately radio button. Click Run Later to delete the devices at a later time.

Step 5 To create a job for deleting the EMCC devices, click Submit.

Step 6 To schedule and activate this job, use the Job Scheduler option in the Bulk Administration main menu.


New Fields in Bulk Administration

The following new fields are added to the Bulk Administration User Interface:

Bulk Administration > Phones > Phone Template—The following new fields are added to this page:

Feature Control Policy—Enter the Feature Control Policy for this group of phones. A feature control policy specifies the appearance of features and the associated softkeys that are displayed on the phone.

Hotline Device—Check this check box to make this device a Hotline device. Hotline devices can only connect to other Hotline devices. This feature is an extension of PLAR, which configures a phone to automatically dial one directory number when it goes off-hook. Hotline provides additional restrictions that you can apply to devices that use PLAR.
To implement Hotline, you must also create a softkey template without supplementary service softkeys, and apply it to the Hotline device.

Secure Authentication URL—Enter the secure URL that the phone uses to validate requests that are made to the phone web server.


Note If you do not provide a Secure Authentication URL, the device uses the nonsecure URL. If you provide both a secure URL and a nonsecure URL, the device chooses the appropriate URL, based on its capabilities.


By default, this URL accesses a Cisco Unified CM User Options window that was configured during installation.
Leave this field blank to accept the default setting.
Maximum length: 255.

Secure Directory URL—Enter the secure URL for the server from which the phone obtains directory information. This parameter specifies the URL that secured Cisco Unified IP Phones use when you press the Directory button.


Note If you do not provide a Secure Directory URL, the device uses the nonsecure URL. If you provide both a secure URL and a nonsecure URL, the device chooses the appropriate URL, based on its capabilities.


Leave this field blank to accept the default setting.

Maximum length: 255

Secure Idle URL—Enter the secure URL for the information that displays on the Cisco Unified IP Phone display when the phone is idle, as specified in Idle Timer field. For example, you can display a logo on the LCD when the phone has not been used for 5 minutes.


Note If you do not provide a Secure Idle URL, the device uses the nonsecure URL. If you provide both a secure URL and a nonsecure URL, the device chooses the appropriate URL, based on its capabilities.


To accept the default setting, leave this field blank.

Maximum length: 255

Secure Information URL—Enter the secure URL for the server location where the Cisco Unified IP Phone can find help text information. This information displays when the user presses the information (i) button or the question mark (?) button.


Note If you do not provide a Secure Information URL, the device uses the nonsecure URL. If you provide both a secure URL and a nonsecure URL, the device chooses the appropriate URL, based on its capabilities.


To accept the default setting, leave this field blank.

Maximum length: 255

Secure Messages URL—Enter the secure URL for the messages server. The Cisco Unified IP Phone contacts this URL when the user presses the Messages button.


Note If you do not provide a Secure Messages URL, the device uses the nonsecure URL. If you provide both a secure URL and a nonsecure URL, the device chooses the appropriate URL, based on its capabilities.


To accept the default setting, leave this field blank.

Maximum length: 255

Secure Services URL—Enter the secure URL for Cisco Unified IP Phone services. The is the location that the secure Cisco Unified IP Phone contacts when the user presses the Services button.


Note If you do not provide a Secure Services URL, the device uses the nonsecure URL. If you provide both a secure URL and a nonsecure URL, the device chooses the appropriate URL, based on its capabilities.


To accept the default setting, leave this field blank.

Maximum length: 255

Bulk Administration > Phones > Add a new DN—the following new fields are added to this page:

Park Monitoring Forward No Retrieve Destination External—When the parkee is an external party, then the call will be forwarded to the specified destination in the parker's Park Monitoring Forward No Retrieve Destination External parameter. If the Forward No Retrieve Destination External field value is empty, the parkee will be redirected to the parker's line.

Park Monitoring Forward No Retrieve Destination Internal—When the parkee is an internal party, then the call will be forwarded to the specified destination in the parker's Park Monitoring Forward No Retrieve Destination Internal parameter. If the Forward No Retrieve Destination Internal is empty, the parkee will be redirected to the parker's line.

Park Monitoring Reversion Timer—This parameter determines the number of seconds that Cisco Unified Communications Manager waits before prompting the user to retrieve a call that the user parked. This timer starts when the user presses the Park softkey on the phone, and a reminder is issued when the timer expires.

Default: 60 seconds


Note If you configure a non-zero value, this value overrides the value of this parameter set in the Service Parameters window. However, if you configure a value of 0 here, then the value in the Service Parameters window will be used.


Park Monitoring Forward No Retrieve Internal Voice Mail—Check this check box to use settings in the Voice Mail Profile Configuration window.


Note When this check box is checked, Cisco Unified Communications Manager ignores the settings in the Destination box and Calling Search Space.


Park Monitoring Forward No Retrieve External Voice Mail—Check this check box to use settings in the Voice Mail Profile Configuration window.


Note When this check box is checked, Cisco Unified Communications Manager ignores the settings in the Destination box and Calling Search Space.


Park Monitoring Forward No Retrieve External CSS—A calling search space comprises an ordered list of route partitions that are typically assigned to devices. Calling search spaces determine the partitions that calling devices search when they are attempting to complete a call.

Park Monitoring Forward No Retrieve Internal CSS—A calling search space comprises an ordered list of route partitions that are typically assigned to devices. Calling search spaces determine the partitions that calling devices search when they are attempting to complete a call.

Bulk Administration > User Device Profiles > User Device Profile Template—the following new fields are added to the User Device Profile Template Configuration page:

Park Monitoring Forward No Retrieve Destination External—When the parkee is an external party, then the call will be forwarded to the specified destination in the parker's Park Monitoring Forward No Retrieve Destination External parameter. If the Forward No Retrieve Destination External field value is empty, the parkee will be redirected to the parker's line.

Park Monitoring Forward No Retrieve Destination Internal—When the parkee is an internal party, then the call will be forwarded to the specified destination in the parker's Park Monitoring Forward No Retrieve Destination Internal parameter. If the Forward No Retrieve Destination Internal is empty, the parkee will be redirected to the parker's line.

Park Monitoring Reversion Timer—This parameter determines the number of seconds that Cisco Unified Communications Manager waits before prompting the user to retrieve a call that the user parked. This timer starts when the user presses the Park softkey on the phone, and a reminder is issued when the timer expires.

Default: 60 seconds


Note If you configure a non-zero value, this value overrides the value of this parameter set in the Service Parameters window. However, if you configure a value of 0 here, then the value in the Service Parameters window will be used.


Park Monitoring Forward No Retrieve Internal Voice Mail—Check this check box to use settings in the Voice Mail Profile Configuration window.


Note When this check box is checked, Cisco Unified Communications Manager ignores the settings in the Destination box and Calling Search Space.


Park Monitoring Forward No Retrieve External Voice Mail—Check this check box to use settings in the Voice Mail Profile Configuration window.


Note When this check box is checked, Cisco Unified Communications Manager ignores the settings in the Destination box and Calling Search Space.


Park Monitoring Forward No Retrieve External CSS—A calling search space comprises an ordered list of route partitions that are typically assigned to devices. Calling search spaces determine the partitions that calling devices search when they are attempting to complete a call.

Park Monitoring Forward No Retrieve Internal CSS—A calling search space comprises an ordered list of route partitions that are typically assigned to devices. Calling search spaces determine the partitions that calling devices search when they are attempting to complete a call.

Bulk Administration > Gateways > Gateway Template—The following field has been added to the Gateway FXS/FXO Port Configuration Settings page:

Hotline Device—Check this check box to make this device a Hotline device. Hotline devices can only connect to other Hotline devices. This feature is an extension of PLAR, which configures a phone to automatically dial one directory number when it goes off-hook. Hotline provides additional restrictions that you can apply to devices that use PLAR.
To implement Hotline, you must also create a softkey template without supplementary service softkeys, and apply it to the Hotline device.

Import/Export Updates

The Import/Export tool in BAT has the following new and updated list of entities on the Export Data page:

Bulk Administration > Import/Export > Export—The following new and updated fields can now be exported through the Export Data page under System Data:

Certificate

LDAP Custom Filter

Bulk Administration > Import/Export > Export—The following new and updated fields can now be exported through the Export Data page under Call Routing Data:

CCD Requesting Service

Hosted DN Group

Block Learned Patterns

Hosted DN Patterns

CCD Advertising Service

External Call Control Profile

Transformation Profile

Bulk Administration > Import/Export > Export—The following new and updated fields can now be exported through the Export Data page under User Data:

End User CAPF Profile

Bulk Administration > Import/Export > Export—The following new and updated fields can now be exported through the Export Data page under Advanced Features:

SAF Forwarder

SAF Security Profile

EMCC Remote Cluster

EMCC Intercluster Service Profile

VPN Profile

VPN Gateway

VPN Group

EMCC Feature Configuration