Dell Vizioncore software Owner's Manual

Add to My manuals
123 Pages

advertisement

Dell Vizioncore software Owner's Manual | Manualzz

vFoglight™ Pro

5.2.4

Installation and Setup Guide

Installing on Windows with an

Embedded MySQL Database

© 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. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording for any purpose other than the purchaser's personal use without the written permission of Quest Software, Inc.

If you have any questions regarding your potential use of this material, contact:

Quest Software World Headquarters

LEGAL Dept

5 Polaris Way

Aliso Viejo, CA 92656 www.quest.com

email: [email protected]

Refer to our Web site for regional and international office information.

Trademarks

Quest, Quest Software, the Quest Software logo, Aelita, Akonix, Akonix L7 Enterprise, Akonix L7 Enforcer,

AppAssure, Benchmark Factory, Big Brother, DataFactory, DeployDirector, ERDisk, Foglight, Funnel Web, I/Watch,

Imceda, InLook, IntelliProfile, InTrust, Invertus, IT Dad, I/Watch, JClass, Jint, JProbe, LeccoTech, LiteSpeed,

LiveReorg, MessageStats, NBSpool, NetBase, Npulse, NetPro, PassGo, PerformaSure, Quest Central, SharePlex,

Sitraka, SmartAlarm, Spotlight, SQL LiteSpeed, SQL Navigator, SQL Watch, SQLab, Stat, StealthCollect, Tag and

Follow, Toad, T.O.A.D., Toad World, vANALYZER, vAUTOMATOR, vCONTROL, vCONVERTER, vEssentials, vFOGLIGHT, vOPTIMIZER, vRanger Pro, vReplicator, Vintela, Virtual DBA, Vizioncore, Xaffire, and XRT are trademarks and registered trademarks of Quest Software, Inc in the United States of America and other countries.

Other trademarks and registered trademarks used in this guide are property of their respective owners.

Disclaimer

The information in this document is provided in connection with Quest products. No license, express or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of

Quest products. EXCEPT AS SET FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE

LICENSE AGREEMENT FOR THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND

DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS

INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A

PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE FOR ANY

DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING,

WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS OF

INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS

BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. Quest does not make any commitment to update the information contained in this document.

License Credits and Third Party Information

To view license credit information, click the License Credits link on the Welcome to vFoglight online help page.

Installation and Setup Guide

March 2009

Version 5.2.4 - Professional Edition

Table of Contents

Before Installing vFoglight..................................................................................................................................7

What Is vFoglight?............................................................................................................................................................ 8

Planning Your Installation or Upgrade.............................................................................................................................. 9

Using Embedded Databases................................................................................................................................. 10

Licensing ............................................................................................................................................................... 10

Hardware Requirements and Guidelines ....................................................................................................................... 11

Installation Recommendations .............................................................................................................................. 11

Hardware Requirements........................................................................................................................................ 12

Introduction to this Guide .................................................................................................................................13

About vFoglight .............................................................................................................................................................. 14

About this Guide............................................................................................................................................................. 14

vFoglight Documentation Suite ...................................................................................................................................... 15

Core Documentation Set ....................................................................................................................................... 15

Cartridge Documentation Sets .............................................................................................................................. 16

Feedback on the Documentation........................................................................................................................... 16

Text Conventions ........................................................................................................................................................... 17

About Vizioncore Inc. ..................................................................................................................................................... 17

Contacting Dell ............................................................................................................................................................... 18

Installing vFoglight ............................................................................................................................................31

Preparing to Install ......................................................................................................................................................... 32

Installing a New Version of the vFoglight Management Server...................................................................................... 32

Installing the vFoglight Management Server - Standard Install Option ................................................................. 33

Next Steps ............................................................................................................................................................. 46

Installing the vFoglight Management Server - Custom Install Option.................................................................... 47

Next Steps ............................................................................................................................................................. 64

4 Foglight

Installation and Setup Guide

Installation Modes .................................................................................................................................................. 65

Upgrading vFoglight........................................................................................................................................................ 68

Installed Directories ....................................................................................................................................................... 69

vFoglight Settings ........................................................................................................................................................... 70

Editing the foglight.config File ................................................................................................................................ 71

Setting Memory Parameters for the Server .......................................................................................................... 71

Adding Command Line Options ............................................................................................................................. 72

Setting the SQL Parser Properties......................................................................................................................... 72

Setting Up vFoglight Server Federation................................................................................................................. 73

Configuring vFoglight to Access the Server Only Through the HTTPS Port.......................................................... 74

Setting Up an Encrypted Database Connection with SSL ..................................................................................... 76

Setting Up an Encrypted LDAP Connection with SSL ........................................................................................... 77

UninstallingvFoglight vFoglight ....................................................................................................................................... 77

Running the vFoglight Management Server ................................................................................................... 79

Before You Begin............................................................................................................................................................ 80

Migrating Data from an Existing Database ..................................................................................................................... 80

Initializing the Database.................................................................................................................................................. 81

Starting and Stopping the vFoglight Management Server .............................................................................................. 81

Starting the vFoglight Management Server as a Windows Service ....................................................................... 81

Stopping the Server ............................................................................................................................................... 83

Logging in to the vFoglight Browser Interface ................................................................................................................ 84

Next Steps ............................................................................................................................................................. 84

Running the vFoglight Management Server FAQ........................................................................................................... 85

Installing and Upgrading Cartridges ............................................................................................................... 87

Accessing the Cartridge Inventory Page ........................................................................................................................ 88

Installing Cartridges ........................................................................................................................................................ 88

Upgrading Cartridges...................................................................................................................................................... 89

Next Steps ............................................................................................................................................................. 89

Installing and Running the vFoglight Agent Manager (FglAM)..................................................................... 91

Installing the vFoglight Agent Manager .......................................................................................................................... 92

Deploying the vFoglight Agent Manager Cartridge ................................................................................................ 92

Downloading the vFoglight Agent Manager Installer ............................................................................................. 93

Installing the vFoglight Agent Manager.................................................................................................................. 94

Table of Contents 5

Upgrading the vFoglight Agent Manager ......................................................................................................................104

Configuring the vFoglight Agent Manager.....................................................................................................................104

Configuring the vFoglight Agent Manager............................................................................................................104

Installing the vFoglight Agent Manager as a Windows Service............................................................................106

Running the vFoglight Agent Manager..........................................................................................................................106

Next Steps.....................................................................................................................................................................107

Uninstalling the vFoglight Agent Manager ....................................................................................................................107

vFoglight Agent Manager Platform Support Matrix .......................................................................................................108

Installing Agents ..............................................................................................................................................109

vFoglight Agents ...........................................................................................................................................................110

Agent Installers .............................................................................................................................................................110

Remote Agent Installation.............................................................................................................................................111

Appendix: Switching from an Embedded to an External Database ............................................................113

Converting to an External Database .............................................................................................................................114

Appendix: Installing and Running the vFoglight Client (SPID) ...................................................................115

Installing the vFoglight Client (SPID) ............................................................................................................................116

Installing the vFoglight Client (SPID) from an Existing Cartridge .........................................................................116

Installation Processes ..........................................................................................................................................116

Next Steps............................................................................................................................................................118

Upgrading the vFoglight Client (SPID)..........................................................................................................................118

Running the vFoglight Client (SPID) .............................................................................................................................118

Connecting SPI Through a Firewall......................................................................................................................118

Installing and Running the vFoglight Client (SPID) FAQ...............................................................................................119

Index..................................................................................................................................................................121

6 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 ...........................................................................................9

Hardware Requirements and Guidelines .....................................................................................11

8 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. Using vFoglight, application and information technology managers can understand user service levels and notify stakeholders when those service levels are violated.

vFoglight helps you to:

• Focus on system and application availability and performance.

• Observe system capacity and application efficiency.

• Gauge user response time from multiple geographic locations.

• Identify and bridge gaps between business and information technology staff.

• Highlight historical information for planning and reporting.

Before Installing vFoglight

Planning Your Installation or Upgrade

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.

Image 1

9

The following list summarizes the main steps involved in installing (or upgrading) and configuring vFoglight:

Step 1: Install the vFoglight Management Server (or upgrade your installation to version 5.2.4) and configure the Management Server. The Management Server is the data collection and processing server.

Step 2: Install the database (or upgrade it, if you are upgrading your Management

Server installation to version 5.2.4) and configure it. You can choose to use an embedded database or an external database. The instructions in this guide are for embedded database installations only.

Step 3: Install and configure cartridges. Cartridges extend the functionality of vFoglight, and are installed on the machine hosting the vFoglight Management Server.

A cartridge contains one or more cartridge components, such as agents for deployment, communication capabilities, modifications to the way that data is transformed or handled, rules, reports, and views.

10 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.

Providing a License File During Installation

You can install a license file during the installation process. See “ Step 11: Add vFoglight License File

” on page 56 in Installing a New Version of the vFoglight

Management Server

.

Managing a License After Installation

You can also manage licenses after installing vFoglight. There are three ways of providing a license file to the Management Server after installation.

Manual Process

• Move an existing license file into the < vfoglight_home >\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

4

If you have not already done so, extract the file fglcmd.zip

in

< vfoglight_home >\tools .

Upload a license by navigating to < vfoglight_home >\tools and entering the following commands: fglcmd -usr <username> -pwd <password> -cmd license:import -f

<license-file>

Before Installing vFoglight

Hardware Requirements and Guidelines

11 fglcmd -usr <username> -pwd <password> -cmd license:list fglcmd -usr <username> -pwd <password> -cmd license:remove serial <serial>

Note The commands listed above assume that you are using a default port=8080 and a localhost. If you are not running with these default values, use the following options to indicate server and port:

-prt <xx> -srv <servername>

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. You can arrange for a sizing analysis by contacting your VizioncorevSales Representative. At a minimum, you will be required to provide hardware matching the specifications below.

Installation Recommendations

Running a vFoglight server requires:

• The vFoglight Management Server

• The vFoglight database repository

While these components can be installed on a single tier or on multiple tiers, it is critical to realize that the management server and database repository will require separately dedicated resources to support them. In order to help facilitate sizing, the resources required to support each component are addressed separately. They can either be summed to support a single-tier installation, or treated independently as the requirements for each server in a two-tier installation.

12 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 ..........................................................................................................................14

vFoglight Documentation Suite ....................................................................................................15

Text Conventions .........................................................................................................................17

About Vizioncore Inc.

...................................................................................................................17

14 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. With vFoglight, administrators can quickly determine the root-cause of an incident or problem, track virtual machine (VM) movements and understand their impact, and identify contention for resources between virtual machines.

About this Guide

This guide walks you through a vFoglight installation. Before you begin, ensure that your system and development environments are set up correctly. For more information, refer to the vFoglight System Requirements and Platform Support Guide .

This guide is organized as follows:

Chapter 1, Before Installing vFoglight — This chapter introduces vFoglight and outlines the steps you must take in order to assure a successful installation.

Chapter 2, Installing vFoglight — This chapter guides you through the installation process. It also provides information on the vFoglight directory structure, and how to adjust certain vFoglight settings to best suit your environment.

Chapter 3, Running the vFoglight Management Server — This chapter outlines how to start and stop the vFoglight Management Server, how to initialize the database, how to migrate data from an existing database, and how to log into vFoglight.

Chapter 4, Installing Cartridges — This chapter describes the process for installinga nd updgrading vFoglight cartridges.

Chapter 5, Installing the vFoglight Agent Manager — This chapter outlines how to install, upgrade and configured the vFoglight Agent Manager.

