Dell Vizioncore Manuel d'utilisateur Page 1

vFoglight™ 5.2.4 Administration and Configuration Guide

10 vFoglight Administration and Configuration Guide About vFoglightvFoglight helps IT organizations understand the virtual infrastructure by managing

100 vFoglight Administration and Configuration Guide 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44

Setting Up vFoglight 101Backing Up, Upgrading, and Restoring vFoglight Your embedded MySQL database is successfully backed up. For instructions on how

102 vFoglight Administration and Configuration Guide Restoring vFoglight“Restoring” a physical backup means reconstructing it and making it available

Setting Up vFoglight 103Backing Up, Upgrading, and Restoring vFoglight SQL> @ <foglight_home>/scripts/sql/oracle_drop_db.sqlNote The files or

104 vFoglight Administration and Configuration Guide SOURCE <path to .sql file>Note The “.sql” is the backup file you must create in order to r

3Managing Users and SecurityThis chapter introduces you to the concepts and terms related to managing security in vFoglight and looks into security-re

106 vFoglight Administration and Configuration Guide About Security in vFoglightIn vFoglight, user management consists of three related entities:• Us

Managing Users and Security 107Managing Users Figure 1Managing UsersThere are three types of users in vFoglight:• Internal. Internal users include the

108 vFoglight Administration and Configuration Guide Roles are assigned to a user through groups: when a user belongs to a group, the roles that are

Managing Users and Security 109Managing Users 2On the navigation panel, under Dashboards, choose Administration > Users & Security > Manage

Introduction to this Guide 11About this Guide cartridge-related concepts in vFoglight and to find out how to install and manage cartridges using the C

110 vFoglight Administration and Configuration Guide To clear the filters, click Clear Filters.The Manage Users list refreshes, showing the list of a

Managing Users and Security 111Managing Users •“Forcing Password Changes” on page 115•“Unlocking Passwords” on page 115•“Deleting Internal Users” on p

112 vFoglight Administration and Configuration Guide As you type the password into the Password and Confirm Password boxes, asterisk ‘*’ characters a

Managing Users and Security 113Managing Users To add a user to groups:Note This procedure continues from “Creating Users” on page 111.1In the Manage U

114 vFoglight Administration and Configuration Guide The Edit Groups dialog box closes and the Manage Users dashboard refreshes to show the groups th

Managing Users and Security 115Managing Users bClick OK.4The Change Password dialog box closes and vFoglight updates the user password in the database

116 vFoglight Administration and Configuration Guide using the Configure Password Settings dashboard. For more information, see “Editing Password Set

Managing Users and Security 117Managing Users Deleting Internal UsersUse the Delete button on the Manage Users dashboard to delete user accounts from

118 vFoglight Administration and Configuration Guide 3In the Confirm Delete dialog box, click OK.The dialog box closes and the Manage Users dashboard

Managing Users and Security 119Managing Groups For more information about configuring vFoglight to use an external directory service, see “Configuring

12 vFoglight Administration and Configuration Guide vFoglight Documentation SuiteThe vFoglight documentation suite is made up of the core documentati

120 vFoglight Administration and Configuration Guide 3To sort the list by name, users, role, or type, click the Name, Users, Roles, or Type column he

Managing Users and Security 121Managing Groups To clear the filters, click Clear Filters.The Manage Groups list refreshes, showing the list of all gro

122 vFoglight Administration and Configuration Guide •“Deleting Internal Groups” on page 126Creating GroupsUse the Create Group button on the Manage

Managing Users and Security 123Managing Groups Editing Users in GroupsUse the Edit Users button on the Manage Groups dashboard to quickly edit users i

124 vFoglight Administration and Configuration Guide • : The user account has been removed from or does not have access to this group.• : There is no

Managing Users and Security 125Managing Groups Note The dialog box lists existing vFoglight roles. If you previously added any roles, they also appear

126 vFoglight Administration and Configuration Guide Deleting Internal GroupsUse the Delete button on the Manage Groups dashboard to delete user acco

Managing Users and Security 127Managing Roles The message box closes and vFoglight deletes the user account.4Observe the Manage Groups dashboard.The u

128 vFoglight Administration and Configuration Guide the Schema Browser. This role is for users who design dashboards using these advanced dashboard

Managing Users and Security 129Managing Roles Accessing the Manage Roles DashboardThe Manage Roles dashboard contains a table that lists roles, their

Introduction to this Guide 13vFoglight Documentation Suite • Installation and Setup Guide set (all in PDF format):• Installation and Setup Guide—Insta

130 vFoglight Administration and Configuration Guide • Type: Type the type name for which you want to filter.For example, to list only the roles whos

Managing Users and Security 131Managing Roles From here, you can proceed to any of the following procedures:•“Creating Roles” on page 131•“Editing Gro

132 vFoglight Administration and Configuration Guide 2Specify the name of the role that you want to create.aIn the Create Role dialog box, in the Nam

Managing Users and Security 133Managing Roles Note The dialog box lists existing vFoglight groups. If you previously added any groups, they also appea

134 vFoglight Administration and Configuration Guide You can only delete those roles that you add to vFoglight after the installation. Their type app

Managing Users and Security 135Configuring Password Settings Configuring Password SettingsvFoglight automatically times out after 60 minutes of inacti

136 vFoglight Administration and Configuration Guide Accessing the Configure Password Settings DashboardThe Configure Password Settings dashboard con

Managing Users and Security 137Configuring Password Settings Editing Password SettingsUse the Configure Password Settings dashboard to edit any polici

138 vFoglight Administration and Configuration Guide • Minimum password length• Number of old passwords that will be remembered• Number of days befor

Managing Users and Security 139Configuring Directory Services To avoid compromising the password, users must insert an updated encrypted password.To c

14 vFoglight Administration and Configuration Guide Text ConventionsThe following table summarizes how text styles are used in this guide:About Vizio

140 vFoglight Administration and Configuration Guide You can track user login credentials using the Manage Users dashboard. This dashboard lists the

Managing Users and Security 141Configuring Directory Services From here, you can proceed to “Editing Directory Settings” on page 142.

142 vFoglight Administration and Configuration Guide Editing Directory SettingsDefault settings for these LDAP directory servers are different. The t

Managing Users and Security 143Configuring Directory Services The second group namespaceOU=Dynamic Groups,DC=MyCompany,DC=comN/AThe third group namesp

144 vFoglight Administration and Configuration Guide To edit directory settings:Note This procedure continues from “Accessing the Configure Directory

Managing Users and Security 145Configuring Directory Services 3In the Configure Directory Services dashboard, click the Edit button in the lower-left

146 vFoglight Administration and Configuration Guide

4Managing CartridgesThis chapter introduces you to vFoglight cartridges and provides information on how to install and manage cartridges. It contains

148 vFoglight Administration and Configuration Guide About vFoglight CartridgesA cartridge is a unit that is distributed separately from the vFogligh

Managing Cartridges 149Installing and Managing Cartridges See “Managing Agents” on page 165 for more information about agents.• Agent adapters. Agent

Introduction to this Guide 15About Vizioncore Inc.

150 vFoglight Administration and Configuration Guide Use the Cartridge Inventory dashboard to view information about installed cartridges, and to ins

Managing Cartridges 151Installing and Managing Cartridges 3View information about one or more cartridges.• Move the mouse pointer over the Cartridge N

152 vFoglight Administration and Configuration Guide or• To view cartridge information and any dependencies with other cartridges, click the Cartridg

Managing Cartridges 153Installing and Managing Cartridges 4To sort the list of cartridges, click any of the Status, Cartridge Name, or Version column

154 vFoglight Administration and Configuration Guide The Cartridge Inventory dashboard refreshes, showing the list of all cartridges.From here, you c

Managing Cartridges 155Installing and Managing Cartridges Installing CartridgesInstallation is the first step in adding a cartridge to the vFoglight M

156 vFoglight Administration and Configuration Guide For example, if the name of the CAR file is Virtual-VMware.car, and it resides in the <vfogli

Managing Cartridges 157Installing and Managing Cartridges The Status column contain icons that indicate if a cartridge is enabled , enabled pending d

158 vFoglight Administration and Configuration Guide 3In the Cartridge Inventory dashboard, observe the Status column of the cartridges that you enab

Managing Cartridges 159Installing and Managing Cartridges The Status column contain icons that indicate if a cartridge is enabled , enabled pending d

Contacting Dell Note: If you do not have an active Internet connection, you can find contact information on your purchase invoice, packing slip, bill,

160 vFoglight Administration and Configuration Guide A CAR file can contain multiple cartridges. When you remove all of the cartridges that come in a

