Installation and Upgrade Guide for Cisco Unified Intelligence Center Release 10.5(1)

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Book Contents
Find Matches in This Book
Available Languages
Download Options

Book Title

Installation and Upgrade Guide for Cisco Unified Intelligence Center Release 10.5(1)

Chapter Title

Upgrades and Migrations

Results

Updated:
November 25, 2015

Chapter: Upgrades and Migrations

Upgrades and Migrations

This section explains how to upgrade Unified Intelligence Center software with engineering specials, minor releases, and maintenance releases as they become available and to migrate an older version of Unified Intelligence Center Release 8.x to Unified Intelligence Center Release 9.x and higher running on a Virtual Machine.

An upgrade typically happens in place and requires no hardware change whereas a migration involves change in hardware. To continue with Upgrade, see About Upgrades. To continue with migration, skip the initial tasks in this section and start with About Migrations.

To upgrade, you must obtain the upgrade executable file and then apply it using Access Cisco Unified OS Administration.

About Upgrades

The upgrade takes less than one hour, and you can install upgrade software on your server while the system continues to operate.

Perform a DRS backup on the primary Unified Intelligence Center server. To access the DRS application, direct your browser to https://IP address of Unified Intelligence Center server:8443/drf. For more information, see the online help provided with the DRS application.

Before starting the software upgrade, back up your system data using the Disaster Recovery system application. For more information about backup, see the Administration Console User Guide for Cisco Unified Intelligence Center.

Upgrade and restart the Controller node first. Then upgrade and restart the members. All nodes must be on the same version of Unified Intelligence Center.

Two bootable partitions exist on your system: an active, bootable partition and an inactive, bootable partition. The system boots up and operates entirely on the partition that is marked as the active partition. Upgrade software installs on the inactive partition. The system continues to function normally on the active partition during the upgrade installation on the inactive partition.

When you are ready, you initiate a Switch Version action. You can do this using a CLI command utils system switch-version. You can also do it in the Cisco Unified OS Administration interface. The switch version action activates the inactive partition. The system reboots to the newly active (formerly inactive) partition that is running the new upgrade software. The pre-upgrade version of the software is in the inactive partition and remains there until the next upgrade.

Your configuration information moves automatically to the upgraded version in the active partition.

All configuration information in Unified Intelligence Center 8.x and 9.x releases are preserved across an upgrade to Unified Intelligence Center 10.5(1), except in the case of the following scenario:

