Page 1
Installing on Windows with an Embedded
MySQL Database
Page 2
© 2008 Vizioncore, 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 Vizioncore, Inc.
If you have any questions regarding your potential use of this material, contact:
Vizioncore, Inc
975 Weiland Ave
Buffalo Grove, IL 60089
www.vizioncore.com
email: info@vizioncore.com
Refer to our Web site for regional and international office information.
Trademarks
Vizioncore, the Vizioncore logo, and vFoglight are trademarks and registered trademarks of
Vizioncore, 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.
Third Party Contributions
For a list of third-party components and licenses, see Appendix: License Credits.
Disclaimer
The information in this document is provided in connection with Vizioncore 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 Vizioncore products. EXCEPT AS SET FORTH IN
VIZIONCORE'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR
THIS PRODUCT, VIZIONCORE 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 VIZIONCORE 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 VIZIONCORE HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES. Vizioncore 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. Vizioncore does
not make any commitment to update the information contained in this document.
Installation and Setup Guide - Installing on Windows with an Embed ded MySQL
Database
September 2008
Version 3.0.1
Page 3
Table of Contents
Introduction to this Guide...................................................................................................................................5
About vFoglight ................................................................................................................................................................ 6
About this Guide............................................................................................................................................................... 6
vFoglight Documentation Suite ........................................................................................................................................ 6
Core Documentation Set......................................................................................................................................... 7
Cartridge Documentation Sets ................................................................................................................................ 8
Feedback on the Documentation............................................................................................................................. 8
Text Conventions..................................................................................................................................................... 8
About Vizioncore Inc. ....................................................................................................................................................... 9
Contacting Dell...................................................................................................................................................10
Before Installing vFoglight................................................................................................................................23
What is vFoglight?.......................................................................................................................................................... 24
Planning Your Installation or Upgrade............................................................................................................................ 25
Using Embedded Databases................................................................................................................................. 26
Licensing ............................................................................................................................................................... 27
Hardware Requirements and Guidelines ....................................................................................................................... 28
Installation Recommendations .............................................................................................................................. 28
Hardware Requirements........................................................................................................................................ 28
Installing vFoglight............................................................................................................................................29
Preparing to Install ........................................ ................................................................................................................. 30
Installing a New Version of the vFoglight Management Server...................................................................................... 30
Installing the vFoglight Management Server - Standard Install Option ................................................................. 31
Next Steps............................... ...... ....... ......................................................................... ........................................ 43
Installing the vFoglight Management Server - Custom Install Option.................................................................... 44
Page 4
4 vFoglight
Installation and Setup Guide
Next Steps .............................................................................................................................................................60
Upgrading the vFoglight Management Server................................................................................................................61
Installed Directories........................................................................................................................................................61
vFoglight Settings......................................................................... ....... ...... .....................................................................63
Editing the foglight.config File................................................................................................................................63
Setting Memory Parameters for the Server ..........................................................................................................63
Setting the SQL Parser Properties.............................................................................................. ...........................64
Configuring vFoglight to Access the Server Only Through The HTTPS Port ........................................................64
Setting Up an Encrypted Database Connection with SSL .....................................................................................66
Setting Up an Encrypted LDAP Connection with SSL ...........................................................................................67
Uninstalling vFoglight......................................................................................................................................................67
Running the vFoglight Management Server................................................................................................... 69
Before You Begin............................................................................................................................................................70
Migrating Data from an Existing Database.....................................................................................................................70
Initializing the Database..................................................................................................................................................71
Starting and Stopping the vFoglight Management Server..............................................................................................71
Starting the vFoglight Management Server as a Windows Service.......................................................................71
Stopping the Server...............................................................................................................................................72
Logging in to the vFoglight Browser Interface ................................................................................................................73
Running the vFoglight Management Server FAQ...........................................................................................................74
Appendix A: Switching from an Embedded to an External Database.......................................................... 75
Converting to an External Database...............................................................................................................................76
Page 5
Introduction to this Guide
This chapter provides information about what is contained in the Installation and
Setup Guide. This guide provides you with detailed instructions for installing the
vFoglight Management Server in a Windows environment with an embedded MySQL
database. It also provides information about the vFoglight documentation suite and
Vizioncore.
This chapter contains the following sections:
About vFoglight..............................................................................................................................6
About this Guide............................................................................................................................6
vFoglight Documentation Suite......................................................................................................6
Text Conventions...........................................................................................................................8
About Vizioncore Inc......................................................................................................................9
Page 6
6 vFoglight
Installation and Setup Guide
About vFoglight
vFoglight is an application management solution that reduces or eliminates service
disruptions to unify IT and the business. Unlike other solutions, it provides a correlated,
360 degree view of your applications from end user to database and from service levels
to infrastructure—to source the root cause of every incident impacting your business
and fix them quickly. vFoglight correlates data from multiple perspectives into a single
version of the truth to provide deep insight into the service relationships that exist
between end users, the business and infrastructure components. Its unique adaptive
technology rapidly adjusts to change for improved application performance and service
levels, reduced operational cost and risk, and enhanced visibility for all stakeholders.
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 . F or 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.
Appendix A, Switching from an Embedded to an External Database— This
appendix describes how to migrate and reconfigure an embedded database used with the
vFoglight Management Server to an external database.
vFoglight Documentation Suite
The vFoglight documentation suite is made up of the core documentation set plus
documents set for advanced configurations. Documentation is provided in a
combination of online help and PDF.
Page 7
Introduction to this Guide 7
vFoglight Documentation Suite
• Online Help: You can open online help by selecting the Help tab in the action
panel.
•
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.
Core Documentation Set
The core documentation set consists of the following:
• Release Notes (PDF)
• Getting Started Guide (PDF)
• What’s New Guide (PDF)
• System Requirements and Platform Support Guide (PDF)
• 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 (all in PDF format):
• 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)
Page 8
8 vFoglight
Installation and Setup Guide
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, a Reference Guide, an Installation Guide, or the
online help as a User 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:
info@vizioncore.com
Please do not submit Technical Support related issues to this email address.
Text Conventions
This section outlines an approach for using this guide, reviews the text conventions that
are used, and summarizes the rest of the documentation set.
The following table summarizes how text styles are used in this guide:
Convention Description
Code
Variables
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.
Page 9
Introduction to this Guide 9
About Vizioncore Inc.
Convention Description
Interface Bold text is used for interface options that you select (such as
menu items) as well as keyboard commands.
Files, components,
and documents
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.
Italic text is used to highlight the following items:
• Pathnames, file names, and programs
• Figure captions
• The names of other documents referenced in this guide
Page 10
Contacting Dell
Note: If you do not have an active Internet connection, you can find contact information on your purchase invoice,
packing slip, bill, or Dell product catalog.
Dell provides several online and telephone-based support and service options. Availability varies by country and
product, and some services may not be available in your area. To contact Dell for sales, technical support, or customer
service issues:
1
Visit http://support.dell.com.
2
Verify your country or region in the Choose A Country/Region drop-down menu at the bottom of the page.
3
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
Select the appropriate service or support link based on your need.
5
Choose the method of contacting Dell that is convenient for you.
Country (City)
International Access
Code
Country Code
City Code
Anguilla
Antigua and Barbuda
Aomen
Argentina (Buenos Aires)
International Access
Code: 00
Country Code: 54
City Code: 11
Aruba
Australia (Sydney)
International Access
Code: 0011
Country Code: 61
City Code: 2
Service Type Area Codes,
Web Address
E-Mail Address
Technical Support., Customer Service, Sales
Web Address
E-Mail Address
Technical Support., Customer Service, Sales
Technical Support
™
Dimension™, Dell Inspirion™, Dell
Dell
Optiplex
Precision
™
, Dell Lattitude™, and Dell
™
Servers and Storage
Web Address
E-Mail Address for Desktop/ Portable Computers
E-Mail Address for Servers and EMC
®
Storage
Products
Customer Service
Technical Support
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
Local Numbers, and
Toll-Free Numbers
Web and E-Mail Addresses
www.Dell.com/ai
la‐techsupport@dell.com
toll-free: 800-335-0031
www.Dell.com.ag
la‐techsupport@dell.com
1-800-805-5924
0800-105
0800-105
www.dell.com.ar
la‐techsupport@dell.com
la_enterprise@dell.com
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‐techsupport@dell.com
toll-free: 800-1578
support.ap.dell.com
support.ap.dell.com/contactus
13DELL-133355
Page 11
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
Tech_support_central_europe@dell.com
Support.euro.dell.com
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‐techsupport@dell.com
toll-free: 1-866-874-3038
www.dell.com/bb
la‐techsupport@dell.com
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
la_techsupport@dell.com
toll-free: 800-10-0238
www.dell.com/br
BR_TechSupport@dell.com
0800 970 3355
51 2104 5470
51 2104 5480
0800 722 3498
Technical Support, Customer Service, Sales toll-free: 1-866-278-6820
Technical Support (Penang, Malaysia)
Customer Service (Penang, Malaysia)
Transaction Sales (Penang, Malaysia)
Online Order Status Web Address
www.dell.ca/ostatus
604 633 4966
604 633 4888
604 633 4955
AutoTech (automated Hardware and Warranty
Support)
Customer Service
Home/Home Office
Small Business
Medium/Large Business, Government, Education
Hardware Warranty Phone Support
Computers for Home/Home Office
Computers for Small/Medium/Large Business
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
Government
Printers, Projectors, Televisions, Handheld,
1-877-335-5767
Digital
Jukebox, and Wireless Sales
Home and Home Office Sales
Small Business
Medium/Large Business, Government
toll-free:1-800-999-3355
toll-free:1-800-387-5752
toll-free:1-800-387-5755
1 866 440 3355
Spare Parts and Extended Service
E-Mail Address
Technical Support, Customer Service, Sales
la‐techsupport@dell.com
1-877-262-5415
Page 12
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‐techsupport@dell.com
toll-free: 1230-020-4823
support.dell.com.cn
support.dell.com.cn/email
customer_cn@dell.com
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‐techsupport@dell.com
01-800-915-4755
www.dell.com/cr
la‐techsupport@dell.com
0800-012-0231
support.euro.dell.com
czech_dell@dell.com
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‐techsupport@dell.com
toll-free: 1-866-278-6821
Page 13
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‐techsupport@dell.com
1-800-156-1588
www.dell.com/ec
la‐techsupport@dell.com
toll-free: 999-119-877-655-3355
toll-free: 1800-999-119-877-655-3355
www.dell.com/sv
la‐techsupport@dell.com
800-6132
support@euro.dell.com
fi_support@dell.com
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
tech_support_central_europe@dell.com
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‐techsuppo@dell.com
toll-free: 1-866-540-3355
Page 14
Guatemala
Guyana
Hong Kong
International Access
Code: 001
Country Code: 852
India
Web Address
E-Mail Address
Technical Support, Customer Service, Sales
E-Mail Address
Technical Support, Customer Service, Sales
Web Address
Technical Support E-mail Address
Technical Support - Dimension and Inspiron
Technical Support - OptiPlex, Latitude, and Dell
Precision
Technical Support - Servers and Storage
Technical Support - Projectors, PDAs, Switches,
Routers, etc .
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
www.dell.com/gt
la‐techsupport@dell.com
1-800-999-0136
la‐techsupport@dell.com
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
india_support_desktop@dell.com
india_support_notebook@dell.com
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
Gold Support Only
E-mail Address
Phone Numbers
Customer Service
Home and Small Business
Large Corporate Accounts
Sales
Large Corporate Accounts
Home and Small Business
india_support_Server@dell.com
080-25068032 or 080-25068034 or
your city STD code + 60003355 or
toll-free: 1-800-425-8045
eec_ap@dell.com
080-25068033 or your city STD code +
60003355 or
toll-free: 1-800-425-9045
India_care_HSB@dell.com
toll-free : 1800-4254051
India_care_REL@dell.com
toll free : 1800-4252067
1600 33 8044
1600 33 8046
Page 15
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
dell_direct_support@dell.com
1850 543 543
1850 543 543
1850 200 889
1850 333 200
1850 664 656
1850 200 646
1850 200 646
Dell_IRL_Outlet@dell.com
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
la-techsupport@dell.com
1-800-440-920
Page 16
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
T echnical 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
Page 17
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
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
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
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‐techsupport@dell.com
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‐techsupport@dell.com
Toll-free: 1-866-278-6822
la‐techsupport@dell.com
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
www.dell.com/ni
la‐techsupport@dell.com
001-800-220-1377
Support.euro.dell.com
671 16882
671 17575
231 62298
671 16800
671 16865
www.dell.com/pa
la‐techsupport@dell.com
011-800-507-1264
www.dell.com/pe
la‐techsupport@dell.com
0800-50-669
Page 18
Poland (Warsaw)
International Access
Code: 011
Country Code: 48
City Code: 22
Portugal
International Access
Code: 00
Country Code: 351
Puerto Rico
St. Kitts and Nevis
St. Lucia
St. Vincent and the
Grenadines
Singapore
International Access
Code: 005
Country Code: 65
Slovakia (Prague)
International Access
Code: 00
Country Code: 421
South Africa
(Johannesburg)
International Access
Code: 09/091
Country Code: 27
City Code: 11
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
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)
Web Address
E-mail Address
Gold Queue
Technical Support
Customer Service
Sales
support.euro.dell.com
pl_support_tech@dell.com
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‐techsupport@dell.com
1-877-537-3355
www.dell.com/kn
la‐techsupport@dell.com
toll-free: 1-866-540-3355
www.dell.com/lc
la‐techsupport@dell.com
toll-free: 1-866-464-4352
www.dell.com/vc
la‐techsupport@dell.com
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
czech_dell@dell.com
02 5441 5727
420 22537 2707
02 5441 8328
02 5441 8328
02 5441 8328
02 5441 7585
support.euro.dell.com
dell_za_suppor@dell.com
011 709 7713
011 709 7710
011 709 7707
011 709 7700
Page 19
Spain (Madrid)
International Access
Code: 00
Country Code: 34
City Code: 91
Sweden (Upplands
Vasby)
International Access
Code: 00
Country Code: 46
City Code: 8
Switzerland (Geneva)
International Access
Code: 00
Country Code: 41
City Code: 22
Taiwan
International Access
Code: 002
Country Code: 886
Thailand
International Access
Code: 001
Country Code: 66
Trinidad/Tobago
Turks and Caicos Islands
Web Address
Home and Small Business
Technical Support
Customer Service
Sales
Switchboard
Fax
Corporate
Technical Support
Customer Service
Switchboard
Fax
Web Address
Technical Support
Relational Customer Service
Home/Small Business Customer Service
Employee Purchase Program (EPP) Support
Technical Support Fax
Web Address
E-mail Address
Technical Support – Home and Small Business
Technical Support – Corporate
Customer Service – Home and Small Business
Customer Service – Corporate
Fax
Switchboard
Web Address
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
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
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
Tech_support_central_Europe@dell.com
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‐techsupport@dell.com
toll-free: 1-888-799-5908
www.dell.com/tc
la‐techsupport@dell.com
toll-free: 1-877-441-4735
Page 20
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
dell_direct_support@dell.com
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‐techsupport@dell.com
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)
Page 21
U.S. Virgin Islands
Venezuela
Web Address
E-mail Address
Technical Support, Customer Service, Sales
Web Address
E-mail Address
Technical Support, Customer Service, Sales
www.dell.com/vi
la‐techsupport@dell.com
toll‐free:1‐877‐702‐4360
www.dell.com/ve
la‐techsupport@dell.com
0800‐100‐4752
Page 22
Page 23
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?.......................................................................................................................24
Planning Your Installation or Upgrade.........................................................................................25
Hardware Requirements and Guidelines.....................................................................................28
1
Page 24
24 vFoglight
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 efficiency.
• Identify and bridge gaps between business and information technology staff.
• Highlight historical information for planning and reporting.
Page 25
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
Before Installing vFoglight 25
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 3.0.1) and configure the Management Server. The Management Server is the
data collection and processing server.
Step 2 : Install the database (or upg rade it, if you are upgrading your Management
Server installation to version 3.0.1) and configure the database. You can choose to use
an embedded database or an external database. The instructions in this guide are for
external database installations only.
Step 3 : Install and configure the VMware cartridge. A cartrid ge 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.
Note The VMware cartridge is installed automatically with vFoglight, but can be upgraded
separately from the application.
Page 26
26 vFoglight
Installation and Setup Guide
Step 4: Install and configure Agents. Agents are deployed on VirtualCenters in your
monitored environment and send data to the vFoglight Management Server. If your
environment includes only one VirtualCenter, the installation of the VMware
Infrastructure Agent is automated by the vFoglight installer. If your environment
includes multiple VirtualCenters, the installation of the first VMware Infrastructure
Agent will be automated, but the remaing agents must be installed manually.
Using Embedded Databases
vFoglight offers the option to use MySQL (5.0.27) 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.
Page 27
Before Installing vFoglight 27
Planning Your Installation or Upgrade
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 9: Add vFoglight
License File” on page 52 in Installing vFoglight.
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 <
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.
vfoglight_home
>\license folder.
2
Ensure that
3
If you have not already done so, extract the file fglcmd.zip in
<
vfoglight_home
4
Upload a license by navigating to <
JAVA_HOME
>\tools.
is set.
vfoglight_home
>\tools and entering the
following commands:
fglcmd -usr <username> -pwd <password> -cmd license:import -f <l icense-file>
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>
Page 28
28 vFoglight
Installation and Setup Guide
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 Vizioncore Sales 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.
Hardware Requirements
For the current single- and multi-tier hardware requirements, consult the vFoglight
System Requirements and Platform Support Guide.
Page 29
Installing vFoglight
The vFoglight 3.0.1 installer allows you either to install a new instance of the vFoglight
Management Server or to upgrade an existing installation of a vFoglight 3.x vFoglight
Service Manager.
This chapter contains the following sections:
Preparing to Install.......................................................................................................................30
Installing a New Version of the vFoglight Management Server...................................................30
Installing the vFoglight Management Server - Standard Install Option.......................................31
Installing the vFoglight Management Server - Custom Install Option..........................................44
Upgrading the vFoglight Management Server.............................................................................61
Installed Directories.....................................................................................................................61
2
vFoglight Settings........................................................................................................................63
Uninstalling vFoglight..................................................................................................................67
Note The vFoglight Management Server should be installed on a dedicated physical machine.
Page 30
30 vFoglight
Installation and Setup Guide
Preparing to Install
You will need the following to install vFoglight:
• A machine to host the vFoglight Management Server. The vFoglight Service
Manager should run on a dedicated machine because it must process and store
large volumes of data.
• Administrator or root access to all machines requiring a vFoglight agent.
• An administrator password for vFogli ght. The user name vfoglight and the default
password for this account can initially be used to log in to the consoles 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 31.
• 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 44.
The vFoglight installation process consists of the same basic steps for all platforms. For
specific platform customizations, see “Installed Directories” on page 61.
Page 31
Installing vFoglight 31
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.
Page 32
32 vFoglight
Installation and Setup Guide
Step 2: License Agreement
1
Read through 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.
Page 33
Installing a New Version of the vFoglight Management Server
Step 3: Select Installation
1
Choose the Typical Install option.
Installing vFoglight 33
2
Click Next.
Page 34
34 vFoglight
Installation and Setup Guide
Step 4: Installing vFoglight 3.0.1
1
Choose the location where you want to install vFoglight. You can accept the
default location C:\Vizioncore\vFoglight or click the Browse button to navigate to
another location.
2
Image 2
Click Next.
Page 35
Installing a New Version of the vFoglight Management Server
.Step 5: Install Complete
1
Click Done to complete the installation process.
Image 3
Installing vFoglight 35
Page 36
36 vFoglight
Installation and Setup Guide
Step 6: Add vFoglight License File
1
2
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.
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.
The Typical Installation prodedure now takes you through the installation of the
vFoglight VMware Infrastructure Agent components.
Page 37
Installing vFoglight 37
Installing a New Version of the vFoglight Management Server
Step 7: 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.
Page 38
38 vFoglight
Installation and Setup Guide
Step 8: License Agreement
1
Read through the VMware Infrastructure Agent License Agreement statement,
and accept or decline the terms.
2
If you selected I accept the terms in the License Agreement, click Next.
Page 39
Installing vFoglight 39
Installing a New Version of the vFoglight Management Server
Step 9: 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.
2
Click Next.
Page 40
40 vFoglight
Installation and Setup Guide
Step 10: VMware Infrastructure Agent Install Screen
The Agent Install screen is displayed. Click Install.
Page 41
Installing vFoglight 41
Installing a New Version of the vFoglight Management Server
Step 11: VirtualCenter Authentication
1
On the VirtualCenter Authentication Information screen, enter the VirtualCenter
Server name or IP Address.
2
Enter VirtualCenter Server Username and Password credentials that will provide
you with access to the VMware Virtual Infrastructure Client.
3
Click Save to have your entries validated.
4
On the Credentials Entered are Valid! dialog, click OK.
Page 42
42 vFoglight
Installation and Setup Guide
Step 12: vFoglight Server Destination
1
2
3
4
5
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.
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.
6
Click Save to have your entries validated.
Page 43
Installing vFoglight 43
Installing a New Version of the vFoglight Management Server
Step 13: InstallShield Wizard Completed
Click Finished to complete the VMware Infrastructure Agent components installation.
The services of the agent components start automatically after the installation is
complete.
Next Steps
If you did not install a license in Step 6, follow the instructions in “Managing a License
After Installation” on page 27 to provide a license file to the vFoglight Management
Server after installation.
If you need to import and initialize your database, refer to the procedures in “Migrating
Data from an Existing Database” on page 70.
Start the vFoglight Management Server by following the instructions in “Starting and
Stopping the vFoglight Management Server” on page 71.
T o log into the vFoglight Console, refer to “Logging in to the vFoglight Browser
Interface” on page 73.
Page 44
44 vFoglight
Installation and Setup Guide
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.
Page 45
Installing vFoglight 45
Installing a New Version of the vFoglight Management Server
Step 2: License Agreement
1
Read through the License Agreement statement, and accept or decline the terms
of the license agreement.
Image 4
2
If you selected I accept the terms of the License Agreement, click Next.
Page 46
46 vFoglight
Installation and Setup Guide
Step 3: Select Installation
1
Choose the Custom Install option.
2
Click Next.
Page 47
Installing vFoglight 47
Installing a New Version of the vFoglight Management Server
Step 4: Choose Install Folder
1
Choose the location where you want to install vFoglight. You can accept the
default location C:\Vizioncore\vFoglight or click the Browse button to navigate to
another location.
Image 5
2
Click Next.
Page 48
48 vFoglight
Installation and Setup Guide
Step 5: Pre-Installation Summary
1
2
Image 6
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 v.3.0.1, click Previous until you return to the Choose Install Folder screen.
Page 49
Installing a New Version of the vFoglight Management Server
Step 6: Installing vFoglight 3.0.1
vFoglight installs files into the specified directory.
Image 7
Installing vFoglight 49
Page 50
50 vFoglight
Installation and Setup Guide
Step 7: vFoglight Database Configuration
1
2
3
4
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 uses this account to store data in the database.
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 , retype the password for
verification.
From the vFoglight Database drop-down list, choose Embedded.
Embedded Database Installation
1
Accept the default port (13306) or enter an alternate Database Port.
2
In the DB Administrator Password field, accept the default password provided
(foglight) or enter an alternate one.
3
In the Retype DB Administrator Password field, accept the default (foglight)
or, if you have provided an alternate password , retype the password for
verification.
4
Click Next. A progress box appears as the embedded database is installed.
Page 51
Installing vFoglight 51
Installing a New Version of the vFoglight Management Server
Step 8: 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.
Page 52
52 vFoglight
Installation and Setup Guide
Step 9: Add vFoglight License File
1
2
Image 8
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.
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.
Page 53
Installing a New Version of the vFoglight Management Server
Step 10: Install Complete
Click Next to complete the installation process.
Image 9
Installing vFoglight 53
The Custom Installation prodedure now takes you through the installation of the
vFoglight VMware Infrastructure Agent components.
Page 54
54 vFoglight
Installation and Setup Guide
Step 11: InstallShield W izard 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.
Page 55
Installing vFoglight 55
Installing a New Version of the vFoglight Management Server
Step 12: License Agreement
1
Read through the VMware Infrastructure Agent License Agreement statement,
and accept or decline the terms.
2
If you selected I accept the terms in the License Agreement, click Next.
Page 56
56 vFoglight
Installation and Setup Guide
Step 13: 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.
2
Click Next.
Page 57
Installing vFoglight 57
Installing a New Version of the vFoglight Management Server
Step 14: VMware Infrastructure Agent Install Screen
The Agent Install screen is displayed. Click Install.
Page 58
58 vFoglight
Installation and Setup Guide
Step 15: 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.
3
Click Save to have your entries validated.
4
On the Credentials Entered are Valid! dialog, click OK.
Page 59
Installing vFoglight 59
Installing a New Version of the vFoglight Management Server
Step 16: vFoglightServer Destination
1
On the vFoglight Server Destination Information screen, enter the agent name as
you want it to be displayed in vFoglight.
2
Enter the vFoglight Server name or IP address. This is the name or IP of the
vFoglight Management Server.
3
Enter the port number of the port that the vFoglight Server uses for HTTP traffic.
The default is 8080.
4
If this port requires SSL, check the SSL check box.
5
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.
6
Click Save to have your entries validated.
Page 60
60 vFoglight
Installation and Setup Guide
Step 17: InstallShield Wizard Completed
Click Finished to complete the VMware Infrastructure Agent components installation
process.
The services of the agent components start automatically after the installation is
complete.
Next Steps
If you did not install a license in Step 9: Add vFoglight License File, follow the
instructions in “Managing a License After Installation” on page 27 to provide a license
file to the vFoglight Management Server after installation.
If you need to import and initialize your database, refer to the procedures in “Migrating
Data from an Existing Database” on page 70.
Start the vFoglight Management Server by following the instructions in “Starting and
Stopping the vFoglight Management Server” on page 71.
To log into the vFoglight Console, refer to “Logging in to the vFoglight Browser
Interface” on page 73.
Page 61
Installing vFoglight 61
Upgrading the vFoglight Management Server
Upgrading the vFoglight Management Server
Please consult the vFoglight 3.0.1 Upgrade Field Guide for detailed upgrade
instructions.
Installed Directories
The following table describes the directories that are installed under your target
installation folder. They may vary , depending on the product features that you select and
the components installed for your platform.
Directory Contents
bin vFoglight executables for running the server and utilities.
client Files used by client programs (such as the command line
client) for remote access to vFoglight.
config 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.
docs HTML and PDF versions of the product documentation.
dtd Descriptors for configuration files that can be imported into
vFoglight (for example, by installing a cartridge).
jre Version of the JRE (1.5.0_11-b03) used by vFoglight.
lib The vFoglight JARs.
logs Default location of the log files generated by vFoglight when
it runs.
Generated at runtime.
Page 62
62 vFoglight
Installation and Setup Guide
Directory Contents
mysql The current embedded database version is 5.0.27.
perl Libraries needed to interpret the PERL scripts, version 5.8.8.
scripts Supported and unsupported utility scripts to extend the
server JARs and data files used by a particular vFoglight server
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
scripting engine.
scripts/sql contains SQL scripts to drop, create-schema or
create/populate the database.
variant (such as default).
tools Various utilities such as the foglight-federation-support.sar
file.
Additional directories created after the vFoglight Management Server is started:
Directory Contents
cartridge Installed cartridge files in their original form.
support Where support bundled archive information is stored.
tmp\cartridge.exploded Unzipped contents of installed cartridges.
Unizpped at runtime.
Page 63
vFoglight Settings
vFoglight can be run with the defaul t settings. However, you can edit these settings if
you need to change runtime parameters such as ports used by the vFoglight Serv i ce
Manager. To do so, you can edit the file <vfoglight_home>/config/foglight.config,
which contains central settings.
Editing the foglight.config File
The foglight.config file contains parameters for port settings, virtual memory, command
line options, and server federation. You can edit the file using a text editor. Values
within quotation marks can be edited.
Setting Memory Parameters for the Server
If you are running vFoglight Management Server by running fms.exe, you can configure
the Java Virtual Machine’s minimum and maxi mum parameters for the server in the
<vfoglight_home>/config/foglight.config file.
Installing vFoglight 63
vFoglight Settings
If you are starting vFoglight using the
parameters set in the <vfoglight_home>/config/foglight.config file do not ta ke effect.
Use
-X
options to pass the memory parameters straight to the VM.
If your installation supports a large number (100s) of agents, Java heap memory sizes
should be set to the same minimum and maximum values. 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”;
You can set up to 100 VM options.
run.[bat|sh]
command, the JVM heap memory
Page 64
64 vFoglight
Installation and Setup Guide
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.
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< vfoglight_home>\config\foglight.config file. Set the following
parameter:
You will have to reboot the server after setting the parameter.
# qp5app port and info
foglight.qp5app.max.connections = "10";
foglight.qp5app.port = "8448";
foglight.console.httpsonly = "true";
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 will need to
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
)
Page 65
Installing vFoglight 65
vFoglight Settings
• 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:
$FMS_HOME/server/default/conf/
2
Delete the existing tomcat key from the tomcat.keystore directory using the
following command:
$FMS_HOME/jre/bin/keytool -keystore FMS_HOME/server/default/conf/
tomcat.keystore -storepass nitrogen -delete -alias tomcat
3
Create a new key under the tomcat alias using the following command:
$FMS_HOME/jre/bin/keytool -keystore FMS_HOME/server/default/conf/
tomcat.keystore -storepass nitrogen -genkey -alias tomcat
4
Generate a Certificate Signing Request (CSR) using the following command:
$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
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.
using
Page 66
66 vFoglight
Installation and Setup Guide
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
To set up an encrypted database connection with SSL:
1
2
3
4
vFoglight Management Server.
Import a CA certificate into the vFoglight Management Server keystore (cacerts)
as outlined in “Importing a Network Security Certificate” on page 64.
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>
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 un til the d atabase serv er's
CA certificate is properly imported into $fms_dir/jre/lib/security/cacerts.
foglight.database.secureconn = "true";
Start the vFoglight Management Server.
Page 67
Installing vFoglight 67
Uninstalling vFoglight
Setting Up an Encrypted LDAP Connection with SSL
Follow the directions below if you need to encrypt communication between the
vFoglight Management Server and the LDAP server.
To encrypt communication between vFoglight Management Server and LDAP:
1
Acquire the LDAP server certificate in .pem format from the administrator.
2
Import the certificate into the vFoglight Management Server keystore (
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>
3
Go to Administration > Users & Security > Configure Directory Services.
4
Click Edit.
5
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.
$FMS_HOME/
Uninstalling vFoglight
You can uninstall vFoglight using the uninstaller uti lit y for your platform. The
uninstaller can be found in <vfoglight_home>/UninstallerData.
Page 68
68 vFoglight
Installation and Setup Guide
Page 69
Running the vFoglight Management Server
This chapter contains the following sections:
Before You Begin.........................................................................................................................70
Migrating Data from an Existing Database..................................................................................70
Initializing the Database..............................................................................................................71
Starting and Stopping the vFoglight Management Server...........................................................71
Logging in to the vFoglight Browser Interface.............................................................................73
Running the vFoglight Management Server FAQ........................................................................74
3
Page 70
70 vFoglight
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 29 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
The -h parameter can be omitted if the database is on the same host.
2
Import the database using the following syntax:
mysql -<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 will be 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).
Page 71
Running the vFoglight Management Server 71
Initializing the Database
Initializing the Database
If you are using the embedded database, the initialization is performed when you start
vFoglight.
Starting and Stopping the vFoglight Management Server
The following sections describe how to start and stop the vFoglight Management
Server.
To start the vFoglight Service Manager from the command line:
• Execute the following command:
<vfoglight_home>\bin\fms.exe
To start the vFoglight Service Manager on Windows:
• Depending on where you installed the startup icon, choose Start > Programs >
Vizioncore > vFoglight > 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.
Using the Start Menu Options
To install or remove the vFoglight Service Manager service from the Start menu:
• Choose Start > Programs > Vizioncore > vFoglight > Windows Service >
Install Service for vFoglight (or Remove Service for vFoglight).
Page 72
72 vFoglight
Installation and Setup Guide
To start or stop the vFoglight Service Manager service from the Start menu:
• Choose S tart > Programs > V izioncor e> vFoglight > W indows Service > S tart
Using the Command Line
From the command line, type the following to install the vFoglight Management Server
as a Windows service:
Additional Commands:
Command Represents Description
-s start Start the vFoglight Management Server (this is
-q stop Stop the vFoglight Management Server
-b start-service Start the vFoglight Management Server Windows
Service for vFoglight (or Stop Service for vFoglight).
fms.exe -i
assumed if no command is specified)
service
-r removeservice
-n name Provide a unique name for this instance of the
-j jvm-argument Set an option to be passed directly to the Java
-v version Display the version number for this program and exit
-h help Show this information and exit
Stop and remove th e vFoglight Management Server
Windows service
vFoglight Management Server service
™ VM
(can be used to set more than one VM option)
Stopping the Server
To stop the vFoglight Management Server:
Do one of the following:
Page 73
Running the vFoglight Management Server 73
Logging in to the vFoglight Browser Interface
• Type Ctrl-C in the command window from which the vFoglight Service Manager
started.
• In the command line, type:
fms.exe -q
• Depending on where you installed the startup icon, choose Start > Programs >
Vizioncore> vFoglight > Stop vFoglight or double-click the Stop vFoglight
icon on the desktop.
When the server has stopped successfully, the Start vFoglight command window
closes.
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 > 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>
Server is installed and
default is
8080).
is the name of the machine where the vFoglight Management
<port>
is the http port specified during installation (the
Page 74
74 vFoglight
Installation and Setup Guide
Running the vFoglight Management Server FAQ
When I try to start the vFoglight Management Server using Remote Desktop, an error
appears. How can I resolve this error?
There are two options to resolve this problem.
• Use VMWARE Console to start the server.
• Change the JVM options by reducing the memory requirements of the vFoglight
Management Server so you can start it using Remote Desktop. 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
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.
2
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.
Page 75
4
Appendix A: Switching from an Embedded to an External Dat abase
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............................................................................................76
Page 76
76 vFoglight
Installation and Setup Guide
Converting to an External Database
This section describes how to migrate and reconfigure an embedded database used with
the vFoglight Management Server to an external database.
1
Stop the vFoglight Management Server.
2
Start the embedded database manually:
<vfoglight_home>/bin/runDb.sh
3
Export the database content:
<vfoglight_home>/mysql/bin/mysqldump -uroot --port=13306 -databases foglight > <fms_home>/foglight.dump
4
Shut down the database:
<vfoglight_home>/bin/shutdownDb.sh
5
Connect to the external MySQL instance via MySQL:
<vfoglight_home>/mysql/bin/mysql -h [mysql host] -P [mysql
port] -u root -p
6
Create the vFoglight database instance by running:
mysql> source
<vfoglight_home>\scripts\sql\mysql_create_db.sql
7
Re-import the data dump:
mysql> source <vfoglight_home>/foglight.dump
8
Configure the vFoglight Management Server to use this new database by opening
the following file:
<vfoglight_home>/config/foglight.config
9
Update the following values in the above file:
foglight.database.host = "[mysql host]";
foglight.database.port = "[mysql port]";
foglight.database.embedded = "false";
Page 77
Index 1
A
administration
administrator default account
default user name and password 30
Agents 26
B
bin directory 61
C
cartridge
documentation
cartridge directory 62
client directory 61
config directory 61
core 7
8
D
database
initializing
documentation 7
cartridge 8
documentation directory 61
dtd directory 61
71
30
logs 61
mysql 62
scripts 62
server 62
support 62
J
JAR files directory 61
JRE directory 61
L
lib directory 61, 62
licensing 27
log files directory 61
logging in
to the Administration Console
M
Management Server 25
mysql files directory 62
P
password, administrator 30
perl files directory 62
73
I
installation
recommendations
requirements 30
installed directories
bin
61
cartridge 62
client 61
config 61
docs 61
dtd 61
jre 61
lib 61, 62
28
R
recommendations
for installing vFoglight
running vCharter Pro 69
S
scripts directory 62
server
starting
stopping 72
server directory 62
starting the server 71
stopping the server 72
71
28
Page 78
2 vFoglight
Installation and Setup Guide
support 9
support directory 62
T
technical support 9
text conventions 8
U
uninstalling
vCharter Pro
user account
administrator
67
30
V
vCharter Pro
uninstalling
Vizioncore Software 9
67
W
Windows
service, from the command line
service, installing vCharter Pro as a 71
72
Loading...