Installation and Setup Guide 5.6.3

Transcription

1 Installation and Setup Guide 5.6.3

2 2012 Quest Software, Inc. ALL RIGHTS RESERVED. This guide contains proprietary information protected by copyright. The software described in this guide is furnished under a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording for any purpose other than the purchaser s personal use without the written permission of Quest Software, Inc. The information in this document is provided in connection with Quest products. No license, express or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of Quest products. EXCEPT AS SET FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. Quest does not make any commitment to update the information contained in this document. If you have any questions regarding your potential use of this material, contact: Quest Software World Headquarters LEGAL Dept 5 Polaris Way Aliso Viejo, CA legal@quest.com Refer to our Web site for regional and international office information. Patents This product is protected by U.S. Patent: 7,979,245. Additional patents pending. Trademarks Quest, Quest Software, the Quest Software logo, Foglight, IntelliProfile, PerformaSure, Spotlight, StealthCollect, TOAD, Tag and Follow, Vintela Single Sign-on for Java, and vfoglight are trademarks and registered trademarks of Quest Software, Inc in the United States of America and other countries. For a complete list of Quest Software s trademarks, please see Other trademarks and registered trademarks are property of their respective owners. Third Party Contributions Foglight for Virtual Desktops contains some third party components. For a complete list, see the License Credits page in Foglight for Virtual Desktops online help. Installation and Setup Guide May 2012 Version 5.6.3

3 Foglight for Virtual Desktops: Installation and Setup Guide Guide 3 Table of Contents Introduction to this Guide...5 Syntax Conventions in the Guide... 5 About Quest Software, Inc Contacting Quest Software... 6 Contacting Quest Support Before Installing Foglight for Virtual Desktops...7 What Is Foglight for Virtual Desktops?... 7 Planning Your Installation... 8 High Availability Mode... 8 Using the Embedded Database... 9 Using External Databases... 9 Hardware Requirements and Guidelines Installing Foglight for Virtual Desktops...11 Preparing to Install Installing Foglight for Virtual Desktops To Install Foglight for Virtual Desktops Foglight for Virtual Desktops Startup Page Installing and Setting Up Multiple Agent Managers for Load Balancing To Install Foglight for Virtual Desktops in HA Mode Next Steps External MySQL Database Access for Remote Users Manual Database Configuration Installed Directories Importing a Network Security Certificate Uninstalling Foglight for Virtual Desktops Installing Foglight for Virtual Desktops FAQ Running Foglight for Virtual Desktops...34 Initializing the Database Tuning an External MySQL Database for Foglight for Virtual Desktops Starting and Stopping Foglight for Virtual Desktops Starting Foglight for Virtual Desktops... 37

4 Foglight for Virtual Desktops: Installation and Setup Guide Guide 4 Table of Contents Running Foglight for Virtual Desktops as a Windows Service...38 Stopping Foglight for Virtual Desktops Starting and Stopping the Server in High Availability Mode...39 Remote Monitor Logging in to Foglight for Virtual Desktops Running the Foglight for Virtual Desktops Management Server FAQ...42 Index... 45

5 Introduction to this Guide This guide provides instructions for installing, configuring, and starting Foglight for Virtual Desktops. Before you begin, refer to the Release s. Syntax Conventions in the Guide This guide employs a set of conventions that are used in the command syntax. Generic examples follow the UNIX path structure that uses forward slashes / to separate directories. <foglight_for_virtual_desktops_home> is a placeholder that represents the path to the Foglight for Virtual Desktops Management Server installation.

6 Foglight for Virtual Desktops: Installation and Setup Guide 6 Introduction to this Guide About Quest Software, Inc. Established in 1987, Quest Software (Nasdaq: QSFT) provides simple and innovative IT management solutions that enable more than 100,000 global customers to save time and money across physical and virtual environments. Quest products solve complex IT challenges ranging from database management, data protection, identity and access management, monitoring, user workspace management to Windows management. For more information, visit Contacting Quest Software Mail Web site info@quest.com Quest Software, Inc. World Headquarters 5 Polaris Way Aliso Viejo, CA USA Refer to our Web site for regional and international office information. Contacting Quest Support Quest Support is available to customers who have a trial version of a Quest product or who have purchased a Quest product and have a valid maintenance contract. Quest Support provides unlimited 24x7 access to our Support Portal at From our Support Portal, you can do the following: Retrieve thousands of solutions from our Knowledge Base Download the latest releases and service packs Create, update, and review Support cases View the Global Support Guide for a detailed explanation of support programs, online services, contact information, policies, and procedures. The guide is available at: support.

