Cisco Unified Communications Manager Bulk Administration Guide 7.0(1)
Importing Configuration
Downloads: This chapterpdf (PDF - 358.0KB) The complete bookPDF (PDF - 10.87MB) | Feedback

Importing Configuration

Table Of Contents

Importing Configuration

Log Files

Cyclic Dependency

Override Only

Upgrading from Cisco Unified CallManager 4.x Releases

Related Topics


Importing Configuration


To import configuration data to Cisco Unified Communications Manager using the Bulk Administration Menu, use the following procedure.


Note 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 import transaction.


Procedure


Step 1 Choose Bulk Administration > Import/Export> Import.

The Import Configuration window displays.

Step 2 Select the .tar file name in the File Name field and click Next.


Note The File Name drop-down list box lists all uploaded .tar files. For information on uploading the .tar file, refer to Chapter 2, "Uploading a File."


Step 3 The Import Configuration section lists all the components of the .tar file. Check the corresponding check boxes for the options that you want to import.

Step 4 To make BPS update the item if it exits, and insert if it does not, check the Override the existing configuration check box. Overriding the existing configuration is optional.


Note In case the files are modified, then the filename and the file format must not be changed during the update.


Step 5 You can click Select All to select all the options at once, and click Clear All to clear all selections.

Step 6 Choose to run the job immediately or later by selecting the corresponding radio button.

Step 7 To create a job for importing the selected data, click Submit.

A message in the Status section lets you know that the job was submitted successfully.

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


Note You can use Override when you are running the same tar file with corrections, after a failed job-run.



Log Files

Multiple log files are created for a single import transaction. One for the overall transaction, and one each for the items selected for import. The log file name is prepended with the item name, to make it easier to identify the logs. The log showing the overall transaction will have the job ID prepended.

These files can be accessed from the Job Scheduler page.

Cyclic Dependency

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:

1. The entity with the higher priority is imported first, with a blank value for the supporting entity.


Note This occurs because the value of the supporting entity is not available at the time.


2. 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.


Note The value of the supporting entity becomes available in the next cycle.


Example

Consider the following example to understand how cyclic dependency works:

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 dependency:

Device Pool and MRGL

Device Pool and Route Group

Partition and Time Schedule

Application User and User group

Sample Record

devicepool.csv

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

Branch_0000,CMG 1 Phones,Central,region_0001,Disable,NULL,NULL,NULL,Intrn_MRGL-1_Volkswagen Intn.,NULL,,-1,NULL,NULL,Default,NULL,NULL,NULL,Default,Default,Default,Default,NULL

mediaresourcegrouplist.csv

NAME,MEDIA RESOURCE GROUP 1,SORT ORDER 1

Intrn_MRGL-1_Volkswagen Intn.,,


Note Be aware that 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.


Override Only

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

LDAP System

Enterprise Parameters

Service Parameter

Mobility Configuration

Annunciator

MOH Server

Device Defaults

Credential Policy Default

Upgrading 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:

The entity names should be valid as per the naming conventions of the Cisco Unified Communications Manager version running on the target server. For Cisco Unified Communications Manager naming conventions, refer to the Cisco Unified Communications Manager Data Dictionary, Release 7.0(1).

Some user groups associated to application users that are relevant to the Cisco Unified CallManager 4.x version running on the source server, may not be relevant to the Cisco Unified Communications Manager version running on the target server. Import transaction for such user groups will fail.

Related Topics

Exporting Configuration, page 60-1

Editing the .tar File, page 60-5

Log Files

Override Only

Upgrading from Cisco Unified CallManager 4.x Releases

Finding a File, page 2-1

Downloading a File, page 2-2

Uploading a File, page 2-3

Deleting a File, page 2-3