Chapter 6, Installing Agents — This chapter guides you through installing Agents that may be required by installed cartridges.

Introduction to this Guide vFoglight Documentation Suite

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.

15

• PDF: The Getting Started Guide , What’s New Guide , System Requirements and

Platform Support Guide , Installation and Setup Guide set, Administration and

Configuration Guide , vFoglight User Guide , Command-Line Reference Guide ,

Web Component Guide , and Web Component Tutorial , are provided as PDF files.

The PDF guides are included in the zip file downloaded from Vizioncore.

Adobe® Reader® is required.

• HTML: Release Notes are provided in HTML.

Core Documentation Set

The core documentation set consists of the following files:

• Release Notes (HTML)

• Getting Started Guide (PDF)

• What’s New Guide (PDF)

• System Requirements and Platform Support Guide (PDF)

16 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-Line Reference Guide (PDF and online help)

• Web Component Guide (PDF and online help)

• Web Component Tutorial (PDF and online help)

• Web Component Reference (online help)

Cartridge Documentation Sets

When you deploy a cartridge, the documentation set for the cartridge is installed. The online help for the cartridge is integrated automatically with the core vFoglight help.

When you open the help, the name of the cartridge is displayed in a top level entry within the table of contents.

Some cartridges include additional PDF guides, which may be one or more of the following: a Getting Started Guide , an Installation Guide , a User Guide , and a

Reference Guide .

Feedback on the Documentation

We are interested in receiving feedback from you about our documentation. For example, did you notice any errors in the documentation? Were any features undocumented? Do you have any suggestions on how we can improve the documentation? All comments are welcome. Please submit your feedback to the following email address: [email protected]

Please do not submit Technical Support related issues to this email address .

Introduction to this Guide

Text Conventions

Text Conventions

The following table summarizes how text styles are used in this guide:

Convention Description

Code

Variables

Interface

Monospace text represents code, code objects, and commandline input. This includes:

• Java language source code and examples of file contents

• Classes, objects, methods, properties, constants, and events

• HTML documents, tags, and attributes

Monospace-plus-italic text represents variable code or command-line objects that are replaced by an actual value or parameter.

Bold text is used for interface options that you select (such as menu items) as well as keyboard commands.

Files, components, and documents

Italic text is used to highlight the following items:

• Pathnames, file names, and programs

• The names of other documents referenced in this guide

17

About Vizioncore Inc.

Vizioncore was formed in July 2002 as a consulting and software-development company with the mission to create easy-to-use software solutions that performed reliable and repeatable automation of datacenter functions specifically for the Citrix platform. A main corporate goal was to enable business partners to offer solutions that targeted real-world IT issues and provided the best possible installation and automation for their clients' systems.

Vizioncore's solutions have proved successful in organizations from small to mid-sized businesses to large enterprises, in a wide variety of vertical industries, including

Financial Services, Government, Healthcare, Manufacturing, and High Tech.

Vizioncore, Inc. can be found in offices around the globe and at www.vizioncore.com

.

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

2

3

Visit http://support.dell.com.

Verify your country or region in the Choose A Country/Region drop-down menu at the bottom of the page.

Click Contact Us on the left side of the page.Note: Toll-free numbers are for use within the country for which they are listed.

4

5

Select the appropriate service or support link based on your need.

Choose the method of contacting Dell that is convenient for you.

Country (City) Service Type

International Access

Code

Country Code

City Code

Anguilla

Antigua and Barbuda

Web Address

E-Mail Address

Technical Support., Customer Service, Sales

Web Address

E-Mail Address

Aomen

Technical Support., Customer Service, Sales

Technical Support

Dell

Dimension

, Dell Inspirion

, Dell

Optiplex

, Dell Lattitude

, and Dell

Argentina (Buenos Aires)

Precision

Servers and Storage

Web Address

International Access

E-Mail Address for Desktop/ Portable Computers

Code: 00

E-Mail Address for Servers and EMC

®

Storage

Country Code: 54

Products

City Code: 11

Customer Service

Technical Support

Aruba

Australia (Sydney)

International Access

Code: 0011

Country Code: 61

City Code: 2

Technical Support Services

Sales

Web Address

E-Mail Address

Technical Support., Customer Service, Sales

Web Address

Contact Dell Web Address

Technical Support., Customer Service, Sales

Area Codes,

Local Numbers, and

Toll-Free Numbers

Web and E-Mail Addresses www.Dell.com/ai la ‐ [email protected]

toll-free: 800-335-0031 www.Dell.com.ag

la ‐ [email protected]

1-800-805-5924

0800-105

0800-105 www.dell.com.ar

la ‐ [email protected]

[email protected]

toll-free: 0-800-444-0730 toll-free: 0-800-444-0733 toll-free: 0-800-444-0724

0-800-444-3355 www.Dell.com/aw la ‐ [email protected]

toll-free: 800-1578 support.ap.dell.com

support.ap.dell.com/contactus

13DELL-133355

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

Cayman Islands

Web Address

E-Mail Address

Home/Small Business Sales

Home/Small Business Fax

Home/Small Business Customer Service

Home/Small Business Support

Preferred Accounts/Corporate Customer

Service Preferred Accounts/Corporate Customer

Switchboard

Web Address

E-Mail Address

Technical Support., Customer Service, Sales

Web Address

E-Mail Address

Technical Support., Customer Service, Sales

Web Address

General Support

General Support Fax

Customer Service

Corporate Sales

Fax

Switchboard

Web Address

E-Mail Address

Technical Support., Customer Service, Sales

Web Address

E-Mail Address

Customer Service and Tech Support

Technical Support Fax

Customer Service Fax

Sales

Technical Support, Customer Service, Sales

Technical Support (Penang, Malaysia)

Customer Service (Penang, Malaysia)

Transaction Sales (Penang, Malaysia)

Online Order Status Web Address

AutoTech (automated Hardware and Warranty

Support)

Customer Service

Home/Home Office

Small Business

Medium/Large Business, Government, Education

Hardware Warranty Phone Support

Support.euro.dell.com

[email protected]

0820 240 530 00

0820 240 530 49

0820 240 530 14

0820 240 530 17

0820 240 530 16

0820 240 530 17

0820 240 530 00 www.dell.com/bs la ‐ [email protected]

toll-free: 1-866-874-3038 www.dell.com/bb la ‐ [email protected]

1-800-534-3142

Support.euro.dell.com

02 481 92 88

02 481 92 95

02 713 15 65

02 481 91 00

02 481 91 99

02 481 91 00 www.dell.com/bo [email protected]

toll-free: 800-10-0238 www.dell.com/br

[email protected]

0800 970 3355

51 2104 5470

51 2104 5480

0800 722 3498 toll-free: 1-866-278-6820

604 633 4966

604 633 4888

604 633 4955 www.dell.ca/ostatus support.ca.dell.com

toll-free:1-800-247-9362 toll-free:1-800-847-4096 toll-free:1-800-906-3355 toll-free:1-800-387-5757 toll-free:1-800-847-4096 toll-free:1-800-387-5757

Computers for Home/Home Office

Computers for Small/Medium/Large Business

Government

Printers, Projectors, Televisions, Handheld,

Digital

Jukebox, and Wireless Sales

Home and Home Office Sales

Small Business

Medium/Large Business, Government

Spare Parts and Extended Service

E-Mail Address

Technical Support, Customer Service, Sales la ‐

1-877-335-5767 toll-free:1-800-999-3355 toll-free:1-800-387-5752 toll-free:1-800-387-5755

1 866 440 3355 [email protected]

1-877-262-5415

Chile (Santiago)

Country Code: 56

City Code: 2

China (Xiamen)

Country Code: 86

City Code: 592

Columbia

Costa Rica

Czech Republic (Prague)

International Access

Code: 00

Country Code: 420

Denmark (Copenhagen)

International Access

Code: 00

Country Code: 45

Dominica

Web Address

E-Mail Address

Sales and Customer Support

Technical Support Web Address

Technical Support E-Mail Address

Customer Service E-Mail Address

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 Service

Customer Service Fax

Home and Small Business

Preferred Accounts Division

Large Corporate Accounts GCP

Large Corporate Accounts Key Accounts

Large Corporate Accounts North

Large Corporate Accounts North Government and

Education

Large Corporate Accounts East

Large Corporate Accounts East Government and

Education

Large Corporate Accounts Queue Team

Large Corporate Accounts South

Large Corporate Accounts West

Large Corporate Accounts Spare Parts

Web Address

E-Mail Address

Technical Support, Customer Service, Sales

Web Address

E-Mail Address

Technical Support, Customer Service, Sales

Web Address

E-Mail Address

Technical Support

Customer Service

Fax

Technical Fax

Switchboard

Web Address

Technical Support

Customer Service – Relational

Home/Small Business Customer Service

Switchboard – Relational

Switchboard Fax – Relational

Switchboard – Home/Small Business

Switchboard Fax – Home/Small Business

Web Address

E-Mail Address

Technical Support, Customer Service, Sales www.dell.com/cl la ‐ [email protected]

toll-free: 1230-020-4823 support.dell.com.cn

support.dell.com.cn/email [email protected]

592 818 14350 toll-free: 800 858 2969 toll-free: 800 858 0950 toll-free: 800 858 0960 toll-free: 800 858 2920 toll-free: 800 858 2311 toll-free: 800 858 2060

592 818 1308 toll-free: 800 858 2222 toll-free: 800 858 2557 toll-free: 800 858 2055 toll-free: 800 858 2628 toll-free: 800 858 2999 toll-free: 800 858 2955 toll-free: 800 858 2020 toll-free: 800 858 2669 toll-free: 800 858 2572 toll-free: 800 858 2355 toll-free: 800 858 2811 toll-free: 800 858 2621 www.dell.com/co la ‐ [email protected]

01-800-915-4755 www.dell.com/cr la ‐ [email protected]

0800-012-0231 support.euro.dell.com

[email protected]

22537 2727

22537 2707

22537 2714

22537 2728

22537 2711

Support.euro.dell.com

7023 0182

7023 0184

3287 5505

3287 1200

3287 1201

3287 5000

3287 5001 www.dell.com/dm la ‐ [email protected]

toll-free: 1-866-278-6821

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)

Germany (Frankfurt)

International Access

Code: 00

Country Code: 49

City Code: 69

Greece

International Access

Code: 00

Country Code: 49

Grenada

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 Service, Sales

Web Address

E-Mail Address

Technical Support

Customer Service

Switchboard

Sales under 500 employees

Fax

Sales over 500 employees

Fax

Web Address

Home and Small Business

Technical Support

Customer Service

Switchboard

Switchboard (calls from outside of France)

Sales

Fax

Fax (calls from outside of France)

Corporate

Technical Support

Customer Service

Switchboard

Sales

Web Address

E-mail Address

Technical Support

Home/Small Business Customer Service

Global Segment Customer Service

Preferred Accounts Customer Service

Large Accounts Customer Service

Public Accounts Customer Service

Switchboard

Web Address

Technical Support

Gold Service Technical Support

Switchboard

Gold Service Switchboard

Sales

Fax

Web Address

E-Mail Address

Technical Support, Customer Service, Sales www.dell.com/do la ‐ [email protected]

1-800-156-1588 www.dell.com/ec la ‐ [email protected]

toll-free: 999-119-877-655-3355 toll-free: 1800-999-119-877-655-3355 www.dell.com/sv la ‐ [email protected]

800-6132 [email protected]

[email protected]

0207 533 555

0207 533 538

0207 533 533

0207 533 540

0207 533 530

0207 533 533

0207 533 530

Support.euro.dell.com