Managing Cartridges 161Downloading Agent Components 3In the Cartridge Confirmation dialog box, click OK.The Cartridge Confirmation dialog box closes.

162 vFoglight Administration and Configuration Guide To download agent components:Note This procedure continues from “Getting Started with the Admini

Managing Cartridges 163Downloading Agent Components 5To sort the list of components, click any of the Name, Cartridge Name, Component Name, OS, Archit

164 vFoglight Administration and Configuration Guide To download an agent component:Note This procedure continues from “Accessing the Components for

5Managing AgentsThis chapter introduces you to vFoglight agents and provides information on how to install and manage them. It contains the following

166 vFoglight Administration and Configuration Guide About vFoglight AgentsA vFoglight agent monitors a specific part of your environment, such as a

Managing Agents 167Managing Agent Properties by Type Managing Agent Properties by TypeWhen an agent connects to the vFoglight Management Server, it is

168 vFoglight Administration and Configuration Guide • You want a set of default agent properties to use different lists at different times. For exam

Managing Agents 169Managing Agent Properties by Type Note For a sample screen capture of this dashboard in a monitoring environment that uses the vFog

Austria (Vienna)International Access Code: 900Country Code: 43City Code: 1Web AddressE-Mail AddressHome/Small Business SalesHome/Small Business FaxHom

170 vFoglight Administration and Configuration Guide 4Select an agent type.In the Agent Properties dashboard, in the Type pane, click an agent type.T

Managing Agents 171Managing Agent Properties by Type A primary property appears as a box or an option.For complete information about any agent propert

172 vFoglight Administration and Configuration Guide You can edit a primary property simply by specifying the desired value or option for the selecte

Managing Agents 173Managing Agent Properties by Type 3Click the Save button.The Agent pane refreshes.Cloning lists in secondary propertiesEach seconda

174 vFoglight Administration and Configuration Guide A dialog box appears.3In the dialog box, in the Clone name box, specify the name of the cloned l

Managing Agents 175Managing Agent Properties by Type Use this type of approach when you want to use different lists at different times, or to assign d

176 vFoglight Administration and Configuration Guide Note The appearance of the dialog box depends on the nature and complexity of the list entry.Not

Managing Agents 177Managing Agent Properties by Type cTo save your changes, click the Save button that appears in the dialog box.The dialog box closes

178 vFoglight Administration and Configuration Guide A message box appears, asking you to confirm the delete operation.3Click Remove in the message b

Managing Agents 179Assigning Blackouts to Agent Instances Assigning Blackouts to Agent InstancesA schedule defines a period of time during which an ac

Chile (Santiago)Country Code: 56City Code: 2Web AddressE-Mail AddressSales and Customer Supportwww.dell.com/clla‐[email protected]: 1230-0

180 vFoglight Administration and Configuration Guide 3To sort the list by their ID, host name, instance name, agent type, or schedule name, click the

Managing Agents 181Assigning Blackouts to Agent Instances To clear the filters, click Clear Filters.5Assign or remove a blackout schedule for an agent

182 vFoglight Administration and Configuration Guide The list reflects the entries in Manage Schedules dashboard. For more information, see “Managing

6Working with vFoglight Rules and RegistryThis chapter introduces you to vFoglight rules and registry and provides information on how to create and ma

184 vFoglight Administration and Configuration Guide About Rules, Registry, and Topology in vFoglightvFoglight collects data about your system and dy

Working with vFoglight Rules and Registry 185Working with vFoglight Registry Variables •“Editing Registry Variables” on page 200•“Viewing Registry Val

186 vFoglight Administration and Configuration Guide 3To sort the list of variables by their name or type, click the Variable Name or Type column hea

Working with vFoglight Rules and Registry 187Working with vFoglight Registry Variables The Manage Registry Variables dashboard refreshes, showing only

188 vFoglight Administration and Configuration Guide •“Viewing and editing variable definitions” on page 194Editing permissions of registry variables

Working with vFoglight Rules and Registry 189Working with vFoglight Registry Variables 2To add permissions to a variable, complete the following steps

Dominican RepublicWeb AddressE-Mail AddressTechnical Support, Customer Service, Saleswww.dell.com/dola‐[email protected] Ad

190 vFoglight Administration and Configuration Guide bIn the dialog box that appears, use the Read, Write, and Control check boxes to assign permissi

Working with vFoglight Rules and Registry 191Working with vFoglight Registry Variables bTo edit the permissions, ensure that the Edit option is select

192 vFoglight Administration and Configuration Guide 2In the Copy Registry Variable dialog box, click OK.The Copy Registry Variable dialog box closes

Working with vFoglight Rules and Registry 193Working with vFoglight Registry Variables 4If required, edit the newly-copied variable.For more informati

194 vFoglight Administration and Configuration Guide 1In the Manage Registry Variables dashboard, select the row containing the variable that you wan

Working with vFoglight Rules and Registry 195Working with vFoglight Registry Variables 2Observe the variable definitions.3Edit the variable if require

196 vFoglight Administration and Configuration Guide 2Open the Create Registry Variable dashboard by completing one of the following steps:• On the n

Working with vFoglight Rules and Registry 197Working with vFoglight Registry Variables • Description/Comments: Any comments about the variable or its

198 vFoglight Administration and Configuration Guide Timestamp Contains a date and time. For example, valid values include 06/12/06, 2006-06-21 15:30

Working with vFoglight Rules and Registry 199Working with vFoglight Registry Variables 4Click Add.5A confirmation message appears in the display area,

© 2008 Quest Software, Inc. ALL RIGHTS RESERVED.This guide contains proprietary information protected by copyright. The software described in this g

GuatemalaWeb AddressE-Mail AddressTechnical Support, Customer Service, Saleswww.dell.com/gtla‐[email protected] AddressTe

200 vFoglight Administration and Configuration Guide 6To verify if the variable appears in the Manage Registry Variables dashboard, click Go to Regis

Working with vFoglight Rules and Registry 201Working with vFoglight Registry Variables Note The name and value type of a registry variable cannot be c

202 vFoglight Administration and Configuration Guide Multiple Values to a Registry Variable” on page 216 for an example of how to use this feature. F

Working with vFoglight Rules and Registry 203Working with vFoglight Registry Variables For more information about different data types you can use, se

204 vFoglight Administration and Configuration Guide Note The value that you specify in this field applies to all topology types and objects other th

Working with vFoglight Rules and Registry 205Working with vFoglight Registry Variables To add schedules to a performance calendar:Note This procedure

206 vFoglight Administration and Configuration Guide To move a threshold bound up or down, in the Default Value Performance Calendar table, in the Sc

Working with vFoglight Rules and Registry 207Working with vFoglight Registry Variables 2Click Topology Type and select a type from the list that appea

208 vFoglight Administration and Configuration Guide Use the Value box to specify the value with which you want to replace the default value during t

Working with vFoglight Rules and Registry 209Working with vFoglight Registry Variables Viewing Registry ValuesA registry variable can have a global va

Ireland (Cherrywood)International Access Code: 00Country Code: 353City Code: 1Web AddressTechnical SupportE-mail AddressBusiness computersHome compute

210 vFoglight Administration and Configuration Guide • Registry Value: The value to which the variable is set during a specified date and time range.

Working with vFoglight Rules and Registry 211Working with vFoglight Registry Variables bIn the Registry Variable list, scroll down until you find SYSA

212 vFoglight Administration and Configuration Guide bIn the Topology Object list, select an object instance.7Specify the date and time range during

Working with vFoglight Rules and Registry 213Working with vFoglight Registry Variables Since all of the four columns appear in the Registry Value tabl

214 vFoglight Administration and Configuration Guide The Show columns dialog box appears.bIn the Show Columns dialog box, under Actions, click one of

Working with vFoglight Rules and Registry 215Working with vFoglight Registry Variables Note The appearance of the above dialog box may be different, d

216 vFoglight Administration and Configuration Guide Example: Assigning Multiple Values to a Registry VariableYou have several groups of servers in y

Working with vFoglight Rules and Registry 217Working with vFoglight Registry Variables that is set to the recur daily at the times when it is acceptab

218 vFoglight Administration and Configuration Guide 3On the Manage Registry Variables dashboard, locate the row containing the SYSADMIN variable.Tip

Working with vFoglight Rules and Registry 219Working with vFoglight Registry Variables 5Assign an email address to each monitored host by adding two h

Japan (Kawasaki)International Access Code: 001Country Code: 81City Code: 44Web AddressTechnical Support - Dimension and Inspiron Technical Support out