7 1 Before Installing Foglight for Virtual Desktops This chapter provides you with setup information and an initial overview of installing Foglight for Virtual Desktops. Important Before you begin, consult the Release s. That document contains important information about any late-breaking changes, as well as known and resolved issues. What Is Foglight for Virtual Desktops? Foglight for Virtual Desktops is a software application used for monitoring virtual desktops. Foglight for Virtual Desktops enables both new and experienced users to significantly reduce the mean time to resolution (MTTR) of issues within virtual desktop environments by increasing their visibility into those frequently changing environments. It provides diagnostic details about servers and other components, historical trending information, and highly informative alerts and graphs. Foglight for Virtual Desktops: Shows you the availability and resource consumption of the core vworkspace infrastructure (including brokers, secure gateway servers, and print servers). Shows you who is logged into your environment and whether they are using a VM-based virtual desktop (VDI), a terminal server (TS), or both. Shows you the status of each virtual machine (VM). Shows you the status and resource consumption of each TS, along with any outages. Shows you the VDI and TS sessions for each named user. Provides rich alerting, which identifies the affected users for each alert. This helps you prioritize your time, so that you can focus on the issues that affect the most users. Provides functionality for integrating your Foglight for Virtual Desktops alerts with System Center Operations Manager (SCOM). This enables your helpdesk or IT operations teams to see alerts from your virtual desktop infrastructure and to react accordingly.

8 Foglight for Virtual Desktops: Installation and Setup Guide 8 Chapter 1 Before Installing Foglight for Virtual Desktops Planning Your Installation Before you install Foglight for Virtual Desktops, ensure that you have the information you need, such as port numbers and the host names. The following are the main stages involved in installing and configuring Foglight for Virtual Desktops: Stage 1: Install and configure the Foglight for Virtual Desktops Management Server and configure the server and database. Stage 2: If you are using the embedded database, start the Foglight for Virtual Desktops Management Server and log in. If you are using an external database, install, configure, and initialize the database, and then start the Foglight for Virtual Desktops Management Server and log in. If you are using the embedded database, initialization is performed when you start the Foglight for Virtual Desktops Management Server. If you are using an external database, the database must be initialized successfully before you can run the server. High Availability Mode Before you install Foglight for Virtual Desktops, you need to determine if you are going to set up and run the Foglight for Virtual Desktops Management Server in High Availability (HA) mode or as a standalone server. High Availability mode enables you to install multiple Management Servers where one server is the primary server and the others are standby servers. If the primary server stops responding, then the responsibility is taken over by one of the standby servers in the HA cluster. Configuring multiple servers using HA mode offers the following benefits: Automatic restart: The restart process (Foglight for Virtual Desktops HA Daemon) runs on the same host as the Foglight for Virtual Desktops Management Server it is monitoring, and it monitors the state of the server. If the server stops responding or has a fatal error, then the restart process stops and restarts the server automatically. The process can also send out notifications about various conditions of the server. The default value for the restart process is five minutes (300 seconds). Machines with a slower processing speed take longer to reboot. You can modify the default time by editing the startup.grace variable in the <foglight_for_virtual_desktops_home>/config/ foglight.config file. Standby Server: To reduce outage times, a standby server instance is created (for a particular Foglight for Virtual Desktops Management Server), and forms a partition. One server becomes the primary server and communicates with the agents, receives and processes data, and processes rules. All other servers are standby servers. If a primary server stops responding, one of the standby servers resumes service and becomes the primary server.

9 Foglight for Virtual Desktops: Installation and Setup Guide 9 Chapter 1 Before Installing Foglight for Virtual Desktops Considerations for running the Foglight for Virtual Desktops Server in HA mode If you plan to run the Foglight for Virtual Desktops Management Server in HA mode, there are certain considerations: Specific ports are required for the HA setup to work. These are: Cluster Mcast Port HA JNDI RMI Port HA JNDI JNP Port HA JRMP Invoker Port HA Pooled Invoker Port HA JNDI UDP Group Port All of these ports must be set to the same values for all servers in the HA cluster. By default, HA mode works only within the local subnet and uses UDP (User Datagram Protocol) for communication. You can reconfigure your HA cluster to use TCP (Transmission Control Protocol), which can work outside of the local subnet; this is the recommended alternative if your HA cluster consists of a small number of designated HA Management Servers. In both High Availability Mode and Single Server Mode, the database must be running for Foglight for Virtual Desktops to operate. You may have to implement a combined databasebackup and High Availability solution to achieve true failover of all components. A server running in HA mode can only use an external database. Using the Embedded Database Foglight for Virtual Desktops offers the option to use MySQL as an embedded database. The lifecycle of the embedded database matches that of the Foglight for Virtual Desktops Management Server. If the server is stopped or started, the embedded database is automatically stopped or started. Using External Databases An external instance of an Oracle database, a Microsoft SQL Server database, or MySQL with an InnoDB storage engine, can be used if your DBA has installed one. See the Foglight System Requirements and Platform Support Guide at for more information on the supported external databases. The Foglight for Virtual Desktops Management Server supports connecting to the Microsoft SQL Server database only by means of SQL Server Authentication. Windows Authentication is not supported.

10 Foglight for Virtual Desktops: Installation and Setup Guide 10 Chapter 1 Before Installing Foglight for Virtual Desktops A setup with an external database has the advantage of using existing infrastructure. For setup, a remote administrator user/password is required that has rights to create users and tables in the user/ temp tablespace. Remote administrator access must be granted. Oracle databases must be configured to support Unicode characters. For example, you can use UTF-8 or UTF-16 to support Unicode. Hardware Requirements and Guidelines The hardware requirements to run Foglight for Virtual Desktops can vary widely, depending on the size of your monitored environment. For the current hardware requirements and supported browsers, consult the Release s.

