Overview:

As your setups get larger, and start covering an ever increasing real estate you will need to start reusing parts of your setup and putting selected information into reusable variable to reduce your maintenance overhead

Timing:

20 mins

 

207.5 How can I use elements of my setup in many places?

By studying this tutorial, you will learn how to:

  • Create Types and promulgate the values of Variables defined in a type
  • Create Variables in Managed entities, Environments and the Operational Environment
  • Understand the scope of Variables as they are defined in Entities, Samplers, Types, Environments and the Operating Environment

Each of the three videos explains how to define Variables in different components of a monitoring environment, and illustrates how scoping rules are applied.  For more detail on scoping rules, refer to the Gateway Technical Reference Guide.

Features mentioned in this tutorial:

  • Samplers: See explanation in 201.1
  • Types: The same list of Samplers is often used across a number of Managed Entities, so from an organisational point of view, a Type is used to collect samplers into a single item meaning, for example, that the value of a variable needs to be changed in only one place rather than in each sampler
  • Variables: In many parts of the monitoring environment it is possible to specify the value of a setting either by entering data directly, or by referencing a variable. Variables, which are typically configured for settings in a sampler configuration, allows the same sampler definition to be used in several places, and the behaviour of the sampler will depend on the values of the variables at the point at which it is used
  • ​Managed Entities: See definition in Tutorial 201.1
  • Environments: If the same group of variables are used repeatedly in multiple places, you can use an Environment to simplify the management of the variables. An Environment is a collection of variables, and is configured using the Environment's top-level section. Each Managed Entity or Type can reference a single Environment which then makes the variables contained within the environment accessible by any samplers defined on that entity or Type. When a Type is added to a Managed Entity using an addTypes setting, an Environment can also be specified for use by the Samplers defined within the Type
  • Operating Environment: The Gateway Operating Environment is a configuration section in which settings that will affect the whole Gateway are set

There are three videos in this tutorial covering:

  • Samplers and Types
  • Managed Entities, Environments and the Operational Environment
  • Scope of Variables

All of these videos define the Variable GlobalsampleInterval in different parts of the monitored environment, and illustrate how the value of variables can be promulgated throughout the monitored environment. 

This first of three videos illustrates the creation of Types and shows how you can create a Type containing a variable whose value is promulgated to Samplers that are assigned to the Type. Click below to watch the video: 

 

Give it a try

  1. Fire up the GSE
  2. Click on Samplers and then New Sampler
  3. Create a new Sampler and assign it a Plug-in
  4. Create a second and maybe a third Sampler
  5. Evaluate and Save the new Samplers
  6. To create a Type, click on Types in the left hand pane of the GSE
  7. Click on New type
  8. Create a new Type
  9. Assign the samplers to the Type
  10. On the Advanced Tab, create a variable, select one of the options and give it a value
  11. Add the Variable to the individual Samplers you created earlier
  12. Create Managed Entity by right-clicking on Managed Entities in the left hand pane of the GSE
  13. Click on New Managed Entity
  14. Assign a NetProbe
  15. Assign the Type you created earlier
  16. Exit the GSE
  17. Check out the Metric for one of the Samplers.  What is the Sampling time?
  18. Fire up the GSE
  19. Return to the type you created earlier
  20. Change the value of the Variable
  21. Evaluate, save the change and exit the GSE
  22. Return to the Metric for the CPU Sampler.  Has the value of the sample interval changed

 

This video shows how you can create Variables of the same name in a Managed Entity, an Environment and the Operating Environment.  The video illustrates how the rules of scope are applied to the Variable depending on where it is defined.

Give it a try

  1. Create a Variable, GlobslSampleInterval, in a Managed Entity through a Sampler
  2. Verify that the sample interval has changed by checking the Active Console
  3. Create an Environment by right-clicking on Environments in the left pane of the GSE
  4. Click on New Environment and give it a name
  5. Create a Variable, GlobalSampleInterval as an integer.  Give it a value
  6. Evaluate and Save the Environment
  7. Go to the Active Console. Has the value of the sample interval changed? If not, why not?
  8. Click on Operating Environment in the left pane of the GSE
  9. In the dialog box, create a Variable, GlobalSampleInterval as an integer.  Give it a value
  10. Evaluate and save the Operating Environment
  11. Go to the Active Console. Has the value of the sample interval changed? If not, why not?
  12. Return to the Managed Entity in the GSE
  13. Remove the Variable definition
  14. Add the Environment that you previously created to the Managed Entity
  15. Evaluate and Save the change
  16. Go to the Active Console.  Has the value the sampling interval changed? If it has changed, why has it changed?
  17. go to the Environment you previously created
  18. Remove the Variable that you created
  19. Evaluate and save the change

Go to the Active Console.  Has the value the sampling interval changed? If it has changed, why has it changed?

 

This video explains how you can set a variable in different parts of the monitored environment and promulgate the value throughout your monitored environment.  The video also illustrated the rules of scope in the Geneos environment.  The video uses an Managed Entities and Managed Entity Attributes to explain some of the points, so there is reference to entities called Bonds 1 and Equities 1 and an attribute called AMRS.

