Configuring a blackout by using pconfig

uInclude the PATROL_CONFIG string at the start of the PATROL Agent Configuration File (.cfg ).

Note

The .cfg file may contain multiple configuration variables. Ensure that the last variable does not have a trailing comma.

The following tasks explain how to use the pconfig command-line utility to configure the PATROL Agent configuration branch, /AgentSetup/Blackout, on UNIX and Windows.

To modify the configuration variable on UNIX

Go to the PATROL Agent installation directory and run the following script:
- For Korn and Bourne shell: ../patrolrc.sh
- For C shell: source.patrolrc
Create the config_file.cfg file and edit the configuration variables as required.

To modify the value of the /AgentSetup/Blackout configuration variable, use the following format:
```
PATROL_CONFIG "/AgentSetup/Blackout/<object>" = {REPLACE = "[TYPE; START_INFO; DURATION; INFO_MSG]"}
```
Save the config_file.cfg file.
Apply the changes made in the configuration variable to PATROL Agent, as follows:
```
pconfig -p <port> -host <hostName> <config_file.cfg>
```
Obtain the latest configuration information, as follows:
```
pconfig +get -p <port> -host <hostName> | grep Blackout
```
Verify that the change is made to the configuration variable.

To modify the configuration variable on Windows

Create the config_file.cfg file and edit the configuration variables as required.

To modify the value of the /AgentSetup/Blackout configuration variable, use the following format:
```
PATROL_CONFIG "/AgentSetup/Blackout/<object>" = {REPLACE = "[TYPE; START_INFO; DURATION; INFO_MSG]"}
```
Save the config_file.cfg file.
Apply the changes made in the configuration variable to PATROL Agent, as follows:
```
pconfig -p <port> -host <hostName> <config_file.cfg>
```

Obtain the latest configuration information, as follows:

pconfig +get -p <port> -host <hostName> -save <config_file.cfg>

Verify that the change is made to the configuration variable.

Examples

The following examples illustrate the blackout configuration and settings:

Example

"/AgentSetup/Blackout/CPU/CPU/CPUCpuUtil" = {REPLACE = "[ TYPE_COLLECTION; START DOW 1,3 AT 18:03; 15; \"Day of week Blackout \"]"}

This blackout is applied for the CPUCpuUtil parameter, on Monday and Wednesday of every week, at 18:03 hours, for a duration of 15 minutes.
"/AgentSetup/Blackout/CPU/CPU" = {REPLACE = "[ TYPE_COLLECTION; START DOM 15-21 AT 11:48; 5; \"Day of Month Blackout \"]"}

This blackout is applied for the CPU application class instance, for the span between the 15 ^th to the 21 ^st of every month, at 11:48 hours, for a duration of 5 minutes.
"/AgentSetup/Blackout/CPU" = {REPLACE = "[ TYPE_EVENT; START DAILY AT 17:00; 2; \"Daily Blackout will happen \"]"}

This blackout is applied for the CPU application class, daily, at 17:00 hours, for a duration of 2 minutes.
"/AgentSetup/Blackout/CPU/CPU/CPUCpuUtil" = {REPLACE = "[ TYPE_ALL; START ONCE AT 16:15; 0; \"Start Once Blackout \"]"}

This blackout starts at 16:15 hours and is applied once for an infinite duration of time.

Configuring a blackout by using pconfig

To modify the configuration variable on UNIX

To modify the configuration variable on Windows

Examples

Comments