VMUnify EC2 Gateway Guide Version 2.8.1
Copyright Information This document is the exclusive property of Mindtree limited (Mindtree); the recipient agrees that they may not copy, transmit, use or disclose the confidential and proprietary information in this document by any means without the expressed and written consent of Mindtree. By accepting a copy, the recipient agrees to adhere to these conditions to the confidentiality of Mindtree's practices and procedures; and to use these documents solely for responding to Mindtree's operations methodology. Mindtree Limited 2013
Table of Contents 1 Introduction... 4 VMUnify EC2 Gateway Versions... 4 VMUnify EC2 Gateway Portal... 4 Accessing VMUnify EC2 Gateway Appliance... 4 2 Pre-Configurations of VMUnify EC2 Gateway (VMManager)... 5 3 Registering VMUnify EC2 Gateway... 6 4 Configuring VMUnify EC2 Gateway... 7 5 Accessing the VMUnify Self Service Portal (SSP)... 9 6 Configuring Security Groups... 10 7 Requesting VMs... 12 8 Upgrading VMUnify EC2 Gateway... 13 9 Backup and Restore... 15 Procedure to Back up Files... 15 Procedure to Restore Files... 15 10 License Request... 18 Mindtree Limited 2013 ii
Preface The VMUnify EC2 Gateway Guide contains information about installing the VMUnify as Amazon EC2 Public Cloud Gateway Appliance. This document also explains the features of the VMUnify EC2 Gateway Appliance graphical user interface, Self Service Portal and provides guidelines to use the features. This document is intended for administrators and AWS community using VMUnify. Abbreviations and Acronyms The following terms are used in this document. CA EE OS OVF Acronym Certificate Authority Enterprise Edition Operating System Open Virtualization Format Description REST AMI SP SSP vapp VM AWS WS REpresentational State Transfer Amazon Machine Images Service Provider Self Service Portal Virtual Appliance Virtual Machine Amazon Web Services Web Service Mindtree Limited 2013 3
Introduction 1 1 Introduction VMUnify helps organizations deliver Infrastructure as a Service (IaaS) with Secure Amazon EC2 Cloud. VMUnify as an Amazon EC2 Gateway Appliance aggregates all Amazon IaaS traffic and enables to define/resell value added services on top of Amazon Cloud. VMUnify aggregates all customer traffic for Service Providers and company traffic for Enterprises and routes them through a single node. It supports Security Groups for each customer along with ability to setup and present custom templates. VMUnify EC2 Gateway also provides standard REST/WS based interface for integration with third-party solutions. VMUnify EC2 Gateway Versions VMUnify EC2 Gateway is available in following version: VMUnify EC2 Gateway - 10VM Version (Evaluation version for max 10VMs) BYOL version Evaluation upgraded to unlimited VM version VMUnify starts with Evaluation Version. You can install the license and upgrade to unlimited VMs version. For more information, please contact http://www.vmunify.com/support/ or email vmunify@mindtree.com. VMUnify EC2 Gateway Portal VMUnify EC2 Gateway Appliance is based on SUSE Linux Enterprise 11 Service Pack 3 32-bit. Default VMUnify Self Service Portal Supports integration into WHMCS environment with VMUnify WHMCS plugin Supports integration into HostBill environment with VMUnify HostBill plugin Supports integration into Parallels Automation (PS) using VMUnify APS Package For customized integration - please contact vmunify@mindtree.com Accessing VMUnify EC2 Gateway Appliance For free trial visit Amazon AWS Market Place @ https://aws.amazon.com/marketplace. Mindtree Limited 2013 4
Configurations of VMUnify EC2 Gateway (VMManager) 2 Pre- 2 Pre-Configurations of VMUnify EC2 Gateway (VMManager) After requesting and launching the VMUnify EC2 Gateway-10VM Version from the AWS market, it is recommended to allocate a new Elastic IP Address and associate it with VMUnify EC2 Gateway VM (VMManager). Mindtree Limited 2013 5
Registering VMUnify EC2 Gateway 3 3 Registering VMUnify EC2 Gateway On the registration page, select PUBLIC CLOUD option. You can register VMUnify for AMAZON EC2 Cloud. AMAZON Enter the following AMAZON account details Access key: Secret key: Amazon Owner Number: Figure: Public Cloud registration Mindtree Limited 2013 6
Configuring VMUnify EC2 Gateway 4 4 Configuring VMUnify EC2 Gateway After successfully registering the public cloud, you can open the VMUnify Manager web page by clicking the link provided after successful registration and configure Amazon region and templates. Procedure To access the VMUnify Manager (VMManager) as an Administrator, follow these steps: 1. Open Internet Explorer IE 8/9/10 and enter the following URL in the address bar. https:// <VMUnify Manager IP> /SecureVMProject/ 2. The VMManager login page appears. 3. Default Credentials: Username Administrator and password Admin@vmUnify. It is highly recommended to change the credentials on first login. Mindtree Limited 2013 7
Configuring VMUnify EC2 Gateway 4 Figure: Configure Amazon @ VMManager Mindtree Limited 2013 8
Accessing the VMUnify Self Service Portal (SSP) 5 5 Accessing the VMUnify Self Service Portal (SSP) Procedure To access the VMCrafter SSP as an Administrator, follow these steps: 1. Open Internet Explorer IE 8/9/10 and enter the following URL in the address bar. https:// <VMUnify Manager IP> /SSP/ 2. The VMCrafter Self Service Portal (SSP) login page appears. 3. Default Credentials: Username Administrator and password Admin123 It is highly recommended to change the credentials on first login. Mindtree Limited 2013 9
Configuring Security Groups 6 6 Configuring Security Groups Mindtree Limited 2013 10
Configuring Security Groups 6 Mindtree Limited 2013 11
Requesting VMs 7 7 Requesting VMs The requested VM can be accessed from VM Operations tab shown in above figure. The operations which can be performed on the VM are 1. Upgrade/Downgrade 2. Console Access 3. VM Details like IP, VM Name is displayed 4. VM Graphs for CPU, Network Usage and Storage utilization Mindtree Limited 2013 12
Upgrading VMUnify EC2 Gateway 8 8 Upgrading VMUnify EC2 Gateway This section explains the procedure to upgrade VMUnify EC2 Gateway Virtual Appliance. Procedure 1. Please set the java memory as recommended for successful upgrade to happen. Change the parameters highlighted in /usr/apache-tomcat-6.0.35/bin/setenv.sh file, GENERAL_JVM_OPTS="-Xmx2048m Xms1024m -Xss192k -XX:PermSize=128m - XX:MaxPermSize=128m -XX:+CMSClassUnloadingEnabled - Dcom.sun.management.jmxremote=true -Dcom.sun.management.jmxremote.port=9999 - Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false - Djava.awt.headless=true" Restart the tomcat server. 2. Set the VMUnify EC2 Gateway to maintenance mode by not accepting any new VM requests (i.e. no VM provisioning requests should be allowed). Figure 0-1: Upgrading VMUnify 3. Backup the existing database using the VMUnify Backup feature in VMManager->Help. 4. Download the relevant upgrade packages from www.vmunify.com or alternatively contact VMUnify support at vmunify@mindtree.com for upgrade packages. 5. To schedule the upgrade, set the Upgrade Time, upgrade the Manager and Agent packages by browsing the local system and click on Upload. 6. Restart the VMManager. 7. Log in to the VMManager and on the Help tab, select About menu. 8. If the upgrade is successful, the version of the VMManager will be changed to the latest upgraded version. 9. Upon successful upgrade, the following configurations have to be performed immediately before the system can be declared ready: Mindtree Limited 2013 13
Upgrading VMUnify EC2 Gateway 8 Configure the RAM threshold values of Hypervisor (Setting ->Manage Hypervisor - RAM threshold value -> Apply). Post upgrade, it is defaulted to 50 GB. VMUnify recommends assigning 85% of the total RAM of the Hypervisor. Figure 0-2: Configuring RAM Threshold 10. In case of failure, version in the About menu will not be changed. 11. Capture the logs and contact VMUnify support at vmunify@mindtree.com. 12. Restore the backed-up database manually (only in case of failure). Refer Backup and Restore section for more details. Mindtree Limited 2013 14
Backup and Restore 9 9 Backup and Restore You can use this feature to take a backup of the VMUnify database (DB) and files, in case of any crash, you can restore these backed up files. Procedure to Back up Files To back up the files, folders, and databases, follow these steps: 1. On the Help tab, click Backup. 2. Enter the path to copy the backup files. Example: /etc/backup 2. From this location, copy the files to your local machine. The following folders, files, and databases are backed up: Figure: Backed up files and folders Procedure to Restore Files From Amazon AWS Market Place request a new VMUnify EC2 Gateway, configure this VM with the same VM name, hostname, and IP Address as of the machine from where files were backed up. To restore the backed up files, follow these steps: 1. Delete securevm directory at /etc/, if present 2. Create new securevm directory within /etc/ 3. Copy AgentCertificationStore, CertificationStore and conf.properties to: /etc/securevm/ 4. Delete securevm directory at /usr/sbin/, if present 5. Create new securevm directory within /usr/sbin/ 6. Delete vmunify_x_x_x (Data Base File)at /usr/sbin/securevm., if present 7. Copy vmunify_x_x_x (Data Base File) to /usr/sbin/securevm. Mindtree Limited 2013 15
Backup and Restore 9 8. Copy or overwrite SecureVMDatabase.sql and ServicePortaldb.sql into the /etc folder. 9. Create a database with names securevmdatabase and serviceportaldb in postgres. 10. Use the postgres command to create the databases. create database securevmdatabase; create database serviceportaldb; 8. Import the SecureVMDatabase.sql and ServicePortaldb.sql to the created databases respectively. 9. Use the postgres command to import the databases. psql -U postgres SecureVMDatabase < /etc/securevmdatabase.sql psql -U postgres ServicePortaldb < /etc/serviceportaldb.sql. 10. Open Internet Explorer IE 8/9/10 and enter the following URL in the address bar. https:// <VMUnify Manager IP> /SecureVMProject/ 11. Register VMUnify as RESTORE. Example: Host Name/Host IP: Port: Figure 0-1: Registering VMUnify Host name or IP of the database server Enter the VMManager IP if VMManager and database are on the same machine.) Port for the database server for DB communications Mindtree Limited 2013 16
Backup and Restore 9 VMManager DB Name: SSP DB Name: DB UserName DB Password securevmdatabase serviceportaldb postgres postgres Mindtree Limited 2013 17
License Request 10 10 License Request When you first access the VMUnify EC2 Public Gateway Appliance, the Evaluation edition is provided with max support of 10 VM provisioning. You can then upgrade to BYOL edition with new license request. For more information about the licenses, please contact vmunify@mindtree.com. Mindtree Limited 2013 18
Mindtree limited Global Village, RVCE Post, Mysore Road, Bangalore-560 059 INDIA Phone- 91 (80) 6706 4000 Fax- 91 (80) 6706 4100 Email vmunify@mindtree.com Web- www.vmunify.com This document is the exclusive property of Mindtree Limited (Mindtree). The recipient agrees that they will not copy, transmit, use or disclose the confidential and proprietary information in this document by any means without the expressed and written consent of Mindtree. By accepting a copy, the recipient agrees to adhere to these conditions to the confidentiality of Mindtree's practices and procedures; and to use these documents solely for responding to Mindtree's operations methodology.