This document provides instructions for installing and configuring IBM SmartCloud Entry+ for System X. It describes deploying the IBM SmartCloud Entry virtual appliance to an existing VMware vSphere environment. It also covers optional components like Tivoli Provisioning Manager for Images to manage virtual images, and IBM Systems Director for system management. The document is intended to supplement official IBM product documentation for a quick installation and proof of concept of the IBM SmartCloud Entry cloud management platform.

1. IBM
IBM SmartCloud Entry+ for System X
Administrators Guide – Version 2.2
This edition applies to version 2, release 2, modification 0 of IBM SmartCloud Entry+ for
System X (product numbers 5641-SK1 and 5641-SK3) and to all subsequent releases and
modifications until otherwise indicated in new editions.
© Copyright International Business Machines Corporation 2011.
US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP
Schedule Contract with IBM Corp.

2. Table of Contents
Introduction........................................................................................................................1
Solution overview.....................................................................................................................1
Understanding and using the guide.........................................................................................2
Suggested additional reading and education..........................................................................2
IBM SmartCloud Entry...........................................................................................................................2
Tivoli Provisioning Manager for Images................................................................................................2
Pre-requisites......................................................................................................................3
Component installation......................................................................................................4
IBM® SmartCloud Entry........................................................................................................4
Database installation...............................................................................................................................4
Deploying the vApp................................................................................................................................4
Verifying the IBM SmartCloud Entry virtual machine............................................................................6
Connecting to the IBM SmartCloud Entry User Interface......................................................................7
Configuring IBM SmartCloud Entry.......................................................................................................7
Tivoli® Provisioning Manager for Images.............................................................................8
Installing TPMfI......................................................................................................................................8
Connecting to the TPMfI user interface..................................................................................................8
IBM Systems Director Standard Edition................................................................................8
IBM Systems Director Storage Control..................................................................................9
IBM SmartCloud Entry+ for System X i

3. Introduction
Solution overview
IBM SmartCloud Entry+ for System X (delivered as IBM Starter Kit for Cloud x86
Edition) is an integrated cloud management platform that is designed to be quickly
installed and operational. The IBM SmartCloud Entry application is implemented as a
lightweight Web-based application that runs as an Open Services Gateway initiative
(OSGI) application. It is installed as a pre-integrated software stack, and delivered as
virtual images that automate IT service deployment in a virtual environment. IBM
SmartCloud Entry provides resource monitoring and cost management for a cloud-based
architecture. In addition, a supplemental virtual server is created for Tivoli Provisioning
Manager for Images (TPMfI). TPMfI provides a simple way to discover, capture, store
and deploy virtual images and physical server images from a single repository.
IBM SmartCloud Entry version 2.2 supports management of VMware hypervisors only.
IBM SmartCloud Entry’s self-service capabilities simplify the process of performing
many common public or private Cloud operations such as:
• Provisioning and de-provisioning virtual servers (process known as deploying)
• Capturing a workload to create a new virtual appliance
• Starting up and shutting down virtual servers
• Resizing existing virtual servers
• Creating projects to give team-specific access to workloads
• Providing network configurations which set unique network properties to different
workloads
• Billing, accounting, and metering support
• Providing request and approval workflow support
Tivoli Provisioning Manager for Images (TPMfI) provides the following capabilities to
manage the virtual images created and utilized in IBM SmartCloud Entry+ for System X:
• Reduces labor costs by better managing “image sprawl”—Discover, capture, store
and deploy virtual images and physical server images from a single repository
• Optimizes server assets and reduces energy costs with anywhere-to-anywhere
server image conversions (Physical-to-Virtual, Virtual-to-Physical or Virtual-to-
Virtual)
• Improves your agility and flexibility through snapshot/restore of servers with
complete hardware independence
IBM SmartCloud Entry+ for System X 1

4. Understanding and using the guide
Use this guide to install and configure the IBM SmartCloud Entry+ for System X product.
This document is designed to supplement, not replace, IBM product documentation.
The document covers:
• Deploying or creating the IBM SmartCloud Entry+ for System X virtual servers
to an existing VMware environment
• Starting and validating the IBM SmartCloud Entry+ for System X virtual servers
Suggested additional reading and education
SmartCloud Entry+ for System X includes a number of IBM technologies. While it is not
necessary to be an expert on all of these technologies to install and run a simple proof of
concept environment, detailed expertise is important for the proper running of a
production deployment.
The following provides links to additional information and IBM education for each of the
included products. This not an all comprehensive list of resources. Additional information
such as user forums are available on the IBM www.ibm.com web site.
IBM SmartCloud Entry
IBM SmartCloud Entry – developerWorks Group
IBM SmartCloud Entry - Wiki
IBM SmartCloud Entry - Documentation
IBM SmartCloud Entry - Support and Fix
Tivoli Provisioning Manager for Images
IBM Tivoli Provisioning Manager for Images Version 7.1.1.6 Information Center
IBM SmartCloud Entry+ for System X 2

