Hp Cloudsystem Foundation Installation Guide 8.0 And Configuration

2015-03-28

: Hp Hp-Cloudsystem-Foundation-Installation-Guide-669905 hp-cloudsystem-foundation-installation-guide-669905 hp pdf

Open the PDF directly: View PDF .
Page Count: 72

Download
Open PDF In Browser	View PDF

HP CloudSystem 8.0 Installation and
Configuration Guide

About this guide
This information is for use by administrators using HP CloudSystem Foundation and Enterprise Software 8.0, who are assigned
to configure and provision compute resources for deployment and use in virtual data centers.

HP Part Number: 5900-3382
Published: March 2014
Edition: 1

© Copyright 2014 Hewlett-Packard Development Company, L.P.
Microsoft® and Windows® are U.S. registered trademarks of the Microsoft group of companies.
Red Hat® is a registered trademark of Red Hat, Inc. in the United States and other countries.
Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial
Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under
vendor's standard commercial license.
The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express
warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall
not be liable for technical or editorial errors or omissions contained herein.
The open source code used by HP CloudSystem is available on the HP web at http://www.hp.com/software/opensource.

Contents
1 Welcome to HP CloudSystem.......................................................................5
Explanation of solution components............................................................................................6
Management hypervisors and integrated tools.........................................................................7
CloudSystem Foundation components.....................................................................................8
CloudSystem Enterprise components.......................................................................................8
CloudSystem networks..........................................................................................................9

2 Before you begin......................................................................................10
Audience...............................................................................................................................10
Assumptions...........................................................................................................................10

3 HP CloudSystem installation prerequisites....................................................11
Understand the installation process...........................................................................................11
Hardware requirements...........................................................................................................12
Physical configuration hardware requirements........................................................................12
Management hypervisors...............................................................................................12
Compute nodes............................................................................................................13
SAN and Storage.........................................................................................................14
Virtual appliance requirements — CloudSystem virtual appliances.......................................14
Software requirements.............................................................................................................15
Networking requirements.........................................................................................................15
Overview of network topology.............................................................................................16
Network definitions.......................................................................................................17
Configuration of management networks...........................................................................18
Browser requirements..............................................................................................................19
Tools requirements..................................................................................................................20

4 Prepare for the installation.........................................................................21
Installation kits.......................................................................................................................21
Contents of CloudSystem .zip files........................................................................................21
Preparing to install on ESX.......................................................................................................23
Preparing to install on KVM.....................................................................................................24

5 Installing CloudSystem on an ESX cluster.....................................................26
Understanding the network infrastructure....................................................................................26
Create the ESX management hypervisor and configure the network infrastructure........................27
Configuring the ESX management environment...........................................................................28
Selecting hypervisor security level for CloudSystem installation.................................................29
Configuring the Foundation base appliance on ESX................................................................29

6 Installing CloudSystem on a KVM hypervisor................................................33
Creating the management hypervisor........................................................................................33
Preparing the hardware......................................................................................................33
Installing RHEL...................................................................................................................33
Creating a local YUM repository and validating RHEL RPMs....................................................34
Configuring the CloudSystem network infrastructure.....................................................................35
Configure the network infrastructure on the KVM management hypervisor..................................36
Configuring the KVM management environment.........................................................................40
Selecting hypervisor security level for CloudSystem installation.................................................40
Configuring the Foundation base appliance on KVM..............................................................41

7 Setting up the CloudSystem Console for the first time.....................................44
Configuring cloud networking..................................................................................................44
Performing time synchronization on the Foundation base appliance...............................................44
Contents

8 CloudSystem Foundation installation next steps.............................................46
9 Preparing HP Operations Orchestration for CloudSystem Foundation...............47
Using OO Central..................................................................................................................47
Installing OO Studio ..............................................................................................................47

10 Installing CloudSystem Enterprise..............................................................49
Installing the Enterprise appliance.............................................................................................49

11 Troubleshoot installation issues..................................................................52
Basic troubleshooting techniques..............................................................................................52
csstart errors..........................................................................................................................53
OO Studio installation errors....................................................................................................55
Enterprise upgrade errors.........................................................................................................55

12 Support and other resources.....................................................................57
Information to collect before contacting HP.................................................................................57
How to contact HP..................................................................................................................57
Registering for software technical support and update service.......................................................57
HP authorized resellers............................................................................................................58
Documentation feedback.........................................................................................................58
Related information.................................................................................................................58
HP CloudSystem documents.................................................................................................58
HP Software documents......................................................................................................59
Finding documents on the HP Software Product Manuals web site........................................59
HP Insight Management documents......................................................................................59
Third-party documents........................................................................................................59
HP 3PAR StoreServ Storage documents.................................................................................60
Finding documents on the HP Support Center web site.......................................................60
HP ProLiant servers documents.............................................................................................61

A Command line interfaces..........................................................................62
Preparing to use CLIs..............................................................................................................62
Installing OpenStack CLIs on Windows.................................................................................62
Installing OpenStack CLIs on Linux.......................................................................................62
Using CLI commands..............................................................................................................63
csstart commands..............................................................................................................63
csadmin CLI and OpenStack CLI..........................................................................................64
Additional CLI tasks................................................................................................................64
Using the csstart CLI to install the Foundation base appliance..................................................64
Enabling REST API for storage drivers...................................................................................66
Using the CLI to access the Enterprise console........................................................................66

B Configuring additional providers for CloudSystem Enterprise..........................67
Configuring HP Operations Orchestration to integrate with HP CSA..............................................67
Importing Operations Orchestration flows..................................................................................69
Importing a service design.......................................................................................................70
Configuring a Matrix OE resource provider................................................................................71

C Configuring a large-scale CloudSystem deployment......................................72

Contents

1 Welcome to HP CloudSystem
HP CloudSystem provides a software-defined approach to managing the cloud in a converged
infrastructure environment. CloudSystem consists of two offerings:
•

HP CloudSystem Foundation is based on the HP Cloud OS distribution of OpenStack Cloud
Software. It integrates hardware and software to deliver core Infrastructure as a Service (IaaS)
provisioning and lifecycle management of compute, network and storage resources. You can
manage CloudSystem Foundation from an administrative console, self-service portal, CLIs,
and OpenStack APIs. It provides an appliance-based deployment console to simplify installation
and maintenance, and an embedded version of HP Operations Orchestration (OO) for
automating administrative processes.
See CloudSystem Foundation components (page 8).
Figure 1 CloudSystem Foundation
OpenStack
service offerings
Consumers
• Browse, request & manage
virtualized services
• Simple self-service portal

Virtual
machines

Networks
and
endpoints

Ephemeral
volumes

Identity (Keystone)
users, projects,...
Compute (Nova)
images, instances,
security groups, ...

Compute
services

Network (Neutron)
provider and private tenant
networks, endpoints, routing

Storage
services

Network
services

Resources

Volumes (Cinder)
block storage for VMs

Administrator
• Manage resources and access
• Provision VM Hosts

Servers

Storage

Networking

HP Converged Infrastructure

•

HP CloudSystem Enterprise expands on CloudSystem Foundation to integrate servers, storage,
networking, security, and management to automate the lifecycle for hybrid service delivery.
Template architects can use Enterprise to create infrastructure templates and offer them as
services in a Marketplace Portal. Users select services from a catalog and manage their
subscriptions. When a service is requested, Enterprise automatically provisions the servers,
storage, and networking. Enterprise also includes an enhanced set of Operations Orchestration
workflows.
CloudSystem Enterprise provides a hybrid cloud management platform where you can manage
all cloud services.
See CloudSystem Enterprise components (page 8).

Figure 2 CloudSystem Enterprise

Figure
2 CloudSystem Enterprise
Design, provision, and manage complex services with HP CloudSystem Enterprise

Consumers

• Browse request & manage
virtualized services

Architects

• Design and publish
infrastructure and
applications services
• Topology and service
design tools

Service Catalog

Administrator

Complex service
template

• Manage catalog, subscriptions
and providers

Compute
services

Network
services

Resources

Storage
services

Public
cloud
services

HP Servers
HP Storage
HP Networking

Explanation of solution components
The components of CloudSystem Foundation and CloudSystem Enterprise are explained below.

•

Management hypervisors and integrated tools (page 7)

•

CloudSystem Foundation components (page 8)

•

CloudSystem Enterprise components (page 8)

•

CloudSystem networks (page 9)

Welcome to HP CloudSystem

Figure 3 CloudSystem architecture

CSA Admin UI
(w Designer)
CSA Marketplace
Portal

CS Enterprise Appliance

Network Node
Appliances

Cloud OS
Services

CSA

Foundation
Services

neutron L2 and L3
agents
LDAP
(e.g. AD)

OpenStacks CLIs
SDN Appliance

CS Foundation Base Appliance
Horizon UI

keystone

neutron

SDN Controller

SDN plug-in

LDAP driver

nova
postgres

OO Central UI

OO Central

cinder

glance

3Par Driver

neutron L2 agent
rabbitmq

CS Management Services

CS Admin UI

KVM Compute Node(s)

Foundation Services

nova compute
libvirtd

vCenter Proxy
Appliance(s)
neutron L2 agent
nova compute

OO Studio
CS Admin CLI

3Par array(s)

Foundation
Services

vCenter(s)

vCNS(s)
ESX Clusters
ESX Hosts

Management hypervisors and integrated tools
•

Management hypervisors host the various virtual machine appliances that make up the
CloudSystem solution. Both ESX and KVM hypervisors are supported.

•

VMware vCenter Server acts as a central administrator for ESX clusters that are connected on
a network. vCenter Server allows you to pool and manage the resources of multiple hosts, as
well as monitor and manage your physical and virtual infrastructure. You can import and
activate ESX clusters in the CloudSystem Console after you register a connection with vCenter
Server.
VMware vCloud Networking and Security (vCNS) provides security for the ESX compute hosts.

•

An HP 3PAR storage system provides a method of carving storage for boot and data disks.
Block storage drivers are imported from the HP 3PAR storage system to the CloudSystem
Console.

•

An FC SAN, ISCSI or Flat SAN connects the HP 3PAR storage system to compute nodes or ESX
clusters.

Explanation of solution components

CloudSystem Foundation components
•

CloudSystem Foundation is the IaaS solution used for provisioning virtual machine instances.
Management tasks for both Foundation and Enterprise are performed from Foundation’s
CloudSystem Console. Foundation includes the following components, which all run on virtual
machines on one or more management hypervisors:

◦

The Foundation base appliance contains the core services and functionality of the
CloudSystem Console. The CloudSystem Portal, OpenStack services, OO Central and
supporting CLIs also reside on the Foundation base appliance.
–

The SDN (Software Defined Networking) appliance is the control center for the network
infrastructure of the Foundation base appliance. When the OpenStack Neutron
service needs to define a new router or a plugin on the Foundation base appliance,
the request is sent to the SDN appliance.
CloudSystem Foundation automatically creates the SDN appliance after the
Foundation base appliance is installed and the Cloud Networking settings are saved
in the CloudSystem Console.

