Published: October 2013Interworks Cloud 2013interworks.cloud OSS VMware vSphere® Service ManagerInstallation Guide
Interworks interworks.cloud S.A.









   



























This document contains information proprietary to Interworks interworks.cloud S.A. and its receipt or possession does not convey any rights to reproduce, disclose, manufacture, or sell anything it might describe. Use without Interworksinterworks.cloud' specific written authorization is strictly forbidden. interworks. Interworks cloud 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 interworks.cloud 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
interworks.cloud, the Interworks interworks.cloud logo, the Interworks Cloud interworks.cloud Platform logo, the Interworks Cloud interworks.cloud BSS logo, the Interworks Cloud interworks.cloud Storefront logo, the Interworks interworks.cloud Marketplace and the Interworks Cloud interworks.cloud OSS logo are registered trademarks of Interworks interworks.cloud S.A. All other trademarks are the property of their respective owners.
Interworks


interworks.cloud S.A.

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

...

This guide provides instructions for installing and configuring Interworks Cloud interworks.cloud OSS VMware vSphere Service Manager 2.x. The following versions of VMware vSphere are currently supported in this release:

...

...

This chapter provides an overview of Interworks Cloud interworks.cloud OSS platform and the VMware vSphere Service Manager.

...

VMware vSphere is the industry-leading virtualization platform for building cloud infrastructures. It enables IT to meet SLAs (service-level agreements) for the most demanding business critical applications, at the lowest TCO (total cost of ownership).
VMware vSphere Hypervisor Architecture provides a robust, production-proven, high-performance virtualization layer. It enables multiple virtual machines to share hardware resources with performance that can match (and in some cases exceed) native throughput.
VMware vSphere Virtual Symmetric Multiprocessing enables the use of ultra-powerful virtual machines that possess up to 64 virtual CPUs.
VMware vSphere Virtual Machine File System (VMFS) allows virtual machines to access shared storage devices (Fiber Channel, iSCSI, etc.) and is a key enabling technology for other vSphere components such as VMware vSphere Storage vMotion®.
VMware vSphere Storage APIs provide integration with supported third-party data protection, multi-pathing and disk array solutions.

Overview of Cloud OSS

The Interworks Cloud interworks.cloud OSS platform is a centralized software application that simplifies the day-to-day burden of activating, configuring and managing a service provider's unified communications and collaboration infrastructure. interworks. Interworks Cloud cloud OSS enables service providers to centrally create, control, and deliver hosted IP and application services. It addresses critical operational challenges for provisioning, monitoring, metering, self-management, authentication and further integration into other applications in the service provider's OSS/BSS systems.
Interworks Cloud interworks.cloud OSS has the following components:

...

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 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 interworks.cloud Platform Installer. For more information about installing the Interworks Cloud interworks.cloud Platform Installer and the Service Managers please consult the Interworks Cloud interworks.cloud OSS Installation Guide.
The mediation server should have the following minimum system and software specifications:
Mediation Server System Requirements

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

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.
Image Removed Image Added

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.
Image RemovedImage Removed Image AddedImage Added 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
• Image Removed Image Added Click on the Add Service button

...

VMware Custom Service has been provisioned successfully
Image Removed Image Added
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).
Image Removed Image Added





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

Image RemovedImage Added

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

Image Added

Image Removed 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.
Image RemovedImage Removed Image AddedImage Added 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.
Image RemovedImage Removed Image AddedImage Added 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) Image Removed Image Removed Image Added Image Added In this example the selection is Windows and Microsoft Windows Server 2008 R2 (64-bit)
Image RemovedImage Removed Image AddedImage Added
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 Image Removed Image Removed Image Added Image Added Fig. A10: Choose the LSI Logic SAS SCSI controller
Image RemovedImage Removed Image AddedImage Added
Fig. A11: Select to create a new virtual disk Fig. A12: Set the disk size to 20GB and select Thindisk provisioning
Image RemovedImage Removed
Image AddedImage Added
Fig. A13: Keep default settings in disk advanced options Fig. A14: Click Finish to create the new VM
Image RemovedImage Removed Image AddedImage Added
Fig. A15: Optionally uncheck the Enable logging checkbox Fig. A16: Enable memory and CPU hot add for the VM
Image RemovedImage Removed Image AddedImage Added

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
Image Removed Image Added
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

Image RemovedImage Added
Fig. A20: Sample content of setupcomplete.cmd file

Image RemovedImage Added


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.
Image RemovedImage Removed Image AddedImage Added 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.
Image RemovedImage Removed Image AddedImage Added 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
Image Removed Image Added
Image Removed Image Added
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)
Image RemovedImage Removed Image AddedImage Added
Fig. A28: Select 1 virtual socket and 1 CPU core Fig. A29: Select 512 MB for the memory size of the VM
Image RemovedImage Removed Image AddedImage Added
Fig. A30: Configure 1 Network connection, choose the VMXNET 3 Adapter Fig. A31: Choose the VMware Paravirtual SCSI controller
Image RemovedImage Removed Image AddedImage Added

Fig. A32: Select to create a new virtual disk Fig. A33: Set the disk size to 20GB and select Thindisk provisioning
Image RemovedImage Removed

Image AddedImage Added
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:

...

This section provides basic information that can help you troubleshoot issues with Interworks Cloud interworks.cloud OSS VMware vSphere Service Manager installation and configuration.

...

Interworks interworks.cloud S.A.Interworks Cloud interworks.cloud OSS VMware vSphere® Service ManagerInstallation Guide