This chapter provides information to import configuration data to Cisco Unified Communications Manager using the Bulk Administration Menu.
You can only update the existing enterprise or service parameters using import/export. If your import .csv file has templates specific to IPMA, make sure that you run the IPMA wizard on the target server before you proceed with the import transaction.
You can import configuration data to
Cisco Unified Communications Manager using the Bulk Administration Menu.
To successfully import enterprise or service parameters, you must
update the parameter from the
Enterprise Parameter or
Service Parameter window in
Cisco Unified Communications Manager Administration from where it is being
imported. In this case, when you are in the
Enterprise Parameter or
Service Parameter window in
Cisco Unified Communications Manager Administration, click
Save without making any changes before you run
You can only update the existing enterprise or service parameters
using import/export. If some of the parameters are
missing in the database, importing the parameter fails.
You can use the
"Override the existing configuration" option to make BPS update an
item if it already exists on the server or insert the item if it does not. When
you import phones or User Device Profiles using the override option, the IP
phone services do not get updated but only get appended to the existing set of
Because there can be multiple IP Phone services with the same name
and there is no unique key to distinguish these services, Import/Export cannot
determine which service to update and appends the service instead.
Before You Begin
If your import .csv file has templates specific to IPMA, make sure
that you run the IPMA wizard on the target server before you carry out the
Select the .tar file name in the
File Name field and click
File Name drop-down list box lists all
uploaded .tar files.
Import Configuration section lists all the
components of the .tar file. Check the corresponding check boxes for the
options that you want to import.
To make BPS update the item if it exists and insert if it does
not, check the
Override the existing configuration check box.
Overriding the existing configuration is optional.
In case the files are modified, then the filename and the file
format must not be changed during the update.
You can click
Select All to select all the options at once,
Clear All to clear all selections.
Choose to run the job immediately or later by selecting the
corresponding radio button.
To create a job for importing the selected data, click
A message in the Status section lets you know that the job was
Use the Job Scheduler option in the
Bulk Administration main menu to schedule
and/or activate this job.
What to Do Next
You can use Override when you are running the same tar file with
corrections, after a failed job-run.
Cisco Unified Communications Manager server is created, there are database triggers
on the background which create entities such as Conference Bridge (CFB), Media
Termination point (MTP), and so on, automatically. These entities have names
like CFB_1, MTP_1, and so on.
When a user exports this information into a TAR file and imports it
to a different
Cisco Unified Communications Manager server, then the system creates items such as
CFB and MTP. The names on the new
Cisco Unified Communications Manager server may be consistent with the names before
import, or can be different.
Some entities in
Cisco Unified Communications Manager depend upon each other in such a way that one
cannot be imported without importing the other. Import/Export carries out the
import process for such entities in two stages:
The entity with the higher priority is imported first, with a
blank value for the supporting entity.
This occurs because the value of the supporting entity is not
available at the time.
After importing all the entities in the .tar, Import/Export
updates the higher priority entity with the value of the supporting entity to
complete the import process.
The value of the supporting entity becomes available in the next
Consider the following example to understand how cyclic
Device Pool and Media Resource Group List (MRGL)—Device Pool
(entity with the higher priority) gets imported first, with a blank value for
MRGL (supporting entity), because the value of MRGL is not available at the
time. After importing all the entities in the .tar file, Import/Export updates
Device Pool, replacing the blank value with the true value of MRGL to complete
the import process.
Consider the following entities as bound by cyclic
Device Pool and MRGL
Device Pool and Route Group
Partition and Time Schedule
Application User and User group
DEVICE POOL NAME,CISCO UNIFIED CALLMANAGER GROUP,DATE/TIME GROUP,REGION,SRST REFERENCE,CALLING SEARCH SPACE FOR AUTO-REGISTRATION,AAR CALLING SEARCH SPACE,DEVICE MOBILITY CALLING SEARCH SPACE,MEDIA RESOURCE GROUP LIST,LOCATION,NETWORK LOCALE,CONNECTION MONITOR DURATION,DEVICE MOBILITY GROUP,AAR GROUP,REVERTED CALL FOCUS PRIORITY,LOCAL ROUTE GROUP,CALLING PARTY TRANSFORMATION CSS,CALLED PARTY TRANSFORMATION CSS,INCOMING CALLING PARTY NATIONAL NUMBER PREFIX,INCOMING CALLING PARTY INTERNATIONAL NUMBER PREFIX,INCOMING CALLING PARTY UNKNOWN NUMBER PREFIX,INCOMING CALLING PARTY SUBSCRIBER NUMBER PREFIX,PHYSICAL LOCATION
Import/Export generates two logs files for every import of dependent
entities. The first log file indicates the status of insert of the first
entity; the other indicates whether the first entity was successfully updated
with the value of the supporting entity.
The following items are not supported on import or export:
Dial Plan Installer
Route Plan Report
MOH Audio Source
Fixed MOH Audio Source
MOH Audio File Management
Cisco Voice Mail Port wizard
Firmware load information
Import/Export does not support insert functionality for the following entities in the Cisco Unified Communications Manager database. You can only update/override these entities.
Cisco Unified CM
Annunciator/MOH Server—When a Cisco Unified Communications Manager server is created, database triggers create entities such as MOH server, annunciator, and so on. When you export this information into a TAR file and import it to a different Cisco Unified Communications Manager server, the system trigger creates items such as MOH server, annunciator, and so on. Import/Export supports only update of existing MOH server—server association/annunciator—server association. You can edit the TAR file to make sure that the csv file has the valid association before importing. Cisco recommends that you import the server first; then, based on the association created, you can edit the csv file and do an Import with Override.
Credential Policy Default
Certificate—Import/Export supports only update of existing certificates as new certificates cannot be created/uploaded from Cisco Unified Communications Manager Administration. Only the Duration in Cache parameter from the certificate can be updated.
Upgrade from Cisco Unified CallManager 4.x releases
Keep the following points in mind when you import entities
after an upgrade from Cisco Unified CallManager 4.x releases:
BAT supports Import/Export between the same versions of
Cisco Unified Communications Manager only. After the upgrade from a 4.x release of
Cisco Unified CallManager, make sure that you have the same
Cisco Unified Communications Manager version on both the source and target servers.
Some user groups associated to application users that are relevant
to the erstwhile Cisco Unified CallManager 4.x version that was running on the
source server before the upgrade, may not be relevant to the
Cisco Unified Communications Manager version running on the target server. Import
transaction for such user groups will fail.