–

The network node appliances manage various network services, such as DHCP and
L3 (routing) services, for provisioned virtual machines and provisioned virtual networks.
The SDN appliance manages the network node appliances as a cluster. When the
SDN appliance receives a request to create a new router, it creates the router in one
of the network node appliances.
Multiple network node appliances are created during installation, after the base
appliance is installed and Cloud Networking settings are saved in the CloudSystem
Console.

–

A vCenter proxy appliance supports ESX configurations. OpenStack Nova and
Neutron agents reside in the vCenter proxy appliance, which acts as a proxy for the
ESX management hypervisor. The management hypervisor accepts each vCenter
Server cluster as one large compute node. This configuration allows your cloud to
take advantage of HA and load balancing features supported in vCenter Server.
The vCenter proxy appliance runs the OpenStack agents for up to 12 ESX clusters.
Foundation automatically creates the first vCenter proxy appliance when the first ESX
cluster is activated in the CloudSystem Console.

–

The CloudSystem Console GUI supports administrative tasks, such as creating storage
templates, activating compute nodes, setting up networks, monitoring the Foundation
base appliance, and performing maintenance tasks on the appliance.

–

The CloudSystem Portal GUI is accessed from a modified Foundation base appliance
URL by appending portal to the Foundation IP address. Example:
https://Foundation_IP/portal. Instances are created and managed from
this portal.

–

HP Operations Orchestration (OO) Central provides the ability to run scripted
workflows on the Foundation base appliance. Access OO Central from the Integrated
Tools screen in the CloudSystem Console.
HP OO Studio provides the ability to edit the OO workflows. It has a separate installer,
which is included in the HP CloudSystem-OO-Studio-8.0.0.20 zip file.
See Preparing HP Operations Orchestration for CloudSystem Foundation (page 47).

CloudSystem Enterprise components

Welcome to HP CloudSystem

•

HP CloudSystem Enterprise expands on CloudSystem Foundation by integrating servers,
storage, networking, security, and management to automate the lifecycle for hybrid service
delivery. Template architects use Enterprise to create infrastructure templates, which are offered
as services in the Marketplace Portal. When a cloud user requests a service from the catalog,
Enterprise automatically provisions the servers, storage, and networking designed in the
service.
Enterprise is installed from Foundation and uses the Foundation platform to conduct management
tasks. Enterprise includes the following components:

◦

The Enterprise appliance contains the core functionality of the Enterprise offering, including
HP Cloud Service Automation (HP CSA), the Marketplace Portal, Topology Designer and
Sequential Designer.
–

The Marketplace Portal displays offerings that can be purchased and applied to a
cloud environment.

–

Enterprise includes two designers, Topology Design and Sequential Design. The
Topology Designer is an easy to use solution for infrastructure provisioning designs.
Sequential Designer handles more complex application provisioning designs. Designs
from both designers are offered as services in the Marketplace Portal.

–

HP CSA is the administrative portal for the Enterprise appliance. Designs are created
in the HP CSA portal.

CloudSystem networks
See Network definitions (page 17).

Explanation of solution components

2 Before you begin
HP CloudSystem is a flexible cloud management solution that supports multiple installation options.
This guide does not cover all possible options. If the installation required by your organization
does not match the installation described in this guide, contact an HP Support representative for
assistance.

Audience
This guide is intended for experienced system administrators with a working knowledge of the
following concepts.
•

TOR switches for networking

•

CLI commands for Windows and Linux

•

VMware vCenter Server functionality, if using ESX hypervisors and compute nodes

•

VMware distributed and standard vSwitches

•

Red Hat KVM hypervisor configuration and use

If you plan to use the OpenStack CLI and APIs to manage some of the cloud resources from the
command line, it is helpful to have experience with OpenStack technologies such as Nova, Glance,
Cinder and Neutron.

Assumptions
This installation guide makes the following assumptions about your readiness for the installation.
Make sure these assumptions match the state of your environment before you begin the installation.
•

All hardware required to support a CloudSystem installation is installed and configured. You
can use the requirements chapter to verify this before installation. See HP CloudSystem
installation prerequisites (page 11).

•

If you are using ESX, then VMware vCenter Server is installed and ready to connect to
CloudSystem.

•

If you plan to use block storage, then an HP 3PAR storage system is configured and ready to
connect to CloudSystem.

•

You have a list of user names and passwords for VMware vCenter Server and HP 3PAR storage
system.

•

You have a set of IP addresses that you can assign to CloudSystem virtual appliances.

Next steps: HP CloudSystem installation prerequisites (page 11).

Before you begin

3 HP CloudSystem installation prerequisites
This chapter outlines the recommended and minimum hardware and software requirements, the
networking pre-configuration, and the solution integration tools that must be in place before installing
CloudSystem.
Hardware requirements (page 12)
Software requirements (page 15)
Networking requirements (page 15)
Browser requirements (page 19)
Tools requirements (page 20)

Understand the installation process
A high-level overview of the CloudSystem installation path is provided in the table below. The
Additional resources column contains links to information in this guide, as well as information from
other documentation sources.
Table 1 Installation process
Installation step

Additional resources

Verify that the target environment satisfies the hardware,
See
software, and networking prerequisites described in this guide. Hardware requirements (page 12)
Software requirements (page 15)
Networking requirements (page 15)
Configure the HP 3PAR storage system to support storage
See
requirements for compute nodes and virtual machine instances. Openstack Cinder documentation
This guide does not cover the specific steps required to
HP 3PAR documentation
accomplish this.
• The 3PAR storage system server certificate must contain a
Fully Qualified Domain Name (FQDN) in the CN attribute
Subject field.
• For block storage volumes, use the OpenStack interfaces
that are dependent on block storage support.
• For ephemeral storage, define the storage in the flavor
definitions.
Set up the management hypervisor solution (ESX or KVM) per
CloudSystem requirements. If using ESX, configure vCenter
Server.

See

Use csstart to deploy the Foundation base appliance.

See

Installing CloudSystem on an ESX cluster
(page 26)
Installing CloudSystem on a KVM hypervisor
(page 33)
VMware vSphere Documentation at VMware

Configuring the ESX management
environment (page 28)
Configuring the KVM management
environment (page 40)
Enter and save Cloud Networking settings in the CloudSystem
Console.

See Setting up the CloudSystem Console for
the first time (page 44)

Optional: Install OO Studio, if you want to customize workflows. See Preparing HP Operations Orchestration
for CloudSystem Foundation (page 47)
Optional: Install CloudSystem Enterprise.

See Installing CloudSystem Enterprise
(page 49)

Understand the installation process

Table 1 Installation process (continued)
Installation step

Additional resources

Stage and prepare compute nodes. This guide does not cover
the specific steps required to accomplish this.

See “Resource Configuration in CloudSystem
Foundation: Compute node creation” in the
HP CloudSystem 8.0 Administrator Guide
at Enterprise Information Library

Build and manage cloud resources. This guide does not cover
the specific steps required to accomplish this.

See “Cloud service provisioning,
deployment, and service management in
CloudSystem” in the HP CloudSystem 8.0
Administrator Guide at Enterprise
Information Library

Hardware requirements
Hardware requirements for management hypervisors, compute nodes, virtual appliances, and SAN
and Storage are provided in this section.

Physical configuration hardware requirements
Management hypervisors
The following table lists the recommended and minimum hardware requirements for a single ESX
or KVM management hypervisor. Only HP servers are supported as management hypervisors.
In an HA configuration, both the primary and failover hypervisors must meet the hardware
requirements described in this table.
Table 2 Management hypervisor hardware requirements
Requirements

Cores

RAM

Storage

Recommended

16 cores

128 GB

See the formula below.

Minimum supported

8 cores

96 GB

See the formula below.

Formula to determine the storage requirements for the management hypervisor
The formula used to determine the management hypervisor storage requirements is appliance
storage + glance images/snapshots = management hypervisor storage
•

•

appliance storage: 600 GB

◦

25 GB for templates

◦

160 GB (3) for the Foundation base appliance, vCenter proxy appliance and Enterprise
appliance

◦

20 GB (3) for the network node appliances

◦

25 GB for the SDN appliance

glance images/snapshots: varies
Table 3 Glance repository sizing guidelines

Glance repository

Linux images (4 GB
each)

Windows images (16 Snapshots (20 GB
GB each)
each)

TOTAL

Small

520 GB

Medium

1.2 TB

Large

500

10.1 TB

HP CloudSystem installation prerequisites

Use the links in the table below to verify component compatibility and find a list of supported
hardware.
Table 4 Verify compatibility and supported versions
Additional resources

Use this to...

Where do I find it...

HP Insight Management Support
Matrix version 7.3.1

Refer to the supported HP servers
http://www.hp.com/go/
tables. CloudSystem supports all
insightmanagement/docs
servers supported in the HP Matrix
Operating Environment, version 7.3.1.
• Table 26
• Table 28
• Table 29
• Table 30
The server must have a check in the
Matrix OE column.

HP Support Center

Verify the compatibility of the servers, http://www.hp.com/go/hpsc
drivers, firmware and software

HP Customized ESXi images for
management hypervisor

Find customized ESXi images.
http://h18004.www1.hp.com/
Supported versions are 5.0 Update 3, products/servers/software/vmware/
5.1 Update 2, and 5.5.
esxi-image.html

Compute nodes
Compute node sizes vary according to your resource needs. The following questions are provided
to guide you as you determine the size of your compute node.
•

What flavor settings will the provisioned instances use?

•

What oversubscription rate is supported for each compute resource? See the Compute Node
Management chapter in the HP CloudSystem 8.0 Administrator Guide at Enterprise Information
Library.

•

How many instances will each compute node support?

After answering the questions above, determine the amount of CPU cores, memory, and storage
to allocate to each compute node. You can also use the HP Sizer for Server Virtualization website
to determine hypervisor sizing for compute nodes.
Table 5 Hardware requirements
Additional resources

Use this to...

Where do I find it...

HP Sizer for Server Virtualization
website

Find details on sizing hypervisors for
compute nodes

http://h71019.www7.hp.com/
ActiveAnswers/us/en/size

Use the links in the table below to verify component compatibility and find a list of supported
hardware.

Hardware requirements

Table 6 Verify compatibility and supported versions
Additional resources

Use this to...

Where do I find it...

HP Insight Management Support
Matrix version 7.3.1

HP Support Center

Verify the compatibility of your servers, http://www.hp.com/go/hpsc
drivers, firmware and software

SAN and Storage
The table below contains SAN and storage requirements for ephemeral and block storage.
Table 7 Hardware requirements
Requirements

Purpose

Find more information...

Ephemeral storage

