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 .................................................................................................................................................. 57 Upgrading vFoglight.............................................................................................................................
Table of Contents 5 Upgrading Cartridges ......................................................................................................................................................83 Next Steps..............................................................................................................................................................83 Installing and Running the vFoglight Agent Manager (FglAM) .....................................................................
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 vvFoglight 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 vFoglight Agent Manager 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 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. 4 Upload a license by navigating to \tools and entering the following commands: fglcmd -usr <
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 will need the following to install vFoglight: • A machine to host the vFoglight Management Server. The Management Server should run on a dedicated machine because it must process and store large volumes of data. Note Please 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:\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 39 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. Note Image 4 As shown below, the installation type (New Install) is displayed on this screen. If you wanted to upgrade an existing installation of the vFoglight Management Server to version 5.2.
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. 2 In the vFoglight Database Account Password field accept the default password (foglight) or enter an alternate one.
Foglight Installation and Setup Guide 4 In the User ID field, enter the database name (foglight is the default name). Image 8 5 Select one of the following Setup DB options: • Now • Later (manually). Note If you select the option Later (manually), you must 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 10 On the External Database Administrator Login screen: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. 11 Click Next. Note If a database schema already exists, the vFoglight Database Found screen appears.
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 Typical Installation prodedure now takes you through the installation of the vCharter Pro VMware Infrastructure Agent components. Step 11: 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 13: 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 14: 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 15: VMware Infrastructure Agent Install Screen The Agent Install screen is displayed. Click Install. Step 16: 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 17: 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 18: 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. If you did not install a license in Step 11: Add vFoglight License File, follow the instructions in “Managing a License After Installation” on page 29 to provide a license file to the vFoglight Management Server after installation.
Foglight Installation and Setup Guide External MySQL Database Access for Remote Users When running vFoglight 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, check the Modify Security Settings check box. 2 Enter a new root password (this password is used when executing the Grant All On Query executed below).
Installing vFoglight Installing a New Version of the vFoglight Management Server 57 This script must be run as the vFoglight Database Account User ID that you set in step 1 of “A server running in HA mode can only use an external database.” on page 42. The default vFoglight Database Account User ID is foglight. • mysql_populate_db.sql This script must be run as the vFoglight Database Account User ID that you set in step 1 of “A server running in HA mode can only use an external database.” on page 42.
Foglight Installation and Setup Guide Property Description Default INSTALLER_UI The property is set to SILENT for silent mode. This is the default setting and is mandatory. SILENT USER_INSTALL_DIR The vFoglight installation directory. If you want to upgrade an existing installation, specify the path to the existing installation directory here (and ensure that FMS_UPGRADE is set to 1). C:\Program Files\Vizioncore\vFoglight USER_SHORTCUTS Sets the shortcut location. C:\Documents and Settings\A
Installing vFoglight Installing a New Version of the vFoglight Management Server Property Description Default FMS_UPGRADE Only required to update an existing installation, in which case it must be set to 1. 1 FMS_ADMIN_PASSWORD Administrator password for vFoglight. foglight FMS_DB Allows you to specify the database type (embedded or external). Must be external if FMS_HA_MODE=1 embedded FMS_DB_USER Default database user. foglight FMS_DB_USER_PASSWORD Default database password.
Foglight Installation and Setup Guide Property Description Default FMS_JNDI_RMI_PORT Port of RMI naming service. 1098 FMS_HTTP_PORT HTTP/1.1 Connector. 8080 FMS_HTTPS_PORT HTTP/1.1 Connector. 8443 FMS_AJP13_PORT AJP 1.3 Connector. 8009 FMS_HA_JNDI_RMI_PORT Port of RMI naming service in HA mode. 1101 FMS_HA_JNDI_JNP_PORT Bootstrap JNP service in HA mode. 1100 FMS_HA_JRMP_INVOKER_PORT RMI/JRMP invoker in HA mode. 4447 FMS_HA_POOLED_INVOKER Pooled invoker port in HA mode.
Installing vFoglight Installed Directories 61 Installed Directories The following table describes the directories that are installed under your target installation folder. They may vary, depending on the product features that you select and the components installed for your platform. Directory Contents bin vFoglight executables for running the server and utilities. client Files used by client programs (such as the command line client) for remote access to vFoglight.
Foglight Installation and Setup Guide Directory Contents perl Libraries needed to interpret the PERL scripts, version 5.8.8. scripts Supported and unsupported utility scripts to extend the scripting engine. scripts\sql contains SQL scripts to drop, create-schema or create/populate the database. server JARs and data files used by a particular vFoglight server variant (such as default). tools Various utilities such as the foglight-federation-support.sar file.
Installing vFoglight vFoglight Settings 63 Editing the foglight.config File The foglight.config file contains parameters for port settings, virtual memory, command line options, and server federation. You can edit the file using a text editor. Values within quotation marks can be edited. Setting Memory Parameters for the Server If you are running vFoglight Management Server by running fms.exe, you can configure the JVM’s minimum and maximum parameters for the server in the \config\fogligh
Foglight Installation and Setup Guide You cannot directly set the size of the process heap. The process heap uses memory within the 32-bit address space not used by the garbage-collected heap. To increase the size of the process heap, decrease the maximum Java heap size using the -Xmx option in the foglight.config file Default Stack Size The default stack size can be adjusted with the -Xss option. Adding Command Line Options The foglight.
Installing vFoglight vFoglight Settings 65 The encrypted password appears. 2 Open the foglight.config file. 3 Replace the existing database password with the new encrypted database password on the following line: foglight.database.password = “q4056753111e8a24c9a722048fc6df1f0” 4 Restart the vFoglight Management Server. Setting the SQL Parser Properties The following default system properties appear in the foglight.config file.
Foglight Installation and Setup Guide 2 Copy the ...\vFoglight\tools\foglight-federation-support.sar file into the ...\vFoglight\server\default\deploy-foglight directory. 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\conf
Installing vFoglight vFoglight Settings 67 queries are executed on remote servers within the federation. All attributes are merged for topology #objects that are returned by the queries, plus identity attributes are #fetched (recursively) for topology objects referenced from query results.
Foglight Installation and Setup Guide • The vFoglight Management Server keystore located at: $FMS_HOME\jre\lib\security\cacerts (default password: changeit) To import a certificate: 1 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 2 Create a new key under the tomcat alias using the following command: $FMS_HOME\jre\bin\keytool -keysto
Installing vFoglight vFoglight Settings 69 To set up an encrypted database connection with SSL: 1 Import a CA certificate into the vFoglight Management Server keystore (cacerts) as outlined in “Importing a Network Security Certificate” on page 67. 2 Update the MySQL configuration file (my.ini) with the new security certificate and key information by adding the following properties: • ssl-ca= • ssl-cert= • ssl-key= 3 Uncomment and set the foglight.database.
Foglight Installation and Setup Guide ldaps://ldap_server_host_name:636 Note The port number for LDAP over SSL is usually 636. Confirm the correct port number with your LDAP server administrator. Uninstalling vFoglight You can uninstall vFoglight using the uninstaller utility for your platform. The uninstaller can be found in \UninstallerData.
3 Running the vFoglight Management Server This chapter contains the following sections: Before You Begin.........................................................................................................................72 Migrating Data from an Existing Database ..................................................................................72 Initializing and Tuning the Database ...........................................................................................
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. Migrating Data from an Existing Database The contents of the MySQL database can be copied to another MySQL instance via an export/import cycle. The following procedure performs a full export of the database. This procedure can be run against a database currently in use by a server.
Running the vFoglight Management Server Initializing and Tuning the Database 73 Initializing and Tuning the Database The following sections describe how to initialize and tune your database. Initializing the Database For external databases, once the database has been successfully initialized, you can run vFoglight.
Foglight Installation and Setup Guide my.ini setting Recommended Value Comments tmp_table_size 32M Maximum size for internal (inmemory) temporary tables. sort_buffer_size 256K This buffer is allocated when MySQL needs to rebuild the index in REPAIR, OPTIMIZE, ALTER table statements as well as in LOAD DATA INFILE into an empty table. innodb_additional_mem_ pool_size 20M Additional memory pool used by InnoDB to store metadata information.
Running the vFoglight Management Server Starting and Stopping the vFoglight Management Server 75 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.exe To start the Management Server on Windows: • Depending on where you installed the startup icon, choose Start > Programs > Vizioncore > vFoglight 5.2.
Foglight Installation and Setup Guide Using the Command Line From the command line, type the following to install the vFoglight Management Server as a Windows service: fms.
Running the vFoglight Management Server Starting and Stopping the vFoglight Management Server 77 • 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.
Foglight Installation and Setup Guide Remote Monitor The Remote Monitor is a Java program that regularly communicates with a set of High Availability Servers. If there is no reply after it attempts to contact the server, then it logs the event and can optionally send out e-mail notifications to an administrator. The Remote Monitor takes a list of hostnames or hostname/port pairs as parameters.
Running the vFoglight Management Server Logging in to vFoglight 79 • 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.config and \config\remote_monitor.
Foglight Installation and Setup Guide 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. • Change the JVM options by reducing the memory requirements of the vFoglight Management Server so you can start it using Remote Desktop.
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 .....................................................................................82 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 83 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 .......................................................................................86 Upgrading the vFoglight Agent Manager.....................................................................................98 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 87 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 86. 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 102 for the installer name for your platform. 3 Optional: save the installer. 4 Run the installer. See “Installing the vFoglight Agent Manager” on page 88.
Installing and Running the vFoglight Agent Manager (FglAM) Installing the vFoglight Agent Manager 89 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 91 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 93 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 95 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 95 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 97 • 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 99 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 101 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........................................................................................................................104 Agent Installers..........................................................................................................................104 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 105 To download an agent installer: 1 Select Administration > Cartridges > Components for Download from the navigation panel on the left side of the vFoglight interface. The Components for Download page appears. 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.
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 104 database external MySQL database access for remote users 56 initializing 73 deploying vFoglight Agent Manager cartridge 86 directories installed directories 61 documentation cartridge 10 core 9 feedback 10 suite 9 documentation directory 61 downloading vFoglight Agent Manager installer 87 dtd directory 61 B bin directory 61 C cartridge directory 62 cartridge
Foglight Installation and Setup Guide I M installation modes 57 recommendations 31 requirements 34 installed directories 61 bin 61 cartridge 62 client 61 config 61 docs 61 dtd 61 jre 61 lib 61, 62 logs 61 mysql 61 scripts 62 server 62 support 62 installers downloading the vFoglight Agent Manager installer 87 installing vFoglight Agent Manager 85, 86, 88 installing cartridges 82 Management Server 27 mysql files directory 61 J JAR files directory 61 JRE directory 61 L lib directory 61, 62 licensing
Index U uninstalling vFoglight 70 vFoglight Agent Manager 101 upgrading vFoglight Agent Manager 98 user account administrator 34 using Components for Download dashboard 87 vFoglight Agent Manager installer servlet 87 V vFoglight uninstalling 70 vFoglight Agent Manager configuring 98 deploying the cartridge 86 downloading the installer 87 installer 88 installing 85, 86 installing Windows service 100 platform support 102 removing Windows service 100 running 85, 100 uninstalling 101 upgrading 98 vFoglight Ag