5. Pre-requisites
IBM SmartCloud Entry+ for System X requires an existing installation of VMware
vSphere Enterprise edition managed by VMware vCenter Server Standard edition.
Ensure that the vCenter Server product is installed, operational, and managing a vSphere
environment prior to continuing with the installation of IBM SmartCloud Entry.
The configuration of the VMware products is outside the scope of this document. Please
refer to the VMware product documentation for configuration and troubleshooting
instructions.
VMware vCenter Server
http://www.vmware.com/products/vcenter-server/overview.html
VMware vSphere
http://www.vmware.com/products/vsphere/overview.html
VMware Documentation web site
http://www.vmware.com/support/pubs
vSphere Compatibility Matrixes
http://www.vmware.com/pdf/vsphere4/r40/vsp_compatibility_matrix.pdf
vSphere Basic System Administration
https://www.vmware.com/pdf/vsphere4/r40/vsp_40_admin_guide.pdf
Developer's Setup Guide
http://www.vmware.com/support/developer/vc-
sdk/visdk41pubs/vsp41_developerssetupguide.pdf
For information on IBM SmartCloud Entry specific VMware installation considerations,
see the VMware prerequisite installation section of the IBM SmartCloud Entry
Administrators Guide available at
https://www.ibm.com/developerworks/mydeveloperworks/wikis/home?
lang=en#/wiki/W21ed5ba0f4a9_46f4_9626_24cbbb86fbb9/page/Documentation.
IBM SmartCloud Entry+ for System X 3

6. Component installation
IBM® SmartCloud Entry
Database installation
The default database used by IBM SmartCloud Entry is a Derby database for which there
are no prerequisite installation steps required. The default Derby database is
automatically created and resides in the IBM SmartCloud Entry Home Directory.
Optionally, IBM DB2 may be used by IBM SmartCloud Entry as the database application.
For information on how to download, install, and configure DB2, refer to its product
documentation available at http://www-01.ibm.com/software/data/db2/linux-unix-
windows/.
After DB2 is installed, you must create a DB2 database for IBM SmartCloud Entry. For
instructions, see Creating a DB2 database for IBM SmartCloud Entry section of the IBM
SmartCloud Entry Administrator Guide available at
https://www.ibm.com/developerworks/mydeveloperworks/wikis/home?
lang=en#/wiki/W21ed5ba0f4a9_46f4_9626_24cbbb86fbb9/page/Documentation.
Deploying the vApp
IBM SmartCloud Entry is shipped as a VMware vApp that can be deployed to an existing
VMware installation.
1. Using VMware vCenter, connect to the vSphere environment that will host the IBM
SmartCloud Entry guest.
2. Select the Host on which to deploy the IBM SmartCloud Entry vApp..
3. Click File → Deploy OVF Template...
4. In the Open dialog, select IBM_SKC_x86_App.ovf. Click Open.
5. On the Source section of the Deploy OVF Template dialog, click Next.
6. The details of the OVF file are displayed. Click Next.
7. If desired, change the default name. Select the Inventory Location for the IBM
SmartCloud Entry vApp. Click Next.
8. Select the datastore in which to place the IBM SmartCloud Entry vApp. Click Next.
9. On the Disk Format screen, ensure that Thick provisioned format is selected.
Click Next.
IBM SmartCloud Entry+ for System X 4

7. 10. Choose the Destination Network for each of the Source Networks. The OVF
contains two source networks that must be mapped:
Customer Network: The network that connects the managed (provisioned)
virtual servers with the general user network.
Management Network: The private network that is used for communication
amongst the IBM SmartCloud Entry virtual server, the VMware Virtual Center
server, and the TPMfI virtual server.
Click Next.
11. Enter the values to customize the IBM SmartCloud Entry deployment.
On the IBM SmartCloud Entry Configuration panel, enter or change the
following values to customize your IBM SmartCloud Entry installation:.
Managed Cloud host name: The host name or IP address of the VMware
vCenter installation that IBM SmartCloud Entry is managing
Managed Cloud user name: The user name used to connect to the vCenter
installation
Note: You must set the password for the Managed Cloud user name in the
cloud.properties file of the IBM SmartCloud Entry installation. Please refer
to the Configuring the Cloud manager section of the IBM SmartCloud Entry
Administrators Guide available at
https://www.ibm.com/developerworks/mydeveloperworks/wikis/home?
lang=en#/wiki/W21ed5ba0f4a9_46f4_9626_24cbbb86fbb9/page/Document
ation.
Initial administrator user name: User name of the initial IBM SmartCloud
Entry administrator, used to log into the IBM SmartCloud Entry user
interface.
NOTE: the default password is 'passw0rd' and should be changed in the
IBM SmartCloud Entry user interface.
Initial administrator name: Display name of the initial IBM SmartCloud
Entry administrator, displayed in the IBM SmartCloud Entry user interface.
On the Management Network panel, specify the following required values to
connect the virtual machine to the management network.
System host name
IP address
Subnet mask
Gateway
Primary DNS server
Secondary DNS server
Primary DNS suffix
IBM SmartCloud Entry+ for System X 5

