This checklist gives you quick overview of all the steps you need to do for CUCM upgrade 11.5.x to 12.5.x. I will list existing resources available on the Internet and add few things from my experience.
Before making any changes, please consult with Cisco TAC or do your own research /testing in lab environment.
Please dont consider this as step by step guide and be open to possibility that I may have missed few points:
- I performed the upgrade few months ago so I might have forgot few things. I am human 🙂
- You may not have identical environment.
- You may even hit different issues which I didnt come across.
In short, I am not responsible for any disaster 🙂
Look for BRKUCC-2011 on Cisco live library, there are 2 prez/sessions contain all screenshots/details. Cisco live on demand library is very useful, informative and free. Just logon with your cco account or signup.
CD/DVD - we are mapping the ISO that we have. And here is the final VM profile for the CUCM: CUCM 10 step-by-step installation. After preparing your virtual machine there is nothing more left but to power it on. If you followed the instructions above, the hardware checks should pass flawlessly. CUCM 11.5 - Esxi 6.5 - unable to create VM September 25, 2018 Hi Guys Had an issue where I was unable to deploy a Cisco Unified Call Manager 11.5 OVA to the VMWare Esxi 6.5 standalone server.
Keep Official upgrade guide handy for exhaustive list:
Note – On CUCM12.5 SU2, we are facing the bug CSCth35648 ( and a few others), causing ITL issues.
Run this command and if you see the error on the last line, then you are facing the bug. Contact Cisco TAC as they need to fix the permission issue using the root account. Also a few other things maybe.
In version 12.X we expect to have itl and ctl signed by ITLRecovery cert, if you don’t see it then it also needs to be fixed.
Rather than explain in detail, I let you contact Cisco TAC with bug ID and then will help you with actions, based on your scenario/specific issue.
admin: show itl
“Failed or interrupted I/O operations.
Error parsing the ITL File.”
I work with Cisco Voice applications all the time so I wanted a lab environment where I could play around with the configurations and recreate scenarios and such. So below is how I installed CUCM version 10.5(2) onto VMware Workstation 11. Here is a video of the process outlined below. And the boot sector is usually content independent (i.e. You may extract the boot sector from CUCM 7.1.3 and inject it into 7.1.5). You may save the boot sector on your USB thumb drive and keep it handy. To extract/inject the boot sector, you need some disc image tools like UltraISO. (You may also use other ISO tools with similar features).
Pre-req
- Figure out your target version. Know your WHY. Check release notes for open bug / open security vulnerabilities.
- Check your Platform / server hardware compatibility with target version.
https://www.cisco.com/c/en/us/support/unified-communications/unified-communications-manager-version-12-5/model.html#CompatibilityInformation - Check your esxi version compatibility with target version. ( check BRKUCC-2011 prez).
- Check if any OVA template changes required ( RAM, CPU increase changes recommended or required).
https://www.cisco.com/web/software/283088407/145119/cucm.ova.README.pdf
https://docwiki.cisco.com/docwiki-eol.html#VMware_vSphere_ESXi_Version_Support_for_Call_Processing_and_System_Management_Applications - Check compatibility of other applications relying on CUCM/CUC/UCCX with target version ( SBC, Voice GW, 3rd party apps..).
- Check the list of Deprecated Phone models listed in document, if you have any, take care of that in advance ( upgrade, replacement ..).
- Migrate your ELM/PLM licensing to Smart licensing. Check Cisco live BRKUCC-2725 for more details.
- If you decide, Deploy CSSM in advance.
For some servers/devices only Smart licensing is the option after specific version ( e.g. CUCM 12.5.x) , for some its still optional ( UCCX 12.5.x).
In Plain English, With Smart licensing, Cisco sync your license status/inventory to cloud rather than PAK based/ tied to your device offline mode ( so no pain when you change general setting and license mac changes). You need to decide whether you want to sync your Infra devices to Cisco licensing portal directly ( device having internet access), via http proxy or you can deploy CSSM on prem ( lightweight VM) which can sync license from Cisco and with your infra ( Man in the middle 🙂 ).
Smart licensing goes beyond UC servers You can deploy 1 CSSM and use for entire Org. You will need to organize and clarify the Smart Account Structure in advance. Check Cisco live BRKUCC-2725 for more details.
Example – Top – Smart account = ABC.com
Sub level:
Virtual account = AP Collab
Virtual account = EU Collab
CSSM is simply a router/proxy which talks to internal devices with identifier and sync available licenses for your Smart accounts.
If you decide to use CSSM with Smart licensing, I suggest create a Smart account with Cisco and deploy/configure CCSM in advance then focus on license migration.
BRKUCC-2725 has all details on how to do license migration. If you get the error while doing the migration, open a case with licensing ( few times I got an error and licensing team helped doing from back end), they will deposit the licenses to your smart account. Probably you will need to provide, Smart account name, Smart account domain name, Virtual account name.
Plan your upgrade
- Plan your change window, open a change etc etc.
- Keep note that with RU upgrade, Server is down while upgrade is taking place on inactive partition. RU = refresh upgrade = Underlying Linux version is changing. Plan your downtime window accordingly.
- Decide your upgrade method – Direct or PCD. PCD = Prime Collaboration Deployment, VM you can deploy to orchestrate the migration/upgrades for you.
- Download the Software images and keep on sftp server. Notice the difference in between Restricted VS Unrestricted version, use the correct image.
https://software.cisco.com/download/home/286322286/type/286319236/release/12.5(1)SU3 - Keep a OVA file/ bootable image of your existing version on sftp just in case you will need to rebuild the server. If you have Enterprise Agreement with Cisco, you can download by yourself or else, open a Cisco TAC and ask for images.
Bootable images arent available/same under download page.
From 12.x CUCM and Unity connection ISO are separate. - Either verify that you have rights to deploy new VM or keep your team ready who can create a new VM in change window, if you have to rebuild a server ( worst case scenario).
- If your server has a uptime of more than 365 days, Its nice to plan and give it a reboot in advance to your upgrade.
- Verify you have rights to remove existing/old VM snapshots before upgrade.
- Verify the free space. You will need ~43 GB space. Some ways to clean space are:
Run a cop file which cleanup the space( may need to do in downtime). Ask Cisco TAC before you do it, it might delete your inactive partition sw.
Reduce the log size.
https://www.cisco.com/c/en/us/support/docs/unified-communications/unified-communications-manager-callmanager/200581-Procedure-to-Adjust-WaterMark-in-RTMT-of.html
Delete unused load files from CUCM O.S admin –> load management. - Open a Cisco TAC case for support in advance and inform them to requeue the case to engineer who is available in your change window. Put basic details about what you are doing in that case, it will save your time in change window.
Note that you may need to call TAC frontline and may or may not need to raise a Sev in change window as Cisco TAC could be busy with multiple cases. - Read the upgrade guide carefully.
- Review the Recommended Sequence in advance from upgrade doc. See some notes here:
Publisher node MUST be Upgraded first.
Switchover options depends on the collaboration product.
CUCM Publisher can be switched over before Subscriber(s) Upgrade Startup.
DRU Only –> Switchover IM&P Publisher after CUCM Cluster Database Replication Completes.
CUC Publisher must NOT be switched over before Subscriber Upgrade Completes. - Try the upgrade in lab/ Pre-pod to avoid any surprises.
- Prepare your test plan in advance. What you are gonna test and how are you gonna test it.
1 day before or in same change window
- Verify/take your fresh backup. Back Up Custom Ringtones and Background Images.
- Ensure SFTP is up. Please use SFTP in same location to CUCM to minimize the delay( upgrade iso is ~4G).
- Keep your O.S /Cluster password and SFTP password handy.
In change window ( Pre-upgrade tasks)
- Run Pre-upgrade check cop file. It checks many pre-req but common issue you may see is NTP/Free space/Expire cert/ Simple password, fix issues before upgrade.
If you are using Win NTP or Stratum 4 or above, you may see error. Fix your cert. Change of password. Check upgrade guide for more. - Verify your backup. Take details/screenshots of registered device count/ VG/ SIP trunks.
- Make VM/OVA related changes RAM/CPU if needed.
- Change VM compatibility. CUCM 12.5 needs ESXi 6.5 ( 13). Note that once you change, you might not be able to roll this back.
- Change Guest OS type. See the doc, you will nee to change it to CentOS 7 (64 bit). Its under VM general setting, if its greyed out maybe because you need to shutdown the server first. Should be done before CUCM upgrade.
- Change adapter type to VMXNet3 ( if its not already).
- Update to the latest Vmware tools.
- Remove old VM snapshots.
Upgrade
- You can disable TFTP services and do few other tweaks mentioned in document to expedite/smooth the upgrade.
- Do the upgrade from O.S admin. Follow the seq mentioned in doc ( Upgrade Pub –> Sub1 –> Sub2 …, Switch version Pub –> Sub1 –> Sub2 ..). Be aware of some known issues, with CUC, even if you select do not reboot after upgrade, it might 🙂
For CUC, you may need to run a pre-req cop file as ISO file is changing. Ask TAC.
When you do uccx es release, verify the procedure from the doc, it maybe recommended to do from cli ( as there maybe known issue with tomcat).
Note – In RU, DB replication may take some time, be patient or ask TAC.
Post upgrade
- Run the post upgrade COP.
- Reset any parameters you changed to optimize the upgrade ( TFTP, enterprise parameters). Check upgrade doc for more details.
- Upgrade your RTMT.
- Check Device count/ Trunk/ Vg status.
- Check all the services. Check all the integration ( CCX, CUC …)
- Optional : Switch from Native to Open Vmware Tools via OS Admin CLI –> utils vmtools switch open
- Change Transport Settings for CUCM for Smart Licensing ( you can find the URL from CSSM or from doc or google it).
Common issue you might face is DNS resolution for CSSM , so use IP address and port 80. If your DNS and Cert is all good then it could be different issue, like reachability ( IP/Port). - Create or copy existing registration token from CSSM or Smart Software Manager satellite server to CUCM.
- Do your usual testing.
If you find have any feedback, suggestions, please feel free to put the comment or DM me on LinkedIn.
For whatever reason, Cisco only post 'non-bootable' ISO images on CCO for download. In some urgent situations, you might need a bootable disc to recover the system (or your client/boss would shoot you in the head). Here's the procedure to make a non-bootable ISO image bootable.Before you continue, be aware that this procedure is NOT approved by Cisco. Neither Cisco nor I will be responsible for any loss caused by this.
Any bootable disc has to follow 'El Torito' specification. No exception for Cisco discs. The only difference between a bootable disc and non-bootable disc is the 'boot sector'. Thus the solution is very simple - extract the boot sector from a bootable disc and inject it into a non-bootable disc.
The boot sector is a very small file (usually less than 10k). And the boot sector is usually content independent (i.e. you may extract the boot sector from CUCM 7.1.3 and inject it into 7.1.5). You may save the boot sector on your USB thumb drive and keep it handy.
To extract/inject the boot sector, you need some disc image tools like UltraISO. (You may also use other ISO tools with similar features)
Step 1: Get the boot file
There are two ways to get a boot file - extract from the DVD's file system (regardless bootable or not) or extract from a bootable DVD's boot sector.
Option 1: Extract from DVD's file system (regardless bootable or not)
Cucm 11.5 Sftp
This option is preferred as you don't have to find another bootable disc or ISO file.The boot file should be available on any CUCM DVD, regardless bootable or not. It is located in the 'isolinux' folder. File name is isolinux.bin.
Extract and save the isolinux.bin file to your hard drive. We'll need to use that later.
Option 2: Extract the boot sector from a bootable DVD
If for some reason, you were not able to find/extract the isolinux.bin file, you may extract the boot file from a bootable disc (or ISO image).
Put a bootable CUCM disc into the DVD drive and launch UltraISO. Go to menu 'Bootable > Extract Boot File from CD/DVD...'
Save the file to your hard drive as a 'boot info file' (bif). In our example, we call it 'boot.bif'
Step 2: Inject the boot file
Open the non-bootable image in UltraISO. Go to menu 'Bootable'. Make sure 'Generate Bootinfotable' was checked (it will NOT work without this option). Then choose 'Load Boot File...'.
Cucm 11.5 Su7
Choose the boot file we saved before (isolinux.bin or boot.bif).Cucm 11.5 Iso Download Free
Note that the image type changed to 'Bootable'.
Now, you may go to 'File > Save As' to save the bootable image to an ISO file. Then you may burn the ISO to a disc with your favorite disc burner software.