11 2 Installing Foglight for Virtual Desktops This chapter provides the instructions for installing Foglight for Virtual Desktops Foglight for Virtual Desktops should be installed on a dedicated machine. Preparing to Install The requirements for installing Foglight for Virtual Desktops are: A machine to host Foglight for Virtual Desktops. Foglight for Virtual Desktops should run on a dedicated machine because it must process and store large volumes of data. Ensure that a host name resolution and reverse lookup are confirmed prior to installing the Foglight for Virtual Desktops Management Server. Administrator access to all machines requiring a Foglight for Virtual Desktops agent. An administrator password for Foglight for Virtual Desktops. The user name (foglight) and the default password (foglight) for this account can initially be used to log in to the browser interface and to use command-line interface options with root or administrator privileges. Quest Software recommends that you change the default password for this account. The TEMP environment variable must be set to a location with sufficient space for installer self-extraction to meet the requirements described in the document available at: If you are installing Foglight for Virtual Desktops with the embedded MySQL database, the Foglight for Virtual Desktops installer and the Foglight for Virtual Desktops Management Server must be able to write to the directory where the MySQL socket is installed. By default, the MySQL socket is installed in the /tmp directory. Flexera Software, makers of the InstallAnywhere tool, recommend that you install as Administrator or use an account that is part of the Administrator group. If yours is a large scale installation and you are planning to balance the agent data collection load across multiple Agent Managers (recommended), we recommend that you dedicate at least one server to hosting multiple Agent Manager installations. For information on how to install and set up multiple Agent Managers for load balancing, see Installing and Setting Up Multiple Agent Managers for Load Balancing on page 21.

12 Foglight for Virtual Desktops: Installation and Setup Guide 12 Chapter 2 Installing Foglight for Virtual Desktops Installing Foglight for Virtual Desktops When all system requirements are in place, you are ready to install. The installer prompts you to input data, and provides you with progress feedback during the installation process. The installation process offers two installation options: Standard This option accepts all of the installer defaults, and installs a standalone instance of Foglight for Virtual Desktops and an embedded MySQL database. Custom This option allows you to modify installer defaults, choose an external database type, and configure Foglight for Virtual Desktops to run in HA mode. If you want to install in HA mode, see To Install Foglight for Virtual Desktops in HA Mode on page 23. Otherwise, proceed to To Install Foglight for Virtual Desktops below. To Install Foglight for Virtual Desktops Start the installation process by initiating the executable included on the Foglight for Virtual Desktops install media. Each installation screen includes a Previous button, allowing you to go back and adjust the information you have specified. Step 1: Introduction The Introduction screen provides an overview of the mechanics of the installation interface. Review the contents of this screen, then click Next. Step 2: Transaction Product Agreement 1 Read the Transaction Product Agreement statement, and accept or decline the terms of the agreement. 2 If you select I accept the terms of the License Agreement, click Next. Step 3: Select Installation 1 Choose Standard Install or Custom Install. The standard option accepts all of the installer defaults, and installs a standalone instance of Foglight for Virtual Desktops and an embedded MySQL database. The custom option allows you to modify installer defaults, choose an external database type, and configure Foglight for Virtual Desktops to run in HA mode. 2 Click Next. If you chose the Standard Installation option, the installer proceeds to Step 8: Installing Foglight for Virtual Desktops Step 4: Choose Installation Folder 1 Choose the location where you want to install Foglight for Virtual Desktops. You can accept the default location.../quest_software/foglightvdesktops or click the Browse button to navigate to another location.

13 Foglight for Virtual Desktops: Installation and Setup Guide 13 Chapter 2 Installing Foglight for Virtual Desktops 2 Click Next. Step 5: Choose Shortcut Location 1 Choose the location where you want to create product icons. There are several options: In a new Program Group: Type the name of the group in the field. In an existing Program Group: Use the menu to select an existing program group. In the Start Menu On the Desktop In the Quick Launch Bar Other (default): Browse your system for a shortcut location. Click the Choose button to enable the browser. Don t create icons Select the Create Icons for all Users check box to create shortcuts for all Foglight for Virtual Desktops users. 2 Click Next. Step 6: Foglight for Virtual Desktops Service 1 If you want Foglight for Virtual Desktops to run as a Windows service, select Enable Foglight For Virtual Desktops as a Service. The default is to enable Foglight for Virtual Desktops as a Windows service. 2 Click Next. Step 7: Pre-Installation Summary Review the installation information. If you are satisfied with the parameters of your installation, click Install.

