Cisco UCS Director Express for Big Data Installation Guide on
VMware vSphere, Release 2.0
First Published: November 03, 2015
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,
INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH
THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,
CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version
of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS.
CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT
LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network
topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional
and coincidental.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http://
www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1110R)
© 2015
Cisco Systems, Inc. All rights reserved.
CONTENTS
Preface
Preface v
Audience v
Conventions v
Related Documentation vii
Documentation Feedback vii
Obtaining Documentation and Submitting a Service Request vii
CHAPTER 1
Overview 1
Cisco UCS Director Express for Big Data 1
Cisco UCS Integrated Infrastructure for Big Data 1
Supported Hadoop Distributions 2
Cisco UCS Director Express for Big Data for VMware vSphere 2
Prerequisites 2
About Licenses 3
Fulfilling the Product Access Key 3
CHAPTER 2
Installing Cisco UCS Director Express for Big Data 5
Installing Cisco UCS Director Express for Big Data on VMware vSphere 5
Changing the Default Password 7
Updating the License 8
Reserving System Resources 8
Changing the Maximum Packet Size 8
Configuring the Network Interface using Shelladmin 9
CHAPTER 3
Restarting Cisco UCS Director Express for Big Data 11
Restarting Cisco UCS Director Express for Big Data 11
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
iii
Contents
CHAPTER 4
Upgrading Cisco UCS Director Express for Big Data, Release 2.0 13
Supported Upgrade Paths to Cisco UCS Director Express for Big Data, Release 2.0 13
Upgrading a Single Node Cisco UCS Director Express 14
Preparing a Single Node Cisco UCS Director Express for Big Data, Release 1.1 VM for
Upgrade 14
Upgrading a Single Node Cisco UCS Director Express for Big Data to Release 2.0 15
Completing the Upgrade to Cisco UCS Director Express for Big Data, Release 2.0 16
CHAPTER 5
Upgrading Cisco UCS Director Express for Big Data 19
Supported Upgrade Paths for Cisco UCS Director Express for Big Data 19
Upgrading to Cisco UCS Director Express for Big Data, Release 2.0 19
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
iv
Preface
• Audience, page v
• Conventions, page v
• Related Documentation, page vii
• Documentation Feedback, page vii
• Obtaining Documentation and Submitting a Service Request, page vii
Audience
This guide is intended primarily for data center administrators who use Cisco UCS Director Express for Big
Data and who have responsibilities and expertise in one or more of the following:
• Server administration
• Storage administration
• Network administration
• Network security
• Virtualization and virtual machines
Conventions
Text Type
Indication
GUI elements
GUI elements such as tab titles, area names, and field labels appear in this font.
Main titles such as window, dialog box, and wizard titles appear in this font.
Document titles
Document titles appear in this font.
TUI elements
In a Text-based User Interface, text the system displays appears in this font.
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
v
Preface
Conventions
Text Type
Indication
System output
Terminal sessions and information that the system displays appear in this
font.
CLI commands
CLI command keywords appear in this font.
Variables in a CLI command appear in this font.
Note
Tip
[]
Elements in square brackets are optional.
{x | y | z}
Required alternative keywords are grouped in braces and separated by vertical
bars.
[x | y | z]
Optional alternative keywords are grouped in brackets and separated by vertical
bars.
string
A nonquoted set of characters. Do not use quotation marks around the string or
the string will include the quotation marks.
<>
Nonprinting characters such as passwords are in angle brackets.
[]
Default responses to system prompts are in square brackets.
!, #
An exclamation point (!) or a pound sign (#) at the beginning of a line of code
indicates a comment line.
Means reader take note. Notes contain helpful suggestions or references to material not covered in the
document.
Means the following information will help you solve a problem. The tips information might not be
troubleshooting or even an action, but could be useful information, similar to a Timesaver.
Caution
Means reader be careful. In this situation, you might perform an action that could result in equipment
damage or loss of data.
Timesaver
Means the described action saves time. You can save time by performing the action described in the
paragraph.
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
vi
Preface
Related Documentation
Warning
IMPORTANT SAFETY INSTRUCTIONS
This warning symbol means danger. You are in a situation that could cause bodily injury. Before you
work on any equipment, be aware of the hazards involved with electrical circuitry and be familiar with
standard practices for preventing accidents. Use the statement number provided at the end of each warning
to locate its translation in the translated safety warnings that accompanied this device.
SAVE THESE INSTRUCTIONS
Related Documentation
Cisco UCS Director Documentation Roadmap
For a complete list of Cisco UCS Director documentation, see the Cisco UCS Director Documentation
Roadmap available at the following URL: http://www.cisco.com/en/US/docs/unified_computing/ucs/
ucs-director/doc-roadmap/b_UCSDirectorDocRoadmap.html.
Cisco UCS Documentation Roadmaps
For a complete list of all B-Series documentation, see the Cisco UCS B-Series Servers Documentation Roadmap
available at the following URL: http://www.cisco.com/go/unifiedcomputing/b-series-doc.
For a complete list of all C-Series documentation, see the Cisco UCS C-Series Servers Documentation Roadmap
available at the following URL: http://www.cisco.com/go/unifiedcomputing/c-series-doc.
Note
The Cisco UCS B-Series Servers Documentation Roadmap includes links to documentation for Cisco
UCS Manager and Cisco UCS Central. The Cisco UCS C-Series Servers Documentation Roadmap includes
links to documentation for Cisco Integrated Management Controller.
Documentation Feedback
To provide technical feedback on this document, or to report an error or omission, please send your comments
to [email protected]. We appreciate your feedback.
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a service
request, and gathering additional information, see What's New in Cisco Product Documentation, at: http://
www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html.
Subscribe to What's New in Cisco Product Documentation, which lists all new and revised Cisco technical
documentation as an RSS feed and delivers content directly to your desktop using a reader application. The
RSS feeds are a free service.
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
vii
Preface
Obtaining Documentation and Submitting a Service Request
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
viii
CHAPTER
1
Overview
This chapter contains the following sections:
• Cisco UCS Director Express for Big Data, page 1
• Cisco UCS Director Express for Big Data for VMware vSphere, page 2
• Prerequisites, page 2
• About Licenses, page 3
• Fulfilling the Product Access Key, page 3
Cisco UCS Director Express for Big Data
Cisco UCS Director Express for Big Data provides a single touch solution that automates deployment of Big
Data infrastructure and provides a single management pane across both physical infrastructure and Hadoop
software. It supports key Hadoop distributions including Cloudera, MapR, and Hortonworks.
Cisco UCS Director Express for Big Data delivers end-to-end automation of Hadoop cluster deployment that
allows you to spin up and expand clusters on-demand. Configuration of the physical infrastructure, which
includes compute, internal storage, network, and installation of operating system, Java packages, Hadoop
along with provisioning of Hadoop services are handled automatically with minimal user input. This is achieved
through the innovative Cisco UCS service profiles wherein both the physical infrastructure and Hadoop
configuration are incorporated into a Hadoop cluster deployment profile.
Cisco UCS Integrated Infrastructure for Big Data
Cisco UCS Integrated Infrastructure for Big Data is an industry leading architecture designed to meet a variety
of Big Data workloads. It scales as processing and storage needs grow without increasing management
challenges and delivers predictable performance along with reduced total cost of ownership (TCO).
Cisco UCS Integrated Infrastructure is comprised of the following components:
• Cisco UCS Fabric Interconnects
• Cisco UCS 2200 Series Fabric Extenders
• Cisco UCS C-Series Rack-Mount Servers
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
1
Overview
Supported Hadoop Distributions
• Cisco UCS Virtual Interface Cards (VICs)
• Cisco UCS Manager
You can read more about the Cisco UCS Integrated Infrastructure for Big Data in the Data Center Designs
Cloud Computing - Design Zone for Big Data .
Supported Hadoop Distributions
Cisco UCS Director Express for Big Data supports the following Hadoop distributions:
• Cloudera 5.4
• MapR 3.1, 4.0, 4.1, and 5.0
• Hortonworks 2.1, 2.2, and 2.3
Table 1: Java and JDK Software for Hadoop Distributions
Hadoop Distribution
Supported Hadoop Distribution
Versions
Installed Java and JDK
Cloudera
5.0.1, 5.0.6, 5.2.0, 5.2.1, 5.3.0, and oracle-j2sdk1.7
5.4.1
MapR
3.1.1, 4.0.1, 4.0.2, 4.1.0, and 5.0.0 java-1.7.0-openjdk
Hortonworks
2.1, 2.2, and 2.3
java-1.7.0-openjdk
Cisco UCS Director Express for Big Data for VMware vSphere
Cisco UCS Director Express for Big Data can be hosted on VMware vSphere or vCenter.
Note
The appliance and boot-up logs are located in the /var/log/ucsd directory.
• install.log contains the one time appliance installation logs.
• bootup.log contains the appliance boot-up sequence information, such as startup messages for
the database and infrastructure services.
Prerequisites
• Installation of VMware vSphere or vCenter
• Configured system administrator privileges
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
2
Overview
About Licenses
• Cisco UCS Director Express for Big Data deployed on a VMware vSphere or vCenter host
About Licenses
You must obtain a license to use Cisco UCS Director Express for Big Data, as follows:
1 Before you install Cisco UCS Director Express for Big Data, generate the Cisco UCS Director Express
for Big Data license key and claim a certificate (Product Access Key).
2 Register the Product Access Key (PAK) on the Cisco software license site, as described in Fulfilling the
Product Access Key, on page 3.
3 After you install Cisco UCS Director Express for Big Data, update the license in Cisco UCS Director
Express for Big Data as described in Updating the License, on page 8.
4 After the license has been validated, you can start to use Cisco UCS Director Express for Big Data.
Fulfilling the Product Access Key
Before You Begin
You need the PAK number.
Step 1
Step 2
Step 3
Step 4
Step 5
Step 6
Navigate to the Cisco Software License website.
If you are directed to the Product License Registration page, you can take the training or click Continue to Product
License Registration.
On the Product License Registration page, click Get New Licenses from a PAK or Token.
In the Enter a Single PAK or TOKEN to Fulfill field, enter the PAK number.
Click Fulfill Single PAK/TOKEN.
Complete the additional fields in License Information to register your PAK:
Name
Description
Organization Name
The organization name.
Site Contact Name
The site contact name.
Street Address
The street address of the organization.
City/Town
The city or town.
State/Province
The state or province.
Zip/Postal Code
The zip code or postal code.
Country
The country name.
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
3
Overview
Fulfilling the Product Access Key
Step 7
Click Issue Key.
The features for your license appear, and an email with the Digital License Agreement and a zipped license file is sent
to the email address you provided.
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
4
CHAPTER
2
Installing Cisco UCS Director Express for Big
Data
This chapter contains the following sections:
• Installing Cisco UCS Director Express for Big Data on VMware vSphere, page 5
• Changing the Default Password, page 7
• Updating the License, page 8
• Reserving System Resources, page 8
• Changing the Maximum Packet Size, page 8
• Configuring the Network Interface using Shelladmin, page 9
Installing Cisco UCS Director Express for Big Data on VMware
vSphere
The Cisco UCS Director, Release 5.4 OVF file includes Cisco UCS Director Express for Big Data, Release
2.0.
Note
We recommend that you use VMware vCenter for OVF deployment. VMware vCenter versions 5.x and
above are supported. OVF deployment wizards support only IPv4 addresses. If you require IPv6, you can
deploy OVF and use the shelladmin option to configure IPv6 address.
Before You Begin
You need administrator privileges to connect to VMware vSphere or vCenter.
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
5
Installing Cisco UCS Director Express for Big Data
Installing Cisco UCS Director Express for Big Data on VMware vSphere
Note
If you do not want to use DHCP, you need the following information: IPv4 address, subnet mask, and
default gateway.
Step 1
Step 2
Step 3
Log in to VMware vSphere Client.
In the Navigation pane, choose the Data Center for Cisco UCS Director deployment.
Choose File > Deploy OVF Template.
The Deploy OVF Template window appears.
Step 4
In the Source pane, do one of the following to choose your OVF source location:
• Browse to the location, choose the file, and click Open.
• Deploy from a URL on your local area network. Replace FQDN (Fully Qualified Domain Name) with the IP address
or domain name, and click Next.
Step 5
In the OVF Template Details pane, verify the details, and click Next.
Step 6
In the End User License Agreement pane, read the license agreement, and click Accept. Click Next.
Step 7
In the Name and Location pane, do the following:
a) (Optional) In the Name field, edit the VM name.
b) From the Inventory Location area, choose the inventory location where Cisco UCS Director Express for Big Data
is being deployed, and click Next.
Note
If Data Center was chosen in a previous step, option b is not available.
Step 8
In the Host/Cluster pane, choose the required host, cluster, or resource pool, and click Next.
Step 9
In the Storage pane, choose the location to store Cisco UCS Director Express for Big Data VM files, and click Next.
Step 10
In the Disk Format pane, choose one of the following radio buttons and click Next:
• Thick Provisioned (Lazy Zeroed) format—To allocate storage immediately in thick format.
• Thick Provisioned (Eager Zeroed) format—To allocate storage in thick format. It might take longer to create
disks using this option.
• Thin Provisioned format—To allocate storage on demand as data is written to disk.
Step 11
In the Network Mapping pane, choose your network and click Next.
Step 12
In the Properties pane, enter the following information and click Next:
• Root Password
• Shelladmin Password
• Management IP Address
• Management IP Subnet Mask
• Gateway IP Address
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
6
Installing Cisco UCS Director Express for Big Data
Changing the Default Password
Note
Step 13
Step 14
Step 15
Step 16
Step 17
Step 18
Step 19
Step 20
Step 21
Step 22
If the root password and shell admin password are not configured, default values are used.
The management IP address and management IP subnet mask are set to 0.0.0.0 to use DHCP by default.
In the Ready to Complete pane, verify the options selected, and click Finish.
Make sure you have sufficient vCPU and memory to power on the VM.
Power on the VM.
Note
If the Power on after deployment check box on the Ready to Complete pane is checked, the appliance powers
on automatically after deployment.
After the appliance has booted up, transfer the Cisco UCS Director Express for Big Data IP address (from the IP address
that is shown) into a supported web browser to access the Login page.
On the Login page, enter admin as the username and admin for the login password.
Note
Change your admin password after this initial
login.
On the menu bar, choose Administration > License and click the License Keys tab.
Click Manage Personalities.
In the Personality Configuration dialog box, check the check box for the required personalities.
You can check either UCSD or Big Data or both personalities if required.
Click Submit.
Log in to the Cisco UCS Director VM console with the default shelladmin credentials (for example, shelladmin/changeme)
to apply the selected personality (Big Data).
a) From the Cisco UCS Director Shell Menu, choose Stop Services and press Enter.
b) Press Enter to return to the main menu.
c) From the Cisco UCS Director Shell Menu, choose Start Services and press Enter.
d) Press Enter to return to the main menu.
e) Choose Quit.
Changing the Default Password
Change the default password for admin after initial logging.
Step 1
Step 2
Step 3
Step 4
Step 5
On the menu bar, choose Administration > Users and Groups.
Click the Users tab.
Choose the admin user for which you want to change the default password.
Click Change Passwrod.
In the Change Password dialog box, enter the new password and confirm it.
Step 6
Click Save.
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
7
Installing Cisco UCS Director Express for Big Data
Updating the License
Updating the License
Before You Begin
If you received a zipped license file by email, extract and save the .lic file to your local machine.
Step 1
Step 2
Step 3
Step 4
Choose Administration > License.
Click on the License Keys tab.
Click Update License.
In the Update License dialog box, do the following:
• To upload a .lic file, click Browse to the base license's .lic file and select the .lic file, then click Upload.
Step 5
Click Submit.
The license file is processed, and a message appears confirming the successful update.
Reserving System Resources
For optimal performance, we recommend reserving extra system resources for Cisco UCS Director Express
for Big Data beyond the minimum system requirements listed in Minimum System Requirements for a
Single-Node Setup.
Note
For more information about how to reserve system resources, see the VMWare documentation.
Step 1
Step 2
Step 3
Step 4
Step 5
Log into VMware vCenter.
Choose the VM for Cisco UCS Director Express for Big Data.
Shut down the VM.
In VMware vCenter, click the Resource Allocation tab to view the current resource allocations, and click Edit.
In the Virtual Machine Properties pane, edit resource allocations by choosing a resource and entering the new values.
Step 6
Verify that the new resource allocations have been made.
Changing the Maximum Packet Size
The default maximum packet (query) size for the Cisco UCS Director Express for Big Data database queries
is 4 MB. If one or more of your pods requires a larger size, we recommend that you increase the configuration
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
8
Installing Cisco UCS Director Express for Big Data
Configuring the Network Interface using Shelladmin
of the maximum packet size to 100 MB. For example, the import of large open automation modules typically
requires a larger packet size.
Note
For a multi-node setup, perform this configuration on the inventory database and monitoring database
nodes.
Step 1
In the shelladmin, choose Login as Root to log in to Cisco UCS Director Express for Big Data.
Step 2
Navigate to the /etc folder.
Step 3
Open the my.cnf file and locate the max_allowed_packet parameter.
Step 4
Change the value of the max_allowed_packet parameter to max_allowed_packet=100M
Step 5
Save the my.cnf file.
Step 6
In the shelladmin, stop and restart the Cisco UCS Director Express for Big Data services on the every node, as follows:
a) Choose Stop services.
b) To verify that all services are stopped, choose Display services status.
c) After all services have stopped on the node, choose Start services.
Configuring the Network Interface using Shelladmin
This procedure is optional.
Step 1
Log into the Cisco UCS Director Express for Big Data VM console with the following credentials:
a) User—shelladmin
b) Password—changeme
If you have already logged into the shelladmin and changed the default password, use your new password instead.
After you have logged in, you can choose Change shelladmin password to change the default password.
Step 2
Choose Configure Network Interface.
Step 3
At the Do you want to Configure DHCP/STATIC IP [D/S] prompt, enter one of the following choices:
• If DHCP is enabled, enter D (IP addresses are assigned automatically)
• To configure static IP, enter S, and then choose the interface you want to configure at the next prompt followed by
the option to select IPv4 or IPv6. This will be followed by the confirmation of the interface selected and the version
of IP for which you select Y to continue. Then enter the following details:
◦IP address
◦Netmask
◦Gateway
◦DNS Server 1
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
9
Installing Cisco UCS Director Express for Big Data
Configuring the Network Interface using Shelladmin
◦DNS Server 2
Step 4
Confirm when prompted.
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
10
CHAPTER
3
Restarting Cisco UCS Director Express for Big
Data
This chapter contains the following sections:
• Restarting Cisco UCS Director Express for Big Data, page 11
Restarting Cisco UCS Director Express for Big Data
If you see errors after installing Cisco UCS Director Express for Big Data, log into the Secure Shell (SSH)
client and run scripts to verify whether services are running or not.
Step 1
Using the Cisco UCS Director Express for Big Data IP address, log in with the following credentials:
a) User—shelladmin
b) Password—changeme
If you have already logged into the shelladmin and changed the default password, use your new password instead.
After you have logged in, you can choose Change shelladmin password to change the default password.
Step 2
To display the status of all services, choose Display services status.
If this option is not available, you can use SSH to restart the services.
Step 3
Verify that the following services appear:
1.
2.
3.
4.
5.
6.
7.
8.
9.
Broker
Controller
Eventmgr
Client
Idaccessmgr
Inframgr
Tomcat
Websock
Database (mysqld)
Note
Services that start in the background do not appear in the window.
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
11
Restarting Cisco UCS Director Express for Big Data
Restarting Cisco UCS Director Express for Big Data
Step 4
Choose Stop services.
Step 5
To verify that all services are stopped, choose Display services status.
Step 6
To restart services, choose Start services.
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
12
CHAPTER
4
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 13
• Upgrading a Single Node Cisco UCS Director Express , page 14
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.
Note
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.
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
• From Release 5.3.2.0 to Release 5.4
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
13
Upgrading Cisco UCS Director Express for Big Data, Release 2.0
Upgrading a Single Node Cisco UCS Director Express
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
Step 2
Step 3
In your hypervisor, take a snapshot of the VM before you begin the upgrade.
Log in to your Cisco UCS Director Express for Big Data, Release 1.1 appliance, using ShellAdmin.
In the Shell Admin, stop all services as follows:
a) Choose Stop services to stop all services.
b) Choose Display services status to 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
Step 6
In the Shell Admin, choose Manage Root Access and enable root access.
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.
Note
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.
If Release 5.3.x.x VM cannot communicate to Release 5.4, perform an offline migration. See Upgrading Cisco UCS
Director to Release 5.4 Offline
What to Do Next
Complete the steps in Upgrading a Single Node Cisco UCS Director Express for Big Data to Release 2.0, on
page 15
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
14
Upgrading Cisco UCS Director Express for Big Data, Release 2.0
Upgrading a Single Node Cisco UCS Director Express for Big Data to Release 2.0
Upgrading a Single Node Cisco UCS Director Express for Big Data to Release
2.0
Caution
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.
• 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 in Preparing a Single Node Cisco UCS Director Express for Big Data, Release 1.1 VM
for Upgrade, on page 14
Step 1
Step 2
Download the Cisco UCS Director Express for Big Data, Release 2.0 software.
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
Step 4
Step 5
In the Shell Admin on the Release 2.0 VM, choose Manage Root Access and enable root access for that VM.
Log in to the Release 2.0 VM as root.
On the Release 2.0 VM, run /opt/infra/migration/performMigration.sh to 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.
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
15
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
Step 6
Step 7
Step 8
Step 9
Step 10
Step 11
Step 12
Step 13
Complete any manual steps required for your installation as described in Completing the Upgrade to Cisco UCS Director
Express for Big Data, Release 2.0 , on page 16.
In the Shell Admin, choose the Start Services option to start the Cisco UCS Director Express for Big Data services and
complete the process.
Log in to Cisco UCS Director Express for Big Data. choose Administration > License > License Keys, and click
Manage Personolities.
In the Personolity Configuration dialog box, check the UCSD check box if required, or Big Data check box and click
Submit.
In the Shell Admin, choose the Stop Services option to stop the Cisco UCS Director Express for Big Data services and
complete the process.
In the Shell Admin, choose the Start Services option to start the Cisco UCS Director Express for Big Data services and
complete the process.
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.
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.
Note
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.
Before You Begin
Complete the steps in Upgrading a Single Node Cisco UCS Director Express for Big Data to Release 2.0, on
page 15.
Step 1
Step 2
In the Shell Admin, choose the Start Services option to start the Cisco UCS Director services and complete the upgrade
process.
Copy the /etc/hosts file from the Release 1.1 VM to the Release 2.0 VM.
Step 3
Configure the hostname of the Release 2.0 VM to match the configured hostname in the /etc/hosts file.
Step 4
Evaluate and merge the following files from the Release 1.1 VM to the same files on the Release 2.0 VM:
• Changes in /etc/ntp.conf
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
16
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.
Migrate the contents from the/opt/infra/uploads folder.
This folder contains any files and OVFs uploaded from the Cisco UCS Director Express for Big Data user interface.
Note
Step 5
Step 6
Step 7
Step 8
If HTTPS login mode is required, re-configure the Release 2.0 appliance once data migration is complete.
Migrate the CA certificate to the Release 2.0 by importing the certificates to the Release 2.0 appliance.
If necessary, reconfigure the Shell Admin and root passwords.
What to Do Next
Note
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.
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
17
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
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
18
CHAPTER
5
Upgrading Cisco UCS Director Express for Big
Data
This chapter contains the following sections:
• Supported Upgrade Paths for Cisco UCS Director Express for Big Data, page 19
• Upgrading to Cisco UCS Director Express for Big Data, Release 2.0, page 19
Supported Upgrade Paths for Cisco UCS Director Express for
Big Data
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.
Current Release
Direct Upgrade Supported
Upgrade Path
Release 1.0
Yes
1.0 > 1.1
Release 1.x
No
1.x > 2.0
Upgrading to Cisco UCS Director Express for Big Data, Release
2.0
Before You Begin
From the Download Software site, download Cisco UCS Director, Release 5.4 or Cisco UCS Director Express
for Big Data, Release 2.0, and unzip the OVF file from Downloads Home > Products > Servers-Unified
Computing > UCS Director > UCS Director Express for Big Data 2.0.
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
19
Upgrading Cisco UCS Director Express for Big Data
Upgrading to Cisco UCS Director Express for Big Data, Release 2.0
Note
Step 1
Step 2
Step 3
Step 4
Step 5
Step 6
Step 7
Step 8
Step 9
Step 10
Step 11
Step 12
The Cisco UCS Director, Release 5.4 OVF file includes Cisco UCS Director Express for Big Data, Release
2.0.
Log in to the current version of Cisco UCS Director Express for Big Data VM console after installing Cisco UCS Director
Express for Big Data, Release 1.0 or Release 1.1 with the support for personality.
In the shelladmin, choose Stop Services to stop all services.
To verify that all services are stopped, choose Display Services Status.
In the shelladmin, choose Backup Database to back up the inventory database and monitoring database nodes.
Install Cisco UCS Director Express for Big Data, Release 2.0 on a new node as described in Installing Cisco UCS Director
Express for Big Data on VMware vSphere.
Log in to the Cisco UCS Director Express for Big Data, Version 2.0 VM console.
In the shelladmin, choose Stop Services to stop all services.
To verify that all services are stopped, choose Display Services Status.
In the shelladmin, choose Restore Database to restore the inventory database and monitoring database nodes from the
Cisco UCS Director Express for Big Data 1.0 or 1.1 OVF appliance.
In the shelladmin, choose Start Services to start all services.
To verify that all services are started, choose Display Services Status.
Log in to Cisco UCS Director Express for Big Data.
On the menu bar, choose Administration > License and click the License Keys tab.
Click Manage Personalities.
In the Personality Configuration dialog box, check the Big Data check box, and click Submit.
Cisco UCS Director Express for Big Data Installation Guide on VMware vSphere, Release 2.0
20