220 vFoglight Administration and Configuration Guide bSet the scope of the SYSADMIN variable to the Host type.In the Create Registry Value—Step 1 vie

Working with vFoglight Rules and Registry 221Working with vFoglight Registry Variables fIn the bottom-right, click Done.The Manage Registry Variables

222 vFoglight Administration and Configuration Guide

Working with vFoglight Rules and Registry 223Working with Rules Working with RulesvFoglight allows you to create flexible rules that can be applied to

224 vFoglight Administration and Configuration Guide • Registry Variable. A variable stored in the vFoglight registry that can be used in rule condit

Working with vFoglight Rules and Registry 225Working with Rules •“Example: Configuring Rule Action Parameters” on page 314•“Example: Creating Rules wi

226 vFoglight Administration and Configuration Guide To open the navigation panel, click the right-facing arrow on the left.2On the navigation pane

Working with vFoglight Rules and Registry 227Working with Rules • To show only the rules that belong to a particular cartridge, in the Cartridge Name

228 vFoglight Administration and Configuration Guide •“Viewing and editing rule definitions” on page 245Editing rule permissionsvFoglight allows you

Working with vFoglight Rules and Registry 229Working with Rules 2To add permissions to a rule, complete the following steps.aClick the role or user to

Malaysia (Penang)International Access Code: 00Country Code: 60City Code: 4Web AddressTechnical Support - Dell Precision, OptiPlex, and LatitudeTechnic

230 vFoglight Administration and Configuration Guide bIn the dialog box that appears, use the Read, Write, and Control check boxes to assign permissi

Working with vFoglight Rules and Registry 231Working with Rules bTo edit the permissions, ensure that the Edit option is selected and use the Read, Wr

232 vFoglight Administration and Configuration Guide 2In the Rule Confirmation dialog box, click OK.The Rule Confirmation dialog box closes and the E

Working with vFoglight Rules and Registry 233Working with Rules Note The appearance of the Edit Rule area depends on the severity levels of the newly-

234 vFoglight Administration and Configuration Guide To delete a rule:Note This procedure continues from “Accessing the Manage Rules dashboard” on pa

Working with vFoglight Rules and Registry 235Working with Rules 1In the Manage Rules dashboard, select the row containing the rule that you want to di

236 vFoglight Administration and Configuration Guide 3In Delete Rule Confirmation dialog box, click OK.The Delete Rule Confirmation dialog box closes

Working with vFoglight Rules and Registry 237Working with Rules 3Specify the time period for which you want to suspend alarms.In the Temporarily Suspe

238 vFoglight Administration and Configuration Guide 3Click OK.The Rule Confirmation dialog box closes and the Manage Rules dashboard refreshes.4In t

Working with vFoglight Rules and Registry 239Working with Rules A message appears, indicating the actions will be suspended for the selected amount of

Poland (Warsaw)International Access Code: 011Country Code: 48City Code: 22Web AddressE-mail AddressCustomer Service PhoneCustomer ServiceSales Custome

240 vFoglight Administration and Configuration Guide The Rule Confirmation dialog box closes and the Manage Rules dashboard refreshes.4In the Manage

Working with vFoglight Rules and Registry 241Working with Rules 2If required, edit the rule schedules.For more information, see “Associating Rules wit

242 vFoglight Administration and Configuration Guide • Conditional expressions, alarm messages, and actions for each severity levelFigure 3To view a

Working with vFoglight Rules and Registry 243Working with Rules Note The appearance of the Edit Rule view depends on the severity levels of the newly-

244 vFoglight Administration and Configuration Guide Note The appearance of the Rule Summary pane depends on the rule type, its severity levels, and

Working with vFoglight Rules and Registry 245Working with Rules The Behavior tab opens in the Edit Rule view.Viewing and editing rule definitionsTo vi

246 vFoglight Administration and Configuration Guide Note The appearance of the Edit Rule area depends on the severity levels of the newly-copied rul

Working with vFoglight Rules and Registry 247Working with Rules To create a rule:Note This procedure continues from “Getting Started with the Administ

248 vFoglight Administration and Configuration Guide From here, you can proceed to “Defining Rules” on page 248.Defining RulesRule definitions can co

Working with vFoglight Rules and Registry 249Working with Rules •“Defining rule types” on page 250•“Triggering rules” on page 251•“Defining the rule s

Spain (Madrid)International Access Code: 00Country Code: 34City Code: 91Web AddressHome and Small BusinessTechnical SupportCustomer ServiceSalesSwitch

250 vFoglight Administration and Configuration Guide Defining rule typesThere are two types of rules in vFoglight. Each rule type of is associated wi

Working with vFoglight Rules and Registry 251Working with Rules An alarm is generated each time a multiple-severity rule enters a new state. In additi

252 vFoglight Administration and Configuration Guide For details on how to write conditions for event-driven rules, see “Defining conditions for even

Working with vFoglight Rules and Registry 253Working with Rules The Rule Definition tab refreshes, showing the Event Name box on the right.2Specify th

254 vFoglight Administration and Configuration Guide •In the Rule Definition tab, use the Rule Scope area to scope the rule to one or more topology o

Working with vFoglight Rules and Registry 255Working with Rules Figure 4If you plan to make use of this feature, you need to add those variables befor

256 vFoglight Administration and Configuration Guide •“Copying severity-level variables and actions in multiple-severity rules” on page 297Adding sev

Working with vFoglight Rules and Registry 257Working with Rules In the above example, the Text and Subject variables make use of the expression-type v

258 vFoglight Administration and Configuration Guide Note For more information about rule severity levels, see “Adding severity-level variables” on p

Working with vFoglight Rules and Registry 259Working with Rules 3Open the Severity Level Variables tab.The Severity Level Variables tab appears in the

U.K.(Bracknell)International Access Code: 00Country Code: 44City Code: 1344Web AddressE-mail Address Customer Service WebsiteSalesHome and Small Busin

260 vFoglight Administration and Configuration Guide 4Define the type of the severity variable by selecting one of the following Type options on the

Working with vFoglight Rules and Registry 261Working with Rules 7Click Add.The Severity Level Variables pane refreshes, showing the newly-added variab

262 vFoglight Administration and Configuration Guide Furthermore, event-driven rules can retrieve data generated by report- and alarm-related events.

Working with vFoglight Rules and Registry 263Working with Rules to each severity level. System expressions are listed in the vFoglight Administration

264 vFoglight Administration and Configuration Guide Important The appearance of the Condition tab depends on the rule type. In addition to the condi

Working with vFoglight Rules and Registry 265Working with Rules In the Condition tab, use the Condition area to write the conditional expression. You

266 vFoglight Administration and Configuration Guide 3Multiple-severity rules. Activate the condition by selecting the Activate check box.You must ac

Working with vFoglight Rules and Registry 267Working with Rules • To add a rule-level variable, in the Alarm Message Editor dialog box, on the Rule Va

268 vFoglight Administration and Configuration Guide events and use the following properties in rule conditions in order to trigger event-driven rule

Working with vFoglight Rules and Registry 269Working with Rules • ReportGeneratedEventReport generation creates system events. You can monitor these e

U.S. Virgin IslandsWeb AddressE-mail AddressTechnical Support, Customer Service, Saleswww.dell.com/vila‐[email protected]‐free:1‐877‐702‐4360V

270 vFoglight Administration and Configuration Guide In addition to the ReportGeneratedEvent object properties you can reference the Report object pr

Working with vFoglight Rules and Registry 271Working with Rules To define a condition for an event-driven rule:Note This procedure continues from “Add

272 vFoglight Administration and Configuration Guide Important The appearance of the Condition tab depends on the rule type. In addition to the condi

Working with vFoglight Rules and Registry 273Working with Rules In the Condition tab, use the Condition area to write the conditional expression. usin

274 vFoglight Administration and Configuration Guide 3Multiple-severity rules. Activate the condition by selecting the Activate check box.You must ac

Working with vFoglight Rules and Registry 275Working with Rules 5Multiple-severity rules (Optional). To reference a rule-level variable or a system va

276 vFoglight Administration and Configuration Guide Copying conditions in multiple-severity rulesIn some cases you may need to copy the conditions f

Working with vFoglight Rules and Registry 277Working with Rules aClick the Copy condition/alarm button above the Condition tab.A list appears, showing

278 vFoglight Administration and Configuration Guide Defining actionsAn action is a particular operation that is performed when a rule enters or exit

Working with vFoglight Rules and Registry 279Working with Rules • Command Actions. They cause an external action to be executed on the machine hosting