0825 387 270

0825 832 833

0825 004 700

04 99 75 40 00

0825 004 700

0825 004 701

04 99 75 40 01

0825 004 719

0825 338 339

55 94 71 00

01 55 94 71 00 support.euro.dell.com

[email protected]

069 9792-7200

0180-5-224400

069 9792-7320

069 9792-7320

069 9792-7320

069 9792-7320

069 9792-7000

Support.euro.dell.com

00800-44 14 95 18

00800-44 14 00 83

2108129810

2108129811

2108129800

2108129812 www.dell.com/gd la ‐ [email protected]

toll-free: 1-866-540-3355

Guatemala

Guyana

Web Address

E-Mail Address

Technical Support, Customer Service, Sales

E-Mail Address

Technical Support, Customer Service, Sales

Hong Kong

International Access

Code: 001

Country Code: 852

India

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 .

Customer Service

Large Corporate Accounts

Global Customer Programs

Medium Business Division

Home and Small Business Division

Dell Support Website

Portable and Desktop Support

Desktop Support E-mail Address

Portable Support E-mail Address

Phone Numbers la la

‐ www.dell.com/gt [email protected]

1-800-999-0136 [email protected]

toll-free: 1-877-270-4609 support.ap.dell.com

support.dell.com.cn/email

00852-2969 3188

00852-2969 3191

00852-2969 3196

00852-3416 0906

00852-3416 0910

00852-3416 0907

00852-3416 0908

00852-3416 0912

00852-2969 3105 support.ap.dell.com

[email protected]

[email protected]

080-25068032 or 080-25068034 or your city STD code + 60003355 or toll-free: 1-800-425-8045

Server Support

E-mail Address

Phone Numbers [email protected]

080-25068032 or 080-25068034 or your city STD code + 60003355 or toll-free: 1-800-425-8045

Gold Support Only

E-mail Address

Phone Numbers [email protected]

080-25068033 or your city STD code +

60003355 or

toll-free: 1-800-425-9045

Customer Service

Home and Small Business

Large Corporate Accounts

Sales

Large Corporate Accounts

Home and Small Business

[email protected]

toll-free : 1800-4254051

[email protected]

toll free : 1800-4252067

1600 33 8044

1600 33 8046

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.only)

Corporate Customer Service (dial within U.K. only)

U.K. Sales (dial within U.K. only)

Web Address

Home and Small Business

Technical Support

Customer Service

Fax

Switchboard

Corporate

Technical Support

Customer Service

Fax

Switchboard

E-mail Address

Technical Support, Customer Service, Sales

(dial from within Jamaica only)

Support.euro.dell.com

[email protected]

1850 543 543

1850 543 543

1850 200 889

1850 333 200

1850 664 656

1850 200 646

1850 200 646

[email protected]

204 4014

1850 200 982

204 0103

204 4444

0870 906 0010

0870 907 4499

0870 907 4000

Support.euro.dell.com

02 577 826 90

02 696 821 14

02 696 821 13

02 696 821 12

02 577 826 90

02 577 825 55

02 575 035 30

02 577 821 [email protected]

1-800-440-920

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

Technical Support - Dell PowerApp™, Dell

PowerEdge™, Dell PowerConnect™, and Dell

PowerVault™,

Technical Support outside of Japan - PowerApp,

PowerEdge, PowerConnect, and PowerVault

Technical Support - Projectors, PDAs, Printers,

Routers

Technical Support outside of Japan - Projectors,

PDAs, Printers, Routers

Faxbox Service

24-Hour Automated Order Status Service

Customer Service

Business Sales Division - up to 400 employees

Preferred Accounts Division Sales - over 400 employees

Public Sales - government agencies, educational institutions, and medical institutions

Global Segment Japan

Individual User

Individual User Online Sales

Individual User Real Site Sales

Switchboard

Web Address

Technical Support, Customer Service

Technical Support - Dimension, PDA, Electronics, and Accessories

Sales

Fax

Switchboard

Customer Technical Support (Austin, Texas,

U.S.A.)

Customer Service (Austin, Texas, U.S.A.)

Fax (Technical Support and Customer Service)

(Austin, Texas, U.S.A.)

Sales (Austin, Texas, U.S.A.)

SalesFax (Austin, Texas, U.S.A.)

Web Address

Support

Home/Small Business Sales

Corporate Sales

Customer Service

Fax

Technical Support

Customer Service (Xiamen, China)

Transaction Sales (Xiamen, China) support.jp.dell.com

toll-free: 0120-198-26

81-44-520-1435 toll-free: 0120-198-433

81-44-556-3894 toll-free: 0120-198-498

81-44-556-4162 toll-free: 0120-981-690

81-44-556-3468

044-556-3490

044-556-3801

044-556-4240

044-556-1465

044-556-3433

044-556-5963

044-556-3469

044-556-1657

044-556-2203

044-556-4649

044-556-4300

Support.ap.dell.com

toll-free: 080-200-3800 toll-free: 080-200-3801 toll-free: 080-200-3600

2194-6202

2194-6000

512 728-4093

512 728-3619

512 728-3883

512 728-4397

512 728-4600 or 512 728-3772

Support.euro.dell.com

3420808075

+32 (0)2 713 15 96

26 25 77 81

+32 (0)2 481 91 19

26 25 77 82 toll-free: 0800 105

34 160 910

29 693 115

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

Web Address

Technical Support - Dell Precision, OptiPlex, and

Latitude

Technical Support - Dimension, Inspiron, and

Electronics and Accessories

Technical Support - PowerApp, PowerEdge,

PowerConnect, and PowerVault

Customer Service

Transaction Sales

Corporate Sales

Web Address

E-mail Address

Customer Technical Support

Sales

Customer Service

Main

E-mail Address

Technical Support, Customer Service, Sales

Support.ap.dell.com

toll-free: 1800 880 193 toll-free: 1800 881 306 toll-free: 1800 881 386 toll-free: 1800 881 306 (option 6) toll-free: 1800 888 202 toll-free: 1800 888 213 www.dell.com/mx la ‐ [email protected]

001-877-384-8979 or 001-877-269-3383

50-81-8800 or 01-800-888-3355

001-877-384-8979 or 001-877-269-3383

50-81-8800 or 01-800-888-3355 la ‐ [email protected]

E-mail Address

Web Address

Technical Support

Technical Support Fax

Home/Small Business Customer Service

Relational Customer Service

Home/Small Business Sales

Relational Sales

Home/Small Business Sales Fax

Relational Sales Fax

Switchboard

Switchboard Fax

Web Address

E-mail Address

Technical Support, Customer Service, Sales

Toll-free: 1-866-278-6822 la ‐ [email protected]

support.euro.dell.com

020 674 45 00

020 674 47 66

020 674 42 00

020 674 43 25

020 674 55 00

020 674 50 00

020 674 47 75

020 674 47 50

020 674 50 00

020 674 47 50

Support.ap.dell.com

Support.ap.dell.com/contactus

0800 441 567

Web Address

E-mail Address

Technical Support, Customer Service, Sales

Web Address

Technical Support

Relational Customer Service

Home/Small Business Customer Service

Switchboard

Fax Switchboard

Web Address

E-mail Address

Technical Support, Customer Service, Sales

Web Address

E-mail Address

Technical Support, Customer Service, Sales www.dell.com/ni la ‐ [email protected]

001-800-220-1377

Support.euro.dell.com

671 16882

671 17575

231 62298

671 16800

671 16865 www.dell.com/pa la ‐ [email protected]

011-800-507-1264 www.dell.com/pe la ‐ [email protected]

0800-50-669

Poland (Warsaw)

International Access

Code: 011

Country Code: 48

City Code: 22

Portugal

International Access

Code: 00

Country Code: 351

Web Address

E-mail Address

Customer Service Phone

Customer Service

Sales

Customer Service Fax

Reception Desk Fax

Switchboard

Web Address

Technical Support

Customer Service

Sales

Puerto Rico

St. Kitts and Nevis

St. Lucia

St. Vincent and the

Grenadines

Singapore

International Access

Code: 005

Country Code: 65

Slovakia (Prague)

International Access

Code: 00

Country Code: 421

Fax

Web Address

E-mail Address

Technical Support, Customer Service, Sales

Web Address

E-mail Address

Technical Support, Customer Service, Sales

Web Address

E-mail Address

Technical Support, Customer Service, Sales

Web Address

E-mail Address

Technical Support, Customer Service, Sales

NOTE: The phone numbers in this section should be called from within Singapore or Malaysia only.

Web Address

Technical Support - Dimension, Inspiron, and

Electronics and Accessories

Technical Support - OptiPlex, Latitude,

and Dell Precision

Technical Support - PowerApp, PowerEdge,

PowerConnect, and PowerVault

Customer Service

Transaction Sales

Corporate Sales

Web Address

E-mail Address

Technical Support

Customer Service

Fax

Tech Fax

Switchboard (Sales)

South Africa

(Johannesburg)

International Access

Code: 09/091

Country Code: 27

City Code: 11

Web Address

E-mail Address

Gold Queue

Technical Support

Customer Service

Sales support.euro.dell.com

[email protected]

57 95 700

57 95 999

57 95 999

57 95 806

57 95 998

57 95 999

Support.euro.dell.com

707200149

800 300 413

800-300-410 or 800-300 -411 or

800-300-412 or 21-422-07-10

21-424-01-12 www.dell.com/pr la ‐ [email protected]

1-877-537-3355 www.dell.com/kn la ‐ [email protected]

toll-free: 1-866-540-3355 www.dell.com/lc la ‐ [email protected]

toll-free: 1-866-464-4352 www.dell.com/vc la ‐ [email protected]

toll-free: 1-866-464-4353 support.ap.dell.com

toll-free: 1 800 394 7430 toll-free: 1 800 394 7488 toll-free: 1 800 394 7478 toll-free: 1 800 394 7430 (option 6) toll-free: 1 800 394 7412 toll-free: 1 800 394 7419 support.euro.dell.com

[email protected]

02 5441 5727

420 22537 2707

02 5441 8328

02 5441 8328

02 5441 8328

02 5441 7585 support.euro.dell.com

[email protected]

011 709 7713

011 709 7710

011 709 7707

011 709 7700

Spain (Madrid)

International Access

Code: 00

Country Code: 34

City Code: 91

Web Address

Home and Small Business

Technical Support

Customer Service

Sales

Switchboard

Fax

Corporate

Sweden (Upplands

Vasby)

International Access

Code: 00

Country Code: 46

City Code: 8

Switzerland (Geneva)

Technical Support

Customer Service

Switchboard

Fax

Web Address

Technical Support

Relational Customer Service

Home/Small Business Customer Service

Employee Purchase Program (EPP) Support

Technical Support Fax

Web Address

E-mail Address

International Access

Code: 00

Country Code: 41

City Code: 22

Technical Support – Home and Small Business

Technical Support – Corporate

Customer Service – Home and Small Business

Customer Service – Corporate

Fax

Switchboard

Web Address Taiwan

International Access

Code: 002

Country Code: 886

E-mail Address

Technical Support - OptiPlex, Latitude, Inspiron,

Dimension, and Electronics and Accessories

Technical Support - Servers and Storage

Customer Service

Transaction Sales

Corporate Sales

Web Address Thailand

International Access

Code: 001

Country Code: 66

Trinidad/Tobago

Technical Support (OptiPlex, Latitude, and Dell

Precision)

Technical Support (PowerApp, PowerEdge,

PowerConnect, and PowerVault)

Customer Service

Corporate Sales

Transaction Sales

Web Address