This storage is used for provisioned
instances and is defined in the flavor.
When an instance is deleted, this
storage is released.

See HP Matrix Operating Environment,
version 7.3.1. http://www.hp.com/
go/insightmanagement/docs
• Chapter 4 Managed system
hardware

Block storage
Block storage allocates storage to
See HP 3PAR documentation
3 PAR F-Class, P7000, P10000 series virtual machine instances
(attach/detach). Storage is presented
Fibre Channel fabric support
to a single instance via the compute
• pre-configured zones where
node where the instance is hosted.
storage system is zoned to the
appropriate virtual machine host
• open zoning where no zoning
configuration is enabled
FC SAN
iSCSI
Flat SAN
NOTE: REST API interface must be
enabled on the HP 3PAR storage
system.

Virtual appliance requirements — CloudSystem virtual appliances
The table below lists all CloudSystem virtual appliances, along with compute, memory and storage
requirements.
Table 8 Hardware requirements
Virtual appliance

Cores

RAM

Storage

Foundation base appliance

8vCPUs

32 GB

160 GB (Thin Provisioned)
Glance image storage of
2–4 TB is provided by a

HP CloudSystem installation prerequisites

Table 8 Hardware requirements (continued)
Virtual appliance

Cores

RAM

Storage
separate mounted volume in
a production environment.

SDN appliance (Foundation) 4vCPUs

8 GB

25 GB (Thin Provisioned)

network node appliances
(Foundation)

3(2vCPUs)

3(4 GB)

3(21 GB) (Thin Provisioned)

vCenter proxy appliance
(Foundation)

4vCPUs

16 GB

160 GB (Thin Provisioned)

Enterprise appliance

8vCPUs

16 GB

160 GB (Thin Provisioned)

Total of all Foundation and
Enterprise appliances

30 vCPUs (15 cores)

84 GB

568 GB (Thin Provisioned)

NOTE: 1 vCenter proxy
appliance is required for
every VMware vCenter
Server

Software requirements
Refer to the table below for a list of supported software versions.
Software

Version

Location

3PAR Inform

Inform OS 3.1.2
MU2

Contact your HP 3PAR support representative for
additional information.

VMware vSphere

ESXi 5.0.3, 5.1.2
and 5.5b (Custom
HP image)

Available from http://software.hp.com. Select the
virtualization software link.

For ESXi hosts, 5.5
is supported,
instead of 5.5b
VMware vCloud Networking and
Security (vCNS)

5.5

See Third-party documents (page 59)

Red Hat Enterprise Linux

6.4

See Third-party documents (page 59)

OO Studio

10.02

The upgrade executable file is available in the OO Studio
zip file. System requirements must be met to support the
upgrade to OO Studio. You can confirm requirements
here: HP Orchestration Operations System Requirements
document

Required on ESX compute nodes to
support security groups for provisioned
instances.

Networking requirements
Before installing CloudSystem, plan for the following networks.

Software requirements

Table 9 Network planning
Network

Number Purpose

Connected to...

Data Center
Management
Network

This network connects virtual appliances
to HP 3PAR, VMware vCenter Server,
VMware vCloud Networking and Security
(vCNS) and enclosures.

Foundation base appliance
VMware proxy appliance
Enterprise appliance
VMware vCenter Server

Cloud Management 1
Network

This network connects the Foundation
base appliance, vCenter proxy appliance,
network node appliances, SDN appliance
and KVM compute nodes. This is a private
network.

Foundation base appliance
SDN appliance
network node appliances
VMware proxy appliance
KVM compute nodes

External Network

This network allows cloud end users to
attach public IP addresses to their
provisioned virtual machine instances.

network node appliances

Provider Networks
and/or Private
Networks

at
A Provider Network is a data center
Cloud Data Trunk
least 1 network routed through the existing data network node appliances
center infrastructure. A Private Networkk
is created from a pool of VLANs. Both
networks support instance communication.

Overview of network topology
Networks are organized into two trunks. The Management trunk holds all infrastructure networks
that connect the virtual appliances, vCenter Server and the HP 3PAR storage system. The Cloud
Data Trunk holds the networks that connect provisioned virtual machines to the cloud.
Figure
4 CloudSystem
Figure
4 Network
trunks appliances and the network architecture
Foundation
base appliance

vCenter proxy
appliance

Cloud Mgmt
Network

Enterprise
appliance

Network node
appliance

Data Center
Mgmt Network
Management Trunk

External
Network

SDN appliance

vCenter Server

3PAR

Provider or
Private Networks
Cloud Data Trunk

You can use the following interactive graphic to see how each network connects to the CloudSystem
virtual appliances. Click the play button
to enable the graphic, then click a network name to
see which virtual appliances are supported by the network.

HP CloudSystem installation prerequisites

Figure 5 Interactive network diagram

Network definitions
Management Trunk
The Management trunk contains the following networks.
•

Data Center Management Network: This network provides access to the CloudSystem Console,
which is the interface for the Foundation base appliance. REST APIs calls are made from this

Networking requirements

network. The Foundation base appliance and the Enterprise appliance access vCenter Server
and the HP 3PAR storage system over this network.
Three or more vCenter Server are supported.

•

◦

The Foundation base appliance uses this network to access the vCenter Server that is
managing the management hypervisor.

◦

The vCenter proxy appliance uses this network to access the vCenter Server that is
managing ESX compute clusters. This can be a separate vCenter Server or the same
vCenter Server used by the Foundation base appliance.

◦

The Enterprise appliance also uses this network to access vCenter Server. Enterprise can
be configured to use a third vCenter Server, or it can access one of the two existing
vCenter Servers.

Cloud Management Network: This private network for the cloud is typically a VLAN, but could
also be a physical network. The Foundation base appliance runs a DHCP server for this
network.
IMPORTANT: The Cloud Management Network should be a dedicated private network for
Cloud System Management use only. Some of the contents transmitted between compute nodes
and the cloud controller are unencrypted. Network isolation should be used to prevent unwanted
exposure to sensitive data.

•

External Network: This network is automatically connected to the network node appliances
after Cloud Networking settings are saved during the CloudSystem Console first time setup.
Subnets must be defined in the CloudSystem Portal before using this network.
Virtual machines are not connected directly to this network. Internal provider or private networks
connect directly to a virtual machine, then a virtual router is used to connect the internal and
external networks. A networking service routes outgoing traffic to the External Network. When
the External Network subnet assigns Floating IPs to virtual machines, then the External Network
can access them.

Cloud Data Trunk
This network must be configured as a group of VLANs. It hosts the VLANs that OpenStack networking
makes available to users. CloudSystem uses specific VLANs on this trunk as Private Networks.
Some VLANs may not be dedicated to CloudSystem. All compute nodes in the cloud must be
connected to this network.
The Cloud Data Trunk contains the following production networks.
•

Provider Network: A Provider Network is a data center network routed through the existing
data center infrastructure. Adding a Provider Network allows you to add an existing data
center network to any number of virtual machine instances in the cloud.

•

Private Networks: Private Networks are created from a pool of VLANs. The cloud administrator
configures this pool in the CloudSystem Console. Then, when the cloud administrator switches
to the CloudSystem Portal and creates a Private Networks, the OpenStack Neutron networking
service assigns a VLAN from the pool.
OpenStack Neutron networking manages all aspects of this network, including external routing.

Configuration of management networks
Management network configuration varies depending on the management hypervisor configuration.
18

HP CloudSystem installation prerequisites

The following figure shows a sample configuration with an ESX management host, networks and
ESX compute nodes.
Figure 5 Network architecture for ESX management host with ESX compute

Figure 6 ESX
management
host with ESX compute nodes
nodes
and 3PAR storage
ESX cluster mgmt host
Cloud mgmt

Enclosure

CloudSystem Foundation
CloudSystem Enterprise

External router

ESX compute nodes
ESX compute nodes
Onboard Administrator
Virtual Connect

VMware vCenter server

3PAR

Data Center Management
Cloud Managment
External
Provider
Private
Cloud Trunk

The following figure shows a sample configuration with a KVM management host, networks and
KVM compute nodes.
Figure 6 Network architecture for KVM management host with KVM compute

Figure 7 KVMnodes
management
with KVM compute nodes
and 3PARhost
storage
KVM mgmt host

Enclosure

CloudSystem Foundation

External router

KVM compute nodes
KVM compute nodes

CloudSystem Enterprise

3PAR

Onboard Administrator
Virtual Connect

Data Center Management
Cloud Management

External
Management Trunk
Provider
Private
Cloud Trunk

For a detailed explanation of the network configuration, see
Installing CloudSystem on an ESX cluster (page 26)
Installing CloudSystem on a KVM hypervisor (page 33)

Browser requirements
The following browsers are supported for the CloudSystem installation.
Vendor

Product

Version

Microsoft

Internet Explorer

9, 10

Mozilla

Firefox Extended Support Release (ESR)

Browser requirements

Vendor

Google

Product

Version

Personal Edition

Latest version

Chrome

Tools requirements
The CloudSystem-Tools-8.0.0.20.zip file contains a csstart installation script and
several CLI packages. The requirements for the systems running these tools are listed in the table
below.
CloudSystem Tool

Product

Version

csstart

Windows

Version 7, 2008 R2 (32-bit and 64-bit)

Linux

RHEL 6.4

Windows

Version 7, 2008 R2 (32-bit and 64-bit)

Linux

CentOS 6.2, 6.3, 6.4, Ubuntu 12.04

CLI packages

Next step: Prepare for the installation (page 21)

HP CloudSystem installation prerequisites

4 Prepare for the installation
Before you begin the installation, it is important to have all of the required images and tools
unpacked and staged. The installation path varies, depending on whether you are installing
CloudSystem on an ESX or KVM management hypervisor.
•

Installation kits (page 21)

•

Preparing to install on ESX (page 23)

•

Preparing to install on KVM (page 24)

Installation kits
Download the CloudSystem release kit from HP Software Depot at http://software.hp.com.
There are six .zip files that contain the installation components needed for CloudSystem Foundation
and CloudSystem Enterprise. The installation components vary, depending on the type of
management hypervisor you plan to install. The table below shows the .zip files and which
installation path they support.
Table 10 Components included in HP CloudSystem zip files
Installation components

Foundation ESX

HP CloudSystem Foundation ESX 8.0
Mar 2014
(contains ESX images for base, SDN
appliance, and network node
appliances)

HP CloudSystem Foundation KVM 8.0
Mar 2014
(contains KVM images for base, SDN
appliance, and network node
appliances)

Foundation KVM

Enterprise ESX

Enterprise KVM

HP CloudSystem Enterprise ESX 8.0
Mar 2014
(contains the ESX image for the
Enterprise appliance)

HP CloudSystem Enterprise KVM 8.0
Mar 2014
(contains the KVM image for the
Enterprise appliance)

HP CloudSystem Tools 8.0 Mar 2014
(contains the csstart installation script
and the CLI packages))

