Dell Vizioncore Command Line Reference Guide
vFoglight™ 5.2.4
Command-Line Reference Guide
© 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: legal@quest.com
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
Command-Line Reference Guide
March 2009
Version 5.2.4
Table of Contents
Introduction to this Guide...................................................................................................................................7
About vFoglight ................................................................................................................................................................ 8
About this Guide............................................................................................................................................................... 8
vFoglight Documentation Suite ........................................................................................................................................ 9
Core Documentation Set......................................................................................................................................... 9
Cartridge Documentation Sets .............................................................................................................................. 10
Feedback on the Documentation........................................................................................................................... 10
Text Conventions........................................................................................................................................................... 11
About Vizioncore Inc. ..................................................................................................................................................... 11
Contacting Dell............................................................................................................................................................... 14
About the Command-Line Interface.................................................................................................................27
About Syntax Conventions............................................................................................................................................. 28
Looking at vFoglight Commands.................................................................................................................................... 28
Getting Started with vFoglight Commands..................................................................................................................... 32
Managing the vFoglight Management Server..................................................................................................35
Getting Started with Server Commands......................................................................................................................... 36
Running the vFoglight Management Server................................................................................................................... 37
Running the Server in Stand-Alone Mode............................................................................................................. 38
fms................................................................................................................................................................ 38
Running the vFoglight Management Server in High Availability Mode.................................................................. 41
fmsha............................................................................................................................................................ 41
remotemonitor............................................................................................................................................... 44
Starting, Stopping, or Upgrading the Database.............................................................................................................. 47
Starting the Embedded Database ......................................................................................................................... 47
runDB............................................................................................................................................................ 47
4 vFoglight
Command-Line Reference Guide
Stopping the Embedded Database........................................................................................................................47
shutdownDB..................................................................................................................................................47
Upgrading the Database........................................................................................................................................48
foglight_db_upgrade .....................................................................................................................................48
Managing Passwords ............................ ....... .......................................................................... ........................................49
Managing Encryption Keys............................................................................ ....... ...... ....... ....................................49
keyman..........................................................................................................................................................49
Managing Cartridges and Metrics.................................................................................................................... 53
Using the Command Line for Administration Tasks........................................................................................................54
Understanding the Command-Line Structure ........................................................................................................54
About Regular Expressions ...................................................................................................................................56
Getting Started with Administrative Commands ....................................................................................................64
Running Administrative Commands: Example.......................................................................................................65
Looking at Scope-Specific Commands..................................................................................................................66
Listing Administrative Commands.................................................................................................................69
Logging In and Setting the Scope...................................................................................................................................70
fglcmd............................................................................................................................................................70
Managing Agents............................................................. ...............................................................................................72
Listing Agent and Agent Manager Instances .........................................................................................................73
clients............................................................................................................................................................73
list..................................................................................................................................................................75
packages.......................................................................................................................................................78
types..............................................................................................................................................................82
Upgrading the vFoglight Agent Manager...............................................................................................................84
clientupgrade.................................................................................................................................................84
Deploying Agent Packages....................................................................................................................................86
deploy............................................................................................................................................................86
Creating or Deleting Agent Instances....................................................................................................................91
create............................................................................................................................................................91
delete ............................................................................................................................................................95
Activating or Deactivating Agent Instances............................................................................................................99
activate..........................................................................................................................................................99
deactivate....................................................................................................................................................104
Starting or Stopping Data Collection....................................................................................................................108
Table of Contents 5
start..............................................................................................................................................................108
stop..............................................................................................................................................................112
Listing and Retrieving Log Files...........................................................................................................................116
logs..............................................................................................................................................................116
getlog...........................................................................................................................................................118
Listing and Setting Blackout Schedules...............................................................................................................120
showschedule..............................................................................................................................................120
setschedule .................................................................................................................................................124
Managing Cartridges.....................................................................................................................................................128
Installing or Uninstalling Cartridges......................................................................................................................128
install ...........................................................................................................................................................128
uninstall .......................................................................................................................................................129
Enabling or Disabling Cartridges..........................................................................................................................130
disable.........................................................................................................................................................131
enable..........................................................................................................................................................132
Listing Cartridges .................................................................................................................................................133
list................................................................................................................................................................133
Managing Security Entities............................................................................................................................................135
Managing Users...................................................................................................................................................135
assigngroup.................................................................................................................................................135
createuser....................................................................................................................................................137
deleteuser....................................................................................................................................................138
Managing Groups.................................................................................................................................................139
assignrole....................................................................................................................................................139
creategroup .................................................................................................................................................140
deletegroup..................................................................................................................................................141
Managing vFoglight Licenses........................................................................................................................................142
Adding, Removing, or Listing Licenses................................................................................................................142
import...........................................................................................................................................................142
list................................................................................................................................................................143
remove.........................................................................................................................................................144
Running Utility Commands............................................................................................................................................145
Exporting or Importing a Monitoring Policy...........................................................................................................145
configexport.................................................................................................................................................145
configimport.................................................................................................................................................146
6 vFoglight
Command-Line Reference Guide
Exporting, Importing, or Listing UI Modules.........................................................................................................147
uilist.............................................................................................................................................................147
uiexport .......................................................................................................................................................149
uiimport .......................................................................................................................................................150
Exporting Metrics and Topology ..........................................................................................................................151
metricexport ................................................................................................................................................151
topologyexport.............................................................................................................................................154
Looking Up Server Parameters............................................................................................................................157
env ..............................................................................................................................................................157
Assigning Blackouts.............................................................................................................................................157
blackoutobject.............................................................................................................................................157
Listing Schedules.................................................................................................................................................159
list................................................................................................................................................................159
Running Scripts....................................................................................................................................................162
run...............................................................................................................................................................162
Creating a Server Support Bundle.......................................................................................................................162
bundle .........................................................................................................................................................162
Appendix: Command-Line Interface to the vFoglight Client....................................................................... 165
About the Command-Line Interface..............................................................................................................................166
vFoglight Client Commands.................................................................................... ......................................................166
Getting Started with vFoglight Client Commands ................................................................................................166
Using vFoglight Client Commands.......................................................................................................................167
spid..............................................................................................................................................................167
support_bundle ...........................................................................................................................................170
vFoglight Management Server Commands...................................................... ...... ....... ...............................................171
Getting Started with Server Commands.......................................................................................................................172
Administrative Commands............................................................................................................................................172
Index................................................................................................................................................................. 177
Introduction to this Guide
This chapter provides information about what is contained in the vFoglight Command
Line Reference Guide. It also provides information about the vFoglight documentation
suite and Vizioncore.
This chapter contains the following sections:
About vFoglight..............................................................................................................................8
About this Guide............................................................................................................................8
vFoglight Documentation Suite......................................................................................................9
Text Conventions.........................................................................................................................11
About Vizioncore Inc....................................................................................................................11
8 vFoglight Cartridge for VMware
Command Line Reference Guide
About vFoglight
vFoglight helps IT organizations understand the virtual infrastructure by managing the
relationships and interaction between all the components in the environment, includ ing
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 Command Line Reference Guide provides information about the vFoglight
command-line interface. You can use vFoglight commands to interface with different
components of your monitoring environment instead of the browser interface.
This guide is intended for vFoglight System Administrators who want to use the
vFoglight commands.
The Command Line Reference Guide is organized as follows:
Chapter 1, About the Command-Line Interface—Explains the command-line
syntax, lists vFoglight commands and introduces the command-line interface using a
getting started approach. Read this chapter to get an overview of vFoglight commands
and how to get started.
Chapter 2, Managing the vFoglight Management Server—Describes the commands
that allow you to perform server-related operations through the command-line interface
and provides detailed instructions on how to get started with those commands. It
provides reference information on server-related commands along with usage examples.
Use the server-related commands to perform a variety of tasks such as starting or
stopping the vFoglight Management Server, upgrading the database, or managing
encryption keys.
Chapter 3, chapterChapter 3, Managing Agents, Cartridges and Metrics—Provides
information about the fglcmd interface that contains commands for managing common
vFoglight entities such as agents, cartridges and metrics. It also explains the fglcmd
syntax and contains additional getting started instructions that show you how to
configure your environment. Use this chapter to find reference information about the
fglcmd commands and usage examples.
Appendix A, vFoglight Client Commands—Describes the commands that allow you
to access the vFoglight Client through the command-line interface along with
instructions on how to configure your environment to obtain access to the commands
that allow you to start or stop the vFoglight Client display version information, or
manage JVM options. Use this chapter to find reference information on the commands
for managing the vFoglight Client along with usage examples.
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.
Introduction to this Guide 9
vFoglight Documentation Suite
•
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:
10 vFoglight Cartridge for VMware
Command Line Reference Guide
• Release Notes (HTML)
• 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
• Command-Line Reference Guide (PDF and online help)
• Web Component Gui d e (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:
info@vizioncore.com
Please do not submit Technical Support related issues to this email address.
Text Conventions
The following table summarizes how text styles are used in this guide:
Convention Description
Introduction to this Guide 11
Text Conventions
Code
Variables
Interface Bold text is used for interface options that you select (such as
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.
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.
menu items) as well as keyboard commands.
Italic text is used to highlight the following items:
• Pathnames, file names, and programs
• The names of other documents referenced in this guide
12 vFoglight Cartridge for VMware
Command Line Reference Guide
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.
Introduction to this Guide 13
About Vizioncore Inc.
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
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
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
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
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
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
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
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
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
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
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)
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
0
About the Command-Line Interface
This manual describes the commands that come with your vFoglight installation and
allow you to access different components in your monitoring environment without
having to use the standard graphical interface such as the Administration dashboards.
This can be useful in situations when you need to either automate your business logic by
writing scripts, or use regular expressions to select multiple entities where applicable.
This chapter contains the following sections:
About Syntax Conventions..........................................................................................................28
Looking at vFoglight Commands.................................................................................................28
Getting Started with vFoglight Commands..................................................................................32
28 vFoglight
Command-Line Reference Guide
About Syntax Conventions
This manual employs a set of conventions that are used in the command syntax. Y o u
should review them before getting started with the manual in order to successfully make
use of vFoglight commands in your monitoring environment. The syntax conventions
are as follows:
• <vfoglight_home> is a placeholder that represents the path to the vFoglight
Management Server installation.
• Unless otherwise specified, vFoglight commands are not case-sensitive.
Looking at vFoglight Commands
vFoglight provides a number of commands that you can use to manage different
components in your monitoring environment. The commands reside in the following
directories of your vFoglight Management Server installation.
vFoglight Management Server
• <vfoglight_home>/bin: Contains commands that manage the vFoglight
Management Server and administer agents, cartridges, metrics, and other entities.
For more information about these commands, see “Managing the vFoglight
Management Server” on page 35 and “Managing Cartridges and Metrics” on
page 53.
• <vfoglight_home>/tools: Contains the Remote Monitor utility as well as the
administrative commands in ZIP files. For mo re in formation about the Remote
Monitor, see the vFoglight Installation and Setup Guide; for information on the
Remote Monitor command syntax, see “remotemonitor” on page 44.
If required, you can extract these commands to a remote computer in your
network and issue them from there. For more information, see “Getting Started
with Server Commands” on page 36 and “Getting Started with Administrative
Commands” on page 64.
For more information about the <vfoglight_home>, see “About Syntax Conventions” on
page 28.
The following table lists vFoglight commands.
Component
About the Command-Line Interface 29
Looking at vFoglight Commands
Domain
Command
Description
fms Provides command-line interface to the
vFoglight Management Server process
fmsha Provides command-line interface to the
Server
vFoglight Management Server process
running in High Availability (HA) mode
foglight_db_upgrade Verifies the database version and upgrades it
to a higher version if necessary
runDB Starts the embedded database
Database
shutdownDB Stops the embedded database
vFoglight Management Server
keyman Provides an interface that lets you change,
add, or delete encryption keys, or generate
application tokens
Authentication
30 vFoglight
Command-Line Reference Guide
Component
Domain
Command
Description
activate Activates one or more vFoglight agent
instances
clients Shows a list of vFoglight client instances
clientupgrade Upgrades one or more remote instances of the
vFoglight Agent Manager
create Creates one or more vFoglight agent instances
deactivate Deactivates one or more vFoglight agents
delete Deletes one or more vFoglight agent instances
deploy Deploys one or more vFoglight agent
packages
getlog Retrieves a copy of an agent log file
list Shows a list of vFoglight agent instances
Agents
logs Shows a list of agent log files
Administrative Interface
packages Shows a list of available agent packages
setschedule Assigns a blackout schedule to one or more
showschedule Shows the blackout schedule assigned to one
start Starts the data collection for one or more
stop Stops the data collection for one or more
types Shows a list of vFoglight agent types sorted by
vFoglight agent instances
or more vFoglight agent instances.
vFoglight agent instances
vFoglight agent instances
client ID
Loading...