HPE iLO NMI Watchdog Driver

ProLiant iLO watchdog과 ASR

HPE iLO NMI Watchdog 드라이버는 iLO 기반 ProLiant 서버에 기본 watchdog 기능과 iLO의 `Generate NMI to System` 가상 버튼 처리기를 제공하는 커널 모듈입니다. 문서의 iLO 언급은 iLO2와 이후 세대에도 적용됩니다. 마지막 검토일은 2018-08-20입니다.

일반 watchdog 드라이버와 마찬가지로 타이머를 주기적으로 갱신하는 애플리케이션이 필요합니다. `tools/testing/selftests/watchdog/watchdog-test.c`를 빌드해 실행할 수 있습니다.

시스템이 비정상 상태로 멈추면 ProLiant iLO 타이머 레지스터가 제때 갱신되지 않아 Automatic Server Recovery, 즉 ASR 하드웨어 reset이 발생합니다.

===========================
HPE iLO NMI Watchdog Driver
===========================

for iLO based ProLiant Servers
==============================

Last reviewed: 08/20/2018


 The HPE iLO NMI Watchdog driver is a kernel module that provides basic
 watchdog functionality and handler for the iLO "Generate NMI to System"
 virtual button.

 All references to iLO in this document imply it also works on iLO2 and all
 subsequent generations.

 Watchdog functionality is enabled like any other common watchdog driver. That
 is, an application needs to be started that kicks off the watchdog timer. A
 basic application exists in tools/testing/selftests/watchdog/ named

모듈 매개변수

`soft_margin`은 watchdog timeout을 설정하며 기본값은 30초입니다. `timeout`은 같은 값을 가리키는 별칭입니다.

`pretimeout`은 최종 timeout 몇 초 전에 NMI를 전달할지 정합니다. 0이면 pretimeout NMI를 끄고 기본값은 9초입니다.

`nowayout`은 한 번 시작한 타이머를 다시 시작하거나 임박한 ASR을 피하지 못하게 합니다. 기본값은 커널 빌드 때 결정되고 `Y`이면 시작 후 watchdog을 끌 방법이 없습니다.

`kdumptimeout`은 NMI를 받은 뒤 panic을 호출하기 전에 적용할 최소 timeout입니다. -1은 watchdog을 비활성화하고, 0보다 크면 지정값과 현재 timeout 중 더 큰 값으로 타이머를 다시 프로그래밍합니다.

 watchdog-test.c. Simply compile the C file and kick it off. If the system
 gets into a bad state and hangs, the HPE ProLiant iLO timer register will
 not be updated in a timely fashion and a hardware system reset (also known as
 an Automatic Server Recovery (ASR)) event will occur.

 The hpwdt driver also has the following module parameters:

 ============  ================================================================
 soft_margin   allows the user to set the watchdog timer value.
               Default value is 30 seconds.
 timeout       an alias of soft_margin.
 pretimeout    allows the user to set the watchdog pretimeout value.
               This is the number of seconds before timeout when an
               NMI is delivered to the system. Setting the value to
               zero disables the pretimeout NMI.
               Default value is 9 seconds.
 nowayout      basic watchdog parameter that does not allow the timer to
               be restarted or an impending ASR to be escaped.
               Default value is set when compiling the kernel. If it is set
               to "Y", then there is no way of disabling the watchdog once
               it has been started.
 kdumptimeout  Minimum timeout in seconds to apply upon receipt of an NMI
               before calling panic. (-1) disables the watchdog.  When value
               is > 0, the timer is reprogrammed with the greater of
               value or current timeout value.
 ============  ================================================================

 NOTE:

고정 pretimeout과 kdump

일반 watchdog ioctl과 `/dev/watchdog` 인터페이스는 `Documentation/watchdog/watchdog-api.rst`와 `Documentation/driver-api/ipmi.rst`를 참조합니다.

iLO 하드웨어 제약 때문에 NMI pretimeout을 켠 경우 9초로만 설정할 수 있습니다. 다른 0이 아닌 값을 쓰면 반올림되어 0이 될 수도 있으므로 pretimeout이나 timeout을 설정한 뒤 실제 값을 다시 확인해야 합니다.

iLO NMI를 받으면 hpwdt는 crash dump를 수집할 수 있도록 panic을 시작합니다. 사용자는 kdump가 올바르게 구성되었는지 책임져야 합니다.

기본 Linux panic 동작은 kernel tombstone을 출력하고 무한 대기하는데, 일반적인 watchdog 사용자가 원하는 동작은 아닙니다. kdump 문서와 `panic=` 커널 매개변수, 배포판 문서를 함께 확인합니다.

       More information about watchdog drivers in general, including the ioctl
       interface to /dev/watchdog can be found in
       Documentation/watchdog/watchdog-api.rst and Documentation/driver-api/ipmi.rst

 Due to limitations in the iLO hardware, the NMI pretimeout if enabled,
 can only be set to 9 seconds.  Attempts to set pretimeout to other
 non-zero values will be rounded, possibly to zero.  Users should verify
 the pretimeout value after attempting to set pretimeout or timeout.

 Upon receipt of an NMI from the iLO, the hpwdt driver will initiate a
 panic. This is to allow for a crash dump to be collected.  It is incumbent
 upon the user to have properly configured the system for kdump.

 The default Linux kernel behavior upon panic is to print a kernel tombstone
 and loop forever.  This is generally not what a watchdog user wants.

 For those wishing to learn more please see:
        - Documentation/admin-guide/kdump/kdump.rst
        - Documentation/admin-guide/kernel-parameters.txt (panic=)

NMI 누락 시 reset과 저작권

만료 타이머와 연관된 NMI를 hpwdt가 받지 못하더라도 타이머가 갱신되지 않으면 iLO는 최종 timeout 때 시스템 reset을 계속 진행합니다.

HPE iLO NMI Watchdog 드라이버와 이 문서는 원래 Tom Mingarelli가 개발했습니다.

        - Your Linux Distribution specific documentation.

 If the hpwdt does not receive the NMI associated with an expiring timer,
 the iLO will proceed to reset the system at timeout if the timer hasn't
 been updated.

--

 The HPE iLO NMI Watchdog Driver and documentation were originally developed
 by Tom Mingarelli.