HP Cloud Map for Oracle 11gR2 Single Instance Database: Importing the template

An HP Reference Architecture for Oracle

Technical white paper

Table of contents
Executive summary............................................................................................................................... 2 Overview ............................................................................................................................................ 2 Prerequisites ........................................................................................................................................ 3 Resource pool requirements .................................................................................................................. 3 Storage pool requirements ................................................................................................................ 3 Networking requirements .................................................................................................................. 3 Server pool requirements .................................................................................................................. 4 HP Cloud Map for Oracle 11gR2 Single Instance Database ..................................................................... 4 Download the HP Cloud Map for Oracle Single Instance Database ....................................................... 4 Import the template........................................................................................................................... 5 Edit network configuration ............................................................................................................... 10 Edit storage configuration ............................................................................................................... 12 Importing the workflows...................................................................................................................... 15 Review the template ........................................................................................................................... 25 Save and publish the template ......................................................................................................... 27 Additional required files ..................................................................................................................... 27 Copy XSL files to CMS .................................................................................................................... 27 Create the service .......................................................................................................................... 28 Summary .......................................................................................................................................... 30 For more information .......................................................................................................................... 31

Executive summary
For IT teams, infrastructure provisioning can be both time-consuming and resource-draining. Each time a business unit, application owner or development team requests resources, a lengthy process begins. IT experts have to capture system requirements, design the solution from scratch, and then identify the resources that are currently available and those that need to be procured. HP Insight Dynamics infrastructure orchestration enables your IT organization to provision infrastructure consistently and automatically from pools of shared resources using a self-service portal. You can rapidly provision resources ranging from a single virtual machine to complex multi-tier environments with physical and virtual servers and storage systems. HP Cloud Maps were developed to accelerate deployment of business applications by automating application installation, configuration, and lifecycle management. The HP Cloud Map for Oracle 11gR2 Single Instance (SI) Database includes a template and associated workflows which provision a Single Instance Database automatically and quickly in a repeatable fashion. This document describes the process to import the Oracle 11gR2 SI Database templates into target systems and customize them for use. To review this reference architecture, and for further information on the installation and configuration, check the white paper Inside the HP Cloud Map for Oracle 11gR2 Single Instance Database. Target audience: This document is for IT managers, database and system administrators and experienced users who wish to learn more about the capabilities of HP Insight Dynamics and how it can be used to provision Oracle 11gR2 SI Database. Knowledge of the HP BladeSystem Matrix and the underlying components will be helpful when reading this white paper. Please see the For more information section at the end of this paper for links to additional information on these topic areas. This white paper describes testing performed in July 2010.

Overview
The HP Cloud Map for Oracle 11gR2 Single Instance Database provides the template, workflows and scripts used to deploy a single instance 11gR2 Oracle Database (DB) on a single server with a 10GB data disk. The user will need to create the initial image to deploy on the server. Requirements for the initial image are detailed in this document and a more thorough discussion of the image creation process is provided in Inside the HP Cloud Map for Oracle 11gR2 Single Instance Database.
Note HP Insight Dynamics infrastructure orchestration was previously referred to as HP Insight Orchestration (HP IO). Screen shots and technical information throughout the remainder of this white paper will refer to the product as Insight Orchestration.

Prerequisites
The instructions in this document assume you have already created your initial Linux image and created an HP Insight Control server deployment job to deploy the image. See Inside the HP Cloud Map for Oracle 11gR2 Single Instance Database for instructions on creating the initial image. You can import the templates before creating the image but if you do so, you will have to modify the template to change the Server Definition Software deployment job once you have created your image deployment job. The instructions also assume you have already set up your HP Virtual Connect (VC) infrastructure. You will need to specify the network connection required for the SI Database in the template definition. This template was tested using HP ProLiant BL460c G6 server blades including a QLogic HBA (QMH2562) in an HP BladeSystem c7000 enclosure with 2 VC Flex-10 Ethernet modules and 2 VC 8Gb 24-Port Fibre Channel (FC) modules. You must have enabled N_Port ID Virtualization (NPIV) during Insight Dynamics installation for automated storage provisioning to work. The server where Insight Dynamics is installed is known as the Central Management Server (CMS). To download HP BladeSystem firmware go to http://www.hp.com/go/matrixcompatibility. Table 1 lists the firmware and software versions used during testing.
Table 1. Firmware and software levels