Give it a try

  1. Fire up the GSE
  2. If you don't already have a Managed Entity with assigned samplers, create one
  3. Create a Variable, GlobalSampleInterval in the Managed Entity. Make it an integer and give it a value
  4. Create the same Variable in the Samplers
  5. Check that the Variable in the Samplers has the same value as the Variable in the Managed Entity
  6. Evaluate and save the changes
  7. Check that the value of the sample Interval has changed
  8. Create a Type by right-clicking on Types in the left hand pane of the GSE
  9. Click on New Type
  10. Add the Samplers to the Type
  11. Add a Variable (GlobalSampleInterval) to the Type
  12. Evaluate and save the changes
  13. Go to Active Console and take a look at the sampling interval for one of the samplers
  14. Has the value of the sampling interval changed? If not, why not?
  15. Go to the Managed Entity and remove the Variable
  16. Remove the Samplers from the Managed Entity
  17. Add a Type to the Managed Entity
  18. Save and Evaluate the changes
  19. Return to Active console and verify that the sampling interval has now changed. If it has changed, why has it changed?
  20. Create an Environment by clicking on Environments in the left pane of the GSE
  21. Click on New Environment
  22. Create a Variable, GlobalSampleInterval.  Make it an integer and give it a value
  23. Return to the Managed Entity in the GSE
  24. Add the Environment that you just created
  25. Evaluate and save the changes to the Environment and the Managed Entity.
  26. Go the Active console.  Has the value of the sample interval changed.  If so, why has it changed?

 

207.9 How do I share configuration across Gateways? 

By studying this tutorial, you will learn how to share configuration across Gateways.  This feature enables you to share data items among Gateways and that enables you to change s value in one place.  Features covered in this session are:

  • Creating an Include file on a Gateway
  • Adding a rule to the Include file
  • Accessing the Include file on a second Gateway
  • Accessing the rule on the second Gateway

 

Give it a try

Before starting this tutorial, make sure that you have two gateways available. Create an Include file and add a rule to it

  1. Add a sampler to each Gateway
  2. Add a Managed Entity to each Gateway
  3. Fire up the Gateway Setup Editor (GSE) on the first Gateway
  4. If the rule doesn't exist, create a rule called percent_util (or similar)
  5. In the Navigation pane, click on "Includes"
  6. Confirm that you want to create Includes
  7. Right-click and select "New Include"
  8. Set the priority of the Include higher than 1
  9. Add the name of the Include in the Location field
  10. Set the reload value
  11. Expand the Include fie in the Navigation pane
  12. Click on "click to load"
  13. Confirm that you want to create and load the file
  14. Expand "Gateway"
  15. Click on "Rules" and confirm that you want to create Rules
  16. Locate "Rules" on the first Gateway (SYSMON in the example)
  17. Expand "Rules" and locate the rule you created earlier (percentutil_rule" in the example)
  18. Drag the rule to the Rules section in the Include file
  19. Check that the rule has successfully moved
  20. Validate and save the change

Make the Include file and the rule accessible from a second Gateway

  1. Right-click on the second Gateway icon in the Gateway view and select "Configure Gateway"
  2. Click on "Includes" in the Navigation pane
  3. Right-click on "Includes"
  4. Select "New Include"
  5. Change the priority of the Include so that it is greater than 1
  6. Set the location to be the same as the previous Include
  7. Set the "Reload Interval" to 1
  8. In the Navigation pane, expand the Include file
  9. Click on "Click to load"
  10. Confirm that you want to load the file
  11. Expand "Gateway" in the Navigation pane
  12. Locate and expand "Rules" in the Include
  13. Check that the rule is the same as previously
  14. To create a new path, click on "Add new"
  15. In the metric for the second gateway (NL_Gateway in this example), locate the cell to which you want to apply the rule
  16. Drag the cell to the path field in the GSE
  17. Validate and save the rule

Check that the Rule has been promulgated to the metrics

  1. In the second Gateway, right-click on the cell (percentUtilisation)
  2. Select "Show rules"
  3. Bring up the metric from the first Gateway and verify that the rule is the same
  4. Right-click in the cell
  5. Select "Show Rules".  Are the rules the same?

Make a change to the rule on one gateway and validate that the change is promulgated to the second Gateway

  1. Fire up the GSE
  2. Expand "Includes" in the Navigation Pane"
  3. Expand the Include file you created earlier
  4. Click on "click to load"
  5. Expand "Gateway" in the Navigation Pane
  6. Expand "Rules" below "Gateway"
  7. Change one or more values in the rule
  8. Validate and save the changed rule
  9. Right-click on the second Gateway icon in the Gateway view and select "Configure Gateway"
  10. Expand "Includes" in the Navigation pane
  11. Expand the Include file you created earlier
  12. Click on "click to load"
  13. Confirm that you want to load the file
  14. Click on "Gateway" in the Navigation pane
  15. Expand "Rules"
  16. Click on the rule that you created earlier
  17. Confirm that the changes have been carried through to this Gateway
  18. Exit the GSE
  19. Go to the cell (percentUtilisation in the example) in the metric for one of the Gateways
  20. Right click in the cell and select "show rules"
  21. Verify that the change has taken effect
  22. Go to the cell (percentUtilisation in the example) in the metric for the other Gateway
  23. Right-click in the cell and select "Show Rules"
  24. Verify that the change has taken effect

 

Exam Guidance:

Pay attention to the use of include files in a gateway, including narratives on when they are of most use, then on types, variables and environments within the gateways setup to setup properties in just one place for use in many.

Click here for legal disclaimer