Installation Guide Lab Manager 2.5.
VMware Lab Manager Installation Guide VMware Lab Manager Installation Guide Revision: 20071129 Item: VLM-ENG-Q407-358 You can find the most up-to-date technical documentation on our Web site at http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: docfeedback@vmware.com © 2007 VMware, Inc. All rights reserved. Protected by one or more of U.S. Patent Nos.
Contents About This Book 5 1 Introduction to the Lab Manager Installation 9 Lab Manager Components 9 High‐Level View of the Installation Process 11 Using Lab Manager with VirtualCenter Management Server 11 Enabling High Availability for the Lab Manager Server 12 2 Installation Requirements 13 General Requirements 13 System Requirements: Lab Manager Server and Managed Server 15 Configuring IIS and ASP.
VMware Lab Manager Installation Guide 3 Installing Lab Manager 27 Reviewing the Installation Flow 27 Setting Up Managed Server Systems 28 Prerequisites for Managed Server Systems 28 Verifying the Setup of the ESX Server System 29 Setting up the VMkernel Network for NFS Storage 29 Installing the Managed Server Agent Software on ESX Server 30 Setting Up the Lab Manager Server System 31 Prerequisites for Lab Manager Server 32 Security Recommendations 32 Installing or Customizing the SSL Certificate 32 Modifyi
About This Book This manual, the VMware Lab Manager Installation Guide, describes installation, configuration, and upgrade tasks for Lab Manager. Intended Audience This book is intended for experienced developers and testers of software applications.
VMware Lab Manager Installation Guide Conventions Table 1 illustrates the typographic conventions used in this manual. Table 1.
About This Book Online and Telephone Support Use online support to submit technical support requests, view your product and contract information, and register your products. Go to http://www.vmware.com/support. Customers with appropriate support contracts should use telephone support for the fastest response on priority 1 issues. Go to http://www.vmware.com/support/phone_support.html. Support Offerings Find out how VMware support offerings can help meet your business needs. Go to http://www.vmware.
VMware Lab Manager Installation Guide 8 VMware, Inc.
1 Introduction to the Lab Manager Installation 1 VMware Lab Manager provides a robust solution to manage virtual machines in the test lab infrastructure. You can capture a complex and running software environment and share it instantly across your organization. See the VMware Lab Manager User’s Guide for a full overview of the product.
VMware Lab Manager Installation Guide Figure 1-1. Lab Manager Components network Lab Manager client user administrator Lab Manager Managed Server Lab Manager Server Lab Manager Managed Server Lab Manager client user Lab Manager client user default media storage Lab Manager Managed Server virtual machine storage (SAN) media and virtual machine storage (NFS) Lab Manager Server – A server that provides Web and SOAP interfaces to interact with Lab Manager.
Chapter 1 Introduction to the Lab Manager Installation High-Level View of the Installation Process The installation process takes about 20 minutes and involves the high‐level tasks described in Table 1‐1. Table 1-1. Installation Tasks Preparing to install Lab Manager Prepare your target system and make sure it meets all software and hardware requirements. Creating Managed Server systems Set up the Managed Server systems.
VMware Lab Manager Installation Guide Enabling High Availability for the Lab Manager Server To take advantage of VMware HA, VMware DRS, or VMware VMotion, install the Lab Manager Server component on a virtual machine rather than a physical system. 12 VMware, Inc.
2 Installation Requirements 2 Review the recommendations and requirements for your Lab Manager components and network.
VMware Lab Manager Installation Guide Managed Server system requirements: One or more VMware ESX Server 3.0.1 or 3.0.2 machines with the specifications detailed in “System Requirements: Lab Manager Server and Managed Server” on page 15. You can mix these versions in a Lab Manager environment. Lab Manager VMware-labmanager-agent-esx-2.5.1-.bin to install the Lab Manager Managed Server software.
Chapter 2 Installation Requirements System Requirements: Lab Manager Server and Managed Server Review the system requirements for the Lab Manager Server and Managed Server components. The Managed Server component requires you to check the ESX Server hardware compatibility list at this link: http://www.vmware.com/support/pubs/vi_pubs.html Table 2-1. System Requirements System Component Operating system and framework CPU speed VMware, Inc.
VMware Lab Manager Installation Guide Table 2-1. System Requirements (Continued) System Component Lab Manager Server Processor Hard disk Pentium III, Pentium 4, Xeon, Opteron, or Athlon processor (32‐bit only) 40GB minimum (Recommended) 200GB or more (Recommended) RAID 0 or RAID 5 for highest performance Managed Server Any CPU compatible with ESX Server.
Chapter 2 Installation Requirements Table 2-1. System Requirements (Continued) System Component Lab Manager Server Memory 512MB minimum 1GB minimum (Recommended) 1GB or more (Recommended) 2GB or more 2GB or more swap space for ESX In general, add 30MB of overhead space to the total RAM of all virtual machines you expect to run.
VMware Lab Manager Installation Guide Table 2-1. System Requirements (Continued) System Component Lab Manager Server CD drive CD/DVD drive Notes and recommendations (Recommended) SSL certificate System clock is in sync with the clocks on the storage servers. This synchronization prevents unnecessary delays during garbage collection (automatic removal of unused virtual machine images).
Chapter 2 Installation Requirements 5 Select the ASP.NET and Internet Information Services (IIS) options. 6 Click OK and Next to install the components. To verify you installed ASP.NET version 2.0.50727 1 Choose Start > Control Panel > Administrative Tools > Internet Information Services (IIS) Manager. 2 On the left pane, expand the entry for the local computer and select Web Service Extensions. 3 Make sure you can see ASP.NET v2.0.50727 with an Allowed status.
VMware Lab Manager Installation Guide Disable the Enhanced Internet Explorer Security Configuration option (accessible from the Control Panel by clicking Add or Remove Programs and clicking Add/Remove Windows Components) for Windows 2003. Verify that the system clock is in sync with the Lab Manager Server system, storage servers, and Managed Server systems. Review the display requirements: 1024 x 768 or higher resolution monitor for users without administrative privileges.
Chapter 2 Installation Requirements VMFS Datastore The initialization process for Lab Manager (page 36) prompts you to select the VMFS devices you want the Managed Server system to use for storage. Review the requirements and recommendations for the VMFS datastore: (Recommended) A small number of large SAN VMFS partitions rather than a large number of small partitions. The lifecycle of a virtual machine involves transitions from templates to configurations to library configurations and more.
VMware Lab Manager Installation Guide Using Hardware and Software-Initiated iSCSI Storage Refer to the VMware Infrastructure 3 online library documentation at http://pubs.vmware.com/vi301 to set up iSCSI storage. To find instructions on iSCSI storage 1 Open the VMware Infrastructure 3 online library. 2 Click the Search tab. 3 Type: > iSCSI See the “Configuring Hardware‐Initiated iSCSI Storage” and “Configuring Software‐Initiated iSCSI Storage” in the Server Configuration Guide section.
Chapter 2 Installation Requirements Configuring Routing Review the requirements for network connectivity: Lab Manager client user machines must have routable access to the Lab Manager Server system, Managed Server systems, and storage servers. If these Lab Manager servers are behind a firewall and not directly accessible, you can use a virtual private network (VPN). See “Configuring Firewall Settings” on page 23 for more information on configuring network ports for routable access.
VMware Lab Manager Installation Guide Managed Server systems to access additional NFS media storage servers or NFS virtual machine storage servers – TCP port 2049. Lab Manager Server system to access Managed Server systems – TCP port 5212. See Figure 2‐1 for an illustration of Lab Manager ports. Figure 2-1. Detailed View of Lab Manager Components and Ports network SOAP API client TCP 443 SOAP API IIS with ASP.
Chapter 2 Installation Requirements Subnet mask for the network. IP address for the network gateway. The Lab Manager Server DNS suffix. Consult your network IT administrator for information. IP Addresses for Virtual Machines Reserve a range of IP addresses for virtual machines. This range is in addition to the IP addresses required for each Lab Manager Server, storage server, and Managed Server. IP addresses for virtual machines are allocated from the pool of IP addresses you reserve.
VMware Lab Manager Installation Guide 26 VMware, Inc.
3 Installing Lab Manager 3 After reviewing the requirements in Chapter 2, install the Managed Server and Lab Manager Server software. This chapter covers these topics: “Reviewing the Installation Flow” on page 27 “Setting Up Managed Server Systems” on page 28 “Setting Up the Lab Manager Server System” on page 31 “Verifying the ASP.
VMware Lab Manager Installation Guide Step 2 Set up the Lab Manager Server system. After creating at least one Managed Server system, create the Lab Manager Server system. The Lab Manager Server system controls both the back‐end (Managed Server systems) and front‐end (Lab Manager Web console). You must have access to the Lab Manager Server executable (VMware-labmanager-server-2.5.1-.exe). See “Setting Up the Lab Manager Server System” on page 31. Step 3 Initialize and configure Lab Manager.
Chapter 3 Installing Lab Manager Verifying the Setup of the ESX Server System Use the VI Client packaged with ESX Server to review these prerequisites for your target Managed Server system: At least one VMFS partition (local SCSI, iSCSI, or SAN) is attached to the Managed Server system. In the VI Client, navigate to the Storage Management page to add VMFS disk volumes and partitions. ESX Server license is configured.
VMware Lab Manager Installation Guide This procedure is required for all Managed Server systems that you attach to Lab Manager. After installing the Managed Server systems and Lab Manager Server system, see “Configuring NFS Servers” on page 39 and “Adding and Synchronizing NFS Media Storage” on page 40 to ensure Lab Manager recognizes the contents of the NFS server.
Chapter 3 Installing Lab Manager 4 5 Continue or stop the installation based on whether you want NFS media storage: If you did not set up the VMkernel network and you want to store media on NFS storage, do not proceed with the installation. Set up the VMkernel network and start the process of installing the Managed Server agent software again. If you did not set up the VMkernel network and you do not need to store media on NFS storage, proceed with the installation. Type a user name and password.
VMware Lab Manager Installation Guide Prerequisites for Lab Manager Server In addition to the installation requirements described in Chapter 2, review these prerequisites for the Lab Manager Server system. The target Lab Manager Server system must have a NIC with these requirements: Static IP address Physically connected NIC (no wireless cards) You must use a fully qualified domain name (FQDN). Certain features of Lab Manager, such as LiveLink, require an FQDN.
Chapter 3 Installing Lab Manager To generate a custom SSL certificate using OpenSSL 1 Download and install OpenSSL on the Lab Manager Server system. 2 Create a file named OpenSSlVMware.cfg in a working directory. Review this sample file: # Conf file that vpx uses to generate SSL certificates. [ req ] default_bits = 1024 default_keyfile = rui.
VMware Lab Manager Installation Guide Modifying Security Policies To use Lab Manager in a high security environment, you must modify the policy settings. To modify a high security policy 1 On the desktop of the target Lab Manager Server system, choose Start > All Programs > Administrative Tools > Local Security Policy. 2 In the left pane, navigate to Security Options under Local Policies. 3 In the right pane, double‐click Microsoft network server: Digitally sign communications (always).
Chapter 3 Installing Lab Manager 3 If the software cannot detect a fully qualified domain name (FQDN), enter one when prompted. For information on FQDN, see “Prerequisites for Lab Manager Server” on page 32. 4 Specify whether you want a Typical or Custom installation. You can perform these tasks with a custom installation: 5 Change the program files directory. Change the repository directory ( \VMwareLM). This directory is the default location for media storage.
VMware Lab Manager Installation Guide Initializing and Configuring Lab Manager After installing the Lab Manager Server software, initialize and configure it using a Web browser. You can perform this task on the Lab Manager Server system or any system with access to the Lab Manager Server system.
Chapter 3 Installing Lab Manager 5 Specify the details on IP addresses for the network environment: a Select the DHCP (dynamic allocation) option, Static IP Pool option, or both options. Lab Manager allows you to use a different option for each virtual machine. The selection determines the choices for IP allocation you will see in the Lab Manager Web console. These choices can be altered after this wizard. See “Static IP and DHCP Networking” on page 38 for more information on the options.
VMware Lab Manager Installation Guide 8 Create the first Lab Manager administrator account with a user name, password, and email address. 9 Choose whether to enable SupportLink, a feature that sends usage data to VMware and improves product support. 10 If you are outside of the U.S. and enabling SupportLink, consent to the possible transfer of data outside of the country where the installation takes place.
Chapter 3 Installing Lab Manager To check the sample template and configuration 1 In the left pane, click Workspace to see the Sample 1 configuration. 2 In the left pane, click Templates to see the ttylinux‐4‐ESX3() template. NOTE The Templates page may not be accessible to non‐administrator users. The first time you deploy a template or configuration to view a virtual machine console, you must follow the instructions to install the ActiveX control.
VMware Lab Manager Installation Guide Adding NFS Virtual Machine Storage If you configured NFS storage for virtual machines, add this storage to the Lab Manager Web console. To add an NFS virtual machine server 1 In the left pane, click Storage. 2 In the Virtual Machines tab, click the Add NFS Storage button. a Enter a name for the new server. The name can only contain alphanumeric characters (a–z, A–Z, 0–9), hyphens, underscores, or periods. The maximum length is 128 characters.
Chapter 3 Installing Lab Manager To add an NFS media server 1 In the left pane, click Storage. 2 In the Media tab, click the Add Media Storage button. a Enter a name for the new server. The name can only contain alphanumeric characters (a–z, A–Z, 0–9), hyphens, underscores, or periods. The maximum length is 128 characters. b (Optional) If you do not want the storage server immediately available for use, deselect the Enabled check box. c Enter a value for Disk Space Threshold Yellow.
VMware Lab Manager Installation Guide Uninstalling Lab Manager Uninstalling Lab Manager involves uninstalling the Lab Manager Server and Managed Server agent software. Review the requirements for the uninstallation process: A system installed with Lab Manager Server software. One or more systems installed with the Managed Server agent software. The user name and password of the Lab Manager administrator. The user name and password of the root user on Managed Server systems.
Chapter 3 Installing Lab Manager 11 Specify the extent of the uninstallation: Select Remove program files only in a partial uninstallation or upgrade process. Proceed to Step 14. Select Remove everything in a full uninstallation. 12 Click Yes to remove all the Lab Manager software. 13 Click Yes to reset Lab Manager Services and IIS. 14 Click Finish. Uninstalling Managed Server Agent Software After uninstalling the Lab Manager Server software, remove the Managed Server agent software.
VMware Lab Manager Installation Guide 44 VMware, Inc.
4 Upgrading Lab Manager 4 You can upgrade Lab Manager from version 2.5 only. This chapter covers these topics: “Backing Up the Lab Manager Database” on page 45 “Uninstalling the Program Files for Lab Manager Server” on page 46 “Installing the Managed Server and Lab Manager Server Software” on page 46 “Restoring the Lab Manager Database” on page 47 Backing Up the Lab Manager Database VMware recommends backing up the Lab Manager 2.5 database as a precaution before upgrading Lab Manager.
VMware Lab Manager Installation Guide Uninstalling the Program Files for Lab Manager Server Upgrading Lab Manager involves uninstalling only the program files for the Lab Manager Server. For instructions on uninstalling program files, see “Uninstalling Lab Manager” on page 42. Installing the Managed Server and Lab Manager Server Software After uninstalling the program files for the Lab Manager Server, install the Managed Server agent and Lab Manager Server software.
Chapter 4 Upgrading Lab Manager Restoring the Lab Manager Database If you backed up the Lab Manager 2.5 database and need to restore it, you can only restore it in a Lab Manager 2.5 environment. To restore the database 1 In IIS Manager, stop the Default Web Site. 2 From the Lab Manager Server desktop, navigate to Windows Services and stop these services: 3 VMware LM Monitor VMware LM SupportLink World Wide Web Publishing Service Restore the database from the command prompt.
VMware Lab Manager Installation Guide 48 VMware, Inc.
Appendix: Troubleshooting the Installation This appendix covers these troubleshooting topics for the Lab Manager installation: “Error 1720: Windows Installer Package” on page 49 “Microsoft SQL Desktop Engine (MSDE) Installation Fails” on page 50 “Transfer of Managed Server Agent Software to ESX Server Machine Fails” on page 51 “Error 1603: Required Services for Installing Lab Manager” on page 51 Error 1720: Windows Installer Package Problem During the installation of Lab Manager Server, you
VMware Lab Manager Installation Guide Microsoft SQL Desktop Engine (MSDE) Installation Fails Problem During the installation of Lab Manager Server, the MSDE installation fails. Subsequent installation attempts also fail, and a reboot has no effect. Solution In Notepad, open the {WinDir}\temp\VMware\MSDE2Klog.log file and see if these lines (or similar text) appear: Loading extended custom action library C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp\{E09B48B5-E141-427A-AB0C-D3605127224A}\sql cax.dll SOFTWARE\Microsoft
Appendix: Troubleshooting the Installation Transfer of Managed Server Agent Software to ESX Server Machine Fails Problem If you download the Managed Server software, copy it to the ESX Server machine, and run the tar -xvzf command, this error appears: tar: tar: tar: tar: This does not look like a tar archive Skipping to next header Archive contains obsolescent base-64 headers Error exit delayed from previous errors running installer Solution The message indicates possible corruption of the file.
VMware Lab Manager Installation Guide 52 VMware, Inc.
Index A L ActiveX Lab Manager installing 39 ASP.
VMware Lab Manager Installation Guide N V network virtual machine consoles configuring domains and permissions 23 installing ActiveX. 39 VMkernel network configuring firewall settings 23 setting up 29 VMware community forums configuring routing 23 IP addresses for virtual machines 25 accessing 6 requirements 22 R requirements client user machines 19 for Lab Manager installation 13 general 13 IIS and ASP.