14 Foglight for Virtual Desktops: Installation and Setup Guide 14 Chapter 2 Installing Foglight for Virtual Desktops To make changes to the installation parameters, click Previous. Step 8: Installing Foglight for Virtual Desktops Foglight for Virtual Desktops installs files into the specified directory. If you chose the Standard Installation option, the installer proceeds to Step 14: Foglight for Virtual Desktops Server Startup Step 9: Administrator Password 1 Type the Foglight for Virtual Desktops Administrator password in the two boxes provided. 2 To run Foglight for Virtual Desktops in secure mode (HTTPS) only, select the Secure Server (HTTPS Only) check box. To set up the system to use HTTPS, you must also generate a key pair (security certificate) into the Foglight for Virtual Desktops keystore. For information about how to do this, see Importing a Network Security Certificate on page Click Next. Step 10: Foglight for Virtual Desktops Mode 1 Select the server startup mode. The options are Standalone (the default) or HA (High Availability). A server running in HA mode can only use an external database. 2 If you choose HA (High Availability): In the HA Partition field, type the partition name. All servers set up in HA (High Availability) mode that you want to act as either primary or secondary servers for failover have to be configured with the same partition name. Caution Servers with different partition names do not participate in the high availability setup. 3 Click Next. Step 11: Foglight for Virtual Desktops Database Configuration This step lets you configure the Foglight for Virtual Desktops database. If you are configuring Foglight for Virtual Desktops to use an external database, the database must exist before you complete this step. After you click Next, the installer creates the user foglight in the database and sets the appropriate permissions. Important If the Foglight for Virtual Desktops Management Server you are installing is configured to be part of an HA cluster, you must set User ID, Password, and Database to the same values as those used for the other Management Servers that share the same HA partition name. 1 In the Foglight For Virtual Desktops Database Account User ID field, accept the default user ID (foglight) or type an alternate one. This is the name for the Foglight for Virtual Desktops user that you are creating. The Foglight for Virtual Desktops Management Server uses this account to store data in the database. 2 In the Foglight For Virtual Desktops Database Account Password field, accept the default password (foglight) or type an alternate one.

15 Foglight for Virtual Desktops: Installation and Setup Guide 15 Chapter 2 Installing Foglight for Virtual Desktops 3 In the Foglight For Virtual Desktops Database Account Retype Password field, accept the default (foglight) or, if you have provided an alternate password in step 2, retype the password for verification. 4 From the Database list, choose Embedded or External. For the embedded database instructions, see Embedded Database below. For the external database instructions, see External Database below. Embedded Database Because an external database is required for an HA configuration, the Database list is disabled if you selected HA as the server startup mode in Step 10: Foglight for Virtual Desktops Mode on page Accept the default port (13306) or type an alternate in the Database Port field. 2 In the DB Administrator Password field, accept the default password provided (foglight) or type an alternate one. 3 In the Retype DB Administrator Password field, accept the default (foglight) or, if you have provided an alternate password, re-type the password for verification. 4 Click Next. A progress box appears as the embedded database is installed.

16 Foglight for Virtual Desktops: Installation and Setup Guide 16 Chapter 2 Installing Foglight for Virtual Desktops External Database For information about granting remote users access to an external MySQL or Oracle database, see External MySQL Database Access for Remote Users on page 25. If the Foglight for Virtual Desktops Management Server you are installing is configured to be part of an HA cluster, you must also configure it to connect to the same database instance as all other members of the cluster. This typically means that you set DB Type, DB Host, DB Port or Instance and DB Name or SID to the same values as those used for the other members. In some rare cases, certain settings might be different. For example, the value for DB Host might be different if there is a firewall between the database and certain members of the cluster in your environment. 1 Choose a database type from the DB Type list. If you install and configure a MySQL database instance as an external database and this instance is to run on a different machine than the one hosting the server, choose the MySQL option to make the database accessible remotely. 2 In the DB Host field, type the database host name or IP address (localhost is the default name). 3 In the DB Port or Instance field, specify a port number or accept the default. This is the TCP/IP port on which the database communicates with the Foglight for Virtual Desktops Management Server. The external database needs to be configured to communicate on this port. If you are configuring a Microsoft SQL Server, you can enter the database instance name here instead of the port number. This is name of the SQL Server instance to which you want the Foglight for Virtual Desktops Management Server to connect. 4 In the DB Name or SID field, type the name of the database (foglight is the default name) if you are configuring a MySQL or SQL Server database. Type the service ID for the database if you are configuring an Oracle database.

17 Foglight for Virtual Desktops: Installation and Setup Guide 17 Chapter 2 Installing Foglight for Virtual Desktops 5 Select one of the following Setup DB options: Now Later (manually) If you select Later (manually), you must manually configure the database after the installation is complete and prior to starting the Foglight for Virtual Desktops Management Server. This is not recommended. 6 If you selected Now in step 5, type the Database Administrator Account User ID and Password. Caution The Database Administrator Account User ID cannot be the same as the Foglight For Virtual Desktops Database Account User ID. Caution If the Foglight for Virtual Desktops Management Server you are installing is configured to be part of an HA cluster, you must set the Database Administrator Account User ID and Password to the same values as those used for the other Foglight for Virtual Desktops servers that share the same HA partition name. 7 Optional. If you are configuring an Oracle database, you can click the Advanced button to configure Oracle tablespace information at this time. The values you specify in this dialog are referenced in the storage-config.xml file. See the Oracle documentation for more information about Oracle tablespaces. Check with your database administrator for information on how to correctly assign tablespace names. It is recommended that you create a Foglight for Virtual Desktops label for Data, Index, and Objects. 8 Click Next. If a database schema already exists, the Foglight for Virtual Desktops Database Found screen appears. This screen allows you to keep your existing data, create a new database, or select a different database. Step 12: Foglight for Virtual Desktops Ports Configuration 1 Configure the server ports. The Foglight For Virtual Desktops Ports Configuration screen displays default ports that you can assign. 2 If you are installing Foglight for Virtual Desktops in High Availability (HA) mode and are planning to have multiple HA partitions on the same sub-network, configure a different