HP CloudSystem OO Studio 8.0 Mar
2014
(contains OO content packs and OO
Studio installation and upgrade)

Signature files
Each zip file has a corresponding signature file. Signature files are used to verify the authenticity
of the downloaded files.
See HP GPG or RPM signature Verification.

Contents of CloudSystem .zip files
The contents of each CloudSystem .zip file are described in the following section.
Installation kits

NOTE: Each qcow2 file comes with a corresponding sha1 checksum file. When csstart runs,
it uses the checksum file to verify that the files are copied to the hypervisor without errors.
HP CloudSystem Foundation ESX-8.0 Mar 2014 Z7550–01317.zip
•

CS-Base-8.0.0.20.ova: Open Virtualization Format (OVF) package for the base appliance on
an ESX hypervisor.

•

CS-Base-8.0.0.20.ova: OVF package for the SDN appliance on an ESX hypervisor.

•

CS–NN–8.0.0.20.ova: OVF package for the network node appliance on an ESX hypervisor.

HP CloudSystem Foundation KVM 8.0 Mar 2014 Z7550–01318.zip
•

CS-Base-8.0.0.20.qcow2: Disk image for the base appliance on a KVM hypervisor.

•

CS-SDN-8.0.0.20.qcow2: Disk image for the SDN appliance on a KVM hypervisor.

•

CS-NN-8.0.0.20.qcow2: Disk image for the network node appliance on a KVM hypervisor.

NOTE: Each qcow2 file comes with a corresponding sha1 checksum file. When csstart runs,
it uses the checksum file to verify that the files are copied to the hypervisor without error.
HP CloudSystem Enterprise ESX 8.0 Mar 2014 Z7550-01323.zip
•

CS-Enterprise-8.0.0.20.ova: OVF package for the Enterprise appliance on an ESX hypervisor.

HP CloudSystem Enterprise KVM 8.0 Mar 2014 Z7550-01324.zip
•

CS-Enterprise-8.0.0.20.qcow2: Disk image for the Enterprise appliance on a KVM hypervisor.

NOTE: Each qcow2 file comes with a corresponding sha1 checksum file. When csstart runs,
it uses the checksum file to verify that the files are copied to the hypervisor without error.
HP CloudSystem Tools 8.0 Mar 2014 Z7550-01325.zip

•

csstartgui-secure.bat: Program used to deploy and configure the management appliances on
the management host. When csstart runs, it verifies the SSL certificate from the hypervisor,
and also verifies any additional virtual appliances created. This is for Windows or Linux
systems.

•

csstartgui-auto-accept.bat: Program used to deploy and configure the management appliances
on the management host. When csstart runs, it does not verify the SSL certificate from the
hypervisor, but will inject the certificate into the Foundation base appliance and check all
subsequent virtual appliances when they are created. This is for Windows or Linux systems.

•

csstartgui-insecure.bat: Program used to deploy and configure the management appliances
on the management host. When csstart runs, it does not verify any certificates for the initial
base appliance installation or for subsequent virtual appliances. This is for Windows or Linux
systems.

•

csstart-linux.tar: Contains the command line to install CloudSystem from a Linux system.

•

csstart-windows.zip: Contains the command line to install CloudSystem from a Windows
system. This is packaged as a folder of files, along with three .bat files, which are used to
invoke the command.

•

csadmin: Provides Linux command line access to perform administrative functions such as
storage management, support dump actions for management virtual appliances, and password
setting for management appliance console access.

•

csdamin.exe: Provides Windows command line access to perform administrative functions
such as storage management, support dump actions for management virtual appliances, and
password setting for management appliance console access.

Prepare for the installation

•

isc-remote-client-8.0.0.20.msi: Installs the Windows version of the commands for OpenStack
Keystone, Nova, Neutron and Cinder.

•

isc–remote–client–8.0.0.20.rpm: Installs the Linux version of the commands for OpenStack
Keystone, Nova, Neutron and Cinder.

•

rhel-kvm-deps-8.0.0.20.rpm: When run in a YUM repository, this file checks for required
RHEL RPMs and returns a list of any that are missing.

HP CloudSystem OO Studio 8.0 Mar 2014 Z7550-01319.zip
•

Content packs that can be installed and edited in OO Studio:

◦

OO-HP-Solutions-cp.jar

◦

OO-Systems-cp.jar

◦

OO-virtualization-cp.jar

◦

OO-Base-cp.jar

◦

OO-cloud-cp.jar

•

OO-installer.exe: Used to install OO Studio.

•

OO-studio-upgrade.zip: Used to upgrade OO Studio to 10.02.

Preparing to install on ESX
This section covers the steps required to download the contents of the release package and stage
the files on a Windows workstation. You can also use a Linux workstation to stage the files.
Figure 8 Path to install from a Windows workstation
VMware vCenter
Server

2
ESX cluster

Windows workstation

ESX mgmt host
CloudSystem OVA images
CS-Base 8.0.0.20.ova

CS-Base-8.0.0.20

CS-SDN 8.0.0.20.ova

CS-SDN-8.0.0.20

CS-NN-8.0.0.20.ova

CS-NN-8.0.0.20

CS-Enter-8.0.0.20.ova

Browser

CloudSystem installation tools
csstart

CS-Enter-8.0.0.20

1
Note: Use the same data store for
all OVA imports, converted
templates and running VM vmdks

Preparing to install on ESX

Prerequisites
•

You have a Windows staging server with access to your vCenter Server. Required disk storage
is approximately 35GB.

•

You have administrator privileges to log in to VMware vCenter Server.

Procedure 1 Downloading .zip files and extracting ESX contents
1.
2.
3.
4.
5.
6.
7.
8.

Log on to the Windows workstation.
Open a browser and navigate to the HP Software Depot at http://software.hp.com.
In the Search field, type CloudSystem.
Select the HP CloudSystem 8.0 offering.
Sign in with your HP Passport or create a new passport account.
Accept the license agreement.
Follow the HP Software Depot instructions for downloading the release files.
Move the following .zip files to the Windows workstation.
The Windows workstation used to stage the files must have access to the vCenter Server that
you plan to use to deploy the OVAs.
•

HP CloudSystem-Foundation-ESX-8.0.0.20.zip

•

HP CloudSystem-Enterprise-ESX-8.0.0.20.zip

•

HP CloudSystem-Tools-8.0.0.20.zip

9. Extract the .zip file content on your workstation.
10. Make sure the csstart folder and the three csstart-XXX.bat files are extracted from the HP
CloudSystem-Tools-8.0.0.20.zip on your workstation so that you can run them later.
Next step: Installing CloudSystem on an ESX cluster (page 26)

Preparing to install on KVM
This section covers the steps required to download the contents of the release package and stage
the files on a Linux workstation. You can also use a Windows workstation to stage the files, but
you will need to substitute Windows commands in the procedures below.
Figure 9 Path to install from a Linux workstation

Linux workstation
csstart
CloudSystem qcow2 images
CS-Base-8.0.0.20.qcow2
CS-SDN-8.0.0.20.qcow2
CS-NN-8.0.0.20.qcow2
CS-Enter-8.0.0.20.qcow2

Prepare for the installation

KVM management host

Copy images to the KVM host.
csstart uses the images
to configure virtual appliances.

CS-Base-8.0.0.20
CS-SDN-8.0.0.20
CS-NN-8.0.0.20
CS-Enter-8.0.0.20

Prerequisites
•

You have a Linux workstation to stage the KVM kit and run installation tools. Required disk
storage is approximately 35 GB.

•

You have administrator privileges to log in to the KVM management hypervisor.

Procedure 2 Downloading .zip files and extracting KVM contents
1.

Log on to the Linux workstation.
NOTE: If you prefer, you can use the KVM management host for staging instead of the Linux
workstation. Make sure you have at least 3 GB of extra space to stage the kits.

2.
3.
4.
5.
6.
7.
8.

Open a browser and navigate to the HP Software Depot at http://software.hp.com.
In the Search field, type CloudSystem.
Select the HP CloudSystem 8.0 offering.
Sign in with your HP Passport or create a new passport account.
Fill in the required form details and accept the license agreement.
Follow the HP Software Depot instructions for downloading the release files.
Move HP CloudSystem Foundation KVM 8.0 Mar 2014, HP CloudSystem Enterprise KVM 8.0
Mar 2014 and HP CloudSystem Tools 8.0 Mar 2014 files to your Linux workstation or KVM
management host.
Log in to the management hypervisor and run:
gunzip

This command unpacks the .zip files.
10. Move the qcow2 image files and the checksum (.sh1) files to the /CloudSystem/images
directory.
11. In the HP CloudSystem Tools 8.0 Mar 2014 file there is a csstart-linux.tar file. Unpack
the .tar file.
12. Copy csstart.exe to any directory on the Linux workstation or KVM management host.
Next step: Installing CloudSystem on a KVM hypervisor (page 33)

Preparing to install on KVM

5 Installing CloudSystem on an ESX cluster
This chapter contains the procedures required to set up the network infrastructure and install the
CloudSystem Foundation base appliance on an ESX management hypervisor. The checklist below
provides an overview of the installation path.
Table 11 ESX management hypervisor installation path
Installation step

Related information

Create the management host and define the vSwitch or port group IDs and Understanding the network
network security settings in vCenter Server.
infrastructure (page 26)
Choose the type of security checks to perform when running csstart.

Configuring the ESX
management environment
(page 28)

Launch csstart and install the Foundation base appliance.

Configuring the Foundation
base appliance on ESX
(page 32)

Understanding the network infrastructure
Multiple networks provide the communication platform for CloudSystem, vCenter Server and the
HP 3PAR storage system. The configuration of the networks is flexible. This section explains the
major components of the networking infrastructure and provides an example of a supported
configuration. This is only a guide. Modify the procedure below to fit your network configuration
needs. For example, the VLAN IDs can vary according to your environment.
Explanation of networks

Network
Data Center Management
Network

CloudSystem virtual
appliance

Management hypervisor
vNICs

Example names for vSwitch
or port group (matches
figure below)

Foundation base appliance

vNIC0

dc-mgmt

vNIC1 on Foundation base
appliance and vCenter
proxy appliance

cloud-mgmt

vCenter proxy appliance
Enterprise appliance
vCenter Server ESX compute
nodes

Cloud Management Network Foundation base appliance
SDN appliance
network node appliances
vCenter proxy appliance

vNIC0 on SDN and network
node appliances

KVM compute nodes
External Network

network node appliances

vNIC2

external

Cloud Data Trunk

network node appliances

vNIC1

CloudTrunk

all compute nodes

IMPORTANT: All of the networks described above must be distinct networks, with the exception
of the External Network. You can use the same network for the External Network and the Data
Center Management Network.
For a detailed explanation of the networks, see Overview of network topology (page 16).
26

Installing CloudSystem on an ESX cluster