Component HP Onboard Administrator HP Virtual Connect Manager HP Integrated Lights-Out 2 (iLO 2) QLogic HBA HP Insight Dynamics

Version 3.00 2.33 1.81 BIOS: 2.15 6.0

Resource pool requirements

Storage pool requirements
The template uses a 48GB disk for boot and 10GB data storage. We will describe below how to customize the template to support the appropriate sizes for your requirements. In order for the template to deploy successfully, you will need to preconfigure storage pool entries of the following sizes: 48GB for boot (customizable: the Linux OS and DB software requires about 15GB) 10GB for database storage (customizable)

Networking requirements
Standard requirements for an Oracle 11gR2 Single Instance Database installation requires network connectivity for application access to the database server. You should set up your Virtual Connect network such that your application servers can connect to the database instance using the network you specify when you customize the Oracle 11gR2 Single Instance Database template.

Server pool requirements

Depending on the size of the database in question, you will want to define server pools with appropriate servers in them. This Oracle 11gR2 Single Instance Database template requires only one server. The recommendations for server configurations based on size of DB are:
Table 2. Server pool selection

Database size 10 GB 50 GB

Type of server BL1 model BL model

Minimum CPU 2 core 3.2 GHz 4 core 2.4 GHz

Minimum memory 4 GB 8 GB

HP Cloud Map for Oracle 11gR2 Single Instance Database

This section describes the process for importing and customizing the downloadable template and workflows.

Download the HP Cloud Map for Oracle Single Instance Database

Go to www.hp.com/go/cloudmaps. Download the HP Cloud Map for Oracle 11gR2 Single Instance Database to your desktop. This will be formatted as a zip file, so you should find an appropriate directory and unzip the file. The file will contain: The HP IO template file name is 11gSIDB.xml Scripts to be installed on the Linux server where you will capture your image Sample image deployment jobs XSL files to be installed on the HP Systems Insight Manager (SIM) server Workflow to be imported into HP Operations Orchestration

BladeSystem server

Import the template

From the Insight Orchestration Designer portal, select the Import button as shown in Figure 1.

Figure 1. Insight Orchestration Designer

The following dialog will be presented. You should find the file you downloaded and select it here and press Open. This will import the template into HP IO.

Figure 2. Upload a template

Because the template defines networking, storage and boot image requirements, you will encounter the following error upon import. This is normal; you will need to reconfigure the boot properties to select a boot image on your system. This will be described later.

Figure 3. Reconcile imported template data

After import, you should see a template that looks like Figure 4. You will notice that the Validation Status is showing errors. If you select the Show Issues button, it will highlight the areas requiring attention.

Figure 4. Single Instance template

Figure 5 shows the two errors that need attention highlighted in red. The first is that the network that was defined in the template does not exist on the target system, so you will need to assign the network to a network that exists on your site. The other is that the boot image in the template also does not exist in this installation. Your installation will need to be modified to use an image on your site. We will now go through the steps required to address these issues.

Figure 5. Single Instance template validation errors

Edit network configuration

We will first address the networking configuration. Right click on the network icon and select Edit Network Configuration.

Figure 6. Edit the network configuration

10

This will bring up the network configuration dialog shown in Figure 7. In this dialog you will specify which network should be used for deployments of this template on your site. Click the Select a specific network radio button. This will display all of the networks configured on your site. Select the network that you wish to use for this template. This will be the network that your application servers will use to connect to your database server.

Figure 7. Configuring the network

As you can see, when you select the network, the details of this network are shown on the dialog, including how many addresses are available in the address pool for this network.

11

Edit storage configuration

Now we need to adjust the storage configuration to match what is available on your site. Right click on the boot disk and select Edit Storage Configuration.

Figure 8. Edit the storage configuration

12

That will display the storage configuration dialog. On this dialog, you will see a red X on the Software tab. Select that tab and you will see the following:

Figure 9. Configure the software deployment job