18 Foglight for Virtual Desktops: Installation and Setup Guide 18 Chapter 2 Installing Foglight for Virtual Desktops Cluster Multi-cast Port for each HA partition. that the primary server and secondary servers within each HA partition must be configured to use the same Cluster Multi-cast Port. Caution Errors can occur if servers that are not part of the same HA partition are configured to multicast on the same port on the same sub-network as the HA partition. See Running the Foglight for Virtual Desktops Management Server FAQ on page 42 for more information about these errors. 3 If you want to revert to the default values, click Defaults. 4 Click Next. If there are any port assignment conflicts, an error message dialog box appears. You can either click Review Ports if you want to return to the Foglight For Virtual Desktops Ports Configuration screen to configure the conflicting port(s), or choose Ignore and Continue to continue with the installation without resolving the port conflicts. Choose one of these options to continue. Step 13: Add Foglight for Virtual Desktops License File 1 Specify the path to the Foglight for Virtual Desktops license file in the License File field, or browse to a license file by clicking the browse button provided. Important See the Administrator s Guide for information about license requirements and managing licenses.

19 Foglight for Virtual Desktops: Installation and Setup Guide 19 Chapter 2 Installing Foglight for Virtual Desktops 2 Click Next. Alternatively, you can provide a license file to the Foglight for Virtual Desktops Management Server after the installation is complete. To do so, leave the License File field blank and click Next. If you selected Enable Foglight For Virtual Desktops as a Service in Step 6: Foglight for Virtual Desktops Service, the Foglight for Virtual Desktops Management Server service is enabled and started at this point. Step 14: Foglight for Virtual Desktops Server Startup The Foglight for Virtual Desktops Server Startup step provides you with the option of starting Foglight for Virtual Desktops from the installer. This screen does not appear if you enabled Foglight for Virtual Desktops to run as a Windows service.

20 Foglight for Virtual Desktops: Installation and Setup Guide 20 Chapter 2 Installing Foglight for Virtual Desktops 1 To start the server at this point (default setting), click Next. If you do not want the installer to start Foglight for Virtual Desktops, clear the Run Now check box, then click Next 2 If you selected Run Now, the installer starts Foglight for Virtual Desktops and the Foglight for Virtual Desktops Server Startup page launches in a Web browser (if a Web browser is available). If a Web browser is not available, the Foglight for Virtual Desktops Server Startup page does not launch. See Foglight for Virtual Desktops Startup Page on page 20 for more information. In either case, the Install Complete screen appears. Step 15: Install Complete Click Done to complete the installation process. Foglight for Virtual Desktops Startup Page If you selected the Run Now check box in the Foglight for Virtual Desktops Startup step in the installer, the installer starts Foglight for Virtual Desktops and launches the Startup page in a Web browser.

21 Foglight for Virtual Desktops: Installation and Setup Guide 21 Chapter 2 Installing Foglight for Virtual Desktops This page provides information about the status of Foglight for Virtual Desktops as it starts up, such as: The number of services that have started and cartridges that are enabled. The latest status of Foglight for Virtual Desktops as it starts. A list of Foglight for Virtual Desktops services that are starting. As shown in the image above, services listed in grey have not yet started, services listed next to a blue circle are starting, and services listed next to a green square with a check mark have started. A link to the Foglight for Virtual Desktops login page (once the server startup is complete). The information on the page is updated as Foglight for Virtual Desktops starts. The page also includes a link that allows you to refresh the page. Installing and Setting Up Multiple Agent Managers for Load Balancing In large scale installations, we highly recommend that you balance the agent data collection load across multiple Agent Managers. We also recommend that you dedicate at least one server to hosting multiple Agent Manager installations. In the following example, we demonstrate how to install and set up the Agent Managers for an environment with 100 terminal servers, one VMware vcenter, and 20 Hyper-V servers. For agent data collection load balancing in this example, we need to install four additional Agent Managers on a dedicated server. We recommend that you designate 512 MB RAM per Agent Manager installation. Therefore, in this case, the dedicated server should have at least 4 GB RAM 2 GB for the operating system and 2 GB for the four Agent Manager installations. To install and set up the four additional Agent Managers required in our example: 1 From the browser interface, download the Agent Manager installer to the server dedicated for load balancing. 2 Run the installer four times to install an Agent Manager into four different directories. Important Do not configure the server URLs. Do not install the Agent Managers as Windows services. Do not start the Agent Managers.