E-mail Address

Turks and Caicos Islands

Technical Support, Customer Service, Sales

Web Address

E-mail Address

Technical Support, Customer Service, Sales

Support.euro.com

902 100 130

902 118 540

902 118 541

902 118 541

902 118 539

902 100 130

902 115 236

91 722 92 00

91 722 95 83 support.euro.dell.com

08 590 05 199

08 590 05 642

08 587 70 527

020 140 14 44

08 590 05 594

Support.euro.dell.com

[email protected]

0844 811 411

0844 822 844

0848 802 202

0848 821 721

022 799 01 90

022 799 01 01 support.ap.dell.com

support.dell.com.cn/email toll-free: 0080 186 1011 toll-free: 0080 160 1256 toll-free: 0080 160 1250 (option 5) toll-free: 0080 165 1228 toll-free: 0080 165 1227

Support.ap.dell.com

toll-free: 1800 0060 07 toll-free: 1800 0600 09 toll-free: 1800 006 007 (option 7) toll-free: 1800 006 009 toll-free: 1800 006 006 www.dell.com/tt la ‐ [email protected]

toll-free: 1-888-799-5908 www.dell.com/tc la ‐ [email protected]

toll-free: 1-877-441-4735

U.K.(Bracknell)

International Access

Code: 00

Country Code: 44

City Code: 1344

Uruguay

U.S.A. (Austin, Texas)

International Access

Code: 011

Country Code: 1

Web Address

E-mail Address

Customer Service Website

Sales

Home and Small Business Sales

Corporate/Public Sector Sales

Customer Service

Home and Small Business

Corporate

Preferred Accounts (500-5000 employees)

Global Accounts

Central Government

Local Government & Education

Health

Technical Support

Corporate/Preferred Accounts/PCA (1000+ employees)

Other Dell Products

General

Home and Small Business Fax

Web Address

E-mail Address

Technical Support, Customer Service, Sales

Automated Order-Status Service

AutoTech (portable and desktop computers)

Hardware and Warranty Support (Dell TV,

Printers, and Projectors ) for Relationship customers

Consumer (Home and Home Office) Support for

Dell products

Customer Service

Employee Purchase Program (EPP) Customers

Financial Services Web Address

Financial Services (lease/loans)

Financial Services (Dell Preferred Accounts

[DPA])

Business

Customer Service

Employee Purchase Program (EPP)

Customer s Support for printers, projectors, PDAs, and MP3 players

Public (government, education, and healthcare)

Customer Service and Support

Employee Purchase Program (EPP) Customers

Dell Sales

Dell Outlet Store (Dell refurbished computers)

Software and Peripherals Sales

Spare Parts Sales

Extended Service and Warranty Sales

Fax

Dell Services for the Deaf, Hard-of-Hearing, or

Speech-Impaired upport.euro.dell.com

[email protected]

support.euro.dell.com/uk/en/ECare/ form/home.asp

0870 907 4000

01344 860 456

0870 906 0010

01344 373 185

0870 906 0010

01344 373 186

01344 373 196

01344 373 199

01344 373 194

0870 908 0500

0870 353 0800

0870 907 4006 www.dell.com/uy la ‐ [email protected]

toll-free: 000-413-598-2521 toll-free: 1-800-433-9014 toll-free: 1-800-247-9362 toll-free: 1-877-459-7298 toll-free: 1-800-624-9896 toll-free: 1-800-624-9897 toll-free: 1-800-695-8133 www.dellfinancialservices.com

toll-free: 1-877-577-3355 toll-free: 1-800-283-2210 toll-free: 1-800-624-9897 toll-free: 1-800-695-8133 toll-free: 1-877-459-7298 toll-free: 1-800-456-3355 toll-free: 1-800-695-8133 toll-free: 1-800-289-3355 or

toll-free: 1-800-879-3355 toll-free: 1-888-798-7561 toll-free: 1-800-671-3355 toll-free: 1-800-357-3355 toll-free: 1-800-247-4618 toll-free: 1-800-727-8320 toll-free: 1-877-DELLTTY

(1-877-335-5889)

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 ‐ [email protected]

toll ‐ free:   1 ‐ 877 ‐ 702 ‐ 4360 www.dell.com/ve la ‐ [email protected]

0800 ‐ 100 ‐ 4752

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 .......................................................................................................................32

Installing a New Version of the vFoglight Management Server ...................................................32

Upgrading vFoglight ....................................................................................................................68

Installed Directories .....................................................................................................................69

vFoglight Settings ........................................................................................................................70

UninstallingvFoglight vFoglight ....................................................................................................77

Note The vFoglight Management Server should be installed on a dedicated machine.

32 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.

• An administrator password for vFoglight. The user name foglight and the default password for this account can initially be used to log on to the browser interface and use command-line options with administrator privileges. Vizioncore recommends that you change the default password for this account.

Installing a New Version of the vFoglight Management

Server

Once all system requirements are in place you are ready to install the vFoglight

Management Server. The installer prompts you to input data, and provides you with progress feedback during the installation process.

The vFoglight installer offers two installation options:

• Standard - This option accepts all of the installer defaults, and installs an embedded SQL database only. To use this option, follow the instructions in

“ Installing the vFoglight Management Server - Standard Install Option ” on page 33.

• Custom - This option allows you to modify the installer defaults, and to choose an external database type. To use this option, following the instructions in

“ Installing the vFoglight Management Server - Custom Install Option ” on page 47.

The vFoglight installation process consists of the same basic steps for all platforms. For

specific platform customizations, see “ Installed Directories ” on page 69.

Installing vFoglight

Installing a New Version of the vFoglight Management Server

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. Click Next after reading the contents of this screen.

33

Figure 1

34 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

35

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.

36 Foglight

Installation and Setup Guide

Click Next .

Step 5: Pre-Installation Summary

1

2

Review the installation information.

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.4, click Previous until you return to the Choose Install Folder screen.

Detailed upgrade instructions are available in the vFoglight 5.2.4 Upgrade Field

Guide .

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.

Figure 2

38 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. Click Skip in this dialog if you would like to add a license file after installing vFoglight.

Figure 3

Step 8: Install Complete

Click Done to complete the installation process.

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.

40 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.

42 Foglight

Installation and Setup Guide

2 Click Next .

Installing vFoglight

Installing a New Version of the vFoglight Management Server

Step 12: VMware Infrastructure Agent Install Screen

The Agent Install screen is displayed. Click Install .

43

Step 13: VirtualCenter Authentication

1

2

On the VirtualCenter Authentication Information screen, enter the VirtualCenter

Server name or IP Address.

Enter VirtualCenter Server Username and Password credentials that will provide you with access to the VMware Virtual Infrastructure Client.

44 Foglight

Installation and Setup Guide

3

4

Click Save to have your entries validated.

On the Credentials Entered are Valid!

dialog, click OK .

Step 14: vFoglight Server Destination

1

2

On the vFoglight Server Destination Information screen, enter the agent name as you want it to be displayed in vFoglight.

Enter the vFoglight Server name or IP address. This is the name or IP of the vFoglight Management Server.

4

5

3 Enter the port number of the port that the vFoglight Server uses for HTTP traffic.

The default is 8080.

If this port requires SSL, check the SSL check box.

Enter a Sample Interval time in seconds. If you enter a lower interval, you could encounter performance problems while gaining little or nothing in terms of the quality of your data. If you enter an interval that is too high, you may not receive data often enough for it to be of much value.

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.

46 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.

Next Steps

If you need to import and initialize your database, refer to the procedures in “ Migrating

Data from an Existing Database ” on page 80.

Start the vFoglight Management Server by following the instructions in “ Starting and

Stopping the vFoglight Management Server ” on page 81.

To log into the vFoglight Console, refer to “ Logging in to the vFoglight Browser

Interface ” on page 84.

Installing vFoglight

Installing a New Version of the vFoglight Management Server

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. Click Next after reading the contents of this screen.

47

Figure 6

48 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

49

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.

50 Foglight

Installation and Setup Guide

2 Click Next .

Step 5: Pre-Installation Summary

1

2

Review the installation information.

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.4, click Previous until you return to the Choose Install Folder screen.

Detailed upgrade instructions are available in the vFoglight 5.2.4 Upgrade Field

Guide .

Installing vFoglight

Installing a New Version of the vFoglight Management Server

51

Step 6: Installing vFoglight

vFoglight installs files into the specified directory.

52 Foglight

Installation and Setup Guide

Figure 7

Step 7: vFoglight Administrator Password

1

2

In the vFoglight Administrator Password field accept the default password

( foglight) or enter an alternate one.

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

4

To run vFoglight in secure mode (HTTPS) only, check the Secure Server

(HTTPS Only) box.

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 .

54 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

3

In the vFoglight Database Account Password field accept the default password

( foglight ) or enter an alternate one.

In the vFoglight Database Account Retype Password field, accept the default

(foglight) or, if you have provided an alternate password in

step 2

, retype the password for verification.

4 From the vFoglight Database drop-down list, choose Embedded .

The vFoglight Database drop-down list is disabled if you selected HA as the server startup mode in “ Step 8: vFoglight Mode ” on page 53.

Embedded Database Installation

1

2

Accept the default port (13306) or enter an alternate Database Port .

In the DB Administrator Password field, accept the default password provided

