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 Before Installing vFoglight..................................................................................................................................7 What Is vFoglight?............................................................................................................................................................ 8 Planning Your Installation or Upgrade.........................................................................................................................
Foglight Installation and Setup Guide Installation Modes .................................................................................................................................................. 65 Upgrading vFoglight........................................................................................................................................................ 68 Installed Directories .........................................................................................................
Table of Contents 5 Upgrading the vFoglight Agent Manager ......................................................................................................................104 Configuring the vFoglight Agent Manager.....................................................................................................................104 Configuring the vFoglight Agent Manager............................................................................................................
Foglight Installation and Setup Guide
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?.........................................................................................................................8 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 9 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 Using Embedded Databases vFoglight offers the option to use MySQL (v5.0.51a) as an embedded database. The lifecycle of the embedded database matches that of the vFoglight Management Server. If the Management Server is stopped or started, the embedded database is automatically stopped or started. Licensing This section provides information about licensing for vFoglight.
Before Installing vFoglight Hardware Requirements and Guidelines 11 fglcmd -usr -pwd -cmd license:list fglcmd -usr -pwd -cmd license:remove serial Note The commands listed above assume that you are using a default port=8080 and a localhost.
Foglight Installation and Setup Guide Hardware Requirements For the current single- and multi-tier hardware requirements, consult the vFoglight System Requirements and Platform Support 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............................................................................................................................14 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 15 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 17 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.
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. 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 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 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 33 Installing the vFoglight Management Server - Standard Install Option Start the installation process by initiating the executable included on the vFoglight install media. Each installation screen includes a Previous button, allowing you to go back and adjust the information you have entered. Step 1: Introduction The Introduction screen provides an overview of the mechanics of the installation interface.
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. 2 If you selected I accept the terms of the License Agreement, click Next. Step 3: Select Installation 1 Choose the Standard Install option.
Installing vFoglight Installing a New Version of the vFoglight Management Server 2 Click Next. 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.
Foglight Installation and Setup Guide Click Next. 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 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.
Installing vFoglight Installing a New Version of the vFoglight Management Server 37 Step 6: Installing vFoglight 5.2.4 vFoglight installs files into the default directories.
Foglight Installation and Setup Guide Step 7: 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. Note If you left the License File field blank, an Invalid License dialog appears.
Installing vFoglight Installing a New Version of the vFoglight Management Server 39 Figure 4 Figure 5 The Standard Installation prodedure now takes you through the installation of the vFoglight VMware Infrastructure Agent components. Step 9: 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.
Foglight Installation and Setup Guide Step 10: License Agreement 1 Read through the VMware Infrastructure Agent License Agreement statement, and accept or decline the terms.
Installing vFoglight Installing a New Version of the vFoglight Management Server 41 2 If you selected I accept the terms in the License Agreement, click Next. Step 11: 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.
Foglight Installation and Setup Guide 2 Click Next.
Installing vFoglight Installing a New Version of the vFoglight Management Server 43 Step 12: VMware Infrastructure Agent Install Screen The Agent Install screen is displayed. Click Install. Step 13: 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.
Foglight Installation and Setup Guide 3 Click Save to have your entries validated. 4 On the Credentials Entered are Valid! dialog, click OK. Step 14: 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. 3 Enter the port number of the port that the vFoglight Server uses for HTTP traffic.
Installing vFoglight Installing a New Version of the vFoglight Management Server 45 6 Click Save to have your entries validated. Step 15: InstallShield Wizard Completed Click Finished to complete the VMware Infrastructure Agent components installation.
Foglight Installation and Setup Guide The vFoglight Agent Manager, Guest Process Investigation components, and required services will be installed automatically. The services will start after the installation is complete. Follow the instructions in “Managing a License After Installation” on page 10 to provide a license file to the vFoglight Management Server after installation.
Installing vFoglight Installing a New Version of the vFoglight Management Server 47 Installing the vFoglight Management Server - Custom Install Option Start the installation process by initiating the executable included on the vFoglight install media. Each installation screen includes a Previous button, allowing you to go back and adjust the information you have entered. Step 1: Introduction The Introduction screen provides an overview of the mechanics of the installation interface.
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. 2 If you selected I accept the terms of the License Agreement, click Next. Step 3: Select Installation 1 Choose the Custom Install option.
Installing vFoglight Installing a New Version of the vFoglight Management Server 2 Click Next. 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.
Foglight Installation and Setup Guide 2 Click Next. 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 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.
Installing vFoglight Installing a New Version of the vFoglight Management Server Step 6: Installing vFoglight vFoglight installs files into the specified directory.
Foglight Installation and Setup Guide Figure 7 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 (HTTPS Only) box. 4 Click Next.
Installing vFoglight Installing a New Version of the vFoglight Management Server 53 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 Click Next.
Foglight Installation and Setup Guide 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.
Installing vFoglight Installing a New Version of the vFoglight Management Server 55 3 In the Retype DB Administrator Password field, accept the default (foglight) or, if you have provided an alternate password in step 2, retype the password for verification. 4 Click Next. A progress box appears as the embedded database is installed. Step 10: vFoglight Ports Configuration 1 Configure the server ports. The vFoglight Ports Configuration screen displays default ports which you can assign.
Foglight Installation and Setup Guide 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.
Installing vFoglight Installing a New Version of the vFoglight Management Server 57 Step 12: Install Complete Click Done to complete the installation process. Figure 8 The Typical Installation prodedure now takes you through the installation of the vFoglight 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.
Foglight Installation and Setup Guide Step 14: License Agreement 1 Read through the VMware Infrastructure Agent License Agreement statement, and accept or decline the terms.
Installing vFoglight Installing a New Version of the vFoglight Management Server 59 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.
Foglight Installation and Setup Guide 2 Click Next.
Installing vFoglight Installing a New Version of the vFoglight Management Server 61 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.
Foglight Installation and Setup Guide 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. 3 Enter the port number of the port that the vFoglight Server uses for HTTP traffic.
Installing vFoglight Installing a New Version of the vFoglight Management Server 63 6 Click Save to have your entries validated. Step 19: InstallShield Wizard Completed Click Finished to complete the VMware Infrastructure Agent components installation.
Foglight Installation and Setup Guide The vFoglight Agent Manager, Guest Process Investigation components, and required services will be installed automatically. The services will start after the installation is complete. Figure 9 If you did not install a license in “Step 11: Add vFoglight License File” on page 56, follow the instructions in “Managing a License After Installation” on page 10 to provide a license file to the vFoglight Management Server after installation.
Installing vFoglight Installing a New Version of the vFoglight Management Server 65 Installation Modes Although the installer follows the same general steps on all platforms (license agreement, shortcut creation), additional steps may be required for some platforms. The default mode for the installer is the graphical user interface mode. However, the vFoglight installer can be started in command-line mode in cases where a graphics display is not available by using the silent mode.
Foglight Installation and Setup Guide Property Description Default 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\All Users\Start Menu\Programs\Vizioncore\v Foglight 5.2.4 FMS_LICENSE_AGREEMENT License agreement acknowledgment.
Installing vFoglight Installing a New Version of the vFoglight Management Server Property Description Default 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 FMS_DB_SETUPNOW 1 = Set up database as part of installation.
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 69 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 71 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.
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 73 Setting Up vFoglight Server Federation Federation is useful for customers who monitor large scale environments that are naturally partitioned into logical units. Each of these partitions is normally served by one vFoglight Management Server instance and its distributed clients/agents.
Foglight Installation and Setup Guide # Example: # JndiURLs = ( # "jnp://example.com:1100", # ); # The default value is JndiURLs = (); # JndiURLs = ( ); 7 Edit the topology auto refresh period. The default provided is 1800 seconds (30 minutes): # *** TopologyRefreshPeriod *** # This property specifies the period in seconds for major topology refresh #operations.
Installing vFoglight vFoglight Settings 75 You must reboot the server after setting the parameter. Note You must have a signed, valid certificate if you want to use the https-only configuration. Vizioncore recommends that you obtain a valid certificate from a third party as outlined in the following procedure. Importing a Network Security Certificate Once you have set the vFoglight Management Server to use only https, you must generate a key pair (security certificate) into the vFoglight keystore.
Foglight Installation and Setup Guide $FMS_HOME\jre\bin\keytool -keystore FMS_HOME\server\default\conf\tomcat.keystore -storepass nitrogen -certreq alias tomcat -file This file must be signed by Certification Authority (CA). 5 Once you have the certificate signed, import it back to the tomcat.keystore using the following command: $FMS_HOME\jre\bin\keytool -keystore FMS_HOME\server\default\conf\tomcat.
Installing vFoglight UninstallingvFoglight vFoglight 77 4 Start the vFoglight Management Server. Setting Up an Encrypted LDAP Connection with SSL Follow the directions below if you need to encrypt communication between the vFoglight Management Server and the LDAP server. To encrypt communication between vFoglight Management Server and LDAP: 1 Acquire the LDAP server certificate in .pem format from the administrator. 2 Import the certificate into the vFoglight Management Server keystore ($FMS_HOME\jre\lib
Foglight Installation and Setup Guide
3 Running the vFoglight Management Server This chapter contains the following sections: Before You Begin.........................................................................................................................80 Migrating Data from an Existing Database ..................................................................................80 Initializing 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 31 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 the Database 81 Initializing the Database If you are using the embedded database, the initialization is performed when you start vFoglight. 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.
Foglight Installation and Setup Guide Using the Start Menu Options To install or remove the Management Server service from the Start menu: • Choose Start > Programs > Vizioncore > vFoglight 5.2.4 > Windows Service > Install Service for vFoglight (or Remove Service for vFoglight). 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).
Running the vFoglight Management Server Starting and Stopping the vFoglight Management Server 83 Additional Commands: Command Represents Description -s start Start the vFoglight Management Server (this is assumed if no command is specified) -q stop Stop the vFoglight Management Server -b start-service Start the vFoglight Management Server Windows service -r removeservice Stop and remove the vFoglight Management Server Windows service -n name Provide a unique name for this instance of the
Foglight Installation and Setup Guide Logging in to the vFoglight Browser Interface Note The vFoglight Management Server must be running before you can log in to the vFoglight Browser Interface. To log in to vFoglight: 1 Depending on where you installed the program icons, choose Start > Programs > Vizioncore> vFoglight 5.2.4 > vFoglightConsole. 2 Enter a valid username and password and click Login.
Running the vFoglight Management Server Running the vFoglight Management Server FAQ 85 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.
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 .....................................................................................88 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 89 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 .......................................................................................92 Upgrading the vFoglight Agent Manager...................................................................................104 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 93 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 92. 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 108 for the installer name for your platform. 3 Optional: save the installer. 4 Run the installer. See “Installing the vFoglight Agent Manager” on page 94.
Installing and Running the vFoglight Agent Manager (FglAM) Installing the vFoglight Agent Manager 95 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 97 The URLs you add are listed on the Configure vFoglight Server URLs screen. 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.
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 99 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 A new step (named Enter the URL data to add) appears. In addition, the URL prompt appears. 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 101 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.
Installing and Running the vFoglight Agent Manager (FglAM) Installing the vFoglight Agent Manager 101 a Type 3 and press Enter. 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 103 • 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 105 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 107 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........................................................................................................................ 110 Agent Installers.......................................................................................................................... 110 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 111 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
A Appendix: Switching from an Embedded to an External Database You may find a performance improvement in vFoglight if you use an external database. This appendix contains the following section: Converting to an External Database..........................................................................................
vFoglight Installation and Setup Guide Converting to an External Database This section describes how to migrate and reconfigure an embedded database used with the vFoglight Management Server to an external database. 1 Stop the vFoglight Management Server. 2 Start the embedded database manually: \bin\runDb.sh 3 Export the database content: \mysql\bin\mysqldump -uroot -p -port=13306 --databases foglight > \foglight.dump 4 Shut down the database: \bin\shu
B Appendix: Installing and Running the vFoglight Client (SPID) This chapter contains the following sections: Installing the vFoglight Client (SPID)......................................................................................... 116 Upgrading the vFoglight Client (SPID) ...................................................................................... 118 Running the vFoglight Client (SPID)..........................................................................................
vFoglight Installation and Setup Guide Installing the vFoglight Client (SPID) The vFoglight Client (SPID) manages agents installed on monitored hosts. The Foglight Client provides a centralized communications link between the vFoglight Management Server and the agents, and manages the life cycles of SPI-based agents. The Foglight Client also provides a number of support services such as installation, upgrade, and the ability to configure agents.
Appendix: Installing and Running the vFoglight Client (SPID) Installing the vFoglight Client (SPID) 117 Run the InstallAnywhere setup program to install the Foglight Client. This program prompts you for information, and informs you of the progress of your installation. Note Install the Foglight Client on each host that you would like to monitor. The installation of Foglight Client is divided into separate procedures: • License: A license is not required to install the Foglight Client.
vFoglight Installation and Setup Guide Installing the vFoglight Client (SPID) in Silent Mode To run the installer in Silent mode: • From the command line enter the following: -i silent –DUSER_INSTALL_DIR= DAGENT_HOST= -DAGENT_PORT= Next Steps To install Agents, refer to the chapter “Installing Agents”. Upgrading the vFoglight Client (SPID) Please consult the vFoglight 5.2.4 Upgrade Field Guide for detailed upgrade instructions.
Appendix: Installing and Running the vFoglight Client (SPID) Installing and Running the vFoglight Client (SPID) FAQ 119 mapping. During the installation of the vFoglight Management Server, the SPI communications port number is set to the default 3528. The port number can be changed by editing the property foglight.orb.port in the file \config\foglight.config.
vFoglight Installation and Setup Guide • In the file \server\*\conf\jacorb.properties on the machine hosting the vFoglight Management Server, set the parameter OAIAddr to the exact server IP address. Stop and restart the vFoglight Management Server.
Index A D about vFoglight 14 administration administrator default account 32 default user name and password 32 Agents installing 110 database initializing 81 deploying vFoglight Agent Manager cartridge 92 directories installed directories 69 documentation cartridge 16 core 15 feedback 16 suite 15 documentation directory 69 downloading vFoglight Agent Manager installer 93 dtd directory 69 B bin directory 69 C cartridge directory 70 cartridges installing 88 client directory 69 Components for Download das
Foglight Installation and Setup Guide I M installation modes 65 recommendations 11 requirements 32 SPI firewall 118 SPID from a cartridge 116 installed directories 69 bin 69 cartridge 70 client 69 config 69 docs 69 dtd 69 jre 69 lib 69, 70 logs 69 mysql 69 scripts 70 server 70 support 70 installers downloading the vFoglight Agent Manager installer 93 installing SPID 116 vFoglight Agent Manager 91, 92, 94 installing cartridges 88 Management Server 9 mysql files directory 69 P password, administrato
Index U uninstalling vFoglight Agent Manager 107 upgrading vFoglight Agent Manager 104 user account administrator 32 using Components for Download dashboard 93 vFoglight Agent Manager installer servlet 93 V vFoglight Agent Manager configuring 104 deploying the cartridge 92 downloading the installer 93 installer 94 installing 91, 92 installing Windows service 106 platform support 108 removing Windows service 106 running 91, 106 uninstalling 107 upgrading 104 vFoglight Agent Manager installer servlet 93 W