280 vFoglight Administration and Configuration Guide To view email settings in vFoglight:Note This procedure continues from “Accessing the vFoglight

Working with vFoglight Rules and Registry 281Working with Rules 2Set the global default values of the following mail. variables:• mail.from: The defau

282 vFoglight Administration and Configuration Guide In the Edit Registry Variable view, in the Global Default area, type the global default value th

Working with vFoglight Rules and Registry 283Working with Rules The Manage Registry Variables dashboard refreshes, and the row containing the newly-ed

284 vFoglight Administration and Configuration Guide bSpecify the name and data type for the variable using the following boxes:Registry Variable Nam

Working with vFoglight Rules and Registry 285Working with Rules dEdit the newly-created registry variable.In the Step 2: Registry Variable Added view,

286 vFoglight Administration and Configuration Guide eSpecify the length of the time-out.In the Edit Registry Variable view, in the Global Default ar

Working with vFoglight Rules and Registry 287Working with Rules To add an action to a rule:Note This procedure continues from “Defining conditions for

288 vFoglight Administration and Configuration Guide From here, you can edit the action parameters as required. For details, see “About action parame

Working with vFoglight Rules and Registry 289Working with Rules COMMAND_LINEYes The command that you want to run on the command line along with its op

1About the Administration ModuleThe Administration module allows you to manage vFoglight in a way that best implements your business logic. It offers

290 vFoglight Administration and Configuration Guide mail.subjectNo Mail subject lineRemote Command ActionsCOMMAND_LINEYes The command that you want

Working with vFoglight Rules and Registry 291Working with Rules The following rules apply to the command syntax for Command and Remote Command actions

292 vFoglight Administration and Configuration Guide IncorrectP:\hello.bat (where P: is a mapped drive)Only those commands that point to a specific b

Working with vFoglight Rules and Registry 293Working with Rules Rules in vFoglight can be triggered by data, time, or events. Different trigger types,

294 vFoglight Administration and Configuration Guide For more information on rule trigger types, see “Triggering rules” on page 251.Note vFoglight pr

Working with vFoglight Rules and Registry 295Working with Rules Note The above screen capture shows a list of parameters for a command action. Each ac

296 vFoglight Administration and Configuration Guide 4Specify the parameter value by completing one of the following steps in the Action Parameter Ed

Working with vFoglight Rules and Registry 297Working with Rules In the Variable tab, in the Rule/System Variables table, select the row containing the

298 vFoglight Administration and Configuration Guide variables, see “Adding severity-level variables” on page 256 and “Defining actions” on page 278.

Working with vFoglight Rules and Registry 299Working with Rules severity, and the conditions for the Fatal and Warning levels have already been define

Table of ContentsIntroduction to this Guide...

30 vFoglight Administration and Configuration Guide About Models and Scope in vFoglightA model is a principle for organizing monitoring data that vFo

300 vFoglight Administration and Configuration Guide rule, then it is automatically active at all times other than those specified by the blackout sc

Working with vFoglight Rules and Registry 301Working with Rules The Effective Schedules list on the right refreshes, showing the newly-added schedules

302 vFoglight Administration and Configuration Guide From here, you can proceed to “Defining Alarm and Action Behavior” on page 302.Defining Alarm an

Working with vFoglight Rules and Registry 303Working with Rules Defining Rule-Level VariablesIn addition to vFoglight registry variables and severity-

304 vFoglight Administration and Configuration Guide To define a rule-level variable:Note This procedure continues from “Defining Alarm and Action Be

Working with vFoglight Rules and Registry 305Working with Rules For example:In the Expression/Message box, type the value of the variable.5Click Add.T

306 vFoglight Administration and Configuration Guide different actions with a rule, configure a rule so that it does not fire repeatedly, and associa

Working with vFoglight Rules and Registry 307Working with Rules • Remote Agent Manager State Rule• ServiceLevelEvaluation – FMSServiceSLP RuleAgent He

308 vFoglight Administration and Configuration Guide Catalyst Database Space Checking RulePurposeThis rule monitors the size of the database.ScopeCat

Working with vFoglight Rules and Registry 309Working with Rules ScopeCatalystTablespaceDiagnosticAgentDiscoveryPurposeThis periodically looks for new

About the Administration Module 31About Models and Scope in vFoglight vFoglight makes use of a topology model to describe the logical and physical rel

310 vFoglight Administration and Configuration Guide ScopeAgentTypeLicensevFoglight Memory Usage Check RulePurposeThis rule checks the memory that is