( 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.

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. You can either click Review Ports if you want to return to the vFoglight Ports

Configuration screen to configure the conflicting port(s), or choose Ignore and

Continue to continue with the installation without resolving the port conflicts.

Choose one of these options to continue.

56 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

3

Click Next .

If you selected Enable vFoglight as a Service in “ Step 5: Pre-Installation

Summary ” on page 50, the vFoglight Management Server service is enabled and started at this point.

Installing vFoglight

Installing a New Version of the vFoglight Management Server

Step 12: Install Complete

Click Done to complete the installation process.

57

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. Click Next after reading the contents of this screen.

58 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.

60 Foglight

Installation and Setup Guide

2 Click Next .

Installing vFoglight

Installing a New Version of the vFoglight Management Server

Step 16: VMware Infrastructure Agent Install Screen

The Agent Install screen is displayed. Click Install .

61

Step 17: VirtualCenter Authentication

1

2

On the VirtualCenter Authentication Information screen, enter the VirtualCenter

Server name or IP Address.

Enter VirtualCenter Server Username and Password credentials that will provide you with access to the VMware Virtual Infrastructure Client.

62 Foglight

Installation and Setup Guide

3

4

Click Save to have your entries validated.

On the Credentials Entered are Valid!

dialog, click OK .

Step 18: vFoglight Server Destination

1

2

On the vFoglight Server Destination Information screen, enter the agent name as you want it to be displayed in vFoglight.

Enter the vFoglight Server name or IP address. This is the name or IP of the vFoglight Management Server.

4

5

3 Enter the port number of the port that the vFoglight Server uses for HTTP traffic.

The default is 8080.

If this port requires SSL, check the SSL check box.

Enter a Sample Interval time in seconds. If you enter a lower interval, you could encounter performance problems while gaining little or nothing in terms of the quality of your data. If you enter an interval that is too high, you may not receive data often enough for it to be of much value.

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.

64 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.

Next Steps

If you need to import and initialize your database, refer to the procedures in “ Migrating

Data from an Existing Database ” on page 80.

Start the vFoglight Management Server by following the instructions in “ Starting and

Stopping the vFoglight Management Server ” on page 81.

To log into the vFoglight Console, refer to “ Logging in to the vFoglight Browser

Interface ” on page 84.

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.

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.

Note The installer uses the properties automatically when the filename and installer prefix are the same. For example, vFoglight-5_2_4-install_windows-ia32.exe

picks up vFoglight-5_2_4install_windows-ia32.properties

automatically.

Property

INSTALLER_UI

Description Default

The property is set to SILENT for silent mode.

This is the default setting and is mandatory.

SILENT

66 Foglight

Installation and Setup Guide

Property

USER_INSTALL_DIR

USER_SHORTCUTS

FMS_LICENSE_AGREEMENT

FMS_LICENSE_FILE

FMS_SERVICE

FMS_UPGRADE

Description Default

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\

Sets the shortcut location.

C:\Documents and

Settings\All Users\Start

Menu\Programs\Vizioncore\v

Foglight 5.2.4

License agreement acknowledgment.

yes

Allows you to add a license file by specifying the path to the license.

None (the license file you specify is validated).

false For enabling vFoglight as a

Windows service.

Only required to update an existing installation, in which case it must be set to 1.

1

Property

FMS_ADMIN_PASSWORD

FMS_DB

FMS_DB_USER

FMS_DB_USER_PASSWORD

FMS_DB_SETUPNOW

FMS_DB_PORT

FMS_HA_MODE

FMS_HA_PARTITION

FMS_JNDI_JNP_PORT

Installing vFoglight

Installing a New Version of the vFoglight Management Server

Description Default

Administrator password for vFoglight.

foglight

Allows you to specify the database type (embedded or external).

Must be external if

FMS_HA_MODE=

1 embedded foglight Default database user.

Default database password.

foglight

1 = Set up database as part of installation.

0 = Set up database after installation is complete.

1

13306 User-defined port for database.

0 = Standalone mode

1 = HA mode

Partition name.

Only required if

FMS_HA_MODE=

1

Bootstrap JNP service.

0

FMS_HA

1099

67

68 Foglight

Installation and Setup Guide

Property Description Default

FMS_JNDI_RMI_PORT

FMS_HTTP_PORT

FMS_HTTPS_PORT

Port of RMI naming service.

1098

HTTP/1.1

Connector.

HTTP/1.1

Connector.

8080

8443

AJP 1.3 Connector.

8009 FMS_AJP13_PORT

FMS_HA_JNDI_RMI_PORT

FMS_HA_JNDI_JNP_PORT

FMS_HA_JRMP_INVOKER_PORT

FMS_HA_POOLED_INVOKER

Port of RMI naming service in HA mode.

1101

Bootstrap JNP service in HA mode.

1100

RMI/JRMP invoker in HA mode.

4447

Pooled invoker port in HA mode.

4446

FMS_HA_JNDI_UDPGROUP_PORT

FMS_CLUSTER_MCAST_PORT Cluster Multicast post.

1102

45566

Upgrading vFoglight

Please consult the vFoglight 5.2.4 Upgrade Field Guide for detailed upgrade instructions.

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 bin client config docs dtd jre lib logs mysql

Contents vFoglight executables for running the server and utilities.

Files used by client programs (such as the command line client) for remote access to vFoglight.

Configuration files and subdirectories.

The files in the config directory contain settings that are most likely to require editing. Files at the next level are less likely to need changing. Files at the lowest level contain settings that are unlikely to need changing except in special circumstances.

HTML and PDF versions of the product documentation.

Descriptors for configuration files that can be imported into vFoglight (for example, by installing a cartridge).

Version of the JRE (1.5.0_11-b03) used by vFoglight.

The vFoglight JARs.

Default location of the log files generated by vFoglight when it runs.

Generated at runtime.

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.

To startup the embedded database individually without running vFoglight, use these parameters

[run|shutdown]Db.[bat|sh] in <install-dir>\bin

70 Foglight

Installation and Setup Guide

Directory perl scripts server tools

Contents

Libraries needed to interpret the PERL scripts, version 5.8.8.

Supported and unsupported utility scripts to extend the scripting engine.

scripts\sql contains SQL scripts to drop, create-schema or create/populate the database.

JARs and data files used by a particular vFoglight server variant (such as default).

Various utilities such as the foglight-federation-support.sar

file.

Additional directories created after the vFoglight Management Server is started:

Directory Contents cartridge support

Installed cartridge files in their original form.

Where support bundled archive information is stored.

tmp\cartridge.exploded

Unzipped contents of installed cartridges.

Unizpped at runtime.

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 < vfoglight_home > \config\foglight.config

, which contains central settings.

Installing vFoglight vFoglight Settings

71

Editing the foglight.config

File

The f oglight.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 Java Virtual Machine’s minimum and maximum parameters for the server in the

<vfoglight_home>\config\foglight.config

file.

If you are starting vFoglight using the run.[bat|sh] command, the JVM heap memory parameters set in the <vfoglight_home>\config\foglight.config

file do not take effect.

Use -X options to pass the memory parameters straight to the VM.

If your installation supports a large number (100s) of agents, you can assign Java heap memory sizes using the minimum ( -Xms ) and maximum ( -Xmx ) options. For example, assigning 2 GB of memory can be set in the foglight.config file as follows: foglight.vm.option0 = “-Xms2048M”; foglight.vm.option1 = “-Xmx2048M”;

Ensure that you uncomment these lines in the file.

You can set up to 100 VM options.

Note The -Xms and -Xmx options are different for 32-bit and 64-bit JVMs.

Note On a 32-bit JVM, the -Xms and -Xmx do not necessarily have to be the same size.

However, the -Xmx should not exceed certain limits as determined by the System

Administrator.

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.

72 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.config

file allows you to add up to ten additional command line options for fms.exe

.

Each command line argument corresponds to a space-delimited argument passed to the vFoglight process.

For example, the following lines in the foglight.config file: foglight.cmdline.option0 = “-b”; foglight.cmdline.option1 = “hostname”; correspond to this direct argument on the command line: fms.exe -b hostname

Note that some arguments may be assembled as single non-separated text. For example, using the long name for the parameter in the example above results in a single foglight.cmdline.option entry: foglight.cmdline.option0 = “--host=hostname”; which corresponds to the following command line argument: fms.exe --host=hostname

Setting the SQL Parser Properties

The following default system properties appear in the foglight.config

file. The port setting can be changed during the install process, or by editing the foglight.config

file.

# qp5app port and info foglight.qp5app.max.connections = "10"; foglight.qp5app.port = "8448";

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. These

Management Server instances together can act as a single logical Management Server by making each instance a Federated Management Server with one central Federation

Management Server.

For more detailed background information on vFoglight Federation, please refer to the vFoglight Federation Field Guide .

To create a Federated environment, you must make changes to both the foglight.config

and the federation.config

files after installation.

Caution A Federated server must always be started with the federation parameter set to true.

To set up a Federated environment:

1

2

Identify the vFoglight Management Server you wish to define as the Federated manager or master server.

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\config\federation.config file.

6 Add the port number of each vFoglight Management Server in the federation to the federation.config

file. The following example is provided in the federation.config

file:

# *** JndiURLs ***

# This list contains JNDI provider URLs for federated servers.

74 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. A major topology refresh involves refetching all relevant #topology objects from all federated servers and merging them into the local #topology model.

# The default value is 1800, that is 30 minutes.

TopologyRefreshPeriod = 1800;

8 Edit the list of topology queries:

# *** TopologyQueries ***

# This list contains topology queries that identify topology objects to be #merged into the federated topology model. These 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.

# The default value is

# TopologyQueries = (

# "!TopologyObject",

# );

TopologyQueries = (

"!TopologyObject",

);

Configuring vFoglight to Access the Server Only Through the

HTTPS Port

If you do not choose to install vFoglight in Secure Server mode, you can manually configure vFoglight Management Server to restrict the server to use only the https port by editing the <foglight_home>\config\foglight.config

file. Set the following parameter: foglight.console.httpsonly = "true";

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. This allows the server to communicate through the https protocol. You need to delete the existing certificate shipped with vFoglight before generating a new key pair. Use the keytool utility shipped with vFoglight to create, import, and export certificates. This utility can be found in:

• $FMS_HOME\jre\bin\keytool

There are two keystores used by vFoglight:

• The built-in Tomcat keystore located at:

$FMS_HOME\server\default\conf\tomcat.keystore

(default password: nitrogen )

• The vFoglight Management Server keystore located at:

$FMS_HOME\jre\lib\security\cacerts (default password: changeit )

To import a certificate:

1 Change directories to the following path:

2

$FMS_HOME\server\default\conf\

Delete the existing tomcat key from the tomcat.keystore directory using the following command:

3

$FMS_HOME\jre\bin\keytool -keystore

FMS_HOME\server\default\conf\tomcat.keystore -storepass nitrogen -delete alias tomcat

Create a new key under the tomcat alias using the following command:

4

$FMS_HOME\jre\bin\keytool -keystore

FMS_HOME\server\default\conf\tomcat.keystore -storepass nitrogen -genkey alias tomcat

Generate a Certificate Signing Request (CSR) using the following command:

76 Foglight

Installation and Setup Guide

$FMS_HOME\jre\bin\keytool -keystore

FMS_HOME\server\default\conf\tomcat.keystore -storepass nitrogen -certreq alias tomcat -file <your_request_file.csr>

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.keystore -storepass nitrogen -import trustcacerts -alias tomcat -file <your_converted_cerificate>

You are prompted to enter the keystore password.

6 Type nitrogen.

Setting Up an Encrypted Database Connection with SSL

The following procedure outlines how to set up a secure embedded MySQL database connection.

Note This procedure must be performed after installation but before you have started the vFoglight Management Server.

To set up an encrypted database connection with SSL:

1

2

Import a CA certificate into the vFoglight Management Server keystore (cacerts)

as outlined in “ Importing a Network Security Certificate ” on page 75.

Update the MySQL configuration file ( my.ini

) with the new security certificate and key information by adding the following properties:

• ssl-ca=<cacert.pem>

• ssl-cert=<server-cert.pem>

• ssl-key=<server-key.pem>

3 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.

# However, for MySQL, DO NOT enable this option until the database server's CA certificate is properly imported into $fms_dir\jre\lib\security\cacerts.

foglight.database.secureconn = "true";

Installing vFoglight

UninstallingvFoglight vFoglight

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

2

Acquire the LDAP server certificate in .pem

format from the administrator.

Import the certificate into the vFoglight Management Server keystore

( $FMS_HOME\jre\lib\security\cacerts (default password: changeit )) with the following command:

$FMS_HOME\jre\bin\keytool -import -file <path_to_cert_file> -alias ldapsvrcert -keystore <path_to_cacerts>

Go to Administration > Users & Security > Configure Directory Services .

3

4

5

Click Edit .

Enter the LDAP server URL in the following format: 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.

77

UninstallingvFoglight vFoglight

You can uninstall vFoglight using the uninstaller utility for your platform. The uninstaller can be found in <foglight_home>\UninstallerData .

78 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 ..............................................................................................................81

Starting and Stopping the vFoglight Management Server ...........................................................81

Logging in to the vFoglight Browser Interface .............................................................................84

Running the vFoglight Management Server FAQ ........................................................................85

80 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.

To export and import a MySQL database:

1 Run the following command from the MySQL command shell: mysqldump -u<username> -p<password> -h<hostname> -P<port> -databases <database name> > backup.sql

2

The -h parameter can be omitted if the database is on the same host.

Import the database using the following syntax: mysql -u<username> -p<password> -P<port> < backup.sql

The import process recreates the tables in the database. Therefore, any data that was in the destination environment prior to the import is lost.

Caution The vFoglight servers must be stopped during the import process.

Note When moving a database between environments, care should be taken to ensure that the vFoglight schema version is lower or equal to the vFoglight server in the destination environment as an upgrade to a new schema is possible (run foglight_db_upgrade.bat|sh or start server with -Dfoglight.database.upgrade=true).

Running the vFoglight Management Server

Initializing the Database

Initializing the Database

If you are using the embedded database, the initialization is performed when you start vFoglight.

81

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:

<vfoglight_home>\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.4 > Start vFoglight or double-click the Start vFoglight icon on the desktop.

When the server has successfully started, the following message appears in the command window: vFoglight Management Server startup completed.

Starting the vFoglight Management Server as a Windows

Service

After the installation is completed, you can install the vFoglight Management Server as a Windows service either from the Start menu or the command line.

Note The procedures below assume that you have installed the program shortcuts in the default location.

82 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 ).