The figure below shows a visual representation of the recommended configuration for networks.
Figure 10 ESX sample network configuration

Foundation
base
appliance

vCenter
server
vNIC0

vNIC0

dc-mgmt

vNIC1

cloud-mgmt

vCenter
proxy
appliance
vNIC0

vNIC1

Enterprise
appliance
vNIC0

vNIC0

vmkO

Management Trunk

External Network

vNICo vNIC2 vNIC2
vNIC0 vNIC1 vNIC2
vNIC1

vNIC2

Cloud Data Trunk Vswitch / Port group

vmkN

Data Center Management Network
Cloud Management Network

vNIC0

Network node
Network node
appliances
Network node
appliances
appliances

CloudTrunk
VLAND ID:All(4095)

external

Management Vswitch / Port group

vmkM

SDN
appliance

vmkP

Cloud Data Trunk
Provider Networks
Private Network

Create the ESX management hypervisor and configure the network infrastructure
The following procedure describes the steps required to create the ESX management hypervisor
and configure the network interfaces. The procedure is based on the information provided in the
image above, but you can modify the configuration to fit your network needs.
Do not begin the procedures in this section until you read the following important notes about
configuring networks.
Table 12 Important network configuration information
Important to know

Why it matters

Do not configure the iSCSI initiators on the management
hypervisor.

iSCSI initiators are set up on the compute nodes, not the
management hypervisor. Initiators check to see which
storage resource on the network are available.

Standard or distributed vSwitch names must be unique to
each host in vCenter Server.

vCenter Server requires that all vSwitch names on a host
be unique names.
(Step 4)

Generic names are used in this procedure. Make sure to
substitute the actual names of your interfaces
(ifcfg-eth), bonds (ifcfg-bond), tagged
VLANs (bond.) and bridges
(ifcfg-br-) when configuring the network.

It is important to use the same names defined in the
hardware profile when assigning the networks in the
management hypervisor. If the names do not match, then
network communication errors will occur.
(Step 4)
Return to procedure

Prerequisites
•

You have administrator privileges to log in to VMware vCenter Server

Procedure 3 Configuring the network infrastructure
1.

Understanding the network infrastructure

Create the management hypervisor (host) in vCenter Server.
See Important network configuration information (page 27).
If you plan to use more than one host to manage the virtual appliances, they must be in a
cluster.

3.
4.

Select the management host and click the Configuration tab, then click the Networking link
on the left menu.
Set up the Management vSwitch or port group IDs according to the configuration that you
defined on the server profile and the dedicated network switch. You can also refer to the
sample diagram above for guidance on setting port group IDs.
See Important network configuration information (page 27).

Set the Cloud Data Trunk port group VLAN.
a. To set the port group on a standard vSwitch, set the port group VLAN to 4095 (all VLANs).
b. To set the port group on a distributed vSwitch, list the exact range of VLANs assigned to
the Cloud Data Trunk.
Example: 1–4, 5, 6, 10–100.

Add the following security settings to the Cloud Data Trunk port group.
•

Set Promiscuous mode to ACCEPT.

•

Set MAC Address Changes to ACCEPT.

•

Set Forged Transmits to ACCEPT.

Add the following security settings to the External Network port group.
•

Set Promiscuous mode to ACCEPT.

•

Set MAC Address Changes to ACCEPT.

•

Set Forged Transmits to ACCEPT.

Configuring the ESX management environment
The management environment consists of a single management hypervisor host or a cluster of
management hypervisor hosts that contain the following virtual appliances.
•

A Foundation base appliance

•

An SDN appliance

•

An optional vCenter proxy appliance
One vCenter proxy appliance is needed for each vCenter that is managing compute nodes
in your cloud. If your cloud contains only KVM compute nodes, then you do not need any
vCenter proxy appliances.

•

Three network node appliances

•

An optional Enterprise appliance, if you are using CloudSystem Enterprise

The csstart installation script launches a setup assistant to guide you through the installation
process. When you run csstart, the setup assistant opens and displays fields for capturing details
about the new virtual appliance, network configuration, and vCenter Server connections. The
information is saved in a configuration file called deployer.conf.
Running csstart applies the configuration information saved in deployer.conf to the virtual
appliance designated to host the Foundation base appliance. When the installation completes,
the Foundation base appliance appears in the management cluster in vCenter Server.
The SDN appliance and the network node appliances are automatically created after the Cloud
Networking settings are entered and saved.

Installing CloudSystem on an ESX cluster

Selecting hypervisor security level for CloudSystem installation
You can select one of three security options when you run the csstart setup assistant.
•

Enable full security checks. When csstart runs, it validates certificates to ensure that it is
accessing the correct hypervisor. In an ESX environment, csstart searches for the stored
vCenter Server certificate and matches it to the vCenter Server defined in the installation setup.
The stored certificate file must have the hypervisor’s certificate along with the complete signing
authority chain, unless it is a valid, self-signed certificate. The name of the stored certificate
file is specified using the --os-cacert command from the csstart CLI. If
csstart cannot open the file or validate the certificate, then it will fail.
The Foundation base appliance also verifies certificates before starting up each additional
virtual appliance.
See csstart commands (page 63).

•

Disable security checks for csstart, but enable security when creating the remaining virtual
appliances. When csstart runs, it injects the certificate into the Foundation base appliance,
but does not try to verify vCenter Server. When the additional virtual appliances are created
by the Foundation base appliance, the certificate is used to verify that the correct hypervisor
is used. This is selected by running --auto-accept-cert from the command line, or by
running the csstartgui-auto-accept.bat file to start the installation setup assistant on Windows.
See csstart commands (page 63).

•

Disable security checks. When csstart runs, it does not verify the SSL certificate from the
hypervisor. The Foundation base appliance does not perform security checks when starting
up the other virtual appliances. This is selected by running --insecure from the command
line, or by running the csstartgui-insecure.bat file to start the installation setup assistant on
Windows.
See csstart commands (page 63).

See also
•

Using the csstart CLI to install the Foundation base appliance (page 64)

•

Troubleshoot installation issues (page 52)

Configuring the Foundation base appliance on KVM
Read the following important notes before configuring the Foundation base appliance.
Table 16 Important CloudSystem configuration information
Important to know

Why it matters

HP recommends that you set the time on the management Data records can get out of sync between appliances when
hypervisor to automatically sync with the NTP server. The time is not set to automatically sync with the NTP server.
Foundation and Enterprise appliances should be synced
with the virtual machine host running the management
hypervisor.
If you are using the RHEL default driver, Broadcom TG3
NIC, then you must update the driver.

Using an outdated driver will prevent you from accessing
a provisioned instance with a floating IP.

See HP Support Center.
If you are using the Emulex driver, be2net, then you must
upgrade the driver to version 4.4.245.0 or later.

Using an outdated driver will interrupt SSH and TCP
network traffic.

See Citrix support.
When installing with Linux, you should run the csstart
setup assistant from a directory with restricted access in
order to protect this file.

The deployer.conf file contains confidential information,
such as passwords, and should be kept secure.
(Step 2)

The installation images and the corresponding checksums The csstart setup assistant does not provide a way to
should be placed in the default /CloudSystem/images change the image location. You must update that directly
directory
in the deployer.conf file.
See Using the csstart CLI to install the Foundation base
appliance (page 64).
Exit the csstart setup assistant before using a text editor The setup assistant caches the contents of the deployer.conf
file in memory. If you edit deployer.conf outside of the
to change the advanced fields in the deployer.conf file.
setup assistant, then the updates are not captured and
applied during installation.
See Using the csstart CLI to install the Foundation base
appliance (page 64).
When you run the csstart setup assistant, you will be
asked for a Glance disk size. Make sure to size the disk
appropriately.

The installation creates a Glance disk on the same
datastore where the base appliance template is stored.
You must have sufficient space for the virtual appliance
See Formula to determine the storage requirements for the boot disks, as well as the Glance disk, or the installation
management hypervisor (page 12) for sizing calculations. process will not be able to complete.
(Step 7)
Do not move, delete or rename images after you create
the base appliance.

In order to speed up virtual machine boot times and save
disk space, csstart does not make a full copy of the
image. Changing the name or location of the image
disrupts the operation of the shared copy encoded by
csstart.
Return to procedure

Prerequisites
•

CloudSystem-Foundation-KVM–8.0.0.20 is downloaded from the release site and images are
unpacked on a Linux server.

•

A /CloudSystem directory is created on the management hypervisor.

Configuring the KVM management environment

•

A /CloudSystem/images directory is created on the management hypervisor and the
qcow2 images and checksums are moved to this directory. The /CloudSystem/images
directory should be owned by root and should have permissions set to 755. This setting allows
write access only to the root user for the files owned by root.

•

128 GB of memory is available on the management hypervisor for image storage
See HP CloudSystem installation prerequisites (page 11).

•

The csstart folder and the three csstart-XXX.bat files are moved to the management hypervisor.
See Prepare for the installation (page 21).

•

The network ifcfg files are created in the management hypervisor
etc/sysconfig/network-scripts directory.
See Configure the network infrastructure on the KVM management hypervisor (page 36).

Procedure 9 Configuring the Foundation base appliance on KVM
1.

Gather the following information, which you will enter later in the csstart setup assistant.
•

Foundation base appliance host name and IP address, if using static IP

•

Glance disk size

•

Foundation base appliance new secure password

•

Data Center Management subnet mask

•

Gateway address (jump box on the management network)

•

Preferred DNS server IP address

•

Management hypervisor host name, user name and password

•

Name of the Data Center Management Network bridge

•

Name of the Cloud Management Network bridge

•

Name of the Cloud Data Trunk bridge

•

Name of the External Network bridge

Set permissions to run csstart:
chmod 700 csstart

Add a hole in the firewall for port 5000 on the Linux system:
iptables -I INPUT 3 -p tcp -m state --state NEW -m tcp --dport 5000 -j ACCEPT

Launch the csstart-XXX.bat file with the preferred security checks.
See Selecting hypervisor security level for CloudSystem installation (page 40).

6.
7.

Open a supported browser and type http://IP_address_of_the_KVM
management_host:5000
Follow the prompts in the csstart setup assistant, using the information you gathered in step
one.
See Important CloudSystem configuration information (page 41).

When the installation completes, log in to the management hypervisor and verify that the
Foundation base appliance was created:
virsh list –all

The SDN appliance and network node appliances are created after entering Cloud Network
settings in the CloudSystem Console.

Installing CloudSystem on a KVM hypervisor

See Troubleshoot installation issues (page 52).
Next step: Setting up the CloudSystem Console for the first time (page 44)

Configuring the KVM management environment

7 Setting up the CloudSystem Console for the first time
To complete the final step of the CloudSystem Foundation installation, add Cloud Networking
information to the CloudSystem Console. Once the network setting is saved, the Foundation base
appliance automatically creates the SDN appliance and network node appliances.
For definitions of the SDN appliance and network node appliances, see CloudSystem Foundation
components (page 8).

