Parameter Sets

Parameters Sets are a grouping mechanism for certain properties. A Parameter Set can be applied to a Dynamic Group or a Static Group of Systems.

The properties available for grouping are: Monitoring Parameters, Check Execution, Check Notification, and Monitoring Exception Parameters.

As you can easily see, there may be situations where a certain system belongs to more than one group. If you have the same property defined in two different Parameters Sets sharing a common subset of a system, you have to prioritize the Parameters Sets in order to decide which one is finally effective.

Furthermore, for every Parameter Set, you can define if the definition of a property in a Parameter Set can or cannot be overridden on a per-system level. If cannot, you can define a consistent set of properties throughout a class of the system. But even if you allow overriding, you can re-apply the properties at any time.

Parameters Sets can be scheduled. So, for example, it is possible to have different values for Monitoring Parameters of different periods of time. You may use schedules or service hours to define the validity period of a Parameter Set.

Please prioritize Parameters Sets carefully if they are scheduled!

Parameters Sets are a grouping mechanism for certain properties. A Parameter Set can be applied to a Dynamic Group or a Static Group of Systems.

The properties available for grouping are: Monitoring Parameters, Check Execution, Check Notification, and Monitoring Exception Parameters.

Please prioritize Parameters Sets carefully if they are scheduled!

Maintaining Parameter Sets

Defining Parameter Sets

The definition of a Parameter Set is performed in several steps:

First, you have to define the Parameter Set itself including the scope, i.e. you can define an ad-hoc System Selectors or choose an existing one.
In a second step, you can restrict the validity period of the Parameter Set. By default, it is valid 7x24h, but you may restrict it to certain Service Hours or Schedules.
In a thirds step, you assign Monitoring Parameters or Monitoring Exception Parameters to the defined set.
Finally, you have to adjust the priority of the Parameter Set. In case you define the same Monitoring Parameter affecting the same System in multiple Parameter Sets, the one with the highest priority will be effective.

In order to define a Parameter Set, proceed as follows:

Select Configuration Parameter Sets from the top-level menu. Push the New button.
Fill in a Name, select a System Type and push the New button in the pop-up window.
Switch to the Properties tab of the newly created record.
If you want to allow that the Monitoring Parameters assigned to this set can be overridden on a per-System level, check the box Allow Parameter Substitution per System.
Choose the Systems the Parameter Set is applied to:
1. You can either select an existing System Selectors (see Systems).
2. You can define a specific ad-hoc custom selection (which is only valid for this particular Parameter Set). In this case, set the flag next to Define specific 'Ad-Hoc' Custom Selection and push the Create button. Fill in selection criteria, push the Test System Selector button to verify the Systems, and hit the Save & Close button.

In section Active Time Period, choose whether the Parameter Set is valid Always, during specific Service Hours, or during Schedules. If you choose Service Hours, click on the , select a Service Hours record from the list and push the OK button. (See also Service hours).

If you choose Schedules, perform the following steps:

Push the New button.
Fill in a Name and select a Timezone value.

Perform one of the following

For a non-recurrent Schedule

Choose the Non-recurrent tab and fill in the Start date and either an End date or a Duration.

For a recurrent Schedule

Choose the Non-recurrent tab and fill in the Start date and either an End date or a Duration.

Select a Range Start and optionally a Range End.

Choose one of the following recurring options:

Daily

is effective every day or every n^th day.

Weekly

is effective for selected days of every n^th week.

Monthly Day

is effective for a single day of every n^th month, where the day of the month is given as number from 1 to 31. For values 29-31 the recurrence will fall on the last day of the month if the month has only 28, 29 or 30 days.

Monthly Weekday

is effective for a single weekday of a single week of every n^th month, where the weekday may be chosen from Sunday to Saturday and the week is specified as either 1^st, 2^nd, 3^rd, 4^th or last week of the month.

Yearly Day

is effective for a single day of a single month of every year.

Yearly Weekday

is similar to Monthly Weekday, except that it is only effective for the chosen month.

Push the OK button.
Add further Schedules if desired.

Push the Apply button.

To assign Monitoring Parameters to the recently created set, proceed as follows:

Switch to the Parameters tab and choose Monitoring from the left-hand side.
Add, modify, or delete Monitoring Parameters or Monitoring Exception Parameters.
Push the Apply button.

The Parameter Set is not yet active. To activate it, switch back to the Properties tab, set the Active flag, and hit the Apply button again.

Listing all Parameters Sets

Listing all defined Parameter Sets is simple: select Configuration Parameter Sets from the top-level menu.

By default Parameter Sets for all System Types are displayed, but you can restrict the list to a certain System Type using the drop-down list next to the icon.

Set the Expand Parameters flag in order to have all Monitoring Parameters defined in the Parameter Set in the list view.

You can click on the to display all Monitoring Parameters together with the values of a particular Parameter Set.

There are five tabs displayed, one for each System Type, and one labeled View All System Types containing all defined Parameter Sets.

The Parameter Sets are always sorted by priority with the highest priority on top.

Empty Parameter Set, i.e. the ones not containing any Monitoring Parameters, are displayed with a symbol in the Active column.