Using the Command Line

From the command line, type the following to install the vFoglight Management Server as a Windows service: fms.exe -i

Running the vFoglight Management Server

Starting and Stopping the vFoglight Management Server

83

Additional Commands:

Command

-s

-q

-b

-r

-n

-j

-v

-h

Represents Description start Start the vFoglight Management Server (this is assumed if no command is specified)

Stop the vFoglight Management Server stop start-service removeservice

Start the vFoglight Management Server Windows service

Stop and remove the vFoglight Management Server

Windows service name Provide a unique name for this instance of the vFoglight Management Server service jvm-argument Set an option to be passed directly to the Java ™ VM

(can be used to set more than one VM option) version help

Display the version number for this program and exit

Show this information and exit

Stopping the Server

To stop the vFoglight Management Server:

Do one of the following:

• Type Ctrl-C in the command window from which the Management Server started.

• In 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.

84 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 .

To log in to vFoglight using a web browser:

• Open a web browser and type the following: http://<hostname>:<port>/console/admin/main.action

where <hostname> is the name of the machine where the vFoglight Management

Server is installed and <port> is the http port specified during installation (the default is 8080 ).

Next Steps

To install cartridges, refer to the chapter “Installing and Upgrading Cartridges”.

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. To do so, use one of the following methods:

• On the command line, enter the following: fms.exe -j -XX:MaxPermSize=96m

• Edit the foglight.config

file found in <vfoglight_home>\config and modify the following parameter: foglight.vm.option0 = "-XX:MaxPermSize=96m";

After you have used one of these methods, restart the server.

If I close the vFoglight Management Server by clicking the X button on the command window, an error appears when I start up the server again. How do I restart the server?

It is recommended that you do not use this method to stop the vFoglight Management

Server. However, if you do use this method, follow the workaround listed below.

1

2

If you are using a managed database (for example, a copy of MySQL that is started by vFoglight), stop the database manually before restarting the vFoglight

Management Server.

Remove the stale .pid

file that is located in the \state directory. The logs or the console output inform you which .pid

file to remove when you restart the server.

86 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 .....................................................................................................................88

Upgrading Cartridges ..................................................................................................................89

88 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 Cartridges

Installation is the first step in adding a cartridge to the vFoglight Management Server. A cartridge file has the extension .car

. Installing the .car

file causes the Management

Server to be aware of all cartridges in the .car

file.

Note You can install a .car

file that is in a local directory on the machine hosting the Management

Server or upload a .car

file from your local machine to the Management Server through the

Administration Module.

A cartridge must also be enabled before it is added to the vFoglight Management

Server. You can cause a cartridge to be enabled upon installation, or you can enable it after installation. See the vFoglight Administration and Configuration Guide for instructions on enabling and disabling cartridges after installation.

To install a cartridge:

1

2

Navigate to the Cartridge Inventory page.

In the Install Cartridge area, type the path to the .car

file for the cartridge you want to install.

• Type the path in File on Local Machine field if you want to upload a .car

file from your local machine to the Management Server.

• Type the path in the File on Server field if you want to install a .

car file that is in a local directory on the machine hosting the Management Server.

Alternatively, you can click Browse to navigate to a .car

file on your local machine using a file chooser. Click OK in the file chooser when you have selected the .car

file you want to install.

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 .

If the installation is successful, the message “Cartridge has been installed successfully” appears in the Install Cartridge area and the cartridge is listed in the Cartridge

Inventory .

If Enable on install was not selected (see

step 3

), a caution symbol ( ) appears in the row for that cartridge in the table in the Cartridge Inventory .

For more information about cartridge installation and configuration see the vFoglight

Administration and Configuration Guide .

Upgrading Cartridges

For complete cartridge upgrade instructions, refer to the vFoglight 5.2.4 Cartridge

Upgrade Field Guide .

Next Steps

To install the vFoglight Agent Manager, refer to the chapter “Installing and Running the vFoglight Agent Manager (FglAM)”.

Note The vFoglight Agent Manager is automatically installed during the vFoglight installation.

These instructions are for reference only.

90 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 .................................................................................104

Running the vFoglight Agent Manager ......................................................................................106

Next Steps .................................................................................................................................107

Uninstalling the vFoglight Agent Manager .................................................................................107

vFoglight Agent Manager Platform Support Matrix ....................................................................108

Note The vFoglight Agent Manager (FglAM) is installed automatically during the vFoglight installation. These instructions are for reference only.

92 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.

Note Throughout this chapter, the convention [ option1 | option2 ] is used in file names at points where you must type, select, or otherwise specify one of multiple options.

Deploying the vFoglight Agent Manager Cartridge

vFoglight Agent Manager installer is delivered in the cartridge FglAM-windows-ia32-

5_2_4.car

. This cartridge is available in Cartridge folder of the vFoglight installation directory.

The following procedure outlines how to deploy the FglAM-windows-ia32-5_2_4.car file on your vFoglight Management Server.

To deploy the vFoglight Agent Manager cartridge:

1

2

3

Log in to vFoglight.

Navigate to the Cartridge Inventory dashboard ( Dashboards > Administration >

Cartridges > Cartridge Inventory ).

Click the Browse button beside the File on Local Server field. The Choose File window appears.

5

6

4 Navigate to your FglAM-windows-ia32-5_2_4.car

file, and click on the Open button. The File on Local Server field is now populated with the path to the vFoglight Agent Manager installer .car

file.

Ensure that the Enable on Install box is checked.

Click the Install Cartridge button.

Once you have deployed the applicable cartridge for the vFoglight Agent Manager, you can then download the installer for your platform and install the vFoglight Agent

Manager. See “ Downloading the vFoglight Agent Manager Installer ” on page 93 and

“ Installing the vFoglight Agent Manager ” on page 94.

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.car

file, you can download the appropriate platform-specific installer from the Components for Download dashboard.

To download the installer for the vFoglight Agent Manager:

1

2

Log in to vFoglight.

Navigate to the Components for Download dashboard ( Dashboards >

Administration > Cartridges > Components for Download ).

4

5

3 Click the vFoglight Agent Manager installer for your platform. Consult the

“ vFoglight Agent Manager Platform Support Matrix ” on page 108 for the

appropriate installer name for your platform.

Optional: save the installer.

Run the installer. See “ Installing the vFoglight Agent Manager ” on page 94 for

details.

Using the vFoglight Agent Manager Installer Servlet

In situations where unauthenticated or headless access to the installers is required, you can download the appropriate platform-specific vFoglight Agent Manager installer from a servlet (after deploying the FglAM-windows-ia32-5_2_4.car

file).

To access the vFoglight Agent Manager installer servlet using a browser:

1 Open a web browser and navigate to the following page:

[http|https]://<hostname>:<port>/catalyst-glue-service/installers/ where <hostname> is the name of the machine where the vFoglight Management

Server is installed and <port> is the HTTP port specified during installation (the default is 8080 ).

If the vFoglight Management Server has been configured to use HTTPS, then you can specify https as the protocol.

Note No login is required to access this page.

94 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

4

Optional: save the installer.

Run the installer. See “ Installing the vFoglight Agent Manager ” on page 94.

To access the vFoglight Agent Manager installer servlet using a file-retrieval tool:

1 Use a file-retrieval tool to obtain the appropriate vFoglight Agent Manager installer for Windows by specifying a path formatted as

[http|https]://<hostname>:<port>/catalyst-glue-service/installers/fglamwindows-[ia32|x64].exe

where <hostname> is the name of the machine where the vFoglight Management

Server is installed and <port> is the HTTP port specified during installation (the default port is 8080

). Consult the “ vFoglight Agent Manager Platform Support

Matrix ” on page 108 for the appropriate installer name for your platform.

If the vFoglight Management Server has been configured to use HTTPS, then you can specify https as the protocol.

2

For example, if you were to retrieve the file fglam-windows-ia32.exe

from a machine called server1 (that uses the default port 8080) using Wget, you would issue the command: wget http://server1:8080/catalyst-glue-service/installers/fglam-windowsia32.exe

Run the installer. See “ Installing the vFoglight Agent Manager ” on page 94 for

instructions.

Installing the vFoglight Agent Manager

After downloading the installer to the machine on which you want to install the

vFoglight Agent Manager (as described in “ Downloading the vFoglight Agent Manager

Installer ” on page 93), you can run the installer from the command line, use the silent

(non-interactive) installer, or use the installer GUI.

The installer includes steps that allow you, for example, to install the vFoglight Agent

Manager as a service and to configure multiple ways of connecting the vFoglight Agent

Manager to the vFoglight Management Server.

Note No Windows shortcuts are created when the vFoglight Agent Manager is installed.

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.

2

A console window appears while the installer is loading and installer files are being extracted to a temporary location on your machine.

The FglAM Installation and Configuration program window appears. Review the information on the Introduction screen and click Next .

3

The License Agreement screen appears.

Accept the terms of the license agreement and click Next .

Note You need to accept the license agreement before you can install the product.

The Installation Directory screen appears.

4 Choose the directory where you want to install the vFoglight Agent Manager and click Next .

The Configure vFoglight Server URLs screen appears:

96 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.

6

For example, you can specify a single URL or configure multiple Management

Server URLs for failover purposes.

Note You can also configure Management Server URLs at a later time using the vFoglight

Agent Manager configuration interface. See “ Configuring the vFoglight Agent

Manager ” on page 104 for information about launching this interface post-

installation.

Click Add to launch the Edit vFoglight Server URL dialog: a Specify the URL used by the vFoglight Agent Manager to connect to the vFoglight Management Server (the Management Server hostname and port).

In addition, you can configure the following vFoglight Agent Manager connection options in this dialog: Connect using HTTPS , Connect using a proxy , and Bind to a local address

. See “ Configuring vFoglight Management

Server URLs from the Installer GUI ” on page 97 for information about these

options.

7 b Once you have specified the desired connection options, click OK .

Repeat step 6 and its sub-steps for each Management Server URL you want to

add.

Installing and Running the vFoglight Agent Manager (FglAM)

Installing the vFoglight Agent Manager

97

8

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.

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.

9 Once you have specified one vFoglight Management Server to which the vFoglight Agent Manager connects, you can search for other Management

Servers that have been configured to be part of the same HA (High Availability) partition by selecting the Management Server URL and clicking Find HA Peers .

10 When you have finished adding Management Server URLs, click Next .

Note If you did not configure any Management Server URLs, if there are URLs listed that have not been tested, or if there are URLs listed that failed the connectivity test, a

Warning dialog appears asking you to confirm whether or not you would like to continue.

The Install Windows Service screen appears.

11 Leave the check box selected (the default setting) if you want to install the vFoglight Agent Manager as a Windows service and have it start automatically when Windows starts.

Deselect the check box if you do not want to install the vFoglight Agent Manager as a Windows service.