Configuring cloud networking
IMPORTANT: Before you apply the Cloud Networking configuration in the CloudSystem Console,
verify that you have the correct subnets. Cloud Networking is intended to be configured only once.
If you need to change Cloud Networking after compute nodes are activated, you will need to
delete all of the compute nodes first.
Prerequisites
•

Minimum required privileges: Infrastructure administrator

•

The appliance is physically connected to the network.

•

The Foundation base appliance is installed.

Procedure 10 Configuring cloud networking for the first time
1.
2.

Open a supported browser and enter the url https://.
Log in to the CloudSystem Console using the administrator user name and the new secure
password you defined in csstart.
The console opens to the Dashboard screen.

3.
4.

Expand the help icon
along the right side of the screen.
Under the Recommended actions heading, select Edit Cloud Networking.
The Cloud Networking window opens.

6.
7.

Enter the Cloud Management subnet in the field provided. This is the Cloud Management
Network you established in Configuring the CloudSystem network infrastructure (page 35) or
Understanding the network infrastructure (page 26).
Click OK to save the settings.
Verify that the SDN appliance and network node appliances are created and running:
•

For ESX, check vCenter Server to make sure the appliances are in the cluster.

•

For KVM, log in to the management hypervisor and run the command
virsh list

Performing time synchronization on the Foundation base appliance
CloudSystem services can encounter errors and unpredictable system behavior can occur if the
time on the Foundation base appliance, vCenter proxy appliance and the Enterprise appliance
differ by more than a few minutes. Make sure the correct Time and Language synchronization
setting in the CloudSystem Console is selected before CloudSystem is available for general use.
Prerequisites

•

Foundation base appliance is successfully installed on a management hypervisor.

•

Management hypervisor where the Foundation base appliance was installed is synchronized
with a set of NTP servers.

Setting up the CloudSystem Console for the first time

Procedure 11 Synchronizing the Foundation base appliance with the management hypervisor NTP
servers
1.
2.

For ESX:
1. In the Time and Language settings section, change the setting to Synchronize with
time server.
2. Enter the IP address of the external NTP servers.
These servers should be the same NTP servers used by the management hypervisor.

•

For KVM:
1. In the Time and Language settings section, keep the setting Synchronize with VM
host.

Save the changes.

Next steps: Choose any of the following next steps.
•

Refer to the HP CloudSystem 8.0 Administrator Guide at Enterprise Information Library for
additional information on configuring ESX and KVM compute nodes, configuring cloud
resources and deploying instances.

•

Preparing HP Operations Orchestration for CloudSystem Foundation (page 47)

•

Installing CloudSystem Enterprise (page 49)

Performing time synchronization on the Foundation base appliance

8 CloudSystem Foundation installation next steps
The CloudSystem Foundation installation is complete, but you still need to prepare and build
resources for the cloud. The table below provides links to resources that will help you complete
these tasks.
Table 17 Cloud preparation steps
Installation Step

Additional Resources

Stage and prepare compute nodes.

See the Resource configuration in
CloudSystem: Compute node creation
chapter in the HP CloudSystem 8.0
Administrator Guide at Enterprise
Information Library

Build and manage cloud resources.

See Cloud service provisioning, deployment
and service management in CloudSystem in
the HP CloudSystem 8.0 Administrator
Guide at Enterprise Information Library

If you are not ready to prepare your cloud, you can go to:

•

Preparing HP Operations Orchestration for CloudSystem Foundation (page 47)

•

Installing CloudSystem Enterprise (page 49)

CloudSystem Foundation installation next steps

9 Preparing HP Operations Orchestration for CloudSystem
Foundation
HP Operations Orchestration (OO) is a next generation IT Process Automation solution. OO supports
CloudSystem in two ways.
•

HP Operations Orchestration Central (OO Central) is integrated with CloudSystem Foundation.
It allows you to run workflows to perform administrative tasks in Foundation.

•

HP Operations Orchestration Studio (OO Studio) is a separate installation. It allows you to
customize workflows, which you can then run in OO Central.

Using OO Central
To access OO Central, open the CloudSystem Console and select Integrated Tools from the main
menu.
OO Central comes with five general use workflows, which perform administrative tasks for
CloudSystem Foundation. You can run these workflows from OO Central.
•

base-cp: This workflow provides support for integrations with various solutions (email, excel,
active directory, file system, etc). It also includes basic operations used by other the content
packs.

•

systems-cp: This workflow provides support for integrating operating systems such as AIX,
FreeBSD, HP UX, Red Hat, Solaris, SUSE Linux and Windows.

•

virtualization-cp: This workflow supports integration with virtualization platforms such as Citrix
Xen Server, Hyper-V, KVM, SCVMM and VMware.

•

hp-solutions-cp: This workflow provides support for integrating HP solutions such as HP
ArchSight, HP Fortify, HP Load Runner, HP Application Lifecycle Management, and HP Onboard
Administrator.

•

cloud-cp: This workflow supports exposed APIs from cloud providers like OpenStack, Amazon
EC2, IAM, S3 and VMware vCloud.

Once the workflows are loaded, you can run them at any time. For more information about HP
Operations Orchestration, see http://www.hp.com/go/oo.

Installing OO Studio
There are two parts to the OO Studio installation.
•

Installing OO Studio (page 47)

•

Upgrading OO Studio (page 48)

Installing OO Studio allows you to customize workflows. Customized flows are saved as content
packs and exported to a local directory. You can then pull the customized flows into OO Central
and run them to perform administrative tasks in CloudSystem Foundation.
Prerequisites
•

Foundation is fully installed and first time setup is completed.

•

You have access to a Windows workstation.

•

System requirements are met. Refer to HP Operations Orchestration System Requirements at
Enterprise Information Library.

Procedure 12 Installing OO Studio
1.
2.

Unzip the HP CloudSystem OO Studio 8.0 Mar 2014 .zip file (Z7550-01319.zip).
Untar the zip file.
Using OO Central

Launch the OO-installer.exe file.
a. Take all default settings when moving through the installation setup, until the Content
packs screen.
b. Do not import content packs at this time. Skip to the next screen.
c. Click Next and finish the installation.

Complete the OO Studio upgrade procedure. Upgrading to OO Studio 10.02 is required.

Procedure 13 Upgrading OO Studio
1.
2.

From the unzipped HP CloudSystem OO Studio 8.0 Mar 2014 .zip file, find
oo-studio-upgrade.zip.
Unzip the oo-studio-upgrade.zip file into the C:/Program
Files/Hewlett-Packard/HP Operations Orchestration folder.
A new folder named upgrade is created.
IMPORTANT: Make sure to extract the zip file directly in the main installation folder, and
not a sub-folder. The apply-upgrade.bat script will only work if the upgrade folder is directly
under the main installation folder.

Open a Windows command line and perform the following directory changes:
cd/ HP Operations Orchestration
cd/ upgrade
cd 10.02
cd bin

4.
5.

Make sure OO Studio is closed. You should not execute the following command with the
program open.
Run the command
apply–upgrade.bat

6.
7.
8.

Type Y to apply the upgrade.
Wait for the UPGRADE SUCCESS message to verify that the upgrade completed without errors.
This can take several minutes.
Optional: If you want to edit the content packs included in OO Central, import the content
packs using the following steps:
•

Open OO Studio.

•

Under Dependencies, click Import Content Pack.

•

Select all the jar files extracted from the OOContentPacks.zip and click Open.

•

Verify that the content packs display in the Dependencies section.

Next steps

•

Refer to the OO Studio documentation bundled with the OO Studio program files for additional
information on using workflows.

•

Refer to the HP CloudSystem 8.0 Administrator Guide at Enterprise Information Library for
additional information.

Preparing HP Operations Orchestration for CloudSystem Foundation

10 Installing CloudSystem Enterprise
CloudSystem Enterprise is an IaaS, PaaS and SaaS solution used for complex cloud provisioning.
Administrators create infrastructure templates and provide them as service offerings in the
Marketplace Portal. Enterprise includes designer software, the Marketplace Portal, and full HP CSA
functionality. See Explanation of solution components (page 6) for a detailed description of
components.
IMPORTANT: Do not change the Foundation base appliance network configuration (host name,
IP address, subnet mask, gateway address, DNS server or alternate DNS server) after Enterprise
is installed. Doing so will break communication between Foundation and Enterprise and you will
not be able to create subscriptions, create or edit designs or manage existing subscriptions in HP
CSA.

Installing the Enterprise appliance
Use the CloudSystem Console to launch the Enterprise installation. When you install Enterprise, a
new virtual appliance is created on the management hypervisor. The entire installation process
should take about 20 minutes.
Table 18 Important CloudSystem configuration information
Important to know

Why it matters

The management hypervisors hosting the Foundation
appliance and Enterprise appliance must use the same
NTP servers for time sync.

When the two appliances are out of sync, then you will
not be able to create designs using HP CSA.

Enterprise and Foundation must use the same IP address
conventions.

If Foundation was configured to support DHCP address
assignments, this configuration will apply automatically to
Enterprise. If Foundation was configured to support static
IP addresses, you must enter an IP address for the new
Enterprise virtual appliance.

If you want to enable strong OpenLDAP or Active Directory
certificate validation for authentication to the CloudSystem
Portal, review the steps in the “Enabling strong certificate
validation in the CloudSystem Portal” appendix of the HP
CloudSystem 8.0 Administrator Guidebefore you install
Enterprise.

Strong certificate validation may require a change to the
alternate DNS server on the Foundation base
appliance. Any changes to the Foundation base appliance
network configuration must be made before Enterprise is
installed, because Enterprise uses these settings to
communicate with Foundation.

Prerequisites
•

Foundation is fully installed and first time setup is complete.

•

In an ESX configuration, the Enterprise OVA is added to the datastore that supports the
management cluster in vCenter Server.

•

In a KVM configuration, the Enterprise qcow2 image is saved to the Linux or Windows server
where you ran csstart to install the Foundation base appliance.

•

You are using a supported Chrome browser. See HP CloudSystem installation prerequisites
(page 11).

•

You have selected an IP address, if using static IPs, and registered the FQDN for the Enterprise
appliance with the DNS server.

Procedure 14 Installing CloudSystem Enterprise
1.
2.
3.

Log in to the CloudSystem Console.
Select Enterprise from the main menu.
Click the Install CloudSystem Enterprise button.
The installation window opens.
Installing the Enterprise appliance

Figure 12 Enterprise screen in CloudSystem Foundation

4.
5.
6.

Review the installation instructions, then click Next.
In the Enterprise appliance host name field, enter the FQDN that you registered with the DNS
server.
Enter the static IP address for the new Enterprise appliance.
NOTE: If the Data Center Management Network configured in Foundation uses DHCP, skip
this step.

7.
8.