22 Foglight for Virtual Desktops: Installation and Setup Guide 22 Chapter 2 Installing Foglight for Virtual Desktops For this example, we will use the following structure: C:\Quest_Software\fglam1 for the 20 Hyper-V servers C:\Quest_Software\fglam2 for the one vcenter C:\Quest_Software\fglam3 for 50 of the terminal servers C:\Quest_Software\fglam4 for 50 of the terminal servers 3 As an Administrator, from the command line, navigate to the C:\Quest_Software\fglam1\bin directory. 4 Run the following command: fglam.exe --create-state -l hyperv A state directory is created and populated with default configuration files. 5 Run the following command: fglam.exe --configure -l hyperv The configuration interface opens. 6 Click Next until you see the Server URLs screen. 7 Edit the localhost entry so that it represents your FMS. 8 Click Test to test the connection. 9 Click Next. 10 Indicate that you want the Agent Manager to be installed as a Windows service by selecting the appropriate check box. 11 Click Next. 12 Click Finish. 13 As an Administrator, from the command line, navigate to the C:\Quest_Software\fglam2\bin directory. 14 Run the following command. fglam.exe --create-state -l vmware A state directory is created and populated with default configuration files. 15 Run the following command. fglam.exe --configure -l vmware The configuration interface opens. 16 Repeat steps 6 to 12 to complete the configuration for this Agent Manager. 17 As an Administrator, from the command line, navigate to the C:\Quest_Software\fglam3\bin directory. 18 Run the following command. fglam.exe --create-state -l ts1 A state directory is created and populated with default configuration files. 19 Run the following command.

23 Foglight for Virtual Desktops: Installation and Setup Guide 23 Chapter 2 Installing Foglight for Virtual Desktops fglam.exe --configure -l ts1 The configuration interface opens. 20 Repeat steps 6 to 12 to complete the configuration for this Agent Manager. 21 As an Administrator, from the command line, navigate to the C:\Quest_Software\fglam4\bin directory. 22 Run the following command. fglam.exe --create-state -l ts2 A state directory is created and populated with default configuration files. 23 Run the following command. fglam.exe --configure -l ts2 The configuration interface opens. 24 Repeat steps 6 to 12 to complete the configuration for this Agent Manager. After the Agent Managers are configured, we have the following four Windows Services: Agent Manager (C:\Quest_Software\fglam1\state\hyperv) Agent Manager (C:\Quest_Software\fglam2\state\vmware) Agent Manager (C:\Quest_Software\fglam3\state\ts1) Agent Manager (C:\Quest_Software\fglam4\state\ts2) For information on how to spread load across the additional Agent Managers you install and set up, see Managing vworkspace Farms on page 28. For more information on Agent Managers and their installation and administration, see the Foglight Agent Manager Installation Guide on To Install Foglight for Virtual Desktops in HA Mode This section describes how to install in HA mode. High Availability mode is a configuration of multiple Foglight for Virtual Desktops Management Servers in a cluster where one server is the primary server and the others are standby servers. If the primary server stops responding, one of the standby servers in the HA cluster takes over monitoring responsibility. HA mode uses redundancy and failover to ensure that Foglight for Virtual Desktops monitoring continues uninterrupted. Important Ensure that you are familiar with the information in the Foglight High Availability Field Guide before performing the following procedure. The Foglight High Availability Field Guide is available at If you intend to have a firewall between the primary and secondary Foglight for Virtual Desktops HA servers, the firewall must be configured to allow the following required ports: For TCP, 45566,

24 Foglight for Virtual Desktops: Installation and Setup Guide 24 Chapter 2 Installing Foglight for Virtual Desktops 8080, 8443, 1098, 1099, 4444, 4445, 4448, 3528, 3529, 1101, 1100, 4447, 4446, 8448, and for UDP, Important In a Foglight for Virtual Desktops HA environment, a firewall can have an adverse affect on system performance and stability. If you have a firewall between your Foglight for Virtual Desktops HA servers, we do not support issues related to the firewall. For the support team to assist in debugging server issues, any such firewall must be disabled. To install Foglight for Virtual Desktops in HA mode: 1 Select a host machine to be the primary Foglight for Virtual Desktops Management Server. 2 Select a different host machine to be a secondary Foglight for Virtual Desktops Management Server instance. 3 Select a third host machine for the database. Important To run Foglight for Virtual Desktops in HA mode, the database must be external. 4 Select a host machine for the Agent Manager. In standalone mode, Foglight for Virtual Desktops uses an embedded Agent Manager. In HA mode, the Agent Manager must be remote in order to provide failover functionality. The Agent Manager can be installed on the same machine as the database, but not on the same machine as either instance of the Foglight for Virtual Desktops Management Server. 5 Install the primary Management Server. For installation instructions, see To Install Foglight for Virtual Desktops on page Start the primary server. For instructions on starting the primary server, see Starting and Stopping the Server in High Availability Mode on page Log in to the primary server. For instructions on logging in, see Logging in to Foglight for Virtual Desktops on page Obtain a Foglight for Virtual Desktops license and install it on the primary server. For instructions on obtaining and installing a license, see the Administrator s Guide. 9 Install the secondary Management Server. For installation instructions, see To Install Foglight for Virtual Desktops on page Start the secondary Management Server. For instructions on starting the secondary Management Server, see Starting and Stopping the Server in High Availability Mode on page Download the Agent Manager installer. a Log in to Foglight for Virtual Desktops. For instructions on how to log in to Foglight for Virtual Desktops, see Logging in to Foglight for Virtual Desktops on page 42. b Navigate to the Components for Download dashboard (Dashboards > Administration > Cartridges > Components for Download).