12 Click Next .

The Summary screen appears.

13 Click Finish to complete the installation.

The vFoglight Agent Manager installer copies files to the machine. The vFoglight

Agent Manager Installer dialog and the console window close automatically when the installation is complete.

Note Install the vFoglight Agent Manager on each host that you would like to monitor.

Configuring vFoglight Management Server URLs from the Installer GUI

As described in

step 6

of “ Using the vFoglight Agent Manager Installation and

Configuration GUI ” on page 95, you can configure the vFoglight Agent Manager

connection parameters described below in the Edit vFoglight Server URL dialog available from the installer GUI.

98 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.

• Allow a certificate with an unexpected common name: Selecting this check box causes a certificate with a common name (host name) different than the one reported by the Management Server to be accepted. You specify the name in the field Certificate Common Name: .

Connect using a proxy

You can specify whether the vFoglight Agent Manager should connect to the

Management Server using a proxy.

Selecting the Connect using a proxy check box causes the following additional fields to become available:

• Proxy URL: Specify the URL of the proxy used to connect to the Management

Server in this field.

• Username: Specify the username provided to the proxy in this field.

• Password: Specify the password provided to the proxy in this field.

• NTLM Domain: Specify the domain provided to the proxy in this field.

Bind to a local address

You can specify a local network address on the vFoglight Agent Manager machine from which connections to the Management Server are made.

• Local Address: Specify the IP address of a NIC (network interface card) on the machine hosting the vFoglight Agent Manager that is used to establish outbound connections to the Management Server.

Installing the vFoglight Agent Manager from the Command Line

The following procedure outlines how to run the command-line installer for the vFoglight Agent Manager.

The command-line installer prompts you for information and informs you of the progress of your installation.

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:

4

5

3 fglam-windows-[ia32|x64].exe --headless

Messages appear in the command window while the installer starts and installer files are being extracted to a temporary location on your machine.

The Introduction step appears in the command window when the installer has finished loading.

Review the information in the Introduction and press Enter to move to the next step.

The first part of the License Agreement step appears.

Press Enter to cause subsequent portions of the license agreement to appear.

6

At the prompt, type Y and press Enter to accept the terms of the license agreement.

Note You need to accept the license agreement before you can install the product.

The Installation Directory step appears.

At the Install directory prompt, type the path to the directory where you want to install the vFoglight Agent Manager and press Enter or simply press Enter to accept the default installation directory.

Note If the specified directory does not exist, the installer prompts you regarding whether or not you would like it to be created. To create a directory, press Enter . To return to the Install directory prompt, type N and then press Enter .

The Configure vFMS URLs step appears.

7

8

The Configure vFMS URLs step and its sub-steps allow you to 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.

Note You can also configure Management Server URLs at a later time using the vFoglight

Agent Manager configuration interface. See “ Configuring the vFoglight Agent

Manager ” on page 104 for information about launching this interface post-

installation.

Type 4 and press Enter to select the Add a new URL option.

100 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. For example: b url=http://localhost:8080,address=127.0.0.1,proxy=http://proxy.server

Once you have typed the desired parameters, press Enter .

A message appears when the URL is added. You then return to the Configure vFMS URLs menu and prompt.

9

Repeat step 8 and its sub-steps for each Management Server URL you want to

add.

10 To list the URLs you have added, type 1 and press Enter .

A numbered list of configured Management Server URLs appears.

A URL for which the connection has not been tested appears with an exclamation point ( !

) next to it.

You then return to the Configure vFMS URLs menu and prompt.

11 Once you have specified one vFoglight Management Server, you can test the vFoglight Agent Manager-vFoglight Management Server connection(s): a Type 2 and press Enter .

The installer tests the connection(s). A message appears informing you of the test progress.

b

When the test is complete, you return to the Configure vFMS URLs menu and prompt.

To see whether the URL(s) passed the connectivity test, type 1 and press Enter .

A URL that failed the connectivity test appears with an x next to it.

You then return to the Configure vFMS URLs menu and prompt.

12 Once you have specified one vFoglight Management Server to which the vFoglight Agent Manager connects, you can search for other Management

Servers that have been configured to be part of the same HA (High Availability) partition:

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.

You then return to the Configure vFMS URLs menu and prompt.

13 When you have finished adding Management Server URLs, type 0 and press

Enter .

Note If you did not configure any Management Server URLs, if there are URLs listed that have not been tested, or if there are URLs listed that failed the connectivity test, a message appears asking you to confirm whether or not you would like to continue.

The Install as a Windows Service step appears.

14 If you want to install the vFoglight Agent Manager as a Windows service (the default setting) and have it start automatically when Windows starts, simply press

Enter .

If you do not want to install the vFoglight Agent Manager as a Windows service, type N and press Enter .

The Summary step appears.

15 Press Enter to exit the installer and complete the installation.

The vFoglight Agent Manager installer calculates the installation size and copies files to the machine.

Note Install the vFoglight Agent Manager on each host that you would like to monitor.

Configuring vFoglight Management Server URLs from the Command Line

As described in

step 8

of “ Installing the vFoglight Agent Manager from the Command

Line ” on page 98 and

step 3 of “ Using the Silent vFoglight Agent Manager Installer ” on page 103, you can configure the vFoglight Agent Manager connection parameters

described below as part of the command-line installation processes.

The required and optional parameters for specifying a vFoglight Management Server

URL are described below. Parameters must be specified as a list of comma-separated name-value pairs, starting with the required url parameter. For example:

102 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. Type the URL used by the vFoglight Agent

Manager to connect to the vFoglight Management Server using the format url=[http|https]://<hostname>:<port> where <hostname> is the name of the machine where the vFoglight Management

Server is installed and <port> is the HTTP port specified during installation (the default port is 8080 ).

If the vFoglight Management Server has been configured to use HTTPS, then you can specify https as the protocol used by the vFoglight Agent Manager to connect to the Management Server.

• proxy : This parameter is optional. Type the URL of the proxy used to connect to the Management Server as the proxy value.

• proxyUser : This parameter is optional. Type the username provided to the proxy as the proxyUser value.

• proxyPass : This parameter is optional. Type the password provided to the proxy as the proxyPass value.

• proxyNtlmDomain : This parameter is optional. Type the NTLM domain provided to the proxy as the as the proxyNtlm value.

• address : This parameter is optional. Type the IP address of a NIC (network interface card) on the machine hosting the vFoglight Agent Manager that is used to establish outbound connections to the Management Server as the address value.

• sslAllowSelfSigned : This parameter is optional.

• Type true as the sslAllowSelfSigned value to allow self-signed certificates to be accepted.

• Type false as the sslAllowSelfSigned value if you do not want self-signed certificates to be accepted.

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.

Using the Silent vFoglight Agent Manager Installer

You can use the silent installer in situations where you want to install the vFoglight

Agent Manager non-interactively—for example, to install the vFoglight Agent Manager from the command line onto a remote, headless machine.

To install the vFoglight Agent Manager using the silent installer:

1 If you are installing onto a remote machine, log in to the target machine (for example, using SSH).

2

3

Launch a command window on the target machine and navigate to the directory to which you downloaded the installer.

Run the installer executable with the --silent option. All desired installation parameters must be included in the command with the --silent option, using the format fglam-windows-[ia32|x64].exe --silent --fms <url_and_other_parameters> -installdir <install_dirirectory_path> where <url_and_other_parameters> is a comma-separated list of parameters for configuring the connection to a vFoglight Management Server and

<install_dirirectory_path> is the full path to the directory where you want to

install the vFoglight Agent Manager. See “ Configuring vFoglight Management

Server URLs from the Command Line ” on page 101 for a description of the

required url parameter and the other optional parameters for the --fms option.

You can provide the --fms option multiple times to configure the connection to more than one Management Server at once.

Note The --installdir option is required, but the --fms option is not.

Messages appear in the command window while the installer starts. Installer files are extracted to the location you specified in the --installdir parameter and the installer runs.

Note Install the vFoglight Agent Manager on each host that you would like to monitor.

104 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.

Note All of the command-line options that you can specify when starting the vFoglight Agent

Manager installer also work with the --configure option that is used to launch the vFoglight Agent Manager configuration interface.

To launch the vFoglight Agent Manager configuration GUI:

1 Run the vFoglight Agent Manager from the command line with the --configure option:

2

<fglam_home>\bin\fglam.exe --configure

The FglAM Installation and Configuration program windowappears.

Review the information on the Introduction screen and click Next .

The Update Client ID screen appears.

3 The second screen—Update Client ID—allows you to reset the unique identifier assigned to this vFoglight Agent Manager if you have discovered that this vFoglight Agent Manager is using the same identifier as another vFoglight Agent

Manager:

• If you would like to reset the unique identifier assigned to this vFoglight

Agent Manager instance: select the Yes, reset this client’s ID check box.

• If you do not want to reset the unique identifier assigned to this vFoglight

Agent Manager instance: leave the Yes, reset this client’s ID check box deselected (the default setting).

Installing and Running the vFoglight Agent Manager (FglAM)

Configuring the vFoglight Agent Manager

105

4 Click Next .

5

The Configure vFoglight Server URLs screen appears.

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. See “ Using the vFoglight Agent Manager Installation and

Configuration GUI ” on page 95 for instructions.

6 When you are finished configuring the vFoglight Agent Manager, navigate to the

Summary screen and click Finish .

To launch the vFoglight Agent Manager configuration command-line interface:

1 Launch a command window on the vFoglight Agent Manager machine and navigate to the <fglam_home>\bin directory.

2 Run the vFoglight Agent Manager from the command line with the following options:

3 fglam.exe --headless --configure

A message appears in the command shell while the configuration interface starts.

The Introduction step appears when the configuration interface has finished loading.

Review the information in the Introduction and press Enter to move to the next step.

4 The second step—Update Client ID—allows you to reset the unique identifier assigned to this vFoglight Agent Manager if you have discovered that this vFoglight Agent Manager is using the same identifier as another vFoglight Agent

Manager:

• If you would like to reset the unique identifier assigned to this vFoglight

Agent Manager instance: type Y at the prompt and press Enter .

• If you do not want to reset the unique identifier assigned to this vFoglight

Agent Manager instance: press Enter ( N is the default option).

The Configure vFMS URLs screen appears.

5 The subsequent steps—Configure vFMS URLs and Install as a Windows

Service—are the same as in the vFoglight Agent Manager command-line

installer. See “ Installing the vFoglight Agent Manager from the Command Line ” on page 98 for instructions.

Navigate through the remaining steps and set the desired options.

106 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.

To install the vFoglight Agent Manager Windows service:

1

2

Launch a command window on the vFoglight Agent Manager machine and navigate to the <fglam_home>\bin directory.

Run the vFoglight Agent Manager from the command line with the --installservice option: fglam.exe --install-service

3 To start or stop the vFoglight Agent Manager service manually, follow the

instructions in “ To run the vFoglight Agent Manager as a Windows service: ” on page 106.

To remove the vFoglight Agent Manager Windows service:

1 Launch a command window on the vFoglight Agent Manager machine and navigate to the <fglam_home>\bin directory.

2 Run the vFoglight Agent Manager from the command line with the --removeservice option: fglam.exe --remove-service

Running the vFoglight Agent Manager

To start the vFoglight Agent Manager:

• Navigate to the \bin directory of your vFoglight Agent Manager installation and run the fglam.exe

executable.

To run the vFoglight Agent Manager as a Windows service:

1

If you have not already done so, follow the instructions in “ To install the vFoglight Agent Manager Windows service: ” on page 106.