Procedure
    Step 1   Upgrade from 8.x or 9.x to 10.5(1) and move all configuration information from 8.x or 9.x to 10.5(1).
    Step 2   Perform a switchback to 8.x or 9.x accordingly.
    Step 3   Log into Intelligence Center Administration page in 8.x or 9.x and make new configuration changes.
    Step 4   Switch over to 10.5(1), the new configuration changes are not migrated when you switch over.

    In the above scenario, if you make any configuration changes in an 8.x or 9.x release after a switchback, perform a full upgrade to Unified Intelligence Center 10.5(1) to reflect all the configuration changes.


    Note
    Database changes are stored on the database in the active partition. The database on the inactive partition does not get updated. If you make changes to the database after an upgrade and then decide to revert to the pre-upgrade software on the inactive partition, you must repeat those changes after switching the partition.

    Note

    Existing customers using VMware EXSi 4.x should first migrate to VMWare EXSi 5.1 or 5.5 before upgrading to Unified Intelligence Center 10.5(1).

    Download Unified Intelligence Center Upgrade File

    You might receive an upgrade file directly from Cisco Systems, but in most cases, you must download the file from the Cisco Systems Website.

    Note
    The download process on Cisco.com changes periodically. The following process was in place at the time this Installation doc was prepared.
    Procedure
      Step 1   Point your browser to the Download Software page for Cisco Unified Intelligence Center: http:/​/​software.cisco.com/​download/​type.html?mdfid=282163829&i=rm, and click the Unified Intelligence Center Software link.
      Step 2   Navigate to the folder and subfolder for the release you want.
      Step 3   Select the Unified Intelligence Center installer .iso file and click Download.
      Step 4   After successful log in, accept the license agreement and download/save the file to the desired location.
      Note   

      Do not rename the file before you install it, because if you do, the system will not recognize it as a valid file.

      Note   

      Do not unzip or untar the file. If you do, the system may not be able to read the upgrade files.

      Step 5   Make this file available on all nodes.

      Access Cisco Unified OS Administration

      To perform an upgrade from the Cisco Unified OS Administration application, perform the following steps:

      Procedure
        Step 1   Enter http://x.x.x.x/cmplatform, where x.x.x.x is the IP address of the node.
        Step 2   Sign in using the username and password of the system administrator account.
        Step 3   Select Software Upgrades > Install/Upgrade to display the Software Installation and Upgrade page.
        Figure 1. Software Upgrade Page

        Step 4   Select source: DVD/​CD or Remote Filesystem.

        Upgrade From DVD/CD

        Follow these steps if a DVD/CD is the source for your install/upgrade.

        Procedure
          Step 1   Prepare a writeable DVD and insert it into the disc drive on the server that is to be upgraded.
          Step 2   Select DVD/CD from the Source list on the Software Upgrades > Install/Upgrade page.
          Step 3   In the Directory field, enter the path to the upgrade file.

          If the file is in the root directory, enter a slash (/) in the Directory field.

          Step 4   To continue the upgrade process, click Next.
          Step 5   Choose the upgrade version that you want to install and click Next.
          Step 6   In the next window, monitor the progress of the download. If you encounter difficulties, see the Frequently Asked Questions About Installation section.
          Step 7   When the download completes, Click Next.
          Step 8   If you want to install the upgrade and automatically reboot to the upgraded partition, choose Reboot to upgraded partition. The system restarts running the upgraded software.
          Step 9   If you want to install the upgrade and then manually reboot to the upgraded partition at a later time, do the following:
          1. Choose Do not reboot after upgrade.
          2. Click Next. The Upgrade Status window displays the Upgrade log.
          3. When the installation completes, click Finish.
          4. To restart the system and activate the upgrade, choose Settings > Version, and then click Switch Version.

          The system restarts running the upgraded software.

          Step 10   Clear the browser cache before you start working on the new version of Unified Intelligence Center. For more information about clearing the cache, see your browser specific documentation.

          Upgrade From Remote Filesystem

          Follow these steps if Remote Filesystem is the source for your install/upgrade.

          Procedure
            Step 1   Choose Remote Filesystem from the Source list on the Software Upgrades > Install/Upgrade page.
            Step 2   Enter the path to the directory that contains the patch file on the remote system in the Directory field.

            If the upgrade file is on a Linux or Unix server, you must enter a forward slash at the beginning of the directory path. For example, if the upgrade file is in the patches directory, enter /patches. If the upgrade file is on a Windows server, check with your system administrator for the correct directory path.

            Step 3   In the Server field, enter the server name or IP address.
            Step 4   In the User Name field, enter your username on the remote server.
            Step 5   In the User Password field, enter your password on the remote server.
            Step 6   Select the transfer protocol from the Transfer Protocol field.
            Step 7   To continue the upgrade process, click Next.
            Step 8   In the next window, monitor the progress of the download. If you encounter difficulties, see the Frequently Asked Questions About Installation section.
            Step 9   When the download completes, click Next.
            Step 10   If you want to install the upgrade and automatically reboot to the upgraded partition, choose Reboot to upgraded partition. The system restarts running the upgraded software.
            Step 11   If you want to install the upgrade and then manually reboot to the upgraded partition at a later time, do the following:
            1. Choose Do not reboot after upgrade.
            2. Click Next. The Upgrade Status window displays the Upgrade log.
            3. When the installation completes, click Finish.
            4. To restart the system and activate the upgrade, choose Settings > Version, and then click Switch Version.

            The system restarts running the upgraded software.

            Note    It takes about half an hour to complete the Switch Version and the restart.
            Step 12   Clear the browser cache before you start working on the new version of Unified Intelligence Center. For more information about clearing the cache, see your browser specific documentation.

            Revert to Previous Version

            After upgrading, you can revert to the software version that was running before the upgrade, by restarting your system and switching to the software version on the inactive partition.

            You can do this in two ways. You can use the CLI command utils system switch-version on each node. You can also use the user interface in the Unified OS Administration.

            Follow these steps to revert using Unified OS Administration.


            Note
            All nodes must be running the same version of Unified Intelligence Center. Reverting is an all-or-none operation when you operate a cluster of Unified Intelligence Center nodes.
            Procedure
              Step 1   Open Unified OS Administration page entering the following URL: https://server-name/cmplatform, where server-name is the hostname or IP address of the node.
              Step 2   Sign in using the system administrator credentials.
              Step 3   Choose Settings > Version.

              This opens the Version Settings screen, which shows the software version on both the active and inactive partitions. To switch versions and restart, click Switch Versions. When the system restarts, it boots to the now-active (formerly inactive) partition with your migrated data in place.

              Note    It takes about half an hour to complete the Switch Version and the restart.

              About Migrations

              As part of the migration, you must first upgrade your old Unified Intelligence Center Release 8.x to Unified Intelligence Center Release 9.x and higher by following the steps in About Upgrades.

              After you successfully upgrade to Unified Intelligence Center Release 9.x and higher, you must back up your Unified Intelligence Center system data using the Disaster Recovery system application. For more information about backup, see the Administration Console User Guide for Cisco Unified Intelligence Center.

              This backed-up data is then restored on the Virtual Machine that has the latest version of Unified Intelligence Center installed.

              Back Up Data From Cisco Unified Intelligence Center Release 8.x or 9.x

              Perform the following tasks on the Unified Intelligence Center release 8.x or 9.x running on a MCS server that you want to migrate, to Unified Intelligence Center Release 10.0(1) running on a Virtual Machine.


              Note
              If you want to upgrade your previous release of Unified Intelligence Center to Release 10.0(1) on a virtual machine, you can do so by following the instructions in theAbout Upgrades section.
              Procedure
                Step 1   Navigate to the Disaster Recovery System. Log in to Cisco Unified Communications Manager Administration, choose Disaster Recovery System from the Navigation menu in the upper-right corner of the Cisco Unified Communications Manager Administration window, and click Go. The Disaster Recovery System Logon window appears.
                Step 2   Log in to the Disaster Recovery System by using the same administrator username and password that you use for Unified Communications OS Administration.
                Step 3   Use the Backup menu options to set up backup devices to take back up of your data.
                Step 4   Run a manual backup. You can select the features to back up in the Select Features section. For more information, see the online help for the Manual Backup window.
                Step 5   Note the host name and IP address of the system that you just backed up. Use the same host name and IP address when you create a Virtual Machine instance.
                Note    Be aware that your backup .tar files are encrypted by a randomly generated password. This password is then encrypted by using the cluster security password and is saved along with the backup .tar files. You must remember this security password or take a backup immediately after the security password change/reset.

                Step 6   Use the Backup History to confirm that the backup was completed without any errors. The Backup History window displays only the last 20 backup jobs.
                Caution    Be aware that if the backup to the remote server is not completed within 20 hours, the backup session times out. You must then begin a fresh backup.

                Installation of Cisco Unified Intelligence Center Release 10.5(1) Over Virtual Machine


                Note
                After you take backup successfully, shut down all of the Unified Intelligence Center nodes that must be migrated from physical hardware to a Virtual Machine.

                Note
                The new Virtual Machine instance should have the same Unified Intelligence Center version, hostname and IP address, as that of the machine from which you are migrating or else the DRF data restore will not be successful.

                For more information, see Preparations for Unified Intelligence Center installation on a Virtual Machine to install Unified Intelligence Center over a Virtual Machine.

                Restore Backed-Up Data on Cisco Unified Intelligence Center Virtual Machine

                After performing a back up of the data and configuration from the Unified Intelligence Center Release 9.x or higher running over physical hardware, you need to restore this on to the Virtual Machine running with Unified Intelligence Center Release 9.x or higher.

                In case of a multi-node cluster deployment, before you restore a cluster, make sure that all nodes in the cluster are up and communicating with the first node. You must perform a fresh install for the nodes that are down or not communicating with first node at the time of the restore.


                Note
                The new Virtual Machine instance should have the same Unified Intelligence Center version, hostname and IP address, as that of the machine from which you are migrating.

                Ensure that the Virtual Machine is up and running the latest version of Unified Intelligence Center by following the tasks mentioned in Install Unified Intelligence Center on Virtual Machine and Installation – all nodes.

                Procedure
                  Step 1   Navigate to the Disaster Recovery System.

                  The Disaster Recovery System Logon window displays.

                  Step 2   Log in to Cisco Unified Communications Manager Administration, choose Disaster Recovery System from the Navigation drop-down list box in the upper, right corner of the Cisco Unified Communications Manager Administration window, and click Go.
                  Step 3   Log in to the Disaster Recovery System by using the same Administrator username and password that you use for Cisco Unified Communications Operating System Administration.
                  Step 4   Navigate to the Backup > Backup Device.

                  The Backup Device List window displays.

                  Step 5   To configure a new backup device, click Add New.

                  The Backup Device window displays.

                  Step 6   Enter the backup device name in the Backup device name field.
                  Step 7   Choose Network Directory as the backup device and provide the details of the network shared location where the previously taken Unified Intelligence Center data backup is located. For details on how to take a data backup using DRF, see Back Up Data From Cisco Unified Intelligence Center Release 8.x or 9.x.
                  Step 8   To update these settings, click Save.
                  Step 9   Navigate to Restore > Restore Wizard. The Restore Wizard Step 1 window displays.
                  Step 10   In the Select Backup Device area, choose the backup device from which to restore the data.
                  Step 11   Click Next. The Restore Wizard Step 2 window displays.
                  Step 12   Choose the backup file that you want to restore.
                  Note    The backup filename indicates the date and time that the system created the backup file.
                  Step 13   Click Next. The Restore Wizard Step 3 window displays.
                  Step 14   Choose the features that you want to restore.
                  Note    Only the features that backed up to the file you chose appear. The existing license will not work on a Virtual Machine. You need to get a different license for the Virtual Machine, based on the licensing MAC. See Acquire your license for detailed steps on obtaining licenses.
                  Step 15   Click Next. The Restore Wizard Step 4 window displays.
                  Step 16   When you get prompted to choose the nodes to restore, choose all the nodes in the cluster.
                  Note    To know more about viewing the status of the restore, see the Viewing the Restore Status topic in the Online Help. Depending on the size of your database and the components that you choose to restore, the system can require a few hours to restore.
                  Step 17   Restart the Unified Intelligence Center virtual machine.
                  Note    Depending on the size of your database and the components that you choose to restore, the system can require a few hours to restore.
                  Step 18   When the restoration completes and the Percentage Complete field on the Restore Status window in the Disaster Recovery System shows 100 percent, begin rebooting the subsequent nodes in the cluster.
                  Step 19   When all the subsequent nodes have rebooted and are running the restored version of Cisco Unified Intelligence Center, reboot the first node.
                  Note    Database replication on the subsequent nodes may take an hour or more to complete after the publisher reboots, depending on the size of the cluster.
                  Step 20   Check the Replication Status value on all nodes by using the utils dbreplication status CLI command as described in the Administration Console User Guide for Cisco Unified Intelligence Center. The value on each node should be equal to 2.
                  Note    If replication does not set up properly, use the utils dbreplication reset CLI command as described in the Administration Console User Guide for Cisco Unified Intelligence Center.
                  Step 21   Log in to the Disaster Recovery System by using the same Administrator username and password that you use for Cisco Unified Communications Operating System Administration.
                  Step 22   Navigate to Restore > Status. The Restore Status window displays. The Status column in the Restore Status window shows the status of the restoration in progress, including the percentage of completion of the restore procedure.
                  Step 23   To view the restore log file, click the log filename link.

                  Was this Document Helpful?

                  FeedbackFeedback

                  Contact Cisco