8. Secondary DNS suffix
On the Customer Network panel, optionally enable the network and supply the
required values.
Use Second Network: enables a second network adapter that can be
connected to a customer network when present. If it is not selected, a
second network will not be configured. In this case, remove the second
network adapter from the appliance in vCenter for better performance.
Use DHCP: configures the second network adapter using a DHCP server. If
this is unselected and the Use Second Network parameter is selected, then
the rest of the fields are required.
System host name
IP address
Subnet mask
Primary DNS server
Secondary DNS server
Primary DNS suffix
Secondary DNS suffix
Click Next.
12. Verify the values on the Ready to Complete screen. Click Finish. A progress
window displays as the IBM SmartCloud Entry application is deployed.
13. After the deployment finishes, select the newly created virtual machine. Click Run.
Verifying the IBM SmartCloud Entry virtual machine
After starting the IBM SmartCloud Entry virtual machine, navigate to the Console tab.
1. Clicking on the console will give it focus and cause the mouse pointer to disappear.
2. Log in to the console using:
skc login: sysadmin
Password: passw0rd
Once logged in, ensure network connectivity with the managed VMware vCenter
installation.
1. Type ifconfig at the command prompt, press enter. Ensure eth0 and eth1 are
configured as specified during the OVF deployment.
2. Test communication with the managed vCenter server by typing ping -c 4
<Managed Cloud host name> and pressing Enter. If properly connected, all
packets should show as received with 0% packet loss:
IBM SmartCloud Entry+ for System X 6

9. 3. Verify IBM SmartCloud Entry is running by entering the command ps aux |
grep skc and pressing Enter. If IBM SmartCloud Entry is running, output will be
similar to:
Connecting to the IBM SmartCloud Entry User Interface
1. Using a web browser, open http://<IBM SmartCloud Entry host
name>:8080/cloud/web/login.html.
2. On first access, one or more licenses will be presented for acceptance. Read and
accept the licenses.
3. The IBM SmartCloud Entry login prompt will be displayed. Enter the “Initial
administrator user name” entered during the OVF deploy step and the default
password of passw0rd.
4. Click Log In.
Configuring IBM SmartCloud Entry
IBM SmartCloud Entry+ for System X 7

10. Documentation for configuring IBM SmartCloud Entry is available in the IBM
SmartCloud Entry Administrators Guide that can be downloaded from the IBM
SmartCloud Entry wiki.
https://www.ibm.com/developerworks/mydeveloperworks/wikis/home?
lang=en#/wiki/W21ed5ba0f4a9_46f4_9626_24cbbb86fbb9/page/Documentation
Refer to the Configuring IBM SmartCloud Entry section.
Tivoli® Provisioning Manager for Images
TPMfI may be optionally installed to provide improved image management capabilities.
These capabilities include the capture and deployment of physical or virtual systems,
anywhere-to-anywhere server image conversions, and snapshot/restore of servers with
complete hardware independence.
Additional information on TPMfI is available the TPMfI Information Center at
http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/topic/com.ibm.tivoli.tpm.osdimg.d
oc/welcome/osdimgwelcome.html
Installing TPMfI
TPMfI may be installed in either a physical machine or virtual machine, provided it has
access to the same network as the managed vCenter installation. Additional network
connectivity may be required in specific capture scenarios.
The installation process is documented at
http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/index.jsp?topic=
%2Fcom.ibm.tivoli.tpm.osdimg.doc%2Finstall%2Fcosd_installationguide.html
Connecting to the TPMfI user interface
Open a web browser to https://<TPMfI host name>. On first access, a licensing
agreement will be presented. After acceptance, the login screen will be displayed. Log in
with the credentials entered during installation.
IBM Systems Director Standard Edition
Systems Director is an component that can be optionally installed to provide system
management and health reporting.
Getting Started PDF guide
https://publib.boulder.ibm.com/infocenter/director/v6r2x/topic/com.ibm.director.editions.
doc_6.2.1/editions_x86_standard_6.2.1_getting_started.pdf
Installation documentation within the Info Center:
https://publib.boulder.ibm.com/infocenter/director/v6r2x/topic/com.ibm.director.editions.
doc_6.2.1/editions_x86_standard_t_installing.html
IBM SmartCloud Entry+ for System X 8

11. IBM Systems Director Storage Control
Storage Control is a component that can be optionally installed to discover and collect
inventory, and monitor health of select storage subsystems and Fibre Channel switches.
The full set of supported devices is available in the Overview section of the Info Center.
Info Center
http://publib.boulder.ibm.com/infocenter/director/v6r2x/topic/com.ibm.director.storagectr
l.helps.doc/fqm0_t_sc_storage_control.html
Installation and User's Guide
http://publib.boulder.ibm.com/infocenter/director/v6r2x/topic/com.ibm.director.storagectr
l.helps.doc/fqm0_sc_pdf.pdf
IBM SmartCloud Entry+ for System X 9