man/dumpconf.8

   1 .TH DUMPCONF 8 "Nov 2006" "s390-tools"
   2
   3 .SH NAME
   4 dumpconf \- Configure automatic dump for Linux on z/Series.
   5
   6 .SH SYNOPSIS
   7 .br
   8 \fBdumpconf\fR [start|stop|status]
   9 .br
  10 \fBdumpconf\fR [-h|-v]
  11
  12 .SH DESCRIPTION
  13 \fBdumpconf\fR reads /etc/sysconfig/dumpconf and initializes the automatic dump
  14 feature according to the configuration file.
  15
  16 The following keywords can be used in the dumpconf file:
  17
  18 .TP
  19 \fB  - ON_PANIC:\fR
  20 Shutdown action in case of a kernel panic. Possible values are 'dump', 'reipl', 'dump_reipl', 'stop' and 'vmcmd':
  21 .br
  22
  23 dump: trigger dump according to configuration in /etc/sysconfig/dumpconf.
  24 .br
  25
  26 reipl: trigger re-IPL according to configuration under /sys/firmware/reipl.
  27 .br
  28
  29 dump_reipl: first trigger dump according to configuration in
  30 /etc/sysconfig/dumpconf, then trigger re-IPL according to configuration under
  31 /sys/firmware/reipl.
  32 .br
  33
  34 stop: stop Linux and enter disabled wait (default).
  35 .br
  36
  37 vmcmd: trigger vm command according to 'VMCMD_X' configuration in /etc/sysconfig/dumpconf.
  38
  39 .TP
  40 \fB  - DUMP_TYPE:\fR
  41 Type of dump device. Possible values are 'ccw' and 'fcp'.
  42
  43 .TP
  44 \fB  - DEVICE:\fR
  45 Device number of dump device.
  46
  47 .TP
  48 \fB  - WWPN\fR
  49 WWPN for scsi dump device.
  50
  51 .TP
  52 \fB  - LUN\fR
  53 LUN for scsi dump device.
  54
  55 .TP
  56 \fB  - BOOTPROG:\fR
  57 Boot program selector
  58
  59 .TP
  60 \fB  - BR_LBA:\fR
  61 Boot record logical block address.
  62
  63 .TP
  64 \fB  - VMCMD_1, VMCMD_2 ... VMCMD_5:\fR
  65 Up to five CP commands, which are triggered in case of a kernel panic.
  66
  67 .SH Reboot loop considerations
  68
  69 If you select the shutdown actions "reipl" or "dump_reipl", in rare cases a
  70 "reboot loop" can occur, if the Linux kernel crashes everytime after the
  71 reboot. If you want to prevent that scenario, one of the following two
  72 approaches can be taken:
  73
  74 1. Manual activation of dumpconf
  75
  76 Ensure that the dumpconf service is not active by default:
  77 .br
  78 # chkconfig --del dumpconf
  79
  80 Start dumpconf service manually:
  81 .br
  82 # service dumpconf start
  83
  84 When your Linux system crashes, the system will be rebooted (after creating
  85 a dump in case of dump_reipl). Because the dumpconf script will then not be
  86 activated automatically, a second crash will stop the system.
  87
  88 2. Automatic delayed activation of dumpconf
  89
  90 Ensure that the dumpconf service is not active by default:
  91 .br
  92 # chkconfig --del dumpconf
  93
  94 To enable delayed activation one of the following methods can be used:
  95   a) Use a init script (e.g. /etc/rc.d/boot.local):
  96      (sleep 10m; /sbin/service dumpconf start) &
  97
  98   b) Use a init script (e.g. /etc/rc.d/boot.local) together with "at":
  99      echo 'echo /sbin/service dumpconf start' |at now+10min
 100
 101   c) Use the following crontab entry:
 102      @reboot sleep 10m && /sbin/service dumpconf start
 103
 104 In these examples, when your Linux system crashes within 10 minutes after
 105 the reboot, the dumpconf script is not active and a second crash will stop
 106 the system.
 107
 108 .SH COMMANDS
 109 .TP
 110 \fBstart\fR
 111 Enable configuration defined in /etc/sysconfig/dumpconf.
 112
 113 .TP
 114 \fBstop\fR
 115 Disable dump configuration.
 116
 117 .TP
 118 \fBstatus\fR
 119 Show current configuration.
 120
 121 .SH OPTIONS
 122 .TP
 123 \fB-h\fR or \fB--help\fR
 124 Print usage information, then exit.
 125
 126 .TP
 127 \fB-v\fR or \fB--version\fR
 128 Print version information, then exit.
 129
 130 .SH EXAMPLES:
 131 The following are examples for /etc/sysconfig/dumpconf:
 132 .br
 133
 134 #
 135 .br
 136 # Example config for CCW dump device (DASD)
 137 .br
 138 #
 139 .br
 140 ON_PANIC=dump_reipl
 141 .br
 142 DUMP_TYPE=ccw
 143 .br
 144 DEVICE=0.0.4714
 145 .br
 146
 147 #
 148 .br
 149 # Example config for FCP dump device (SCSI Disk)
 150 .br
 151 #
 152 .br
 153 ON_PANIC=dump
 154 .br
 155 DUMP_TYPE=fcp
 156 .br
 157 DEVICE=0.0.4711
 158 .br
 159 WWPN=0x5005076303004712
 160 .br
 161 LUN=0x4713000000000000
 162 .br
 163 BOOTPROG=0
 164 .br
 165 BR_LBA=0
 166 .br
 167
 168 #
 169 .br
 170 # Example config for vm command on panic
 171 .br
 172 #
 173 .br
 174 ON_PANIC=vmcmd
 175 .br
 176 VMCMD_1="MESSAGE * Starting VMDUMP"
 177 .br
 178 VMCMD_2="VMDUMP"
 179 .br
 180 VMCMD_3="IPL 4711"
 181
 182 #
 183 .br
 184 # Example config for re-IPL on panic
 185 .br
 186 #
 187 .br
 188 ON_PANIC=reipl
 189
 190 .SH SEE ALSO
 191 Linux on zSeries: Using the Dump Tools