vFoglight™ Pro 5.2.
© 2008 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.
Table of Contents Introduction to this Guide ...................................................................................................................................7 About vFoglight ................................................................................................................................................................ 8 About this Guide...........................................................................................................................................
Foglight Installation and Setup Guide Manual Database Configuration ............................................................................................................................ 56 Installation Modes .................................................................................................................................................. 56 Upgrading the vFoglight Management Server ......................................................................................................
Table of Contents 5 Downloading the vFoglight Agent Manager Installer..............................................................................................85 Installing the vFoglight Agent Manager ..................................................................................................................86 Upgrading the vFoglight Agent Manager ........................................................................................................................
Foglight Installation and Setup Guide
Introduction to this Guide This chapter provides information about what is contained in the vFoglight Installation and Setup Guide. It also provides information about the vFoglight documentation suite and Vizioncore. This chapter contains the following sections: About vFoglight..............................................................................................................................8 About this Guide..........................................................................................
vFoglight Installation and Setup Guide About vFoglight vFoglight helps IT organizations understand the virtual infrastructure by managing the relationships and interaction between all the components in the environment, including data centers, data stores, clusters, resource pools, hosts and virtual machines.
Introduction to this Guide vFoglight Documentation Suite 9 vFoglight Documentation Suite The vFoglight documentation suite is made up of the core documentation set, plus the documentation set for each vFoglight cartridge that you deploy. Documentation is provided in a combination of online help, PDF and HTML. • Online Help: You can open the online help by selecting the Help tab from vFoglight’s action panel.
vFoglight Installation and Setup Guide • Installation and Setup Guide set (all in PDF format): • Installation and Setup Guide—Installing on Windows with an Embedded MySQL Database • Installation and Setup Guide—Installing on Windows with an External MySQL Database • Installation and Setup Guide—Installing on Windows with an External Oracle Database • Administration and Configuration Guide (PDF and online help) • vFoglight User Guide (PDF and online help) • Advanced Configuration Guide set • Command-Lin
Introduction to this Guide Text Conventions 11 Text Conventions The following table summarizes how text styles are used in this guide: Convention Description Code Monospace text represents code, code objects, and commandline input.
Contacting Dell Note: If you do not have an active Internet connection, you can find contact information on your purchase invoice, packing slip, bill, or Dell product catalog. Dell provides several online and telephone-based support and service options. Availability varies by country and product, and some services may not be available in your area. To contact Dell for sales, technical support, or customer service issues: 1 Visit http://support.dell.com.
Austria (Vienna) International Access Code: 900 Country Code: 43 City Code: 1 Bahamas Barbados Belgium (Brussels) Bolivia Brazil International Access Code: 00 Country Code: 55 City Code: 51 British Virgin Islands Brunei Country Code: 673 Canada (North York, Ontario) International Access Code: 011 Support.euro.dell.com Web Address Tech_support_central_europe@dell.
Chile (Santiago) Country Code: 56 City Code: 2 China (Xiamen) Web Address E-Mail Address Sales and Customer Support Technical Support Web Address Technical Support E-Mail Address Country Code: 86 Customer Service E-Mail Address City Code: 592 Technical Support Fax Technical Support – Dimension and Inspiron Technical Support – OptiPlex, Lattitude and Dell Precision Technical Support – Servers and Storage Technical Support – Projectors, PDAs, Switches, Routers, etc Technical Support – Printers Customer Ser
Dominican Republic Ecuador El Salvador Finland (Helsinki) International Access Code: 990 Country Code: 358 City Code: 9 France (Paris) (Montpellier) International Access Code: 00 Country Code: 33 City Codes: (1) (4) Web Address E-Mail Address Technical Support, Customer Service, Sales Web Address E-Mail Address Technical Support, Customer Service, Sales (Calling from Quito) Technical Support, Customer Service, Sales (Calling from Guayaquil) Web Address E-Mail Address Technical Support, Customer Servic
Guatemala Guyana Hong Kong International Access Code: 001 Country Code: 852 India Web Address E-Mail Address Technical Support, Customer Service, Sales E-Mail Address Technical Support, Customer Service, Sales Web Address Technical Support E-mail Address Technical Support - Dimension and Inspiron Technical Support - OptiPlex, Latitude, and Dell Precision Technical Support - Servers and Storage Technical Support - Projectors, PDAs, Switches, Routers, etc .
Ireland (Cherrywood) International Access Code: 00 Country Code: 353 City Code: 1 Italy (Milan) International Access Code: 00 Country Code: 39 City Code: 02 Jamaica Web Address Technical Support E-mail Address Business computers Home computers At Home Support Sales Home Small Business Medium Business Large Business E-mail Address Customer Service Home and Small Business Business (greater than 200 employees) General Fax/Sales fax Switchboard U.K. Customer Service (dealing with U.K.
Japan (Kawasaki) International Access Code: 001 Country Code: 81 City Code: 44 Korea (Seoul) International Access Code: 001 Country Code: 82 City Code: 2 Latin America Luxemborg International Access Code: 00 Country Code: 352 Macao Country Code: 83 Web Address Technical Support - Dimension and Inspiron Technical Support outside of Japan - Dimension and Inspiron Technical Support - Dell Precision, OptiPlex, and Latitude Technical Support outside of Japan - Dell Precision, OptiPlex, and Latitude Techni
Malaysia (Penang) International Access Code: 00 Country Code: 60 City Code: 4 Mexico International Access Code: 00 Country Code: 52 Montserrat Netherlands Antilles Netherlands (Amsterdam) International Access Code: 00 Country Code: 31 City Code: 20 New Zealand International Access Code: 00 Country Code: 64 Nicaragua Norway (Lysaker) International Access Code: 00 Country Code: 47 Panama Peru Support.ap.dell.
Poland (Warsaw) International Access Code: 011 Country Code: 48 City Code: 22 Portugal International Access Code: 00 Country Code: 351 Puerto Rico St. Kitts and Nevis St. Lucia St.
Spain (Madrid) International Access Code: 00 Country Code: 34 City Code: 91 Sweden (Upplands Vasby) International Access Code: 00 Country Code: 46 City Code: 8 Switzerland (Geneva) International Access Code: 00 Country Code: 41 City Code: 22 Web Address Home and Small Business Technical Support Customer Service Sales Switchboard Fax Corporate Technical Support Customer Service Switchboard Fax Web Address Technical Support Relational Customer Service Home/Small Business Customer Service Employee Purchas
U.K.(Bracknell) International Access Code: 00 Country Code: 44 City Code: 1344 Uruguay U.S.A.
U.S. Virgin Islands Venezuela Web Address E-mail Address Technical Support, Customer Service, Sales Web Address E-mail Address Technical Support, Customer Service, Sales www.dell.com/vi la‐techsupport@dell.com toll‐free: 1‐877‐702‐4360 www.dell.com/ve la‐techsupport@dell.
1 Before Installing vFoglight This chapter provides you with setup information and provides an initial overview of installing vFoglight or upgrading your vFoglight installation. This chapter contains the following sections: What Is vFoglight?.......................................................................................................................26 Planning Your Installation or Upgrade .........................................................................................
Foglight Installation and Setup Guide What Is vFoglight? vFoglight is a powerful system and application performance management solution that detects problems and alerts information technology managers. vFoglight has the ability to dynamically create unique data schemas based on any data from any source. Rather than store data based on how it is collected by the agents, vFoglight organizes data based on your perception of the data.
Before Installing vFoglight Planning Your Installation or Upgrade 27 Planning Your Installation or Upgrade Before you install or upgrade vFoglight, you need to review the components that you are going to install or upgrade. Ensure that you have the necessary information, such as port numbers and server names, and the locations where you are going to install the components.
Foglight Installation and Setup Guide communication capabilities, modifications to the way that data is transformed or handled, rules, reports, and views. Step 4: Install and configure Agents. Agents are deployed on machines in your monitored environment and send data to the vFoglight Management Server. There are several types of agents. One or more instances of each type of agent managed by the Administration Module can be deployed per host.
Before Installing vFoglight Planning Your Installation or Upgrade 29 primary server stops responding, one of the standby servers resumes service and becomes the primary server. Note In both High Availability Mode and Single Server Mode, the database must be running for vFoglight to operate. You may have to implement a combined database-backup and High Availability solution to achieve true failover of all components. Note A server running in HA mode can only use an external database.
Foglight Installation and Setup Guide Manual Process • Move an existing license file into the \license folder. Using the vFoglight Administration Module • Upload a license file using the vFoglight Administration Module. See the Administration and Configuration Guide for instructions. Using the Command Line 1 Start the vFoglight Management Server. 2 Ensure that JAVA_HOME is set. 3 If you have not already done so, extract the file fglcmd.zip in \tools.
Before Installing vFoglight Hardware Requirements and Guidelines 31 Hardware Requirements and Guidelines The hardware requirements to run vFoglight can vary widely, based on a number of factors, including: • The number and type of agents that are being used • The persistence and data-rollup policies • Agent configuration settings You should not consider doing a production implementation without conducting a proper scoping and sizing exercise with a qualified Vizioncore representative.
Foglight Installation and Setup Guide
2 Installing vFoglight The vFoglight 5.2.4 installer allows you either to install a new instance of the vFoglight Management Server or to upgrade an existing installation of a vFoglight 5.x Management Server. This guide provides the procedures for a new installation of version 5.2.4 of the Management Server. For upgrade procedures, please refer to the vFoglight 5.2.4 Upgrade Field Guide. This chapter contains the following sections: Preparing to Install.......................................................
Foglight Installation and Setup Guide Preparing to Install You need the following to install vFoglight: • A computer to host the vFoglight Management Server. The Management Server should run on a dedicated computer because it must process and store large volumes of data. Note Ensure that a hostname resolution and reverse lookup are confirmed prior to installing the vFoglight Management Server. • Administrator or root access to all machines requiring a vFoglight agent.
Installing vFoglight Installing a New Version of the vFoglight Management Server Step 1: Introduction The Introduction screen provides an overview of the mechanics of the installation interface. Click Next after reading the contents of this screen.
Foglight Installation and Setup Guide Step 2: License Agreement 1 Read the License Agreement statement, and accept or decline the terms of the license agreement. Image 2 2 If you selected I accept the terms of the License Agreement, click Next.
Installing vFoglight Installing a New Version of the vFoglight Management Server Step 3: Select Installation Note This screen allows you to choose an installation type. The Standard Install option is only available if you are using an embedded database. 1 Choose the Custom Install option. 2 Click Next.
Foglight Installation and Setup Guide Step 4: Choose Install Folder 1 Choose the location where you want to install vFoglight. You can accept the default location C:\Program Files\Vizioncore\vFoglight or click the Browse button to navigate to another location. Image 3 2 Click Next.
Installing vFoglight Installing a New Version of the vFoglight Management Server Step 5: Pre-Installation Summary 1 Review the installation information. 2 If you are satisfied with the parameters of your installation, click Install. To make changes to the installation parameters click Previous.
Foglight Installation and Setup Guide Step 6: Installing vFoglight 5.2.4 vFoglight installs files into the specified directory.
Installing vFoglight Installing a New Version of the vFoglight Management Server 41 Step 7: vFoglight Administrator Password 1 In the vFoglight Administrator Password field accept the default password (foglight) or enter an alternate one. 2 In the Retype Administrator Password field, accept the default (foglight) or, if you have provided an alternate password in step 1, retype the password for verification. 3 To run vFoglight in secure mode (HTTPS) only, check the Secure Server box. 4 Click Next.
Foglight Installation and Setup Guide Step 8: vFoglight Mode 1 Choose the server startup mode. The options are Standalone or HA (High Availability). Servers running in High Availability mode can only use an external database. 2 If you chose HA (High Availability): a In the HA Partition field, enter 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.
Installing vFoglight Installing a New Version of the vFoglight Management Server 43 Step 9: vFoglight Database Configuration 1 In the vFoglight Database Account User ID field accept the default user ID (foglight) or enter an alternate one. This is the name for the vFoglight user that you are creating. The vFoglight Management Server uses this account to store data in the database. Note The User ID is used for the database name.
Foglight Installation and Setup Guide 4 In the DB SID field, enter the service ID for the database. Image 8 5 Select one of the following Setup DB options: • Now • Later (manually). Note If you select the option Later (manually), you need to manually configure the database after the installation is complete and prior to starting the Management Server. See “Manual Database Configuration” on page 56 for information.
Installing vFoglight Installing a New Version of the vFoglight Management Server 45 11 If you selected Now in step 5, enter the Database Administrator Account User ID and Password. Caution The Database Administrator Account User ID cannot be the same as the vFoglight Database Account User ID. 12 Optionally, you can also click the Advanced button to configure Oracle Tablespace information at this time. The values you enter in this dialog are referenced in the storage-config.xml file.
Foglight Installation and Setup Guide Step 10: vFoglight Ports Configuration 1 Configure the server ports. The vFoglight Ports Configuration screen displays default ports which you can assign. If you want to revert to the default values, click Defaults. 2 Click Next. Note If there are any port assignment conflicts, an error message dialog box appears.
Installing vFoglight Installing a New Version of the vFoglight Management Server 47 Step 11: Add vFoglight License File 1 Specify the path to the vFoglight license file in the License File field, or browse to a license file by clicking Browse License. Alternatively, you can provide a license file to the vFoglight Management Server after the installation is complete. To do so, leave the License File field blank and proceed to step 2. 2 Click Next.
Foglight Installation and Setup Guide Step 12: Install Complete Click Done to complete the installation process. Image 10 The Standard Installation prodedure now takes you through the installation of the vCharter Pro VMware Infrastructure Agent components. Step 13: InstallShield Wizard Welcome Screen The Welcome screen for the VMware Infrastructure Agent InstallShield Wizard explains the purpose of the InstallShield Wizard. Click Next after reading the contents of this screen.
Installing vFoglight Installing a New Version of the vFoglight Management Server Step 14: License Agreement 1 Read through the VMware Infrastructure Agent License Agreement statement, and accept or decline the terms.
Foglight Installation and Setup Guide 2 If you selected I accept the terms in the License Agreement, click Next. Step 15: Destination Folder 1 Choose the location where you want to install the VMware Infrastructure Agent components. You can accept the default location C:\Program Files\Vizioncore\vFoglight\Vmware Agent\ or click on the Change button to navigate to another location.
Installing vFoglight Installing a New Version of the vFoglight Management Server 2 Click Next.
Foglight Installation and Setup Guide Step 16: VMware Infrastructure Agent Install Screen The Agent Install screen is displayed. Click Install. Step 17: VirtualCenter Authentication 1 On the VirtualCenter Authentication Information screen, enter the VirtualCenter Server name or IP Address. 2 Enter VirtualCenter Server Username and Password credentials that will provide you with access to the VMware Virtual Infrastructure Client.
Installing vFoglight Installing a New Version of the vFoglight Management Server 53 3 Click Save to have your entries validated. 4 On the Credentials Entered are Valid! dialog, click OK. Step 18: vFoglight Server Destination 1 On the vFoglight Server Destination Information screen, enter the agent name as you want it to be displayed in vFoglight. 2 Enter the vFoglight Server name or IP address. This is the name or IP of the vFoglight Management Server.
Foglight Installation and Setup Guide 6 Click Save to have your entries validated. Step 19: InstallShield Wizard Completed Click Finished to complete the VMware Infrastructure Agent components installation.
Installing vFoglight Installing a New Version of the vFoglight Management Server 55 The vFoglight Agent Manager, Guest Process Investigation components, and required services will be installed automatically. The services will start after the installation is complete.
Foglight Installation and Setup Guide Manual Database Configuration If you chose the option Setup DB Later (manually) while installing the vFoglight Management Server, you must manually configure the database (by running scripts located in the \scripts\sql directory) prior to starting the Management Server. 1 Run SQL*Plus by entering the following from the command line: sqlplus / The SQL prompt appears. 2 Run the .
Installing vFoglight Installing a New Version of the vFoglight Management Server 57 Silent Mode In silent mode, a properties file is used to feed in the properties. The file consists of a list of key-value pairs, which are described in the table below. To execute the silent mode: Windows vFoglight-5_2_4-install_windows-ia32.exe -i silent Use the properties file in silent mode to execute a specific property. Type -f fms_silent_install.properties. The installer loads the properties file specified.
Foglight Installation and Setup Guide Property Description Default USER_SHORTCUTS Sets the shortcut location. C:\Documents and Settings\All Users\Start Menu\Programs\Vizioncore\v Foglight 5.2.4 FMS_LICENSE_AGREEMENT License agreement acknowledgment. yes FMS_LICENSE_FILE Allows you to add a license file by specifying the path to the license. None (the license file you specify is validated). FMS_SERVICE For enabling vFoglight as a Windows service.
Installing vFoglight Installing a New Version of the vFoglight Management Server Property Description Default FMS_DB_SETUPNOW 1 = Set up database as part of installation. 0 = Set up database after installation is complete. 1 FMS_DB_PORT User-defined port for database. 13306 FMS_HA_MODE 0 = Standalone mode 1 = HA mode 0 FMS_HA_PARTITION Partition name. Only required if FMS_HA_MODE=1 FMS_HA FMS_JNDI_JNP_PORT Bootstrap JNP service. 1099 FMS_JNDI_RMI_PORT Port of RMI naming service.
Foglight Installation and Setup Guide Property Description FMS_HA_JNDI_UDPGROUP_PORT FMS_CLUSTER_MCAST_PORT Default 1102 Cluster Multicast post. 45566 Upgrading the vFoglight Management Server Please consult the vFoglight 5.2.4 Upgrade Field Guide for detailed upgrade instructions. Installed Directories The following table describes the directories that are installed under your target installation folder.
Installing vFoglight Installed Directories 61 Directory Contents jre Version of the JRE (1.5.0_11-b03) used by vFoglight. lib The vFoglight JARs. logs Default location of the log files generated by vFoglight when it runs. Generated at runtime. mysql The current embedded database version is 5.0.51a. If the embedded database is selected during installation, then the database is created, populated, and used for vFoglight runtime.
Foglight Installation and Setup Guide vFoglight Settings vFoglight can be run with the default settings. However, you can edit these settings if you need to change runtime parameters such as settings for running the vFoglight Management Server in HA mode or ports used by the Management Server. To do so, you can edit the file \config\foglight.config, which contains central settings. Editing the foglight.config File The foglight.
Installing vFoglight vFoglight Settings 63 Process Heap Use If the VM generates errors relating to a failure to allocate native resources or to exhaustion of process address space, you must increase the native process heap size. Errors appear as a Java VM internal error message or a detail message associated with an out-of-memory error. Messages with the relevant errors indicate that the problem is process heap exhaustion. You cannot directly set the size of the process heap.
Foglight Installation and Setup Guide Changing External Database Credentials Use the following method to reconfigure vFoglight to start up with a new database password. The password can be updated in the foglight.config file. To encrypt your database password using the keyman command: 1 Enter the following from the command line: > bin\keyman -d [FGLHOME\config] encpwd “” foglight.defaultkey The encrypted password appears. 2 Open the foglight.config file.
Installing vFoglight vFoglight Settings 65 3 Edit the following line in the foglight.config file by changing the variable from false to true: # foglight.federation is a boolean parameter that indicates whether the # server should start in the "federation" mode. The default value is false. # foglight.federation = true; 4 Start your master server. 5 Open the ...\vFoglight\config\federation.config file. 6 Add the port number of each vFoglight Management Server in the federation to the federation.
Foglight Installation and Setup Guide the queries, plus identity attributes are #fetched (recursively) for topology objects referenced from query results.
Installing vFoglight vFoglight Settings 67 To import a certificate: 1 Change directories to the following path: $FMS_HOME\server\default\conf\ 2 Delete the existing tomcat key from the tomcat.keystore directory using the following command: $FMS_HOME\jre\bin\keytool -keystore FMS_HOME\server\default\conf\tomcat.keystore -storepass nitrogen -delete -alias tomcat 3 Create a new key under the tomcat alias using the following command: $FMS_HOME\jre\bin\keytool -keystore FMS_HOME\server\default\conf\tomcat.
Foglight Installation and Setup Guide To set up an encrypted Oracle database connection: 1 Enable encryption in your Oracle database. Check with your database administrator for details. 2 Uncomment and set the foglight.database.secureconn attribute in the foglight.config file to true, as shown below. # # For Oracle, this option can be enabled once the database server is properly configured.
Installing vFoglight Uninstalling vFoglight Uninstalling vFoglight You can uninstall vFoglight using the uninstaller utility for your platform. The uninstaller can be found in \UninstallerData.
Foglight Installation and Setup Guide
3 Running the vFoglight Management Server This chapter contains the following sections: Before You Begin.........................................................................................................................72 Starting and Stopping the vFoglight Management Server...........................................................72 Logging in to vFoglight ................................................................................................................
Foglight Installation and Setup Guide Before You Begin The instructions in this chapter assume that you have already installed vFoglight. If you have not, see “Installing vFoglight” on page 33 for installation instructions. Starting and Stopping the vFoglight Management Server The following sections describe how to start and stop the vFoglight Management Server. To start the Management Server from the command line: • Execute the following command: \bin\fms.
Running the vFoglight Management Server Starting and Stopping the vFoglight Management Server 73 To start or stop the Management Server service from the Start menu: • Choose Start > Programs > Vizioncore > vFoglight 5.2.4 > Windows Service > Start Service for vFoglight (or Stop Service for vFoglight). Using the Command Line From the command line, type the following to install the vFoglight Management Server as a Windows service: fms.
Foglight Installation and Setup Guide • Type Ctrl-C in the command window from which the Management Server started. • On the command line, type: fms.exe -q • Depending on where you installed the startup icon, choose Start > Programs > Vizioncore > vFoglight 5.2.4 > Stop vFoglight or double-click the Stop vFoglight icon on the desktop. When the server has stopped successfully, the Start vFoglight command window closes.
Running the vFoglight Management Server Starting and Stopping the vFoglight Management Server 75 • Open a second command window and enter the following command: fmsha.exe -q When the server has stopped successfully, the command window closes. Remote Monitor The Remote Monitor is a Java program that regularly communicates with a set of High Availability Servers.
Foglight Installation and Setup Guide To stop the Remote Monitor: Do one of the following: • Enter Ctrl-C from the command window where the Remote Monitor started. • Choose Start > Programs > Vizioncore > vFoglight 5.2.4 > High Availability > Stop Remote Monitor. Enabling Email Notification Servers running in HA mode can send out email notifications in various situations, such as when servers stop responding or on failure to restart a server. The files \config\restart_monitor.
Running the vFoglight Management Server Running the vFoglight Management Server FAQ 77 Next Steps To install cartridges, refer to the chapter “Installing and Upgrading Cartridges”. Running the vFoglight Management Server FAQ When I try to start the vFoglight Management Server using Remote Desktop, an error appears. How can I resolve this error? There are two options to resolve this problem. • Use VMWARE Console to start the server.
Foglight Installation and Setup Guide
4 Installing and Upgrading Cartridges Using the vFoglight Administration Module, you can install cartridges on the machine hosting the vFoglight Management Server, enable and manage cartridges, and download agent installers. The following topics are covered in this chapter: Accessing the Cartridge Inventory Page .....................................................................................80 Installing Cartridges.........................................................................................
vFoglight Installation and Setup Guide Accessing the Cartridge Inventory Page The Cartridge Inventory page of the vFoglight Administration Module contains controls for installing, enabling, disabling, and uninstalling cartridges, as well as for viewing information about the installed cartridges. To access the Cartridge Inventory page: • In the navigation panel, select Administration > Cartridges > Cartridge Inventory. The Cartridge Inventory page appears.
Installing and Upgrading Cartridges Upgrading Cartridges 81 3 The check box Enable on install is selected by default. • If you would like the cartridge to be enabled when it is installed, leave this check box selected. • If you would like to enable the cartridge after installation, deselect this check box. 4 Click Install Cartridge.
vFoglight Installation and Setup Guide
5 Installing and Running the vFoglight Agent Manager (FglAM) This chapter contains the following sections: Installing the vFoglight Agent Manager .......................................................................................84 Upgrading the vFoglight Agent Manager.....................................................................................96 Configuring the vFoglight Agent Manager ...................................................................................
vFoglight Installation and Setup Guide Installing the vFoglight Agent Manager The vFoglight Agent Manager manages agents installed on monitored hosts, providing a centralized communications link between the vFoglight Management Server and the agents. The vFoglight Agent Manager also provides a number of support services such as installation, upgrade, and the ability to configure agents.
Installing and Running the vFoglight Agent Manager (FglAM) Installing the vFoglight Agent Manager 85 Downloading the vFoglight Agent Manager Installer The sections below outline how to download the installer for the vFoglight Agent Manager once you have deployed the FglAM-windows-ia32-5_2_4.car file as described in “Deploying the vFoglight Agent Manager Cartridge” on page 84. Using the Components for Download Dashboard After deploying the FglAM-windows-ia32-5_2_4.
vFoglight Installation and Setup Guide 2 Click the appropriate vFoglight Agent Manager installer for Windows. Please consult the “vFoglight Agent Manager Platform Support Matrix” on page 100 for the installer name for your platform. 3 Optional: save the installer. 4 Run the installer. See “Installing the vFoglight Agent Manager” on page 86.
Installing and Running the vFoglight Agent Manager (FglAM) Installing the vFoglight Agent Manager 87 Using the vFoglight Agent Manager Installation and Configuration GUI The following procedure outlines how to run the installer GUI for the vFoglight Agent Manager. To install the vFoglight Agent Manager using the installer GUI: 1 Run the installer executable on the target machine. This program prompts you for information, and informs you of the progress of your installation.
vFoglight Installation and Setup Guide 5 From the Configure vFoglight Server URLs screen—and the Edit vFoglight Server URL dialog that is accessible from this screen—you can configure multiple ways of connecting the vFoglight Agent Manager to the vFoglight Management Server. For example, you can specify a single URL or configure multiple Management Server URLs for failover purposes.
Installing and Running the vFoglight Agent Manager (FglAM) Installing the vFoglight Agent Manager 89 A URL for which the connection has not been tested appears with an orange exclamation-point icon ( ) next to it. 8 You can test each vFoglight Agent Manager-vFoglight Management Server connection by selecting the Management Server URL and clicking Test. A URL that failed the connectivity test appears with a red x icon ( ) next to it.
vFoglight Installation and Setup Guide Connect using HTTPS If the vFoglight Management Server has been configured to use HTTPS, then HTTPS can be used by the vFoglight Agent Manager to connect to the Management Server. Selecting the Connect using HTTPS check box causes the following additional options to become available: • Allow self-signed certificates: Selecting this check box causes self-signed certificates to be accepted from the Management Server.
Installing and Running the vFoglight Agent Manager (FglAM) Installing the vFoglight Agent Manager 91 To install the vFoglight Agent Manager from the command line: 1 Launch a command window on the target machine and navigate to the directory to which you downloaded the installer. 2 Run the installer executable by specifying the following: fglam-windows-[ia32|x64].
vFoglight Installation and Setup Guide The step Enter the URL data to add provides information about the parameters available for adding a new URL. See also “Configuring vFoglight Management Server URLs from the Command Line” on page 93 for information about these parameters. a At the URL prompt, type the URL parameters as a comma-separated list of name-value pairs starting with the required url parameter. For example: url=http://localhost:8080,address=127.0.0.1,proxy=http://proxy.
Installing and Running the vFoglight Agent Manager (FglAM) Installing the vFoglight Agent Manager 93 The installer searches for HA peers and tests the connection(s). A message appears informing you of the search and test progress. When the search and test are complete, you return to the Configure vFMS URLs menu and prompt. b To see whether HA peers where found and added to the list, type 1 and press Enter. A URL that failed the connectivity test appears with an x next to it.
vFoglight Installation and Setup Guide url=http://localhost:8080,address=127.0.0.1,proxy=http://proxy.server Important When specifying these parameters as part of the silent installation process, you must specify the option --fms prior to the list of comma-separated name-value pairs. For example: --fms url=http://localhost:8080,address=127.0.0.1 • url: This parameter is required.
Installing and Running the vFoglight Agent Manager (FglAM) Installing the vFoglight Agent Manager 95 • certCommonName: This parameter is optional. Including this parameter causes a certificate with a common name (host name) different than the one reported by the Management Server to be accepted. Type the common name contained in the Management Server’s certificate as the certCommonName value.
vFoglight Installation and Setup Guide Upgrading the vFoglight Agent Manager Consult the vFoglight 5.2.4 Upgrade Field Guide for detailed upgrade instructions. Configuring the vFoglight Agent Manager This section contains information about configuring the vFoglight Agent Manager after installation. Configuring the vFoglight Agent Manager You can change many of the settings available in the vFoglight Agent Manager installer at a later time using the vFoglight Agent Manager configuration interface.
Installing and Running the vFoglight Agent Manager (FglAM) Configuring the vFoglight Agent Manager 97 4 Click Next. The Configure vFoglight Server URLs screen appears. 5 Using the Next and Previous buttons, navigate through the remaining screens and set the desired options. The Configure vFoglight Server URLs and Install Windows Service screens are the same as in the vFoglight Agent Manager installer GUI.
vFoglight Installation and Setup Guide 6 When you have finished configuring the vFoglight Agent Manager, press Enter at the Summary step. Installing the vFoglight Agent Manager as a Windows Service If you did not install the vFoglight Agent Manager as a Windows service using the installer, you can do so from the command line after installing the vFoglight Agent Manager.
Installing and Running the vFoglight Agent Manager (FglAM) Next Steps 99 2 Launch a command window on the vFoglight Agent Manager machine and navigate to the \bin directory. 3 Run the vFoglight Agent Manager from the command line with the desired option: • To start the vFoglight Agent Manager service: Run fglam.exe with the -start-service option: fglam.exe --start-service • To stop the vFoglight Agent Manager service: Run fglam.exe with the -stop option: fglam.
vFoglight Installation and Setup Guide vFoglight Agent Manager Platform Support Matrix The following table outlines the vFoglight Agent Manager installer appropriate for your platform.
6 Installing Agents This chapter contains the following sections: vFoglight Agents........................................................................................................................102 Agent Installers..........................................................................................................................102 Remote Agent Installation .........................................................................................................
vFoglight Installation and Setup Guide vFoglight Agents A cartridge may include one or more executable vFoglight agent installers. These agent installers included in a cartridge are listed on the Components for Download page of the Cartridges area in the vFoglight Administration Module (select Administration > Cartridges > Components for Download from the navigation panel on the left side of the vFoglight interface). Agents must be installed on all of the machines you want to monitor.
Installing Agents Remote Agent Installation 103 2 Click the name of the installer that you want to download. 3 Follow the on-screen instructions for each step of the installation process and specify the appropriate installation options. Note For agents that are installed individually, you have to run the agent installer executable and setup the agent on each machine you want to monitor with that type of agent. The vFoglight Agent Manager defines agents with their Agent Package name.
vFoglight Installation and Setup Guide
Index A D about vFoglight 8 administration administrator default account 34 default user name and password 34 Agents 28 embedded 28 installing 102 database external MySQL database access for remote users 55 deploying vFoglight Agent Manager cartridge 84 directories installed directories 60 documentation cartridge 10 core 9 feedback 10 suite 9 documentation directory 60 downloading vFoglight Agent Manager installer 85 dtd directory 60 B bin directory 60 C cartridge directory 61 cartridges installing 80
Foglight Installation and Setup Guide I M installation modes 56 recommendations 31 requirements 34 installed directories 60 bin 60 cartridge 61 client 60 config 60 docs 60 dtd 60 jre 61 lib 61 logs 61 mysql 61 scripts 61 server 61 support 61 installers downloading the vFoglight Agent Manager installer 85 installing vFoglight Agent Manager 83, 84, 86 installing cartridges 80 Management Server 27 mysql files directory 61 J JAR files directory 61 JRE directory 61 L lib directory 61 licensing 29 log
Index U uninstalling vFoglight 69 vFoglight Agent Manager 99 upgrading vFoglight Agent Manager 96 user account administrator 34 using Components for Download dashboard 85 vFoglight Agent Manager installer servlet 85 V vFoglight uninstalling 69 vFoglight Agent Manager configuring 96 deploying the cartridge 84 downloading the installer 85 installer 86 installing 83, 84 installing Windows service 98 platform support 100 removing Windows service 98 running 83, 98 uninstalling 99 upgrading 96 vFoglight Agent M
