Saumya Saxena

 New upgrade implementation starting in Cisco Unity Connection 8.6
 Upgrades from older versions of RHEL cannot be accomplished using the standard L2 upgrade process in Cisco Unity Connection
 Performs a “clean install” into the inactive partition, rather than installing to the inactive partition while the old version remains running
 Commonly referred to as an “RU” (or Refresh Upgrade)
Presentation_ID © 2011 Cisco and/or its affiliates. All rights reserved.
Cisco Confidential 2

 Requires a COP file to be installed prior to beginning the RU (without the
COP file, attempts to upgrade to 8.6 will be blocked from the start)
 Looks like a “clean install” when viewing local console of machine
 No switch-version (that the administrator will know about)
 Post-upgrade CLI / GUI question is changed (be careful of the default):
CLI – Do not automatically switch back to the previous version after the upgrade completes
Web – Do not reboot to the previous partition after the upgrade completes
 “Reconfiguration and Upgrade Guide for Cisco Unity Connection 8.x” will have more detailed information
© 2011 Cisco and/or its affiliates. All rights reserved.
Presentation_ID Cisco Confidential 3

 Export phase – exports all Informix databases, and some platform files, for use later on in the RU process (normally in /common on the hard drive, except for 7825-H3 and 7828-H3 platforms). This phase happens at the beginning of the upgrade process, before any reboots take place.
 Install phase – After the export phase completes, the machine reboots into the other partition, and begins to install the new version of Cisco
Unity Connection (including RHEL, etc.). This phase also may contain multiple reboots during its process.
 Import phase – After everything is installed, the previously-exported data will be imported back to the new install (DB content into Informix, platform files to the proper locations on the hard drive).
© 2011 Cisco and/or its affiliates. All rights reserved.
Presentation_ID Cisco Confidential 4

The following applies to standalone RU only:
 Most services will be offline for the entire duration of the RU
All administrative interfaces will be offline
All phone access (including voice message access) will be offline
 Plan on the server being offline for however long an L2 upgrade + switchversion would take on the system previously (as a rough estimate)
Presentation_ID © 2011 Cisco and/or its affiliates. All rights reserved.
Cisco Confidential 5

 RAID driver changing for these platforms in Cisco Unity Connection 8.6
(current HW RAID driver in existing versions is not supported in RHEL
5.5, with Connection 8.6)
 Part of RU for these platforms is a switch to a new software-based RAID driver that is supported in RHEL 5.5
 To switch the RAID driver, the existing HD content must be formatted
 External USB Drive Requirement: minimum 128GB (during Export
Phase, data will be put on this USB drive prior to the machine’s hard drives being formatted to use the new RAID driver).
Presentation_ID © 2011 Cisco and/or its affiliates. All rights reserved.
Cisco Confidential 6

 It is very important to make sure DRS backups are taken with these platforms prior to beginning any upgrades
 Reverting to older version after RU completes is not allowed (once the hard drive is formatted, there is no old version to revert back to anymore)
 Instead of revert, you can re-install old version, then restore from previous DRS backup
 In the event of an RU failure on these platforms, the machine may not be able to automatically revert back to the previous version (esp. if the hard drive is already been formatted)
Presentation_ID © 2011 Cisco and/or its affiliates. All rights reserved.
Cisco Confidential 7

 Subscriber must be online and running prior to beginning RU on publisher
(otherwise publisher RU will fail)
 Publisher must be completely upgraded and running prior to beginning
RU on subscriber (otherwise subscriber RU will fail)
 Duration of a cluster RU (both publisher, and subscriber) will be notably longer than previous L2 cluster upgrades (roughly equivalent to two RU back-to-back)
Subscriber will be expected to be online and functional for much longer while publisher is upgrading, and vice versa
Presentation_ID © 2011 Cisco and/or its affiliates. All rights reserved.
Cisco Confidential 8

 While the publisher is being upgraded:
All admin interfaces (and other services) on both publisher and subscriber are disabled
Phone interface on publisher disabled, still enabled on subscriber
Users can still access messages on subscriber through phone, no state changes are preserved!
Any phone messages left on subscriber during this process will not be delivered until subscriber RU is started
 While the subscriber is being upgraded:
Publisher is fully-functional, able to take messages and allow users to retrieve messages on all interfaces
Publisher will also deliver any messages from the subscriber while the publisher was being upgraded
Subscriber will pull down database from publisher, overwriting any local changes that took place while the publisher was upgrading (ex. changes to message read state)
 When the subscriber finishes its RU, the cluster should be restored, and the publisher will have primary role
© 2011 Cisco and/or its affiliates. All rights reserved.
Presentation_ID Cisco Confidential 9

 No voice messages left after upgrading to 8.6 will be migrated back to the previous version
 Any changes to greetings or voice names after upgrading to 8.6 will also not be migrated back to the previous version
 As before, any administrative changes (user adds, changes, deletes, etc.) after upgrading to 8.6 are also not migrated back to the previous version
Presentation_ID © 2011 Cisco and/or its affiliates. All rights reserved.
Cisco Confidential 10

 All logs on this slide will be located in /var/log/install on the machine
 system-history.log: contains previous version and new version information.