This dialog will show the available software deployment jobs that are configured on the deployment server. From here you will need to select the correct image that contains the install image you created that includes the Oracle database binaries. This template was tested with an image that contained the following configuration: Red Hat Enterprise Linux 5 update 3 x86_64 Required Linux packages installed, kernel parameters set, and users defined as specified in Oracle 11gR2 database installation guides Oracle 11gR2 database software zip files and response file copied to /u01/tmp Scripts for automated database configuration and installation are in /opt/oracle/sw. These scripts set up the storage for the database, create a response file and do a silent install of the Oracle database.

13

The data disk in the template does not show any errors (Figure 8), but you may want to adjust its size to be appropriate for the databases you want to be able to deploy. Right click on the data disk and select Edit Storage Configuration. Note that the boot disk and data disk must not be the same size as that will break the scripts which configure multipath. The name of the database disk must be data. The template was tested using a single 10GB data disk. This can easily be adjusted by simply changing the disk size in this dialog (Figure 10) and clicking OK.

Figure 10. Configure the size of the database disk

Before moving to the next step, click on the Save icon to save all of your template changes.

14

Importing the workflows

Before you can complete the required changes to the template, you need to import the workflows that are used in the template. Launch HP Operations Orchestration Studio either from the desktop icon or from the Start menu and login as admin user and specify the password you used during Insight Dynamics installation. Select Repository and then Add Repository (see Figure 11).

Figure 11. Add Repository

15

Type in a Repository Name and select the location where you copied the repository files. The example in Figure 12 shows a Repository Name of OracleSIDB. Click OK to open the repository in Studio.

Figure 12. Add Repository Name

16

Click on Repository and then Set Target Repository and select your Default Public Repository.

Figure 13. Set Target Repository

17

Click on Repository again and then Publish source to Target Preview. Click on the Apply icon circled in red in Figure 14.

Figure 14. Publish to Source Target Preview

18

If desired enter a comment for the workflows added and click on OK.

Figure 15. Publish Comment

19

A confirmation message is displayed as shown in Figure 16. The workflows have been added to the default repository.

Figure 16. Publish completed successfully

20

Click on Repository, then Open Repository and select Default Public Repository.

Figure 17. Open Default Repository

21

After the workflows are imported, they appear in the left pane. The workflows utilized by the Single Instance Database template are DBSetup and UnRegisterAllServersWithDNS. They appear under the SingleInstanceDB2.0 folder as shown in Figure 18.

Figure 18. Workflows for Single Instance Database

22

Next we will add the System Properties that are required for the workflows. Expand the Configuration folder, then right click on System Properties and select New as shown in Figure 19.

Figure 19. Add System Property

Enter SIDatabaseName for the System Property name and click on OK.

Figure 20. System Property SIDatabaseName

23

Specify the name of the database you want to create in the Property Value field. This is also known as the Oracle System ID (SID). The example below creates a database with the name DemoDB.

Figure 21. Add System Property

Two more System Properties need to be added. Table 3 lists the required System Properties and description. Following the method described above, create a new System Property for each property listed in the table.
Table 3. System Properties required for Single Instance Database workflows

Property RemoteUser RemotePassword SIDatabaseName

Description Administrative user with execute access on deployed Linux server (root) Password for RemoteUser Database Name (Oracle SID)

You can now save your modifications and close Operations Orchestration.

24

Review the template

After the workflows are imported, return to Insight Orchestration Designer to review the workflows associated with the template. Click on the Workflows button (circled in red in Figure 22) to display the workflows.

Figure 22. Workflows for Single Instance Database template

25

The workflows associated with the template are shown in Figure 23.

Figure 23. Workflow Execution Points

The main workflow, DBSetup, is called at the end of the Create Service execution point. The CaptureXML workflow is strictly for debugging. This workflow writes the XML to a file in the c:\tmp folder of the CMS when the service is created. The generated XML can then be easily copied into Operations Orchestration Studio for debugging. Verify the execution point for each workflow is properly set in the template.
Table 4. Workflow Execution points

Workflow name CaptureXML DBSetup UnRegisterAllServersWithDNS

Execution point Create Service: End Create Service: End Delete Service: Beginning

26

Save and publish the template

