Upgrading Cisco UCS Director Express for Big
Data, Release 2.0
This chapter contains the following sections:
• Supported Upgrade Paths to Cisco UCS Director Express for Big Data, Release 2.0, page 1 • Upgrading a Single Node Cisco UCS Director Express , page 2
Supported Upgrade Paths to Cisco UCS Director Express for
Big Data, Release 2.0
The upgrade path to Cisco UCS Director Express for Big Data, Release 2.0 depends upon your current version of Cisco UCS Director Express for Big Data.
The following are the supported upgrade paths for Cisco UCS Director Express for Big Data, Release 2.0.
From Release 5.3.1.0 and onwards, the upgrade checks for valid target paths and will upgrade only if the upgrade path from the appliance version and target version is supported.
Note
Upgrade Paths for Release 5.3.x.x Platform •From Release 5.3.0.0 to Release 5.4
•From Release 5.3.0.1 to Release 5.4
•From Release 5.3.0.2 to Release 5.4
•From Release 5.3.1.0 to Release 5.4
•From Release 5.3.1.1 to Release 5.4
•From Release 5.3.1.2 to Release 5.4
Upgrade Paths for Release 5.2.x.x Platform
•From Release 5.2.0.0, you must first upgrade to Release 5.3.0.x, 5.3.1.x, or 5.3.2.x
•From Release 5.2.0.1, you must first upgrade to ,Release 5.3.0.x, 5.3.1.x, or 5.3.2.x
•From Release 5.2.0.2, you must first upgrade to Release 5.3.0.x, 5.3.1.x, or 5.3.2.x
•From Release 5.2.0.2A, you must first upgrade to Release 5.3.0.1 or greater, 5.3.1.x, or 5.3.2.x
•From Release 5.2.0.3, you must first upgrade to Release 5.3.1.2 or 5.3.2.x
Upgrading a Single Node Cisco UCS Director Express
Preparing a Single Node Cisco UCS Director Express for Big Data, Release
1.1 VM for Upgrade
Step 1 In your hypervisor, take a snapshot of the VM before you begin the upgrade.
Step 2 Log in to your Cisco UCS Director Express for Big Data, Release 1.1 appliance, using ShellAdmin.
Step 3 In the Shell Admin, stop all services as follows: a) ChooseStop servicesto stop all services.
b) ChooseDisplay services statusto verify that all services are stopped.
Step 4 If your current version of Cisco UCS Director Express for Big Data is not supported for upgrade, you must upgrade to Release 5.3.0.0, 5.3.0.1, 5.3.0.2, 5.3.1.0, 5.3.1.0, 5.3.1.2, or 5.3.2.0.
For information about how to upgrade from previous releases of Cisco UCS Director Express for Big Data, see the
installation and upgrade guide for that release.
Step 5 In the Shell Admin, chooseManage Root Accessand enable root access.
Step 6 If you want to use the same IP address for the Release 2.0 VM, reconfigure the Release 1.1 VM with a temporary IP address.
The temporary IP address must be in the same subnet and reachable from the Release 2.0 VM to which you are assigning the original IP address. If the new VM cannot reach the old VM, the migration script will fail.
Note
If Release 5.3.x.x VM cannot communicate to Release 5.4, perform an offline migration. SeeUpgrading Cisco UCS Director to Release 5.4 Offline
Upgrading Cisco UCS Director Express for Big Data, Release 2.0 Upgrading a Single Node Cisco UCS Director Express
Upgrading a Single Node Cisco UCS Director Express for Big Data to Release
2.0
Do not perform the following operations on either the Release 1.1 VMs or the Release 2.0 VMS during the migration of data. These operations can cause the migration to fail and you will need to start again.
Caution
•Stop Cisco UCS Director Express for Big Data services on any node.
•Start Cisco UCS Director Express for Big Data services on any node.
•Stop the Cisco UCS Director Express for Big Data databases.
•Start the Cisco UCS Director Express for Big Data databases.
•Close the SSH session.
•Press Ctrl+c to abort the migration.
Before You Begin
Complete the steps inPreparing a Single Node Cisco UCS Director Express for Big Data, Release 1.1 VM for Upgrade, on page 2
Step 1 Download the Cisco UCS Director Express for Big Data, Release 2.0 software.
Step 2 Deploy a VM and install Cisco UCS Director Express for Big Data, Release 2.0.
If you want to use the IP address that was assigned to the Release 1.1 VM, use the Shell Admin to configure the Release 2.0 VM with that IP address.
Step 3 In the Shell Admin on the Release 2.0 VM, chooseManage Root Accessand enable root access for that VM.
Step 4 Log in to the Release 2.0 VM as root.
Step 5 On the Release 2.0 VM, run/opt/infra/migration/performMigration.shto migrate the database and configuration files from the Release 1.1 VM to the Release 2.0 VM.
When prompted, provide the IP address of the Release 1.1 VM. The script performs the following tasks:
•Backs up the database on the Release 1.1 appliance and restores it on the Release 2.0 appliance.
•Determines the Release 1.1 version and executes the database upgrade scripts.
Upgrading Cisco UCS Director Express for Big Data, Release 2.0
Step 6 Complete any manual steps required for your installation as described inCompleting the Upgrade to Cisco UCS Director Express for Big Data, Release 2.0 , on page 4.
Step 7 In the Shell Admin, choose theStart Servicesoption to start the Cisco UCS Director Express for Big Data services and complete the process.
Step 8 Log in to Cisco UCS Director Express for Big Data. chooseAdministration>License>License Keys, and click Manage Personolities.
Step 9 In thePersonolity Configurationdialog box, check theUCSDcheck box if required, orBig Datacheck box and click Submit.
Step 10 In the Shell Admin, choose theStop Servicesoption to stop the Cisco UCS Director Express for Big Data services and complete the process.
Step 11 In the Shell Admin, choose theStart Servicesoption to start the Cisco UCS Director Express for Big Data services and complete the process.
Step 12 Log in to the Cisco UCS Director Express for Big Data, Release 2.0 VM as an admin and verify that all the data from the Release 1.1 VM has been migrated successfully.
Step 13 Apply newly acquired licenses (premium license, if any) for Cisco UCS Director Express for Big Data.
Completing the Upgrade to Cisco UCS Director Express for Big Data, Release
2.0
The migration script cannot anticipate all operating system level customizations that you might have performed on the Cisco UCS Director Express for Big Data, Release 1.1 VM. You must, therefore, ensure that all customizations are duplicated in your Cisco UCS Director Express for Big Data, Release 2.0 VM.
All of the following steps are optional. Complete them only if you customized or otherwise changed the defaults for the specified file. If you made any changes to file and folders that are not listed below, ensure that you also copy or merge those files from the Cisco UCS Director Express for Big Data, Release 1.1 VM to the Release 2.0 VM.
Note
Before You Begin
Complete the steps inUpgrading a Single Node Cisco UCS Director Express for Big Data to Release 2.0, on page 3.
Upgrading Cisco UCS Director Express for Big Data, Release 2.0 Completing the Upgrade to Cisco UCS Director Express for Big Data, Release 2.0
•mysql tuning in/etc/my.cnf
•Changes in the following properties files:
•/opt/infra/client/service.properties •/opt/infra/inframgr/service.properties •/opt/infra/idaccessmgr/service.properties
•/opt/infra/web_cloudmgr/apache-tomcat/bin/service.properties •/opt/infra/controller/service.properties
•/opt/infra/eventmgr/service.properties
•/opt/infra/networkServices/service.properties •/opt/infra/usageMgr/service.properties
•/opt/infra/inframgr/hyperv.properties
You need to change the properties file only if it has been changed in a previous release. The default properties in Release 2.0 are not changed from previous releases.
Note
Step 5 Migrate the contents from the/opt/infra/uploadsfolder.
This folder contains any files and OVFs uploaded from the Cisco UCS Director Express for Big Data user interface.
Step 6 If HTTPS login mode is required, re-configure the Release 2.0 appliance once data migration is complete.
Step 7 Migrate the CA certificate to the Release 2.0 by importing the certificates to the Release 2.0 appliance.
Step 8 If necessary, reconfigure the Shell Admin and root passwords.
What to Do Next
Post migration, you need to create the Hadoop Cluster Configuration Parameters Template so that you can configure the Hadoop Cluster Profile templates before cluster creation.
Note
Upgrading Cisco UCS Director Express for Big Data, Release 2.0
Upgrading Cisco UCS Director Express for Big Data, Release 2.0 Completing the Upgrade to Cisco UCS Director Express for Big Data, Release 2.0