Published: October 2013Interworks Cloud OSS VMware vSphere® Service ManagerInstallation Guide
Interworks S.A.
This document contains information proprietary to Interworks S.A. and its receipt or possession does not convey any rights to reproduce, disclose, manufacture, or sell anything it might describe. Use without Interworks' specific written authorization is strictly forbidden. Interworks makes no representations or warranties with respect to the contents or use of this document, and it reserves the right to revise this document any time, without the obligation to notify any person or entity of revisions. Further, Interworks assumes no responsibility or liability for any errors or inaccuracies, makes no warranty of any kind (express, implied, or statutory) with respect to the contents or use of the information, and expressly disclaims any and all warranties of merchantability, fitness for particular purposes, and non-infringement of third-party rights.
Interworks, the Interworks logo, the Interworks Cloud Platform logo, the Interworks Cloud BSS logo, the Interworks Cloud Storefront logo, the Interworks Marketplace and the Interworks Cloud OSS logo are registered trademarks of Interworks S.A. All other trademarks are the property of their respective owners.
Interworks S.A.
207 Regent Street, London | Atrina Center Building A | 8 Iatrou Gogousi Str. |
www.interworkscloud.com
Table of Contents
Document revision history5
About this guide 6
Introduction6
Document conventions6
Support and feedback7
CHAPTER 1 8
Overview of Cloud OSS VMware vSphere Service Manager 8
Introduction8Overview of VMware vSphere 5.x8
Overview of Cloud OSS9
CHAPTER 2 10
Preparing for the installation 10
Introduction10
Deploying VMware vSphere Infrastructure10
Preparing the network11
Preparing the VM templates (Guest OS Master Images)11
CHAPTER 3 12
Installing Cloud OSS VMware vSphere Service Manager 12
Introduction12
Installing Cloud OSS VMware vSphere Service Managers12
CHAPTER 4 14
Configuring Cloud OSS VMware vSphere Service Manager 14
Introduction14
Configuring VMware vSphere module15
Configuring Network Settings17
Creating Virtual Server18
Creating Hosting Plan19
APPENDIX A 20
APPENDIX B 38
This page is intentionally left blank
Document revision history
...
To integrate VMware vSphere into the Cloud OSS platform you will need to install the Cloud OSS Service Managers components on one or more mediation servers You can install Interworks Cloud OSS Service Manager on more than one servers and make use of hardware or software load balancing to distribute load and maintain high availability. This server may also be referred as Mediation Server. in your environment. Installation of the components is performed by the Interworks Cloud Platform Installer. For more information about installing the Interworks Cloud Platform Installer and the Service Managers please consult the Interworks Cloud OSS Installation Guide.
The mediation server should have the following minimum system and software specifications:
Mediation Server System Requirements
Server Role | Network Zone | Processors | Memory | Storage | Notes | ||||||
Mediation Server | Back Net | 2 CPU Cores 2GHz | 4GB | 60GB | Windows 2008 R2 Std. | ||||||
Software | Version |
|
|
|
| ||||||
PowerCLI | 5.1 Or 5.5 depending on the VSphere version. Version 3
|
|
|
|
|
Login to every mediation server and install the Cloud OSS Service Managers components as described in the Cloud OSS Installation Guide. Keep in mind the following network port requirements, in order to maintain successful communication between the various Cloud OSS components and the vSphere infrastructure.
Network Access Rules
Source | Destination | Protocol | Src. Port | Dest. Port | Notes |
Mediation Server | vCenter Server | TCP | Any | 80,443,902,903 8080,8443,9090 9443 |
|
Mediation Server | vCenter Server | UDP | Any | 902 |
|
OSS Orchestrator Server | Mediation Server | TCP | Any | 9003 |
|
After installation has completed successfully, you will need to manually edit the configuration file templatesConfiguration.xml (you can use notepad or any other common text editor). This file is located at the root of the installation directory of the Cloud OSS Service Manager and contains the VM templates that the Service Manager will use to provision VMs. In this configuration file you define the names of the VM templates and the customization specification files you created earlier in vCenter Server (See previous section Preparing the VM templates). Fig. 3.1 shows an example of the contents of the configuration file.
Fig. 3.1
According to the example above, the administrator has configured one VM template named Windows Server 2008 R2 Standard and one VM template named CentOS 6.4 (64-Bit). There are also two customization specification files. One is configured for Windows based guest OS and is named OSS Windows Customization, and the other is configured for Linux based guest OS and is named OSS Linux Customization.
Appendix A of this guide contains step by step instructions on how to create both VM templates and customization specification files in vCenter Server to support VM provisioning in Cloud OSS.
...
This section provides information about configuring the Cloud OSS VMware vSphere Service Manager. It is assumed that you have installed the Cloud OSS Service Managers components on all servers that require it, as described in the previous sections and you have verified connectivity to the Service Managers web sites. Before configuring each component, it is necessary to add each server to the Cloud OSS servers' collection. This is done by signing in to the Cloud OSS Provisioning Portal, navigating to Configuration ► Servers (Fig. 4.1) and clicking on Add Server (Fig. 4.2) button.
Fig. 4.1 Fig. 4.2
You have to enter a server name (you may choose any name that is meaningful and/or descriptive of the server role) as well as the URL and server password that correspond to each Service Manager installation. For more information about administering and configuring Cloud OSS platform you may consult the Cloud OSS Administrator Guide.
...
- Under the Services section click Add next to VMware vSphere (Fig. 4.4)
- Optionally, change the Service Name label if required
- Select vSphere 5.x as Service Provider
Click on the Add Service button
...
VMware Custom Service has been provisioned successfully
Fig. 4.5
Configuring Network Settings
...
Sign in to Cloud OSS Provisioning Portal and navigate to Configuration ► Virtual LANs. Click on Add Virtual LAN button and enter a meaningful name in the Description field; then enter the range of available VLANs and finally click on the Add button to save your VLAN selection (Fig. 4.6).
Fig. 4.6
You can repeat this process if you wish to insert additional VLAN ranges.
IP Address Pool configuration
Sign in to Cloud OSS Provisioning Portal and navigate to Configuration ► IP Addresses. Click on the Add IP Address button and enter the following information (Fig. 4.7):
- Select VMware External Network in the Pool: drop down list
- Select the server previously configured in the Server: drop down list (See section Configuring VMware vSphere module)
- Enter an appropriate IP address range
- Optionally, set the NAT Address that will apply to the selected IP Address range
- Enter the Subnet mask and the Default Gateway
Fig. 4.7
You can repeat this process if you wish to insert additional IP Address ranges.
...
Click on Add Services button and select VMware vSphere service on the server previously configured.
Click on the Update button.
Creating Hosting Plan
Sign in to Cloud OSS Provisioning Portal and navigate to Account Home ► Hosting Plans ► Create Hosting Plan. Enter a meaningful plan name and an optional description and select as target server the Virtual Server you created earlier from the drop-down list. Under the Quotas section select the VMware vSphere service. Adjust the quotas and values of the service to meet your plan needs and click on the Save button to save the new Hosting Plan (Fig. 4.8).
Fig. 4.8
You are now ready to create a new customer and assign a new Hosting Space to the customer based on the Hosting Plan you just created.
APPENDIX A
...
The following instructions aim to assist in configuring and deploying a server guest OS template based on Windows Server 2008 R2 Standard with SP1. You may choose to select different settings depending on your own experience or other requirements that may apply in your environment.
Launch vSphere client and connect to the vCenter Server using root credentials (or another user with administrative privileges). Navigate to Inventory ► VMs and Templates, select the Datacenter container and right click New Virtual Machine… to create a new VM.
Fig. A1: Select Custom configuration for the VM Fig. A2: Enter a meaningful name for the VM Fig. A3: Select a cluster to run the VM Fig. A4: Choose the destination storage of the VM
Fig. A5: Select the Virtual Machine version Fig. A6: Choose the guest OS and specify the version (Normally the latest version should be selected) 
In this example the selection is Windows and Microsoft Windows Server 2008 R2 (64-bit)
Fig. A7: Select 1 virtual socket and 1 CPU core Fig. A8: Select 512 MB for the memory size of the VM
Fig. A9: Configure 1 Network connection, choose the VMXNET 3 Adapter 
Fig. A10: Choose the LSI Logic SAS SCSI controller
Fig. A11: Select to create a new virtual disk Fig. A12: Set the disk size to 20GB and select Thindisk provisioning
Fig. A13: Keep default settings in disk advanced options Fig. A14: Click Finish to create the new VM
Fig. A15: Optionally uncheck the Enable logging checkbox Fig. A16: Enable memory and CPU hot add for the VM
Fig. A17: Insert the parameter devices.hotplug in Configuration Fig. A18: Set the value of disk.EnableUUID option in Parameters and set its value to false Configuration Parameters to false
Fig. A19: Force the BIOS setup to launch next time the VM starts
Mount a Windows ISO image or insert a Windows DVD in the host DVD device (Make sure that the VM's DVD device status is set to Connect at power on) and power on the VM. At the BIOS setup screen disable the following devices:
...
- Reboot the VM
- Release the IP address (Set TCP/IP settings to DHCP)
- Shutdown the VM
- Right click the VM and select Template ► Convert to Template
Fig. A20: Sample content of setupcomplete.cmd file
Fig. A21: Sample content of unattend.xml file
...
The following instructions aim to assist in configuring and deploying a server guest OS template based on CentOS 6.4 (64-bit). You may choose to select different settings depending on your own experience or other requirements that may apply in your environment.
Launch vSphere client and connect to the vCenter Server using root credentials (or another user with administrative privileges). Navigate to Inventory ► VMs and Templates, select the Datacenter container and right click New Virtual Machine… to create a new VM.
Fig. A22: Select Custom configuration for the VM Fig. A23: Enter a meaningful name for the VM
Fig. A24: Select a cluster to run the VM Fig. A25: Choose the destination storage of the VM
Fig. A26: Select the Virtual Machine version Fig. A27: Choose the guest OS and specify the version (Normally the latest version should be selected) In this example the selection is Linux and Red Hat Enterprise Linux 6 (64-bit)
Fig. A28: Select 1 virtual socket and 1 CPU core Fig. A29: Select 512 MB for the memory size of the VM
Fig. A30: Configure 1 Network connection, choose the VMXNET 3 Adapter Fig. A31: Choose the VMware Paravirtual SCSI controller
Fig. A32: Select to create a new virtual disk Fig. A33: Set the disk size to 20GB and select Thindisk provisioning
Fig. A34: Keep default settings in disk advanced options Fig. A35: Click Finish to create the new VM
Mount a CentOS ISO image or insert a CentOS DVD in the host DVD device (Make sure that the VM's DVD device status is set to Connect at power on) and power on the VM.
The CentOS installer will launch. Proceed with installing CentOS 6.4 (64-bit)
Logon to CentOS after installation completes. Perform the following actions:
...
Note: | The most important information is usually derived from the first error or warning that appears in this log during error reproduction. |
Interworks S.A.Interworks Cloud OSS VMware vSphere® Service ManagerInstallation Guide