25 Foglight for Virtual Desktops: Installation and Setup Guide 25 Chapter 2 Installing Foglight for Virtual Desktops c d Click the Agent Manager installer for your architecture. Save the installer. 12 Run the Agent Manager installer to install the Agent Manager on a remote machine. For instructions on how to install the Agent Manager, see the Foglight Agent Manager Installation Guide at Now data collection is possible. Now Foglight for Virtual Desktops is in HA mode and failover protection is available. Next Steps Start the Foglight for Virtual Desktops Management Server by following the instructions in Starting and Stopping Foglight for Virtual Desktops on page 37. To log in to Foglight for Virtual Desktops, refer to Logging in to Foglight for Virtual Desktops on page 42. Follow the Configuring System Settings and Monitoring your vworkspace Farms section in the Administrator s Guide. External MySQL Database Access for Remote Users Before installing Foglight for Virtual Desktops with an external MySQL database, the GRANT ALL ON query needs to be executed once in order to give users remote access to the database. To provide users with remote access to the database: 1 From the MySQL Server Instance Configuration dialog box, select the Modify Security Settings check box. 2 Type a new root password (this password is used when executing the GRANT ALL ON query executed below). 3 Select the Enable root access from remote machines check box. Executing the Grant All On Query Script Option 1 For better security, employ this option when the MySQL instance is being used for more than one database. To grant remote access to the MySQL Administrator account, create the database, and grant remote access to the database: From the mysql prompt, type: GRANT ALL ON mysql.* TO 'root'@'%' IDENTIFIED BY <password> with grant option; CREATE DATABASE <database_name> DEFAULT CHARACTER SET utf8 COLLATE utf8_bin; GRANT ALL ON <database_name>.* to % identified by <password> with grant option;

26 Foglight for Virtual Desktops: Installation and Setup Guide 26 Chapter 2 Installing Foglight for Virtual Desktops Option 2 Where <database_name> is the database name you will specify while installing Foglight for Virtual Desktops and <password> is the root password you specified in the procedure To provide users with remote access to the database, above. This gives the root user (with username root and password <password>) remote access with all privileges. Use this option only when the MySQL instance is dedicated entirely to Foglight for Virtual Desktops. To grant remote access to the entire MySQL instance: From the mysql prompt, type: GRANT ALL ON *.* TO 'root'@'%' IDENTIFIED BY <password> with grant option; Where <password> is the root password you specified in the procedure To provide users with remote access to the database, above. This gives the root user (with username root and password <password>) remote access with all privileges. Caution In some cases, following one of these options might not give grant_priv to the root user. If grant_priv is missing for root@% after executing the GRANT ALL ON query, see Installing Foglight for Virtual Desktops FAQ on page 32 for more information. Manual Database Configuration If you chose the option Setup DB Later (manually) while installing the Foglight for Virtual Desktops Management Server for use with an external database, you must manually configure the database prior to starting the Management Server by running the scripts in the <foglight_for_virtual_desktops_home>/scripts/sql directory in the order shown below. Manually Configuring the External MySQL Database The external database must exist before you run the scripts. To perform manual database configuration: Run the sql scripts in the following order: a b c mysql_drop_db.sql This script must be run under an account with root privileges (for example, sys) because you require system access to execute it. mysql_create_db.sql This script must be run under an account with root privileges (for example, sys) because you require system access to execute it. mysql_create_schema.sql

27 Foglight for Virtual Desktops: Installation and Setup Guide 27 Chapter 2 Installing Foglight for Virtual Desktops This script must be run as the Foglight For Virtual Desktops Database Account User ID that you set in step 1 of Step 11: Foglight for Virtual Desktops Database Configuration on page 14. The default user ID is foglight. d mysql_populate_db.sql This script must be run as the Foglight For Virtual Desktops Database Account User ID that you set in step 1 of Step 11: Foglight for Virtual Desktops Database Configuration on page 14. The default user ID is foglight. Examples: mysql -uroot -ppassword < mysql_drop_db.sql mysql -uroot -ppassword < mysql_create_db.sql mysql -ufoglight -pfoglight < mysql_create_schema.sql mysql -ufoglight -pfoglight < mysql_populate_db.sql Manually Configuring the External SQL Server Database Manually configure the external SQL Server database by running the scripts in the <foglight_for_virtual_desktops_home>/scripts/sql directory in the order shown below. The external database must exist before you run the scripts. To perform manual database configuration: 1 Launch a command window. 2 Run the.sql scripts by issuing the following commands from the prompt in the order shown below. In the commands shown below, replace <admin username> and <admin password> with the user name and password for the user account of the Microsoft SQL Server administrator. a sqlcmd -U <admin username> -P <admin password> -i <foglight_for_virtual_desktops_home>\scripts\sql\sqlsvr_drop_db.sql b sqlcmd -U <admin username> -P <admin password> -i <foglight_for_virtual_desktops_home>\scripts\sql\sqlsvr_create_db.sql The script sqlsvr_create_db.sql does not drop the existing schema. c sqlcmd -U <foglight db username> -P <foglight db password> -i <foglight_for_virtual_desktops_home>\scripts\sql\sqlsvr_create_schema.sql Warnings related to the maximum length of index keys appear. These warnings are safe to ignore. d sqlcmd -U <foglight db username> -P <foglight db password> -i <foglight_for_virtual_desktops_home>\scripts\sql\sqlsvr_populate_db.sql

