Loading and configuring the diag288 watchdog device driver

Red Hat Enterprise Linux 8.6 LPAR mode z/VM guest KVM guest

You configure the diag288 watchdog device driver when you load the module.

watchdog module parameter syntax

Notes:

¹ cmd= and conceal= apply only to Linux® on z/VM® and are ignored for Linux in LPAR mode and Linux on KVM.

where:

<command>

configures the shutdown action to be taken if Linux on z/VM fails. The default, SYSTEM RESTART, configures the shutdown action that is specified for the restart shutdown trigger.

Any other specification dissociates the timeout action from the restart shutdown trigger. Instead, the specification is issued by CP and must adhere to these rules:

It must be a single valid CP command
It must not exceed 230 characters
It must be enclosed by quotation marks if it contains any blanks or newline characters

The specification is converted from ASCII to uppercase EBCDIC.

For details about CP commands see z/VM: CP Commands and Utilities Reference, SC24-6268.

On an running instance of Linux on z/VM, you can write to /sys/module/diag288_wdt/parameters/cmd to replace the command you specify when loading the module. Through this sysfs interface, you can also specify multiple commands to be issued, see Examples for more details.

The preferred method for configuring a timeout action other than a system restart is to configure a different shutdown action for the restart shutdown trigger.

conceal=1

enables the protected application environment where the guest is protected from unexpectedly entering CP READ. Do not enable the protected environment for guests with multiprocessor configurations. The protected application facility supports only virtual uniprocessor systems.

For details, see the SET CONCEAL section of z/VM: CP Commands and Utilities Reference, SC24-6268.

<nowayout_flag>

determines what happens when the watchdog device node is closed by the watchdog application.

If the flag is set to 1 (default), the watchdog timer keeps running and triggers an action if no positive status report is received within the specified time interval. If the character "V" is written to the device and the flag is set to 0, the z/VM watchdog timer is stopped and the Linux instance continues without the watchdog support.

Examples for Linux on z/VM

The following command loads the watchdog module and determines that, on failure, the Linux instance is to be IPLed from a device with devno 0xb1a0. The protected application environment is not enabled. The watchdog application can close the watchdog device node after writing "V" to it. As a result the watchdog timer becomes ineffective and does not IPL the guest.

# modprobe diag288_wdt cmd="ipl b1a0" nowayout=0

The following example shows how to specify multiple commands to be issued.

# /usr/bin/printf "<cmd1>\n<cmd2>\n<cmd3>" > /sys/module/diag288_wdt/parameters/cmd

where <cmd1>, <cmd2>, and <cmd3>are z/VM commands.

Use the printf version at /usr/bin/printf. The built-in printf command from bash might not process the newline characters as intended.

To verify that your commands have been accepted, issue: To verify that your commands have been accepted, issue:

# cat /sys/module/diag288_wdt/parameters/cmd
<cmd1>
<cmd2>
<cmd3>

Note: You cannot specify multiple commands as module parameters while loading the module.