Also indicates whether upgrade succeeded or failed.
 install.log: platform install log file (grab the one with the latest timestamp in the file name). This is the main log documenting the upgrade procedure.
 cuc-export.log: contains the logged information from the execution of the
Connection Export Phase of the RU
 cuc-install.log: contains the logged information from the execution of the
Connection Install Phase of the RU
 cuc-import.log: contains the logged information from the execution of the
Connection Import Phase of the RU
© 2011 Cisco and/or its affiliates. All rights reserved.
Presentation_ID Cisco Confidential 11

 /var/log/active/cuc/informix.log: contains any logging from Informix to capture database-related changes during the upgrade
 When troubleshooting RU for a clustered install, be sure to gather the log sets from both the publisher and the subscriber
Presentation_ID © 2011 Cisco and/or its affiliates. All rights reserved.
Cisco Confidential 12

 03/21/2011 07:57:06 | root: Cisco Option Install ciscocm.refresh_upgrade_v0.8.cop Start
 03/21/2011 07:59:09 | root: Cisco Option Install ciscocm.refresh_upgrade_v0.8.cop Success
 03/21/2011 08:26:35 | root: Upgrade (refresh) 8.6.0.98000-54
Start
 03/21/2011 08:38:24 | root: Upgrade (refresh) 8.6.0.98000-54
Start-Install
 03/21/2011 08:49:37 | root: Boot 8.6.0.98000-54 Start
 03/21/2011 09:49:03 | root: Upgrade (refresh) 8.6.0.98000-54
Failure
 03/21/2011 09:51:03 | root: Boot 7.1.3.30000-1 Start
© 2011 Cisco and/or its affiliates. All rights reserved.
Presentation_ID Cisco Confidential 13

 03/23/2011 16:34:57 component_install| Execute
"/common/refresh_upgrade/Cisco/connection/scripts/ cuc-export RU Export
8.6.0.99091-9 8.5.1.10000-26 /common/component/connection /usr/local/cm/
/common/log/install/capture.txt"|<LVL::Debug>
 03/23/2011 16:57:11 component_install|(CAPTURE) Launching export|<LVL::Debug>
 03/23/2011 16:57:11 component_install|File:/common/download/8.6.0.99091-
9/Cisco/bin/component_install:798, Function: execute_shell_cmd(),
/common/refresh_upgrade/Cisco/connection/scripts/ cuc-export RU Export
8.6.0.99091-9 8.5.1.10000-26 /common/component/connection /usr/local/cm/
/common/log/install/capture.txt
failed (1)|<LVL::Error>
 03/23/2011 16:57:11 refresh_upgrade| Exiting with result 1 |<LVL::Info>
© 2011 Cisco and/or its affiliates. All rights reserved.
Presentation_ID Cisco Confidential 14

 2011-03-30 19:35:48 + echo 'Attempt to contact the subscriber server failed. Skipping restarting subscriber server services.'
2011-03-30 19:35:48 Attempt to contact the subscriber server failed. Skipping restarting subscriber server services.
2011-03-30 19:35:48 + echo 'Restoration of local server (publisher) to secondary server state completed.'
2011-03-30 19:35:48 Restoration of local server (publisher) to secondary server state completed.
2011-03-30 19:35:48 + recover_was_run=0
2011-03-30 19:35:48 + echo 'Recovery procedure from failed CUC data export done.'
2011-03-30 19:35:48 Recovery procedure from failed CUC data export done.
2011-03-30 19:35:48 + main_exit
2011-03-30 19:35:48 + rc=0
2011-03-30 19:35:48 + [[ 0 == 0 ]]
2011-03-30 19:35:48 + '[' 0 -ne 0 ']'
2011-03-30 19:35:48 + '[' 0 == 0 ']'
2011-03-30 19:35:48 + rc=1
2011-03-30 19:35:48 + '[' 1 '!=' 0 ']'
2011-03-30 19:35:48 ++ basename /common/refresh_upgrade/Cisco/connection/scripts/cuc-export
2011-03-30 19:35:48 + echo 'cuc-export failed.'
2011-03-30 19:35:48 cuc-export failed .
2011-03-30 19:35:48 ++ basename /common/refresh_upgrade/Cisco/connection/scripts/cuc-export
2011-03-30 19:35:48 ++ date '+%m/%d/%y %H:%M:%S'
2011-03-30 19:35:48 + echo 'cuc-export: The CUC export script ran at 03/30/11 19:35:48'
2011-03-30 19:35:48 cuc-export: The CUC export script ran at 03/30/11 19:35:48
2011-03-30 19:35:48 + exit 1
© 2011 Cisco and/or its affiliates. All rights reserved.
Cisco Confidential Presentation_ID 15

 TOI presentations from IPCBU for RU in CUCM: http://wwwineng.cisco.com/Eng/VTG/IPCBU/CUCM/CallManager_MontBlanc/Presentations/Mont
Blanc-Refresh-Upgrade-IR1-TOI.pptx
http://wwwineng.cisco.com/Eng/VTG/IPCBU/CUCM/CallManager_MontBlanc/Presentations/Mont
Blanc-Refresh-Upgrade-IR2-TOI.pptx
Presentation_ID © 2011 Cisco and/or its affiliates. All rights reserved.
Cisco Confidential 16