28 Foglight for Virtual Desktops: Installation and Setup Guide 28 Chapter 2 Installing Foglight for Virtual Desktops Manually Configuring the External Oracle Database Manually configure the external Oracle database by running the scripts in the <foglight_for_virtual_desktops_home>/scripts/sql directory in the order shown below. The external database must exist before you run the scripts. When you manually configure an Oracle database using the scripts described below, a new user is created in your database. The scripts create the required permissions for this user. The scripts described below do not create tablespaces. If you need to create new tablespaces, you must do so manually first, before running the scripts. See the Oracle documentation for more information about Oracle tablespaces. Check with your database administrator to correctly assign tablespace names. It is recommended that you create a Foglight for Virtual Desktops label for Data, Index, and Objects. 1 Run SQL*Plus by specifying the following from the command line: sqlplus <username>/<password> The SQL prompt appears. 2 Run the.sql scripts by issuing the following commands in the order shown below: a SQL> START <foglight_for_virtual_desktops_home>/scripts/sql/ oracle_drop_db.sql If you are using an Oracle database, this script must be run under an account with root or administrator privileges (for example, sys) because you require system access to execute it. b c d SQL> START <foglight_for_virtual_desktops_home>/scripts/sql/ oracle_create_db.sql This script must be run under an account with root or administrator privileges (for example, sys) because you require system access to execute it. SQL> START <foglight_for_virtual_desktops_home>/scripts/sql/ oracle_create_schema.sql This script must be run using the Foglight For Virtual Desktops Database Account User ID that you set in step 1 of Step 11: Foglight for Virtual Desktops Database Configuration. The default user ID is foglight. SQL> START <foglight_for_virtual_desktops_home>/scripts/sql/ oracle_populate_db.sql This script must be run using the Foglight For Virtual Desktops Database Account User ID that you set in step 1 of Step 11: Foglight for Virtual Desktops Database Configuration. The default user ID is foglight.

29 Foglight for Virtual Desktops: Installation and Setup Guide 29 Chapter 2 Installing Foglight for Virtual Desktops Installed Directories The following table describes the directories that are created under your target installation folder. They may vary, depending on the product features that you select and the components installed for your platform. Directory bin cartridge client config docs dtd extension fglam jre lib license Contents Foglight for Virtual Desktops executables for running the server and utilities. Installed cartridge files in their original form. Files used by client programs (such as the commandline client) for remote access to Foglight for Virtual Desktops. Configuration files and subdirectories. The files in the config directory contain settings that are most likely to require editing. Files at the next level are less likely to need changing. Files at the lowest level contain settings that are unlikely to need changing except in special circumstances. HTML and PDF versions of the product documentation. Descriptors for configuration files that can be imported into Foglight for Virtual Desktops (for example, by installing a cartridge). Directory for extension cartridges (optional cartridges that are not installed by default). Directories for the embedded Agent Manager. Version of the JRE (1.6.0_18) used by Foglight for Virtual Desktops. The Foglight for Virtual Desktops JAR files. The Foglight for Virtual Desktops license file you install. Consult the Administrator s Guide for information about license requirements, managing licenses, and the different categories of cartridges (based on their license requirements).

30 Foglight for Virtual Desktops: Installation and Setup Guide 30 Chapter 2 Installing Foglight for Virtual Desktops Directory logs Contents Default location of the log files generated by Foglight for Virtual Desktops when it runs. Generated at runtime. mysql The current embedded database version is If the embedded database is selected during installation, then the database is created, populated, and used for Foglight for Virtual Desktops runtime. To start the embedded database separately, without running Foglight for Virtual Desktops, use these parameters: [run shutdown]db.shbat in <install-dir>/ bin<install-dir>/bin This directory is always installed, even if you select an external database when installing Foglight for Virtual Desktops. scripts server state support tmp/ cartridge.deploytm p\cartridge.deploy tools UninstallerData SQL scripts and examples of the two types of Script Agents. scripts/agentscripts\agent contains sample Type 1 and Type 2 Script Agent files. See the Administrator s Guide for more information about Script Agents. scripts/sqlscripts\sql contains SQL scripts to drop/ create schema, or create/populate the database. The scripts included in this directory are specific to the type of database that you selected when installing Foglight for Virtual Desktops. JAR files and data files used by a particular Foglight for Virtual Desktops Management Server variant (such as default). Where the running state of Foglight for Virtual Desktops is kept. Where support bundled archive information is stored. A working directory for deploying cartridges. Various Foglight for Virtual Desktops utilities. Files used by the Foglight for Virtual Desktops uninstaller.