Changing the Priority of Parameters Sets

Select Configuration Parameter Sets from the top-level menu.

To change the priority of Parameter Sets use the icons.

As a rule of thumb, you should assign a low priority to Parameter Sets affecting all Servers (SAP Instances, SAP Systems, Databases) and those Parameter Sets being active all the time. Otherwise, other Parameter Sets may not be effective at all.

Showing Monitoring Parameter Usage

Select Configuration Parameter Sets from the top-level menu.
To see the values of a particular Monitoring Parameter on all Systems, push the Parameter Usage button.
Select the System Type and choose one or more Monitoring Parameters and move them to the right frame using the (and ) icons.
Push the Show Usage button.

In the result list you have the option to change the sorting, and to restrict the list to those Monitoring Parameters modified on a per-System level.

Overriding Parameter Set on a per-System level

You can override Monitoring Parameters defined in a Parameter Sets on a per-System level if and only if the set is defined with the Allow Parameter Substitution per System box checked.

Perform the following steps to allow parameter substitution for a Parameter Set:

Select Configuration Parameter Sets from the top-level menu. Choose the desired Parameter Set and push the Open button.
Set the flag next to Allow Parameter Substitution per System.
Push the Apply button to finish.

In order to modify or substitute a Monitoring Parameter inherited from a Parameter Set on a System level, perform the following steps:

Select the appropriate System. Choose Systems Servers, or Systems SAP Instances, or Systems SAP Systems, or Systems Databases, or Systems SAP BusinessObjects, or Systems Cloud Services.
Push the Open button and switch to the Moni. Params. tab.
Proceed to the Monitoring Parameter supposed to change and click on the next to the Value field. Confirm the warning message with OK.
Change the Value and push the Apply button.

You cannot delete a Monitoring Parameter inherited from a Parameter Set on a System level. You have to set the value of this Monitoring Parameter back to its default instead!

Deactivating Parameters Sets

In some cases, it can be helpful to deactivate Parameter Sets.

Select Configuration Parameter Sets from the top-level menu. Choose the desired Parameter Set from the list and push the Open button.
Clear the Active flag and push the Apply button.

Export and Import of Parameters Sets

Parameter Sets can be exported from a source Avantra installation and imported on a target Avantra installation. You can also use export and import to create backups for your Parameter Sets.

System selectors associated with a Parameter Set are only preserved when a system selector with the same name exists on the target Avantra installation. If no system selector with the same name can be found, the imported Parameter Set has an empty system selector. The same applies to Service Hours. Service Hours are only preserved when a Service Hour with the same name exists on the target system.

Export Parameters Sets

Select the Parameter Sets you want to export. You can select more than one Parameter Set.
Choose More Export Parameter Sets.
A zip file containing the exported Parameter Sets is downloaded to your download folder.

Import Parameters Sets

Login on your Avantra installation where you want to import the exported Parameter Sets.
In Parameter Sets, choose More Import Parameter Sets.
Upload previously exported parameter sets.
Click Next.
Select the parameter sets you want to import.
Click Next.
If a parameter set with the same name exists already, a new name is proposed. You can change the proposed name.
Click Next.
Click Import to confirm and execute the import.

Predefined Parameters Sets

If Avantra is installed the very first time on a new system, some predefined Parameter Sets are automatically created. The predefined Parameter Sets define typical settings for typical scenarios.

The name of the predefined parameter sets starts with TEMPLATE.

Those predefined Parameter Sets can be used as an example for your own Parameter Sets. You can copy, and or modify them to your needs. If you delete a predefined Parameter Set, Avantra does not recreate it again. The predefined Parameter Sets are not active after a fresh installation. You have to manually set them to active.

Table 1. List of predefined parameter sets
Parameter Set name	Usage
TEMPLATE - Databases [General]	Template parameter set for databases in general.
TEMPLATE - Databases [Non-production]	Template parameter set specifically for non-production databases.
TEMPLATE - Databases [Standalone]	Template parameter set specifically for non SAP Tenant databases e.g. SYSTEMDB.
TEMPLATE - SAP Instances [General]	Template parameter set specifically for SAP Instances in general (ABAP & Java).
TEMPLATE - SAP Instances [Overnight]	Template parameter set specifically for SAP Instances during non-working hours to help to reduce the amount of false-positive alerts.
TEMPLATE - SAP Systems - HANA	Template parameter set specifically for SAP Systems on HANA. It also excludes some indexes and recurrent data_backup_parameter_file.
TEMPLATE - SAP Systems [General]	Template parameter set for all SAP Systems in General.
TEMPLATE - SAP Systems [PROD]	Template parameter set specifically for production SAP systems.
TEMPLATE - SAP Systems [QUAL]	Template parameter set specifically for QA/Quality SAP Systems
TEMPLATE - SAP Systems [Sandbox]	Template parameter set specifically for Sandbox SAP Systems
TEMPLATE - Servers - Unix	Template parameter set specifically for a Unix/Linux OS.
TEMPLATE - Servers - Windows	Template parameter set specifically servers with a Microsoft OS.
TEMPLATE - Servers [General]	Template parameter set for servers in general.