Click Next.
Enter the user name and password required to log in to OO Central.
OO Central runs on the Foundation base appliance. The user name and password are the
same as the user name and password used to access the CloudSystem Console, except that
you must enter the OO user name with all lower case letters. Once you log in to OO Central
for the first time, you can change the user name and password.

9. Click Install.
10. Verify that the appliance was created successfully.
After Enterprise is installed, a Tools and Configuration pane are added to the Enterprise screen.
The Tools pane displays links to the Cloud Service Management Console and the Marketplace
Portal.
All existing Foundation functionality will continue to be available. Enterprise appliance details can
be monitored in the CloudSystem Console from the Enterprise screen. Perform all management
tasks for the Enterprise appliance in the CloudSystem Console on the Settings screen.

Installing CloudSystem Enterprise

Procedure 15 Configure Enterprise to use the Foundation NTP servers for time sync
If you are using an ESX management hypervisor to mange the Enterprise appliance, then you will
need to perform the following procedure.
1. Enable the console user for the Enterprise appliance.
See appendix C, “Supported console operations on the CloudSystem Foundation appliance”
in the HP CloudSystem 8.0 Administrator Guide at the Enterprise Information Library.
2.
3.

Log in as cloudadmin through the Enterprise console. You can use CTRL+ALT+F1 to switch
to the console log in prompt.
Edit the NTP configuration file to add the server entries:
sudo vi/etc/ntp.conf

Restart the NTP service:
sudo service ntpd restart

Restart the Enterprise appliance.

See also: Refer to the HP CloudSystem 8.0 Administrator Guide at the Enterprise Information Library
for additional information on using HP CSA to create designs.
Next steps: See “Understanding CloudSystem Enterprise” in the HP CloudSystem 8.0 Administrator
Guide at Enterprise Information Library.

Installing the Enterprise appliance

11 Troubleshoot installation issues
•

csstart errors (page 53)

•

OO Studio installation errors (page 55)

•

Enterprise upgrade errors (page 55)

NOTE: For additional troubleshooting information, see the Troubleshooting chapters in the HP
CloudSystem 8.0 Administrator Guide, available at Enterprise Information Library.

Basic troubleshooting techniques
HP CloudSystem has a variety of troubleshooting tools you can use to resolve issues. By following
a combined approach of examining screens and logs, you can obtain a history of activity and the
errors encountered.
•

The Activity screen in the CloudSystem Console displays a log of all changes made on the
appliance, whether user-initiated or appliance-initiated. It is similar to an audit log, but with
finer detail and it is easier to access from the UI.
The Activity screen also provides a log of health alerts and status notifications.

•

You can download an audit log in the CloudSystem Console to help you understand what
security relevant actions took place on the system.

•

You can create a support dump file in the CloudSystem Console to gather logs and other
information required for debugging into an encrypted, compressed file that you can send to
your authorized support representative for analysis.

Recommendation

Details

Look for a message

About syntax errors:
• The user interface checks for syntax when you enter a value. If you make a syntax error,
an instructional message appears next to the entry. The user interface or command line
continues to display messages until you enter the correct value.

About network setup errors:
• Before applying them, the appliance verifies key network parameters like the IP address
and the fully qualified domain name (FQDN), to ensure that they have the proper format.
• After network settings are applied, the appliance performs additional validation, such as
reachability checks and host name to IP lookup. If a parameter is incorrect, the appliance
generates an alert that describes validation errors for the Network Interface Card (NIC),
and the connection between the browser and the appliance can be lost.
Examine the Activity
screen

To find a message for an activity:

Examine the appliance
virtual machine

When VM host is down or nonresponsive:

1. Locate recent activities with a severity of Critical, Warning, or Unknown.
2. Read the message for problem identification and potential solutions.
3. Expand the activity to add notes to the activity details.

1. From the local computer, use the ping command to determine if you can reach the
appliance.
• If the ping command is successful, determine that the browser settings, especially the
proxy server, are correct.
Consider bypassing the proxy server.
• If the ping command did not reach the appliance, ensure that the appliance is connected
to the network.
2. Log onto hypervisor to verify that the hypervisor is running.

Troubleshoot installation issues

Recommendation

Details
3. Verify that the virtual guest for the appliance is operational.
4. Ensure that the VM host configuration is valid.
Verify the accuracy of the IP address and other network parameters for the VM host.
5. From the management console, ensure that the appliance network settings are accurate.
6. Examine the hypervisor performance data. If the appliance is running at 100% utilization,
restart the hypervisor.

Enable console access

About console access:
• Use the following csadmin console-users CLI commands to enable console access and set
the password. After running the command, you can locate logs for additional troubleshooting
information. The VM_name is the virtual machine where you want to execute the command.
The csadmin console-users commands are supported on the Foundation base appliance,
the Enterprise appliance, and the Proxy appliances.

To enable console access:
1. Open the CLI.
2. Enter the command:
csadmin console-users enable --vm-name VM_name

To set the password console access:
• Open the CLI.
• Enter the command:
csadmin console-users set-password --password CAPasswd --vm-name
VM_name
Where CAPasswd is the password for the Cloud Administrator.
For more information on the use of CLI, see HP CloudSystem 8.0 Administrator Guide at
Enterprise Information Library.

csstart errors
The log file is the best resource for identifying the type of error that occurred. Check the log file
first to narrow down error possibilities. You can also review the problems and recommendations
listed below.
Table 19 ESX troubleshooting tips
Symptom

Possible cause and recommendation

You see the error
Installation
failed. Please
correct the error
and try again.

The csstart web UI does not run correctly on a Japanese Windows system
• Before running csstart, set the environment variable PYTHONIOENCODING=UTF-8
in the steps below.

◦

If you are running csstart using one of the csstartgui-*.bat files, set this
variable in the csstartgui-*.bat file that you are using.

◦

If you are running csstart from a command prompt window, set this variable in
the csstartgui-*.bat file before running the csstart gui --start-browser
... command.

csstart errors

Table 19 ESX troubleshooting tips (continued)
Symptom

Possible cause and recommendation
1. Edit csstartgui-*.bat.
2. Add set PYTHONIOENCODING=UTF-8 as the first line of the file, and save the file.
3. Double-click the file.
• Run the Linux version of csstart. When you install CloudSystem on a KVM host, you
can run csstart on the hypervisor.
• Set English or Chinese as the preferred language in the web browser.

csstart fails to install User does not have proper privileges in vCenter Server to create virtual
CloudSystem on vCenter machines
Server and you see the
1. Log in to vCenter Server.
error message
[Intlmpl-ESX]
2. Add the privilege for clone operations to the role that is running csstart.
cloneFromTemplate,
This operation allows users to allocate space in the datastore, create virtual machines,
com.vmware.vim25.No
power up and down virtual machines and delete virtual machines on the management
Permission
cluster.
3. From the Host and Cluster view, select the management cluster.
4. Right-click the management cluster and select Add Permissions.
The Assign Permissions window opens.
5. In the left pane, select the role that is running csstart.
This is the role that receives the new permission.
6. In the right pane, scroll down to Virtual machine and expand Provisioning.
7. Select the clone virtual machine permission.
8. Click OK to save the new permission for the role.
Security check fails when
running csstart and
you see the message
Warning: Different
certificates are
being used for SSL
and Solution users.
Manual intervention
is required.

Certificate files do not match
1. Press CTRL-C to interrupt csstart.
2. Query the hypervisor where vCenter Server is installed:
# keytool –printcert –rfc –sslserver servername[:port]
3. Copy everything from -----BEGIN CERTIFICATE----- to -----END CERTIFICATE----- into a new
file.
4. Add a name to the file:

--os-cert option
Security checks fail when
running csstart and
5. Move the file to the same directory where csstart is located.
you see the message
6. Retry the procedure Configuring the Foundation base appliance on ESX (page 32).
Using certificate
file: No File Found
Error: Failed to
validate your
vCenter using ssl.
Security checks fail
Certificate file is missing
because the SSL certificate
expired or is invalid due 1. Use the Add CA Cert option in the vCenter Server Registration screen to add the new
SSL certificate.
to a hypervisor host name
2.
Retry the procedure Configuring the Foundation base appliance on ESX (page 32).
change
You see the message
An upgraded version of vCenter Server has a server certificate with a 512
Certificates do not bit key length
conform to
1. Generate a new certificate for vCenter Server.
algorithm
2. Retry the procedure Configuring the Foundation base appliance on ESX (page 32).
constraints

Troubleshoot installation issues

Table 19 ESX troubleshooting tips (continued)
Symptom

Possible cause and recommendation

Modify the java.security file to accept RSA keys shorter than 1024 bits
1. Log on to the Foundation base appliance.
2. Open
/usr/lib/jvm/jre-1.7.0-openjdk.x86_64/lib/security/java.security
3. Comment out the following line:
jdk.certpath.disabledAlgorithms=MD2, RSA keySize < 1024
IMPORTANT: Make sure that you understand the security implications of using shorter
keys before you modify the java.security file.

Table 20 KVM troubleshooting tips
Symptom

Possible cause and recommendation

RHEL default drivers are
not able to manage
VLANs

Broadcom TG3 NIC driver needs to be upgraded
1. Find the driver and firmware here: HP Support Center.
2. Install the upgrade and retry the procedure Configuring the Foundation base appliance
on ESX (page 32).

Security checks fail when Users directory does not contain an SSH key
running csstart and
1. Log on to Foundation base appliance.
you see the message
2. Edit the known_hosts file with the SSH key value.
Using certificate
file: No File Found 3. Run csstart again.
Error: Failed to
validate your
vCenter using ssl.

OO Studio installation errors
Symptom

Possible cause and recommendation

Anti-virus software
prevents OO Studio
install and displays the
message vbasic
error

OO Studio version needs an upgrade
1. Apply the OO Studio upgrade using the Upgrading OO Studio (page 48) procedure.

Enterprise upgrade errors
The table below contains errors that can occur during an Enterprise upgrade or when using the
HP CSA management console.
Support dump details: You can create a support dump from the csadmin CLI, if you have it installed
on your Windows or Linux server. It is included in the CloudSystem-Tools-8.0.0.20.tar.
Once csadmin is installed, there are two relevant commands:
•

$csadmin appliance list: lists the names of the available management virtual machines.
This lets you find the appropriate appliance name.

•

$csadmin appliance supportdump —av : creates a dump of all
relevant logs and stores it on the management hypervisor. The support dump is saved to your
staging server.

OO Studio installation errors

Table 21 Enterprise troubleshooting tips
Symptom

Possible cause and recommendation

The Enterprise
installation progress
indicator is not visible

The console session was terminated
1. While the installation is in progress, keep your console session active.
• Do not refresh the Enterprise screen.
• Do not log off the CloudSystem Console.
NOTE: While the installation is in progress, you can navigate to other console screens
and see the progress indicator when you return to the Enterprise screen.