Installing and Running the vFoglight Agent Manager (FglAM)

Next Steps

2 Launch a command window on the vFoglight Agent Manager machine and navigate to the <fglam_home>\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.exe --stop

Next Steps

To install vFoglight Agents, refer to the chapter “Installing Agents”.

Uninstalling the vFoglight Agent Manager

To uninstall version 5.2.4 of the vFoglight Agent Manager, delete the installation directory (referred to as <fglam_home> in this chapter).

107

108 vFoglight

Installation and Setup Guide

vFoglight Agent Manager Platform Support Matrix

The following table outlines the vFoglight Agent Manager installer appropriate for your platform.

Operating System

Microsoft Windows

Version

2000

XP

2003 Server

2003 Server ia64

Architecture ia32 ia64

FglAM Installer fglamwindows-ia32

XP x64 x86_64 fglamwindows-ia32

(emulated) fglamwindowsx86_64

6

Installing Agents

This chapter contains the following sections:

vFoglight Agents ........................................................................................................................110

Agent Installers ..........................................................................................................................110

Remote Agent Installation ......................................................................................................... 111

110 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. For agents that are installed on the monitored host you need to install and configure the vFoglight Agent Manager.

Caution If there is a difference between the time on the machine hosting the vFoglight

Management Server and the machine on which an agent is running, then the

Management Server discards all of the observed values for that agent.

The following are examples of problems that may arise as a result of time differences:

• If the Daylight Savings Time patch has not been applied on the agent machine, but the time was moved ahead manually, the vFoglight Management Server discards the data sent to it by the agent.

• If the Daylight Savings Time patch is applied after the agent is installed, the vFoglight

Management Server discards the data sent to it by the agent.

Agent Installers

Agents that depend on the vFoglight Agent Manager are installed using the remote

installation procedure. See “ Remote Agent Installation ” on page 111 and the

Administration and Configuration Guide .

Some cartridges include one or more executable agent installers. The agent installers that are available for download are listed on the Components for Download page of the

Cartridges area. You can use the controls on this page to download agent installers from the vFoglight Management Server to a remote machine.

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.

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. When displayed in the Create Agent dialog, the agent names are prepended with the cartridge name.

Depending on the type of agent that you installed, you may need to edit its properties to configure it for the part of your environment that you want to monitor. For information about agent properties, see the Administration and Configuration Guide and the User

Guide for the cartridge with which the agent was included.

Remote Agent Installation

You can install vFoglight agents on any remote host on which vFoglight Agent Manager

is installed. See “ Installing and Running the vFoglight Agent Manager (FglAM) ” on page 91 .

For more information about remote agent installation, see the Administration and

Configuration Guide .

112 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 ..........................................................................................114

114 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

2

Stop the vFoglight Management Server.

Start the embedded database manually:

3

<fms_home>\bin\runDb.sh

Export the database content:

<fms_home>\mysql\bin\mysqldump -uroot -p<password> -port=13306 --databases foglight > <fms_home>\foglight.dump

4 Shut down the database:

5

<fms_home>\bin\shutdownDb.sh

Connect to the external MySQL instance via MySQL:

6

<fms_home>\mysql\bin\mysql -h [mysql host] -P [mysql port] u root -p

Create the vFoglight database instance by running:

7 mysql> source <fms_home>\scripts\sql\mysql_create_db.sql

Re-import the data dump:

8 mysql> source <fms_home>\foglight.dump

Configure the vFoglight Management Server to use this new database by opening the following file:

9

<fms_home>\config\foglight.config

Update the following values in the above file: foglight.database.host = "[mysql host]"; foglight.database.port = "[mysql port]"; foglight.database.embedded = "false";

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) ..........................................................................................118

Installing and Running the vFoglight Client (SPID) FAQ ...........................................................119

116 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.

Note Before you begin, you must identify the hostname of the vFoglight Management Server with which the Foglight Client is to communicate. By default, the Foglight Client uses port 3528 to communicate with the Management Server. This port number can be changed by editing the property foglight.orb.port in the file <foglight_home>\config\foglight.config

. For more

information on working with the foglight.config file, refer to “ Editing the foglight.config File ” on page 71.

Note that the vFoglight Client (SPID)’s source port for the TCP/IP connection is random.

The OS’s TCP/IP stack chooses a source port from the 1025-65535 range that is not in use when creating the connection. However, the destination port (3528) is constant.

Ensure that a hostname resolution and reverse lookup are confirmed prior to installing the vFoglight Client (SPID).

Installing the vFoglight Client (SPID) from an Existing Cartridge

vFoglight comes with a cartridge that contains the vFoglight Client (SPID) installers for all supported platforms. The cartridge is called SPI-Client-Installers-5_2_4.car and can be found in the directory \Server\FoglightClient-SPID-5_2_4 on your install media.

Once you have installed the cartridge for the Foglight Client, you can then download the

installer for your platform and install Foglight Client. See “ Installation Processes ” on page 116 for more information.

Installation Processes

There are two different ways to install the Foglight Client:

Through the installer GUI. See “ Installing the vFoglight Client (SPID) Through the Installer GUI ” on page 117 for instructions.

In silent mode. See “ Installing the vFoglight Client (SPID) in Silent Mode ” on page 118 for instructions.

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.

• Choosing the Install Folder: Choose the location where you want to install the

Foglight Client.

• Choose Shortcut Location: Choose the location where you want product icons to be created.

• Configuration: Configure the host name and port for the Foglight Client.

Installing the vFoglight Client (SPID) Through the Installer GUI

To install the Foglight Client from the installer GUI :

1 Run the appropriate installer for your operating system:

• Spid-5_2_4-install_<platform>.bin or .exe

2

3

The vFoglight Client 5.2.4 installer launches.

Review the information on the Introduction screen and click Next .

4

Accept or decline the terms of the license agreement. If you selected I accept the terms of the License Agreement , click Next .

Note You need to accept the license agreement before you can install the product.

Choose the location where you want to install the Foglight Client and click Next .

Choose the shortcut location for the Foglight Client and click Next .

5

6

7

On the Configure vFoglight Client 5.2.4 screen, enter the following information:

• The name of the Management Server Host.

• The Management Server Port.

Review the information listed on the Pre-Installation Summary screen to ensure that it is correct. Click Install if you would like to continue with the installation, or click Previous if you would like to change any of the installation options.

8 If you clicked Install in

step 7

, the Foglight Client installs. When the Install

Complete screen appears, click Done to complete the installation.

118 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:

<installer binary> -i silent –DUSER_INSTALL_DIR=<installation directory> -

DAGENT_HOST=<hostname> -DAGENT_PORT=<port number>

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.

Running the vFoglight Client (SPID)

Note You can only run one instance of the vFoglight Client (SPID) on each host.

On Windows, vFoglight checks if an instance of the Foglight Client is already running on that host if you started the Foglight Client using one of the following methods:

• From the Start menu ( Start > Programs > Vizioncore > vFoglight SPID > Start SPID ).

• By running

<spid_home>\spid.exe

from the command line.

Connecting SPI Through a Firewall

When the vFoglight Client (SPID) connects from the monitored machine to the vFoglight Management Server through a firewall, the SPI communications port must be open. The firewall must be configured to allow originating requests from the monitored machine to the vFoglight Management Server. The configuration address, specified in the Foglight Client configuration file must be mapped to the CORBA listen address of the vFoglight Management Server when the firewall performs address and/or port

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

<foglight_home>\config\foglight.config

.

Check the contents of the properties file including the SPI communications port number in the Foglight Client installation directory:

<spid_home>\spid\<version>\cache\SPINetwork\SPINetwork\0\ORBInitRefs.xml

.

Note Set the firewall connection inactivity time-out to at least 30 minutes to avoid SPI connections having to be closed and re-opened when agent data is available.

Installing and Running the vFoglight Client (SPID) FAQ

Are there any known issues with vFoglight Client (SPID) connectivity?

Yes. When starting the vFoglight Client (SPID) on a remote host, the vFoglight Client

(SPID) might fail to connect to the vFoglight Management Server and generate an error message similar to the following:

“Retries exceeded, couldn't reconnect to 127.0.0.1:3528”.

This problem may occur if:

• The server is stopped or otherwise unavailable.

• The server sends a different IP address to the vFoglight Client (SPID) than the one set in the file

<spid_home>\Foglight_SPID\spid\<version>\cache\SPINetwork\SPINetwork\0\

ORBInitRefs.xml

on the vFoglight Client (SPID) machine. For example, this may occur if the server sends its local host IP address or if the server machine has two network cards and sends the IP address for one to which the vFoglight Client

(SPID) cannot connect.

To determine if the second problem is occurring, check the IP address shown in the error message described above. If the IP address shown in this message is different from the one set for the server in

<spid_home>\Foglight_SPID\spid\<version>\cache\SPINetwork\SPINetwork\0\

ORBInitRefs.xml on the vFoglight Client (SPID) machine, then the second problem is occurring.

The following workarounds are available for this problem:

120 vFoglight

Installation and Setup Guide

• In the file <foglight_home>\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.

• Stop the vFoglight Management Server and restart it with the following option:

--host=<ip_address>

Can problems arise as a result of time differences between the machine hosting the vFoglight Client (SPID) and the machine hosting the vFoglight Management Server?

Yes. If there is a difference between the time on the machine hosting the vFoglight

Management Server and the machine hosting the Foglight Client, then the Management

Server discards all of the observed values for this Foglight Client.

The following are examples of problems that may arise as a result of time differences:

• If the Daylight Savings Time patch is not applied on the Foglight Client machine but the time is moved ahead manually, the vFoglight Management Server discards the data sent to it by the Foglight Client.

• If the Daylight Savings Time patch is applied after the Foglight Client is installed, the vFoglight Management Server discards the data sent to it by the Foglight

Client.

Index

A

about vFoglight

14

administration administrator default account

32

default user name and password

Agents installing

110

32

B

bin directory

69

C

cartridge directory

70

cartridges installing

88

client directory 69

Components for Download dashboard

config directory 69

configuring vFoglight Agent Manager

104

93

D

database initializing

81

deploying vFoglight Agent Manager cartridge directories installed directories

69

documentation cartridge

16

core

15

feedback

16

suite 15

documentation directory

69

downloading vFoglight Agent Manager installer dtd directory

69

92

93

H

how to access

the Cartridge Manager

install a cartridge

88

88

122 Foglight

Installation and Setup Guide

I

installation modes

65

recommendations requirements

SPI firewall

32

118

11

SPID from a cartridge

installed directories 69

bin

69

cartridge client config

69

69

70

docs

dtd

69

69

jre lib

69

69, 70 logs mysql

69

69

scripts

server

support

70

70

70

installers

116

downloading the vFoglight Agent Manager installer

93

installing

SPID

116

vFoglight Agent Manager installing cartridges

88

91, 92, 94

J

JAR files directory

JRE directory

69

69

L

lib directory licensing

10

69, 70

log files directory

69

logging in to vFoglight

84

M

Management Server

mysql files directory

9

69

P

password, administrator

perl files directory

70

platform support

32

vFoglight Agent Manager

properties file 65

108

R

recommendations for installing vFoglight remote agent installation running vFoglight Agent Manager running vFoglight

79

11

111

91

S

scripts directory

70

server starting

stopping

81

83

server directory 70

silent installation mode

SPID installing

116

starting the server

stopping the server

81

83

support directory 70

65

T

text conventions

17

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

downloading the installer

92

93

installer installing

94

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

Windows service, from the command line service, installing vFoglight as a

82

81

Index

123

advertisement

Related manuals

advertisement

Table of contents