Working with vFoglight Rules and Registry 311Working with Rules ServiceLevelEvaluation – FMSServiceSLP RulePurposevFoglight monitors each service (eit

312 vFoglight Administration and Configuration Guide Setting basic rule propertiesIn the Rule Definition area of the Create Rule dashboard, you name

Working with vFoglight Rules and Registry 313Working with Rules You click the Validate Scope button ( ) to ensure that the topology type is valid and

314 vFoglight Administration and Configuration Guide An entering Email action is set for this rule. This action uses the ProblemSynopsis message as t

Working with vFoglight Rules and Registry 315Working with Rules 2Open the rule for editing and navigate to the Action tab of the severity level for wh

316 vFoglight Administration and Configuration Guide The following diagram illustrates the scope of each of the rules that you are about to create fr

Working with vFoglight Rules and Registry 317Working with Rules cIn the Create Rule dashboard, in the Rule Definition tab, in the Rule Name box, type

318 vFoglight Administration and Configuration Guide 3Write a condition that triggers the rule each time the utilization of a Processor type reaches

Working with vFoglight Rules and Registry 319Working with Rules dIn the Condition Editor dialog box, open the Metric/Property tab.

32 vFoglight Administration and Configuration Guide Getting Started with the Administration ModuleEach vFoglight module contains a set of dashboards

320 vFoglight Administration and Configuration Guide eOn the Metric/Property tab, in the left pane, in the Scoping Topology area, click Processor.Tip

Working with vFoglight Rules and Registry 321Working with Rules gIn the Metrics area, select percentUserTime and click Insert.The Condition box in the

322 vFoglight Administration and Configuration Guide Edit the condition as follows:max(#percentUserTime for 24h#) > 0.95Click Finish.To scope a ru

Working with vFoglight Rules and Registry 323Working with Rules 2In the Edit Rule view, open the severity level to which you want to add a command act

324 vFoglight Administration and Configuration Guide For example, the expression f4registry("OraDBAWarning") retrieves the value of the Ora

Working with vFoglight Rules and Registry 325Working with Rules When the rule meets the condition that includes the newly-defined command action, it w

326 vFoglight Administration and Configuration Guide

7Working with DataThis chapter introduces you to vFoglight data management entities on how to create and manage these entities. It contains the follow

328 vFoglight Administration and Configuration Guide About Data Management in vFoglightvFoglight models retain collected data and transform it into n

Working with Data 329Adding Topology Types Adding Topology TypesvFoglight transforms monitoring data into models. A model is a set of objects and rela

About the Administration Module 33Getting Started with the Administration Module For a complete list of administration tasks and the dashboards that y

330 vFoglight Administration and Configuration Guide 3To add one or more topology types that are defined in an XML file accessible by your local mach

Working with Data 331Adding Topology Types bIn the File Location on Server box, type the path and name of the topology file. Use either an absolute pa

332 vFoglight Administration and Configuration Guide The Alert message box appears, this time indicating that the topology import was successful.Work

Working with Data 333Working with Derived Metrics •“Creating Derived Metrics” on page 342•“Defining Derived Metrics” on page 344Managing Derived Metri

334 vFoglight Administration and Configuration Guide 3To sort the list of derived metrics by their name or scope, click the Derived Metric Name or De

Working with Data 335Working with Derived Metrics The Manage Derived Metrics dashboard refreshes, showing the list of all variables.From here, you can

336 vFoglight Administration and Configuration Guide • If one has a permission to the derived metric, others with undefined permission do not have an

Working with Data 337Working with Derived Metrics 2To add permissions to a derived metric, complete the following steps.aClick the role or user to whi

338 vFoglight Administration and Configuration Guide bIn the dialog box that appears, use the Read, Write, and Control check boxes to assign permissi

Working with Data 339Working with Derived Metrics bTo edit the permissions, ensure that the Edit option is selected and use the Read, Write, and Contr

34 vFoglight Administration and Configuration Guide 1Ensure that your vFoglight Management Server is running.For example, on Windows platforms, you c

340 vFoglight Administration and Configuration Guide 2In the Copy Derivation dialog box, click OK.The Copy Derivation dialog box closes and the Creat

Working with Data 341Working with Derived Metrics Deleting derived metricsUse the Delete Selected button on the Manage Derived Metrics dashboard to de

342 vFoglight Administration and Configuration Guide 1In the Manage Derived Metrics dashboard, click the Derived Metric Name column of the row contai

Working with Data 343Working with Derived Metrics When you create a derived metric, vFoglight changes the topology type to which the derived metric is

344 vFoglight Administration and Configuration Guide From here, you can proceed to “Defining Derived Metrics” on page 344.Defining Derived MetricsDer

Working with Data 345Working with Derived Metrics The vFoglight Management Server processes the derived metric calculation in the order they are liste

346 vFoglight Administration and Configuration Guide 2Use the Derived Metric Scope and Expression areas to specify the scope of the derived metric.Ca

Working with Data 347Working with Derived Metrics 3When you finish adding calculations to derived metrics, ensure that their order is valid.Caution Th

348 vFoglight Administration and Configuration Guide • thousand• thousandth• trillion• trillionth•yearFor example, to set the unit of the derived met

Working with Data 349Working with Derived Metrics • Schedule-Driven Derived Metric. A schedule-driven derived metric is evaluated based on a schedule

About the Administration Module 35Getting Started with the Administration Module 5Provide the user name and password you obtained in step 2.aIn the vF

350 vFoglight Administration and Configuration Guide • Enter and Exit• Enter only• Exit only4To enable the trigger without data, select the Enable Tr

Working with Data 351Working with Derived Metrics To set the value type for a derived metric:Note This procedure continues from “Triggering derived me

352 vFoglight Administration and Configuration Guide creating rules simpler and more efficient by creating a derived metric scoped to the same topolo

Working with Data 353Working with Thresholds Example: Optimizing PerformanceDerived metrics can also help you optimize performance by reducing the num

354 vFoglight Administration and Configuration Guide To access the Manage Thresholds dashboard:Note This procedure continues from “Getting Started wi

Working with Data 355Working with Thresholds From here, you can proceed to any of the following procedures:•“Editing threshold permissions” on page 35

356 vFoglight Administration and Configuration Guide Figure 2To add permissions for a threshold:Note This procedure continues from “Accessing the Man

Working with Data 357Working with Thresholds 2To add permissions to a threshold, complete the following steps.aClick the role or user to which you wan

358 vFoglight Administration and Configuration Guide bIn the dialog box that appears, use the Read, Write, and Control check boxes to assign permissi

Working with Data 359Working with Thresholds bTo edit the permissions, ensure that the Edit option is selected and use the Read, Write, and Control ch

36 vFoglight Administration and Configuration Guide The Welcome page contains the following elements:For complete information about this page, see th

360 vFoglight Administration and Configuration Guide 3In the Delete Threshold dialog box, click OK.The Delete Threshold dialog box closes.4Observe th

Working with Data 361Working with Thresholds 2Observe the threshold definitions.3Edit the threshold as required.For complete instructions, see “Adding

362 vFoglight Administration and Configuration Guide In the Manage Thresholds dashboard that appears in the display area, click the Add Threshold but

Working with Data 363Working with Thresholds Selecting metrics and threshold levelsTo select a metric and its threshold level:Note This procedure cont

364 vFoglight Administration and Configuration Guide • ThresholdSeverity4Click Next.The Step 3: Create Threshold - Add Bounds area appears in the Cre

Working with Data 365Working with Thresholds AgentState UnknownStoppedStartingStoppingRunningCollecting dataRunning but not collecting dataAlarmChange

366 vFoglight Administration and Configuration Guide You can have one or more threshold bounds in a threshold level. There are three different types

Working with Data 367Working with Thresholds To bind a threshold level to a metric:Note This procedure continues from “Selecting metrics and threshold

368 vFoglight Administration and Configuration Guide To bind a threshold level to a registry variable:Note This procedure continues from “Selecting m

Working with Data 369Working with Thresholds The newly-created registry variable threshold bound appears in the Threshold Bounds table.To bind a thres

About the Administration Module 37Getting Started with the Administration Module If your user account includes the Administration role, in the Unlicen

370 vFoglight Administration and Configuration Guide If you want vFoglight to acknowledge that the threshold is reached when the threshold level reac

Working with Data 371Working with Thresholds or• New thresholds. Click Add.A list appears in the display area, showing the threshold bounds for the se

372 vFoglight Administration and Configuration Guide Observe the Manage Thresholds dashboard.The newly-added threshold appears in the list.Managing R

Working with Data 373Managing Retention Policies •“About Retention Policy Mechanisms” on page 373•“Accessing the Manage Retention Policies Dashboard”

374 vFoglight Administration and Configuration Guide • Generation 3: IndefiniteBecause data is constrained to those buckets, retention policies must

Working with Data 375Managing Retention Policies How retention policies interact with database generationsBoth mechanisms for populating the repositor

376 vFoglight Administration and Configuration Guide Figure 3Individual cartridges frequently have their own policies which must be examined on indiv

Working with Data 377Managing Retention Policies Level 2> 15 minutes and < 3 daysAny roll-up greater than Level 1The age date for the Level 2 po

378 vFoglight Administration and Configuration Guide Accessing the Manage Retention Policies DashboardUse the Manage Retention Policies dashboard to

Working with Data 379Managing Retention Policies In the Manage Retention Policies dashboard, the Age column specifies the amount of time allotted for

38 vFoglight Administration and Configuration Guide 7Select a dashboard and look at its contents in the display area.For example, to look at the Cart

380 vFoglight Administration and Configuration Guide 3To sort the list of retention policies by the topology type to which they apply, click the Topo

Working with Data 381Managing Retention Policies From here, you can proceed to any of the following procedures:•“Deleting Retention Policies” on page

382 vFoglight Administration and Configuration Guide To delete a retention policy:Note This procedure continues from “Accessing the Manage Retention

Working with Data 383Managing Retention Policies Viewing the Hierarchy of Topology Types in the Database SchemaBefore you get started with editing ret

384 vFoglight Administration and Configuration Guide Figure 5To view the hierarchy of a topology type:1Ensure that the navigation panel is open.To op

Working with Data 385Managing Retention Policies 3Ensure that the Schema Browser shows the core topology types.On the navigation panel, under Schema S

386 vFoglight Administration and Configuration Guide To find out the ancestors of the selected topology type, at the top of the lower pane, on the ri

Working with Data 387Managing Retention Policies To edit the default retention policy period:Note This procedure continues from “Accessing the Manage

388 vFoglight Administration and Configuration Guide 5Edit the existing roll-up period or configure the retention policy to purge the data.In the Rol

Working with Data 389Managing Retention Policies 2Add a data sampling period.In the Add Retention Policy dialog box, in the After column, specify the

About the Administration Module 39Viewing the Administration Dashboard Viewing the Administration DashboardThe Administration dashboard contains links

390 vFoglight Administration and Configuration Guide Specify the data sampling and roll-up or purging parameters periods for the newly-added retentio

Working with Data 391Managing Retention Policies after 1 year - purgeNote If the roll-up period is less than one day, the roll-up period must be a mul

392 vFoglight Administration and Configuration Guide Enabling the Collection of Data with Older TimestampsBy default, the vFoglight Management Server

Working with Data 393Enabling the Collection of Data with Older Timestamps 3Find an unused VM option and set it to a desired length in milliseconds.aR

394 vFoglight Administration and Configuration Guide

8Using SchedulesThis chapter introduces you to vFoglight schedules and provides information on how to create and manage them. It contains the followin

396 vFoglight Administration and Configuration Guide About SchedulesA schedule is a calendar entry. A schedule consists of one or more schedule items

Using Schedules 397Managing Schedules Managing SchedulesThe Manage Schedules dashboard allows you to manage existing schedules, assign permissions to

398 vFoglight Administration and Configuration Guide 3To sort the list of variables by their name or next scheduled time, click the Schedule Name or

Using Schedules 399Managing Schedules •“Viewing Schedule Definitions” on page 405•“Viewing and Editing Schedules” on page 406Editing Schedule Permissi

4 vFoglightAdministration and Configuration Guide Managing Support Bundles ...

40 vFoglight Administration and Configuration Guide Thresholds Manage ThresholdsList, add, edit, or delete thresholds.For more information, see “Mana

400 vFoglight Administration and Configuration Guide 2To add permissions to a schedule, complete the following steps.aClick the role or user to which

Using Schedules 401Managing Schedules bIn the dialog box that appears, use the Read, Write, and Control check boxes to assign permissions as required,

402 vFoglight Administration and Configuration Guide bTo edit the permissions, ensure that the Edit option is selected and use the Read, Write, and C

Using Schedules 403Managing Schedules The dialog box closes and the Edit Schedule view appears in the Manage Schedules dashboard.2If required, edit th

404 vFoglight Administration and Configuration Guide Deleting SchedulesUse the Delete Selected button on the Manage Schedules dashboard to delete a s

Using Schedules 405Managing Schedules Viewing Schedule DefinitionsTo view schedule definitions:Note This procedure continues from “Accessing the Manag

406 vFoglight Administration and Configuration Guide 3Observe the schedule definitions for a selected date.In the Business Hours dialog box, use the

Using Schedules 407Creating Schedules to edit it to also run every Saturday from 11:00 am to 4:00 pm in May, add a schedule item for each of these tim

408 vFoglight Administration and Configuration Guide Creating a schedule involves several steps. Once you get started with schedule creation, you nee

Using Schedules 409Creating Schedules From here, you can proceed to “Getting Started with Schedule Definitions” on page 409.Getting Started with Sched

About the Administration Module 41Viewing the Administration Dashboard SchedulesSchedule ManagementManage SchedulesList, edit, or delete schedules.For

410 vFoglight Administration and Configuration Guide The Step 2: Create Schedule - Details of Schedule view appears in the Create Schedule dashboard.

Using Schedules 411Creating Schedules When you create a schedule, you have to specify at least one schedule item and its recurrence pattern. You can e

412 vFoglight Administration and Configuration Guide The Edit Schedule view appears.2In the Edit Schedule view, click Add Schedule Item in the lower-

Using Schedules 413Creating Schedules For complete information on how to define a schedule item, see “Defining Schedule Items” on page 415.To add a sc

414 vFoglight Administration and Configuration Guide To delete a schedule item:Note This procedure continues from “Viewing and Editing Schedules” on

Using Schedules 415Creating Schedules Defining Schedule ItemsThere are six types of patterns that you can define in a schedule item, as listed below.P

416 vFoglight Administration and Configuration Guide To define a schedule item that occurs once:Note This procedure continues from “Adding or Removin

Using Schedules 417Creating Schedules bUse the Start Time [hh:mm] boxes to specify the hour and minute of the start time.Tip The Hour box accepts the

418 vFoglight Administration and Configuration Guide bUse the End Time [hh:mm] boxes to specify the hour and minute of the end time.Tip The Hour box

Using Schedules 419Creating Schedules 5Add one or more schedule items if required.For details, see “Adding or Removing Schedule Items” on page 410.To

42 vFoglight Administration and Configuration Guide Topology TypeAdd Topology TypeAdd topology types.For more information, see “Adding Topology Types

420 vFoglight Administration and Configuration Guide bUse the Start Time [hh:mm] boxes to specify the hour and minute of the start time.Tip The Hour

Using Schedules 421Creating Schedules • To specify an end date, in the Range of Occurrence area, ensure that the End By Date option is selected, and s

422 vFoglight Administration and Configuration Guide 5Save the changes to the schedule item.• New schedules. In the lower-right corner, click Add.• E

Using Schedules 423Creating Schedules 2Specify the start date of the recurrence pattern.Use the Start Date boxes to specify the day, month and year of

424 vFoglight Administration and Configuration Guide • Specify the start time and end time of the schedule item.•Use the Start Time [hh:mm] boxes to

Using Schedules 425Creating Schedules or• If you want the schedule to occur for the entire day, select the Whole Day check box.The Start Time [hh:mm],

426 vFoglight Administration and Configuration Guide 4Specify the recurrence pattern.In the Recurrence Pattern area, use the Every box to specify the

Using Schedules 427Creating Schedules • To have the schedule item recurring at the recurrence pattern specified in step 4 without an end date, in the

428 vFoglight Administration and Configuration Guide 1In the Recurrence Pattern area, select the Weekly option.The view refreshes, showing a set of c

Using Schedules 429Creating Schedules • If you want the schedule to occur for a part of the day, complete one of the following steps.• Specify the sta

About the Administration Module 43Viewing the Administration Dashboard • Current Statistics. Contains information about the installed cartridges, acti

430 vFoglight Administration and Configuration Guide or• If you want the schedule to occur for the entire day, select the Whole Day check box.The Sta

Using Schedules 431Creating Schedules 4Specify the recurrence pattern.In the Recurrence Pattern area, use the Every box to specify the number of weeks

432 vFoglight Administration and Configuration Guide • To specify an end date, in the Range of Occurrence area, ensure that the End By Date option is

Using Schedules 433Creating Schedules The Schedule Items table refreshes, showing the newly-added schedule item.7Add one or more schedule items if req

434 vFoglight Administration and Configuration Guide 2Specify the start date of the recurrence pattern.Use the Start Date boxes to specify the day, m

Using Schedules 435Creating Schedules • If you want the schedule to occur for a part of the day, complete one of the following steps.• Specify the sta

436 vFoglight Administration and Configuration Guide or• If you want the schedule to occur for the entire day, select the Whole Day check box.The Sta

Using Schedules 437Creating Schedules 4Specify the recurrence pattern.• To have the schedule occurring on a specified day of the month, at the rate of

438 vFoglight Administration and Configuration Guide In the Recurrence Pattern area, use the Every box to specify the number of weeks at which the sc

Using Schedules 439Creating Schedules The Hour box accepts the values between 0 and 24. Any positive values outside that range are automatically adjus

44 vFoglight Administration and Configuration Guide 3In the Administration dashboard, observe the Navigation view.The Navigation view contains links

440 vFoglight Administration and Configuration Guide To define a schedule item that occurs yearly:Note This procedure continues from “Adding or Remov

Using Schedules 441Creating Schedules 3Specify the duration of the schedule item.

442 vFoglight Administration and Configuration Guide • If you want the schedule to occur for a part of the day, complete one of the following steps.•

Using Schedules 443Creating Schedules or• If you want the schedule to occur for the entire day, select the Whole Day check box.The Start Time [hh:mm],

444 vFoglight Administration and Configuration Guide 4Specify the recurrence pattern.• To have the schedule occurring on a specified day of the month

Using Schedules 445Creating Schedules 5Specify the date and time after which the schedule item ends using the controls in the Range of Occurrence area

446 vFoglight Administration and Configuration Guide The Minute box accepts the values between 0 and 59. Any positive values outside that range are a

9Working with vFoglight ToolingThis chapter introduces you to the Tooling dashboards and provides information on how to build script agents and use th

448 vFoglight Administration and Configuration Guide About vFoglight ToolingThe vFoglight Management Server collects data from your monitored system

Working with vFoglight Tooling 449Building Script Agents • Type 2 scripts. These scripts control their own collection frequency cycle. In Type 2 scrip

About the Administration Module 45Viewing the Administration Dashboard To return to the Administration dashboard, click Administration in the breadcru

450 vFoglight Administration and Configuration Guide data immediately following the START_SAMPLE_PERIOD command, as shown in the above syntax block:S

Working with vFoglight Tooling 451Building Script Agents When you finish writing the agent script, you can proceed to “Accessing the Build Script Agen

452 vFoglight Administration and Configuration Guide From here, you can go to “Uploading Agent Scripts and Building Agent Packages” on page 452.Uploa

Working with vFoglight Tooling 453Building Script Agents 3Ensure that the version number of the script agent that you are about to upload is correct.T

454 vFoglight Administration and Configuration Guide 6In the Build Script Agent dialog box, click Move to Agent Listing.The Agent Status area appears

Working with vFoglight Tooling 455Building Script Agents Use the Agent Status area in the Build Script Agent dashboard to deploy a script agent. Alter

456 vFoglight Administration and Configuration Guide For example: MyScriptAgent-1.2.04Click Deploy.The Deploy Agent Package dialog box refreshes, sho

Working with vFoglight Tooling 457Building Script Agents 5Click OK to close the Deploy Agent Package dialog box.From here, you can proceed to “Creatin

458 vFoglight Administration and Configuration Guide 1In the Build Script Agent dashboard, in the Agent Status area, click the Create Agent button in

Working with vFoglight Tooling 459Building Script Agents The list reflects the cartridges that have been installed, enabled, and deployed to the monit

46 vFoglight Administration and Configuration Guide For complete information about the Cartridge Inventory dashboard, see Chapter 4, “Installing and

460 vFoglight Administration and Configuration Guide After a few moments, in the Create Agent Results dialog box, in the Status column of the Progres

Working with vFoglight Tooling 461Building Script Agents The Agent Status dashboard, refreshes, showing the newly-created agent instance.6Activate the

462 vFoglight Administration and Configuration Guide After a few moments, in the Agent Operation dialog box, in the Status column of the Progress tab

Working with vFoglight Tooling 463Building Script Agents bIn the Agent Operation dialog box, click OK.The Agent Operation dialog box closes and the Ag

464 vFoglight Administration and Configuration Guide Editing Script Agent PropertiesIn some cases you might need to edit the properties of the newly-

Working with vFoglight Tooling 465Building Script Agents Note The type and range of script agent properties depends on the script that you used to bui

466 vFoglight Administration and Configuration Guide 5Save your changes.Click Save. The Build Script Agent dashboard refreshes, showing a list of all

Working with vFoglight Tooling 467Retrieving Data with Queries and Scripts @echo offif not "%ECHO%"=="" echo %ECHO%if not "%O

468 vFoglight Administration and Configuration Guide retrieve desired results. For more information about the query language and its syntax, see “Usi

Working with vFoglight Tooling 469Retrieving Data with Queries and Scripts From here, you can go to “Selecting Topology Objects” on page 469.Selecting

About the Administration Module 47Viewing the Administration Dashboard For complete information about the Manage Rules dashboard, see Chapter 6, “Mana

470 vFoglight Administration and Configuration Guide • Object type hierarchies• Object properties, including:•Unique ID• Object ID•ID•Version• Effect

Working with vFoglight Tooling 471Retrieving Data with Queries and Scripts 3View information about one of the listed topology objects.In the Instances

472 vFoglight Administration and Configuration Guide Retrieving DataOnce you retrieve information about one or more topology objects, you can run scr

10Using the Query LanguageA query language is used in vFoglight to set the scope for rules and derived metrics, to create rule conditions and expressi

474 vFoglight Administration and Configuration Guide Using the Query Language to Set the Rule or Derived Metric ScopeThe scope of a rule defines the

Using the Query Language 475Using the Query Language to Set the Rule or Derived Metric Scope • Scope down to a property of the selected topology type

476 vFoglight Administration and Configuration Guide The name of the newly-selected property appears in the expression immediately below the Property

Using the Query Language 477Using the Query Language to Set the Rule or Derived Metric Scope From here, you can proceed to any of the following proced

478 vFoglight Administration and Configuration Guide To specify topology type properties:Note This procedure continues from “Restricting the scope to

Using the Query Language 479Using the Query Language to Set the Rule or Derived Metric Scope The Scoping Query Editor dialog box closes and the scopin

48 vFoglight Administration and Configuration Guide To return to the Administration dashboard, click Administration in the breadcrumb trail.5In the A

480 vFoglight Administration and Configuration Guide where TopologyType is the name of the topology type of which Object is an instance and Object is

Using the Query Language 481Using the Query Language in Rule Conditions or Derived Metric Expressions Expressions must be specified using the query la

482 vFoglight Administration and Configuration Guide expression that are either part of the query language or have been formatted to use the query la

Using the Query Language 483Using the Query Language in Rule Conditions or Derived Metric Expressions From here, you can proceed to any of the followi

484 vFoglight Administration and Configuration Guide derived metric scope. Each registry variable’s type and global default value also appear in this

Using the Query Language 485Using the Query Language in Rule Conditions or Derived Metric Expressions • Parent types of the scoping topology type that

486 vFoglight Administration and Configuration Guide The Metric/Property tab refreshes, showing the instances and metrics for the selected topology t

Using the Query Language 487Using the Query Language in Rule Conditions or Derived Metric Expressions In the Properties pane, select the property that

488 vFoglight Administration and Configuration Guide To insert a Groovy function into a rule condition or derived metric expression:Note This procedu

Using the Query Language 489Using the Query Language in Rule Conditions or Derived Metric Expressions 4Specify the function arguments as required usin

About the Administration Module 49Viewing the Administration Dashboard To return to the Administration dashboard, click Administration in the breadcru

490 vFoglight Administration and Configuration Guide Validating conditions or expressionsWhen you have finished editing the rule condition or derived

Using the Query Language 491Using the Query Language in Rule Conditions or Derived Metric Expressions rules to perform the same function (rate) on the

492 vFoglight Administration and Configuration Guide • changeSummary: Returns the list of topology property changes for each topology object referenc

Using the Query Language 493Using the Query Language in Rule Conditions or Derived Metric Expressions • getMonitoredComponentRuleInfoList: Returns a l

494 vFoglight Administration and Configuration Guide • period: calculates the total length of a period of time from a series of metrics and returns a

Using the Query Language 495Using the Query Language FAQ {return false;}Advanced scripting exampleIn most cases, you use the scope variable as a param

496 vFoglight Administration and Configuration Guide If you want to reference the topology object from within a string or embedded query, you must pr

AAppendix: vFoglight Client ReferenceWhile the new versions of vFoglight use the vFoglight Agent Manager to communicate with vFoglight agents, previou

498 vFoglight Administration and Configuration Guide Starting the vFoglight ClientTo start the vFoglight Client:• To start the vFoglight Client, you

Appendix: vFoglight Client Reference 499Viewing the Content of a vFoglight Client Support Bundle Each client support bundle consists of the following

Table of Contents 5 Accessing the Configure Password Settings Dashboard...

50 vFoglight Administration and Configuration Guide To return to the Administration dashboard, click Administration in the breadcrumb trail.8In the A

500 vFoglight Administration and Configuration Guide Note For information about the content of vFoglight Agent Manager support bundles, see “Viewing

Appendix: vFoglight Client Reference 501Browser Interface Browser InterfaceThis section contains sample screen captures that appear in monitoring envi

502 vFoglight Administration and Configuration Guide Agent Status dashboardThe Agent Status dashboard shows an entry for the SPINetwork agent that co

Appendix: vFoglight Client Reference 503Command-Line Interface Command-Line InterfaceThis section contains fglcmd examples and their command-line outp

504 vFoglight Administration and Configuration Guide myhost.mydomain:0#SpiInstaller/adminAgent Package ID: OSCartridge-Windows2003-5.2.4-AgentPackage

Appendix: vFoglight Client Reference 505Command-Line Interface myhost.mydomain.corp:0Client Name: SPI://myhost.mydomain.corp:0Agent Types:NetMonitorWi

506 vFoglight Administration and Configuration Guide Host Name: tor013008.prod.quest.corp50 log files found.OSCartridge\5.2.0\logs\AIX_Console_My_AIX

Appendix: vFoglight Client Reference 507Command-Line Interface Agent Types:------------------------------------Client ID: MyHost#SPI://MyHost:0Client

508 vFoglight Administration and Configuration Guide Agent Package OS Version: /5\.1.*/Agent Package OS Architecture: ia32,x86_64--------------------

IndexAabout vFoglight 10Action Parameter Editor dialog box 295, 296, 297Add Retention Policy dialog box 388, 389Add Role Permission dialog box 189, 22

About the Administration Module 51Looking at Administration Tasks Add topology types “Adding Topology Types” on page 329Add derived metrics “Working w

510 vFoglight Administration and Configuration Guidemanaging schedules 397managing thresholds 353managing users 107managing users and security 105abo

Index 511cloning lists in secondary properties 173editing lists in secondary properties 174editing primary type-specific properties 172editing type-sp

512 vFoglight Administration and Configuration GuideCartridge Inventory node in navigation panel 150cartridgesagent componentsdownloading161, 163comp

Index 513Expression Editor dialog box 482, 483, 484, 485, 487, 488, 491getting started with defining derived metrics 344Scoping Query Editor dialog bo

514 vFoglight Administration and Configuration GuideDdashboardsAdd Topology Type40, 42, 329, 330, 331Administration 39, 43, 44, 45, 46, 47, 48, 49, 5

Index 515Manage Registry Variables 40, 185, 186, 187, 188, 191, 193, 194, 195, 196, 200, 217, 218, 219, 220, 221, 234, 247, 280, 281, 282, 283, 286, 4

516 vFoglight Administration and Configuration GuidePorts view 63, 65Server view 57WCF view 61View Audit Information 40, 82, 83, 85, 87, 88Show colum

Index 517Data node in navigation panel 10, 33, 329, 333, 343, 354, 361, 362, 379databasechanging database credentials138Database view 59, 68Delete Der

518 vFoglight Administration and Configuration Guidedirectory settingsediting142documentationcartridge13core 12feedback 13suite 12download 162EEdit D

Index 519schedule items to a newly-created schedule that has no other schedule items411schedule items to an existing schedule 413schedules to performa

52 vFoglight Administration and Configuration Guide View or edit password settings “Managing Groups” on page 118List, add, edit, or delete groups “Ma

520 vFoglight Administration and Configuration Guidescript agent packages 455disablecartridges158rules 234downloadagent components162, 164editdefault

Index 521passwords 116uploadagent scripts452viewAdministration dashboard43audit logs 88client support bundle content 498derived metrics 341license cap

522 vFoglight Administration and Configuration GuideManage Licenses node in navigation panel 69Manage Registry Variables dashboard 40, 185, 186, 187,

Index 523Edit Role Permission dialog box 230Edit Rule view 241, 242, 243, 244, 245, 323Edit User Permission dialog box 230editing rule definitions 245

524 vFoglight Administration and Configuration Guidecreating users 111Edit Groups dialog box 113, 114forcing password changes 115unlocking passwords

Index 525using in scoping queries 474RRegistry Variable Confirmation dialog box 194registry variablescreating195editing 200getting started with editin

526 vFoglight Administration and Configuration Guidemanaging 225accessing Manage Rules dashboard 225copying rules 231editing rule permissions 228edit

Index 527variables 204viewing variable definitions 194Manage Rules 40, 46, 47, 225, 226, 227, 228, 231, 232, 233, 234, 235, 236, 237, 238, 239, 240, 2

528 vFoglight Administration and Configuration Guideabout 396Create Schedule 42, 407, 408, 409, 410, 411accessing 408adding schedule items 410creatin

Index 529Manage Licenses 48, 69, 70, 73, 74accessing 69deleting licenses 74installing licenses 70License Confirmation dialog box 74, 75viewing license

2Setting Up vFoglightOnce you get started with the Administration module, you can use the Setup & Support dashboards to administer vFoglight.Note

530 vFoglight Administration and Configuration GuideScript Editor 41, 468, 469, 470, 472accessing 468retrieving data from topology objects 472selecti

Index 531vFoglight configurationviewing56vFoglight Configuration dashboard 40, 47, 56, 57, 58, 59, 60, 61, 63, 65, 67, 68, 280accessing 67Database vie

54 vFoglight Administration and Configuration Guide About vFoglight SetupThe Administration module includes a number of features that allow you to ga

Setting Up vFoglight 55Viewing Connection Status

56 vFoglight Administration and Configuration Guide Viewing vFoglight ConfigurationThe vFoglight Configuration dashboard provides information about v

Setting Up vFoglight 57Viewing vFoglight Configuration the data from one or more federated servers. For information on how to set up a federated envir

58 vFoglight Administration and Configuration Guide • Version. The version number of the vFoglight Management Server whose configuration items you ar

Setting Up vFoglight 59Viewing vFoglight Configuration • Topology Queries. A list of one or more topology queries that identify topology objects that

6 vFoglightAdministration and Configuration Guide Working with Rules...

60 vFoglight Administration and Configuration Guide • User. The database user name. This setting is defined by the foglight.database.user parameter.•

Setting Up vFoglight 61Viewing vFoglight Configuration OSThe OS view displays the following settings:• Type. The name and version of the operating sys

62 vFoglight Administration and Configuration Guide administrators when certain thresholds are reached. For more information, see “Viewing email sett

Setting Up vFoglight 63Viewing vFoglight Configuration Figure 8For information on how to view the information on the vFoglight Configuration dashboard

64 vFoglight Administration and Configuration Guide • HA Pooled Invoker Port. Pooled invoker port when vFoglight is running in HA mode. This setting

Setting Up vFoglight 65Viewing vFoglight Configuration Figure 9For information on how to view the information on the vFoglight Configuration dashboard

66 vFoglight Administration and Configuration Guide HA JNDI JNP Port 1100 Port for the bootstrap JNP service when vFoglight is running in HA mode. Fo

Setting Up vFoglight 67Viewing vFoglight Configuration Accessing the vFoglight Configuration DashboardUse the vFoglight Configuration dashboard when y

68 vFoglight Administration and Configuration Guide 3In the vFoglight Configuration dashboard, locate the view that contains information about a set

Setting Up vFoglight 69Managing Licenses •“OS” on page 61•“WCF” on page 61•“Mail (Global Settings)” on page 61•“Ports” on page 63Managing LicensesYou

Table of Contents 7 Creating Retention Policies...

70 vFoglight Administration and Configuration Guide The Manage Licenses dashboard appears in the display area, showing the list of installed licenses

Setting Up vFoglight 71Managing Licenses Alternatively, you can install a license using the command line using the license:import command that comes w

72 vFoglight Administration and Configuration Guide Once the vFoglight Management Server reads the license file, it stores it internally in the datab

Setting Up vFoglight 73Managing Licenses To view license capabilities:Note This procedure continues from “Accessing the Manage Licenses Dashboard” on

74 vFoglight Administration and Configuration Guide For information on how to install a cartridge, see Chapter 4, “Managing Cartridges” on page 147.•

Setting Up vFoglight 75Managing Support Bundles The License Confirmation dialog box closes. The list of installed licenses refreshes and a message ind

76 vFoglight Administration and Configuration Guide Accessing the Manage Support Bundles DashboardUsing the Administration module, you can gather dia

Setting Up vFoglight 77Managing Support Bundles •“Creating Server Support Bundles” on page 77•“Retrieving Server Support Bundles” on page 79•“Viewing

78 vFoglight Administration and Configuration Guide Note The appearance of the above dialog box may be different, depending on the type and version o

Setting Up vFoglight 79Managing Support Bundles Retrieving Server Support BundlesvFoglight stores support bundles in the <vfoglight_home>/suppor

8 vFoglightAdministration and Configuration Guide Using the Query Language to Set the Rule or Derived Metric Scope ...

80 vFoglight Administration and Configuration Guide Viewing the Content of Server Support BundlesServer support bundles contain diagnostic data gathe

Setting Up vFoglight 81Managing Support Bundles AuditingLog_*.xmlA listing of recent auditable changes to the vFMS/registry/rules/cartridges/security/

82 vFoglight Administration and Configuration Guide Note The “*” indicates a date/time stamp of the format “YYYY-MM-DD_HH-MM-SS”“.Viewing Audit Infor

Setting Up vFoglight 83Viewing Audit Information The View Audit Information dashboard allows you to select the time period for which you want to view

84 vFoglight Administration and Configuration Guide The Zonar displays the current date, time, and time range, and allows you to modify the current t

Setting Up vFoglight 85Viewing Audit Information Since all of the four columns appear in the View Audit Information dashboard by default, all of the c

86 vFoglight Administration and Configuration Guide aIn the audit log table, in the Operation Name (Name) column, click the Show/Hide columns button.

Setting Up vFoglight 87Viewing Audit Information When exporting the table contents to a CSV file, a dialog box appears, allowing you open the exported

88 vFoglight Administration and Configuration Guide To specify the period start and end times, click and drag the edges of the grey area in the Zonar

Setting Up vFoglight 89Backing Up, Upgrading, and Restoring vFoglight Backing Up, Upgrading, and Restoring vFoglightBackup and restore processes are i

Introduction to this GuideThis chapter provides information about what is contained in the vFoglight Administration and Configuration Guide. It also p

90 vFoglight Administration and Configuration Guide Option 2•Issue a mysqldump command to export the MySQL database.Alternatively, use the InnoDB Hot

Setting Up vFoglight 91Backing Up, Upgrading, and Restoring vFoglight The procedures below contain detailed information on how to back up the vFogligh

92 vFoglight Administration and Configuration Guide • If your system uses an Oracle database, refer to “To back up an Oracle database used by the vFo

Setting Up vFoglight 93Backing Up, Upgrading, and Restoring vFoglight cClick the Advanced tab and click Environment Variables.The Environment Variable

94 vFoglight Administration and Configuration Guide dVisually inspect the values associated with the PATH and LD_LIBRARY_PATH & ORACLE_HOME varia

Setting Up vFoglight 95Backing Up, Upgrading, and Restoring vFoglight • database_name is the database name, as configured by the foglight.database.nam

96 vFoglight Administration and Configuration Guide innodb_log_group_home_dir="vfoglight_home/mysql/data"set-variable=innodb_log_files_in_g

Setting Up vFoglight 97Backing Up, Upgrading, and Restoring vFoglight Contents of ..\..\backup\config\my.cnf:innodb_data_home_dir got value...Contents

98 vFoglight Administration and Configuration Guide ibbackup: Compressed 210 MB of data files to 36 MB (compression 82%).080922 15:29:54 ibbackup: Fu

Setting Up vFoglight 99Backing Up, Upgrading, and Restoring vFoglight InnoDB Hot Backup version 3.0.0; Copyright 2002-2005Innobase OyLicense A11983 is