- Preface
-
- Manage User Device Profiles
- User Device Profile Templates
- User Device Profile File Format
- User Device Profile File Format Addition
- User Device Profile Validation
- UDP Generation
- User Device Profile Updates
- User Device Profile Deletions
- User Device Profile Exports
- Line Attribute Updates for Devices and User Device Profiles
- UDP Line Additions
- UDP Report Generation
- Intercom DN Additions and Updates for UDPs
- Text-Based CSV Files
- BAT Performance
- Index
Manage Phone Migration
This chapter provides information to use the Phone Migration feature in Cisco Unified Communications Manager Bulk Administration Tool to migrate phones from one type to another in bulk. You can access the Phone Migration submenu from the Bulk Administration menu of Cisco Unified Communications Manager.
Phone Migration Considerations
A text-based CSV data file is used to migrate phones. You can create the CSV data file using either the BAT spreadsheet or a text editor.
Some limitations to keep in mind while migrating phones are:
-
Migrating to a phone with fewer speed dials or lines will not remove lines or speed dials. However, some of the lines/speed dials will no longer show up on the phone. You can still find all of the original lines/speed dials on the phone configuration page.
-
Even migrating to a newer phone can cause loss of features like in the case of moving from SIP to SCCP or vice versa.
-
Only existing phones can be migrated. If you enter a non-existing device in the CSV file, the system displays an error message.
-
If the phone gets migrated successfully, the old phone will be updated with the new phone settings.
-
If you select the reset or restart option, the new phone would be reset.
Create CSV Data Files for Phone Migration Using BAT Spreadsheet
You can use the BAT spreadsheet to create the CSV data file that contains the details for phone migration.
After you have finished editing the fields in the BAT spreadsheet, you can export the content to a CSV formatted data file. A default filename is assigned to the exported CSV formatted data file:
PhoneMigration#timestamp.txt
where "timestamp" represents the precise date and time that the file was created.
![]() Note | If you enter a comma in one of the fields, BAT.xlt encloses that field entry in double quotes when you export to BAT format. If you enter a blank row in the spreadsheet, the system treats the empty row as the end of the file. The system does not convert data that is entered after a blank line to the BAT format. |
What to Do Next
Upload the CSV data file to the first node of the Cisco Unified Communications Manager server so BAT can access the data input file.
Migrate Phones
Use the Phone Migration feature in BAT to migrate phones in bulk.
- You must have a data file in comma separated value (CSV) format that contains device name of the phone that you wish to migrate, the MAC address for the new phone, and the description for the new phone.
- You must have a phone template of a specific type, and the protocol you wish to use for migration configured and ready.
- Upload the data files by choosing the relevant target and function for the transaction.
| Step 1 | Choose . The Phone Migration Configuration window displays. |
| Step 2 | You can choose to reset or restart phones by selecting the appropriate radio button from the Reset/Restart Information section. Don’t Reset/Restart phones is the default setting. |
| Step 3 | In the Phone Migration Information section, from the File Name drop-down list box, choose the file that you uploaded. |
| Step 4 | From the Phone Template Name drop-down list box, choose the phone template that you wish to use for migration. |
| Step 5 | In the Job Information section, enter a description for the job. The default description specifies Phone Migration. |
| Step 6 | You can choose to run the job immediately or later by selecting the corresponding radio button. |
| Step 7 | To create a job for migrating phones, click Submit. |
| Step 8 | A warning message informing you of a possible loss of features/data displays. Do one of the following: A message in the Status section lets you know that the job was submitted successfully. |
| Step 9 | Use the Job Scheduler option in the Bulk Administration main menu to schedule and/or activate this job. |

Feedback