You see the message
CloudSystem
Enterprise
installation
failed

CloudSystem-Enterprise–8.0.020 was not added to the ESX cluster or KVM
management hypervisor
1. For ESX:
• Log in to vCenter Server and make sure the CS-Enterprise-8.0.0.20 OVA is
saved to the datastore supporting the management cluster.
• The image name must be CS-Enterprise-8.0.0.20.
2. For KVM:
• Log in to the management hypervisor and make sure the
CloudSystem-Enterprise-8.0.0.20 image is saved in
/CloudSystem/images.

You see the message
Enterprise appliance is not done booting
CloudSystem
1. Wait a few minutes. The Enterprise appliance is not ready.
Enterprise
2. Retry the login action.
installation
succeeded, but
could not start up
due to a
communication
problem
When logging in to HP Enterprise appliance is not ready
CSA for the first time you
1. Wait a few minutes. The Enterprise appliance is not ready and is still trying to bring up
see the message
the HP CSA appliance or is still recovering from a reboot.
Default
2.
Retry the login action.
organization not
found

Troubleshoot installation issues

12 Support and other resources
IMPORTANT: This product contains a technical feature that will allow an on-site authorized
support representative to access your system, through the system console, to assess problems that
you have reported. This access will be controlled by a password generated by HP that will only
be provided to the authorized support representative. You can disable access at any time while
the system is running.
HP technical support personnel are not granted remote access to the appliance.
•

Information to collect before contacting HP (page 57)

•

How to contact HP (page 57)

•

Registering for software technical support and update service (page 57)

•

HP authorized resellers (page 58)

•

Documentation feedback (page 58)

•

Related information (page 58)

Information to collect before contacting HP
Be sure to have the following information available before you contact HP:
•

Software product name

•

Hardware product model number

•

Operating system type and version

•

Applicable error message

•

Third-party hardware or software

•

Technical support registration number (if applicable)

How to contact HP
Use the following methods to contact HP:
•

To obtain HP contact information for any country, see the Contact HP worldwide website:
http://www.hp.com/go/assistance

•

Use the Get help from HP link on the HP Support Center:
http://www.hp.com/go/hpsc

•

To contact HP by telephone in the United States, use the Contact HP – Phone Assist website
to determine the telephone number that precisely fits your needs. For continuous quality
improvement, conversations might be recorded or monitored.
http://www8.hp.com/us/en/contact-hp/phone-assist.html#section1

Registering for software technical support and update service
HP CloudSystem includes one year of 24 x 7 HP Software Technical Support and Update Service.
This service provides access to HP technical resources for assistance in resolving software
implementation or operations problems.
The service also provides access to software updates and reference manuals, either in electronic
form or on physical media as they are made available from HP. Customers who purchase an
electronic license are eligible for electronic updates only.

Information to collect before contacting HP

With this service, HP CloudSystem customers benefit from expedited problem resolution as well as
proactive notification and delivery of software updates. For more information about this service,
see the following website:
http://www.hp.com/services/insight
Registration for this service takes place following online redemption of the license certificate.

HP authorized resellers
For the name of the nearest HP authorized reseller, see the following sources:
•

In the United States, see the U.S. HP partner and store locator website:
http://www.hp.com/service_locator

•

In other locations, see the Contact HP worldwide website:
http://www.hp.com/go/assistance

Documentation feedback
HP is committed to providing documentation that meets your needs.
To help us improve the documentation, send your suggestions and comments to:
docsfeedback@hp.com
In your mail message, include the following information. They are located on the front cover.
•

Document title

•

Published date

•

Edition number

Help us pinpoint your concern by posting the document title in the Subject line of your mail message.

Related information
•

HP CloudSystem documents (page 58)

•

HP Software documents (page 59)

•

HP Insight Management documents (page 59)

•

Third-party documents (page 59)

•

HP 3PAR StoreServ Storage documents (page 60)

•

HP ProLiant servers documents (page 61)

Use this section to learn about available documentation for HP CloudSystem components and
related products.

HP CloudSystem documents
The latest versions of HP CloudSystem manuals and white papers can be downloaded from the
Enterprise Information Library at http://www.hp.com/go/CloudSystem/docs, including the following
documents:

•

HP CloudSystem 8.0 Release Notes

•

HP CloudSystem 8.0 Installation and Configuration Guide

•

HP CloudSystem 8.0 Administrator Guide

•

HP CloudSystem Help

•

HP CSA Concepts Guide

•

HP CSA Release Notes

Support and other resources

•

HP CSA API Quick Start Guide

•

HP CSA Troubleshooting

•

HP CSA API Reference

•

HP CSA Documentation List

•

HP Operations Orchestration Concepts

•

HP Operations Orchestration Central User Guide

•

HP Operations Orchestration Application Program Interface (API) Guide

Online help for the CloudSystem Console is available by clicking the help control button:
The help control button expands the help sidebar. Links in the sidebar open UI screens for
Recommended Tasks, help for the current screen (Help on this page), and help for all tasks and
procedures (Browse help).

HP Software documents
The latest versions of HP Software product manuals and white papers can be downloaded from
the HP Software Product Manuals web site at http://support.openview.hp.com/selfsolve/manuals.

Finding documents on the HP Software Product Manuals web site
Follow these instructions to access all technical manuals for HP Cloud Service Automation and HP
Operations Orchestration.
1. Go to the HP Software Product Manuals web site (http://support.openview.hp.com/selfsolve/
manuals).
2. Log in with your HP Passport user name and password.
OR
If you do not have an HP Passport, click New users — please register to create an HP Passport,
then return to this page and log in.
3.
4.
5.
6.

In the Product list box, scroll down and select a product name.
In the Product Version list, select the version of the manuals that you are interested in.
In the Operating System list, select the relevant operating system.
Click the Search button to see a list of linked titles.

HP Insight Management documents
The latest versions of HP Matrix Operating Environment manuals, white papers, and the HP Insight
Management Support Matrix can be downloaded from the HP Enterprise Information Library at
http://www.hp.com/go/matrixoe/docs, including the following documents:
•

HP Matrix Operating Environment Release Notes

•

HP Insight Management Support Matrix

•

HP Matrix Operating Environment Infrastructure Orchestration User Guide

•

Cloud bursting with HP CloudSystem Matrix infrastructure orchestration

Third-party documents
CloudSystem incorporates OpenStack technology (listed below), and interoperates with other
third-party virtualization software.

Related information

OpenStack Havana
•

OpenStack Documentation for Havana releases

◦

Cloud Administrator Guide

◦

Virtual Machine Image Guide

◦

API Quick Start

◦

Admin User Guide

◦

End User Guide
–

Command reference
–

Keystone commands

–

Glance commands

–

Neutron commands

–

Nova commands

–

Cinder commands

Red Hat
•

Red Hat Enterprise Linux 6 documents

VMware
•

VMware vSphere documents

HP 3PAR StoreServ Storage documents
The latest versions of HP 3PAR StoreServ Storage manuals can be downloaded from the HP Support
Center, including the following documents:
•

HP 3PAR StoreServ Storage Concepts Guide

•

HP 3PAR StoreServ Storage Troubleshooting Guide

Finding documents on the HP Support Center web site
Follow these instructions to access all technical manuals hosted on the HP Support Center.
1. Go to the HP Support Center web site (http://www.hp.com/go/support).
2. Select the Drivers & Software tab.
3. Type a product name in the Find by product box and click Go.
4. Select a specific product from the resulting list.
5. On the specific product support page, locate the search fields at the top right of the web page.
The top search field will contain the product name that you selected earlier in your search.
6.

In the second search field below the first, type “manuals” and press Enter.
If the list of documents is long, it might take a few seconds to load the page with the search
results.

You can refine the search results using the sorting options in the document table headers or
by further refining your search criteria in the search feature that is located immediately above
the document list.

Support and other resources

HP ProLiant servers documents
•

The HP Integrated Lights-Out QuickSpecs contain support information and are available from
the iLO product website:
http://www.hp.com/go/ilo

•

HP ProLiant servers:

◦

ProLiant BL BladeSystem servers:
http://www.hp.com/go/blades

◦

ProLiant DL series rack mount servers:
http://www.hp.com/servers/dl

◦

ProLiant ML series tower servers:
http://www.hp.com/servers/ml

◦

ProLiant SL series scalable system servers:
http://h10010.www1.hp.com/wwpc/us/en/sm/WF02a/15351-15351-3896136.html

Related information

A Command line interfaces
Four command line interfaces (CLIs) are packaged in the CloudSystem release download.
•

csstart.exe: provides command line access to run CloudSystem installation commands.

•

csadmin.exe: provides command line access to run CloudSystem administrative commands.

•

CS-client-CLI-8.0.0.2.msi: provides the ability to run CloudSystem and OpenStack command
lines from a Windows command prompt.

•

CS-client-CLI-8.0.0.2.rpm: provides the ability to run CloudSystem and OpenStack command
lines from a Linux system.

Preparing to use CLIs
The CLIs are packaged in the CloudSystem-Tools-8.0.0.20 release tar. The csstart and csadmin
CLIs do not require additional installation steps.
The OpenStack CLIs must be installed on either a Windows or Linux workstation.

Installing OpenStack CLIs on Windows
Prerequisite
•

If using an ESX management hypervisor, the CS-client-CLI-8.0.0.2.rpm file is in the
cluster datastore.

•

If using a KVM management hypervisor, the CS-client-CLI-8.0.0.2.msi is in the
/CloudSystem directory.

Procedure 16 Installing the OpenStack CLI on a Windows workstation
1.
2.

From a Windows workstation, double-click the MSI file to execute it and launch the Windows
installer.
Follow the Windows installer screen instructions to complete the installation.
The executable is installed in c:\Program Files\Hewlett-Packard\RemoteCli.

3. Open the Windows command prompt and execute the CLI.
See also
•

For a list of unsupported OpenStack Havana CLI commands, see the Limitations on support
for OpenStack CLI commands appendix in the HP CloudSystem 8.0 Administrator Guide at
Enterprise Information Library.

•

For a list of all OpenStack Havana CLI commands, see OpenStack Documention for Havava
releases.

Installing OpenStack CLIs on Linux
Prerequisite
•

If using an ESX management hypervisor, the CS-client-CLI-8.0.0.2.rpm file is in the
cluster datastore.

•

If using a KVM management hypervisor, the CS-client-CLI-8.0.0.2.msi is in the
/CloudSystem directory.

Procedure 17 Installing the OpenStack CLI on a LInux workstation
1.

From a Linux workstation run:
yum install CS–client–CLI–8.0.0.2.rpm

The executable is installed under /usr/bin.
2.

Open an SSH client and execute the CLI.

Command line interfaces

Hp Cloudsystem Foundation Installation Guide 8.0 And Configuration

Navigation menu

Versions of this User Manual:

Views

Navigation