Now the template Validation Status should be green, so we can save and publish the template. Insert comments in the Notes section that will help your users know when to choose this template, click on the checkbox next to Published, and click on the Save icon to save the template.

Figure 24. Publish the updated template

Your users will now be able to select and deploy this template from the HP IO User Portal.

Additional required files

Copy XSL files to CMS
The workflows use Extended Scripting Language (XSL) files to extract key values from the service model for use by Linux shell scripts. Table 5 lists the XSL files included with the HP Cloud Map for Oracle 11gR2 Single Instance Database. These files should be copied to the HP Systems Insight Manager (HP SIM) server in the following location: c:\Program Files\HP\Insight Orchestration\conf\OO.

27

Table 5. XSL files

Filename DBHostnameandInfo.xsl FindPrimaryIPAddressByLogicalServerId.xsl SIDBGetDataDisks.xsl

Description Get fully qualified hostname, IP addresses, and MAC addresses for NIC teaming Get fully qualified hostnames and IP addresses Get data disk and disk size

Create the service

Once the template edit is complete and the server and storage pools have been created, a service can be created. In the Create Service window, enter a service name. The example in Figure 25 shows a Hostname Completion string of server. Using a hostname completion string of server, the hostname that will be created is siserver01.

Figure 25. Create the service

28

If you wish to change the Lease End date, Email address, or Server Pool selection, click on the Options button to make your modifications. (See Figure 26.)

Figure 26. Service options

Deployment of a Single Instance Database service begins after you click Submit. If all the required resources are available, a logical server will be created and the Linux image will be deployed to the boot LUN. After the OS is deployed, the database disk is automatically attached. Once the OS and shared storage provisioning is complete, the workflows run and complete the installation.

29

As part of the Single Instance Database installation, Oracle Enterprise Manager 11g Database Control is installed and configured on the database server. In Figure 27 below, access to Database Control is https://siserver01:1158/em.

Figure 27. Oracle Enterprise Manager 11g Database Control

Summary
Built on the HP BladeSystem, BladeSystem Matrix is a Converged Infrastructure platform providing pools of computer, storage and network resources that can be quickly deployed. The goals of Matrix are to help accelerate provisioning, to optimize IT capacity across physical and virtual environments and to ensure predictable delivery and service levels. This enables companies to address some of the key datacenter pain points facing them today including rising costs, low utilization rates, and inflexible environments. With Matrix, powered by HP Insight Dynamics, application services can be quickly provisioned using infrastructure orchestration templates. This enables IT organizations to develop service-driven, standardized application deployment processes. The HP Cloud Map for Oracle 11gR2 Single Instance Database detailed in this paper provisions a Single Instance Database automatically and quickly in a repeatable fashion.

30

For more information

HP BladeSystem Matrix HP Cloud Maps download site HP Insight Dynamics HP Infrastructure Orchestration User Guide http://www.hp.com/go/bladesystemmatrix http://www.hp.com/go/cloudmaps http://www.hp.com/go/insightdynamics http://h20000.www2.hp.com/bc/docs/support /SupportManual/c01658528/c01658528.pdf http://www.hp.com/go/bladesystem http://h18013.www1.hp.com/products/servers /management/deployment-migration.html http://h71028.www7.hp.com/enterprise/cache /316682-0-0-0-121.html

HP BladeSystem HP Insight Control server deployment

HP BladeSystem c-Class technical documentation (planning, installing, maintenance and troubleshooting, functionality and value) HP StorageWorks SAN design reference guide best practices for SAN design HP Flex-10 technology technology brief Command View EVA overview and features

http://h20000.www2.hp.com/bc/docs/support /SupportManual/c00403562/c00403562.pdf http://h20000.www2.hp.com/bc/docs/support /SupportManual/c01608922/c01608922.pdf http://h18006.www1.hp.com/products/storage /software/cmdvieweva/index.html http://www.oracle.com/technology/documentat ion/database.html

Oracle 11g Database

To help us improve our documents, please provide feedback at http://h20219.www2.hp.com/ActiveAnswers/us/en/solutions/technical_tools_feedback.html.

Copyright 2009, 2010 Hewlett-Packard Development Company, L.P. 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. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. 4AA2-7623ENW, Created July 2009; Updated August 2010, Rev. 1