OpenVMS VAXDOSD06_062 VAX V6.1 - VAX V6.2 Dump Off System Disk ECO Summary
NOTE: An OpenVMS saveset or PCSI installation file is stored
on the Internet in a self-expanding compressed file.
The name of the compressed file will be kit_name-dcx_vaxexe
for OpenVMS VAX or kit_name-dcx_axpexe for OpenVMS Alpha.
Once the file is copied to your system, it can be expanded
by typing RUN compressed_file. The resultant file will
be the OpenVMS saveset or PCSI installation file which
can be used to install the ECO.
Copyright (c) Digital Equipment Corporation 1996. All rights reserved.
PRODUCT: OpenVMS VAX
COMPONENT: Dump Off System Disk (DOSD)
EXCEPTION.EXE
SDA.EXE
SYSBOOT.EXE
VMB.EXE
EXCEPTION.STB (V6.2 only)
SYSGEN.EXE (V6.2 only)
SYSGEN.HLB (V6.2 only)
SYSMAN.EXE (V6.2 only)
SOURCE: Digital Equipment Corporation
ECO INFORMATION:
ECO Kit Name: VAXDOSD06_062
ECO Kits Superseded by This ECO Kit: VAXDOSD05_062
VAXDOSD04_062
VAXDOSD03_062
VAXDOSD02_062
VAXDOSD01_062
ECO Kit Approximate Size: 3,962 blocks
ECO Kit Size: Saveset A - 108 Blocks
Saveset B - 1,188 Blocks
Saveset C - 2,628 Blocks
Cover Letter - 38 Blocks
Kit Applies To: OpenVMS VAX V6.1, V6.2
System/Cluster Reboot Necessary: Yes
Installation Rating: 3 - To be installed on all systems running
the listed versions of OpenVMS which
are experiencing the problems described.
NOTE: In order to receive the full fixes listed in this kit,
the following remedial kits also need to be installed:
VAXSHAD09_061
**************************** WARNING **************************
* *
* VAX 7000 CONSOLE REQUIREMENT *
* *
* In order to use DUMPSTYLE for DOSD on VAX 7000 type systems, *
* Version 4.3 or later of the VAX 7000 console firmware must *
* be installed. Contact your Digital Service Representative *
* to get the latest version of the console firmware. *
* *
* Later versions of the VAX 7000 console firmware support all *
* LASER VAX processors and the BOOT_ALT environment variable, *
* which allows the operator to specify the alternate path to *
* the system disk for the console to use during shutdown in *
* event of a path failover. All consoles with Version numbers *
* less than V4.0 will support the VAX 7600 system *only*. *
* *
* If an attempt is made to install this ECO kit on a VAX 7000 *
* system that does not have the correct version of the console *
* firmware, the system may be rendered unbootable. *
* *
*****************************************************************
ECO KIT SUMMARY:
An ECO kit exists for OpenVMS VAX V6.1 and V6.2. This kit addresses
the following problems:
Problems Addressed in the VAXDOSD06_062 ECO kit:
o The VAX 7000 console revision referenced was no longer valid.
This kit updates the console requirement information listed
under the section below entitled "Problems addressed in the
VAXDOSD01_062 ECO kit".
o The AUTOGEN.COM and SMISERVER.EXE images were added to the
VAX V6.2 saveset.
Problems Addressed in the VAXDOSD05_062 ECO kit:
o The KITINSTAL.COM in the VAXDOSD04_062 kit included a "set
verify" command that caused unnecessary text to be output to
the console. There are no new DOSD problem fixes in this kit.
If you have installed the VAXDOSD04_062 kit you do not need to
install the VAXDOSD05_062 kit.
Problems Addressed in the VAXDOSD04_062 ECO Kit:
o The KITINSTAL procedure for the VAXDOSD03_062 did not copy the
VMB.EXE and SYSBOOT.EXE images contiguously. This prevented
the system from re-booting after the kit was installed.
Problems Addressed in the VAXDOSD03_062 ECO Kit:
o DOSD (Dump off System Disk) will probably guarantee that
dumps will not always fit in a 1GB user area. SDA's
crash dump analysis is being changed to use RMS I/O to
read the information instead of using $CRMPSC to map
the dump file as part of the user address space. This
change will also give two additional benefits:
o Analyze crash dumps with smaller virtual page count in the
analyzing process.
o Capability to analyze crash dumps using FAL on remote
machines.
Problems Addressed in the VAXDOSD02_062 ECO Kit:
o Add the SYSGEN.EXE and SYSGEN.HLB images to allow the VAX 7000
to use the full range of the DUMPSTYLE parameter.
Problems Addressed in VAXDOSD01_062 Kit:
o Under the following restricted set of configurations, OpenVMS
VAX customers can write the system dump to a device other than
the system disk. To enable the bugcheck code to write the dump
to an alternate device, you must correctly enable the DUMPSTYLE
system parameter.
See the DUMPSTYLE system parameter in the OpenVMS System
Management Utilities Reference Manual for the values (relevant
excerpt from that manual is included below).
Configuration Requirements:
If the following configuration requirements are met, it will be
possible to configure and use a device other than the system
disk for writing the system crash dump file:
- The system must be connected directly to and must boot from
CI controllers.
- The dump device must physically connect to the same two HSx
CI controllers as the boot device.
- The dump device directory structure must resemble the
current system disk structure. The
[SYSn.SYSEXE]SYSDUMP.DMP file will reside there, using the
same boot time system root. On OpenVMS V6.2, you can use
AUTOGEN to create this file. In the MODPARAMS.DAT file,
the following symbol prompts AUTOGEN to create the file:
DUMPFILE_DEVICE = $nnn$ddcuuuu
There is support for this feature under OpenVMS VAX V6.1.
- The volume label can be up to twelve characters long. The
ASCII string DOSD_DUMP must be part of this volume label.
For example, all of the following are valid volume labels:
DOSD_DUMP, DOSD_DUMP_12, 12_DOSD_DUMP. This label is read
and retained in a memory boot data structure.
- The dump device cannot be part of a volume set. Digital
recommends that the dump device not be part of a shadow
set.
- The dump device cannot be MSCP unit zero (0); only unit
numbers 1 to 4095 ( 1 - FFF ) will be supported. You can
designate the dump device as follows:
o On VAX 7000 configurations, by using bits 16 through 27
of the DUMPSTYLE system parameter.
o On configurations other than the VAX 7000, by using
bits 16 through 27 of register 3 (R3). This portion of
the register can specify the desired dump device.
The VAX 7000 has special DUMPSTYLE requirements (listed below)
to implement this feature.
- Excerpt from the OpenVMS V6.2 System Management Utilities
Reference Manual
Parameters
DUMPSTYLE
DUMPSTYLE specifies the method of writing system dumps.
DUMPSTYLE has AUTOGEN and DYNAMIC attributes.
DUMPSTYLE is a 32-bit mask with the following values.
___________________________________________________________
Bit Mask Description
___________________________________________________________
0 00000001 0 = Full dump (SYSGEN default).
The entire contents of
physical memory will be
written to the dump file.
1 = Selective dump. The contents
of memory will be written to
the dump file selectively to
maximize the usefulness of
the dump file while conserving
disk space.
1 00000002 0 = Minimal console output.
1 = Full console output (includes
stack dump, register contents,
so on).
2 (VAX 00000004 0 = Dump to system disk.
only)[1]
1 = Dump off system disk (DOSD) to
an alternate disk.
3 (Alpha 00000008 0 = Do not compress.
only)[2]
1 = Compress. (See note below.)
4 - 14 Reserved to Digital.
15 [3] 00008000 0 = Disable use of bits 16 - 27.
1 = Enable use of bits 16 - 27.
16 - 27 0FFF0000 Range of DOSD unit numbers.
28 - 31 Reserved to Digital.
___________________________________________________________
[1]Alpha systems do not support dumping to an alternate disk.
[2]VAX systems do not support dump compression.
[3]Specific to VAX 7000s.
___________________________________________________________
- Implementation Requirements - VAX 6000 Systems
Register R3 must be used to stipulate the DOSD device unit
number. Note that Bit 31 must be a zero,therefore the system
disk cannot be a Volume Shadow Phase I shadow set device.
R3 =
0001EX006 Bits#
| \ / \ /
| | | +-------> (11 -> 00) Boot Unit Number
| |
| |
| +-------------> (27 -> 16) DOSD Unit Number.
| Unit 30 is hex 1E
|
+-----------------> (31) Must be Zero
$MC SYSGEN
$! For a FULL dumpstyle dump, on the DOSD device.
SYSGEN> SET DUMPSTYLE %X00000004
SYSGEN> WRITE CURRENT
$! For a Sub-set dumpstyle dump, on the DOSD device.
SYSGEN> SET DUMPSTYLE %X00000005
SYSGEN> WRITE CURRENT
SYSGEN> EXIT
$
Reboot the VAX 6000
- Implementation Requirements - VAX 7000 Systems
VAX 7000 Use of DUMPSTYLE for DOSD
In order to stipulate the dump device on this platform, the
SYSGEN parameter DUMPSTYLE must be used.
Bits sixteen (16) through twenty-seven (27) will be checked by
SYSBOOT for the unit number of the dump device ... IF bit
fifteen (15) is also set.
For example, to use unit thirty (30) as the dump device, and
have a full (as versus a subset) dump take place:
$MC SYSGEN
SYSGEN> SET DUMPSTYLE %X001E8002
SYSGEN> WRITE CURRENT
Reboot the VAX 7000
Bit#
%X001E8006 / (0) = 0 Full Dump
\ / | | / (1) = 1 Full Console Output at
| | | / Bug Check
| | +------> (2) = 1 Use Dump Off System
| | \ Disk device
| | \ (3) = ·
| |
| | / (12) = ·
| | / (13) = ·
| +---------> (14) = ·
| (15) = 1 Enable Flag for bits 27 - 16
| for DOSD on VAX 7000
+------------> (27->16) DOSD Unit Number ...
Unit 30 in hex
o VAX 7000 CONSOLE REQUIREMENT
In order to use DUMPSTYLE for DOSD on VAX 7000 type systems
you must install version 4.3 or later of the VAX 7000 console
firmware. Contact your Digital Service Representative to get
the latest version of the console firmware.
Later versions of the VAX 7000 console firmware support all
LASER VAX processors and the BOOT_ALT environment variable,
which allows the operator to specify the alternate path to the
system disk for the console to use during shutdown in the
event of a path failover. All consoles with Version numbers
less than V4.0 will support the VAX 7600 system only.
Copy the console image to a MOM$SYSTEM: area on a system that
can serve as a boot-host to the VAX 7000. Prepare and update
the console by doing the following at the console prompt of the
target VAX 7000 system.
>>> show *
... record current environment variable settings.
NOTE: If the patch for the HSJ single path problem described
in BLITZ article TD# 1566 has been applied to this
system, you must erase that patch before proceeding.
To do this, type:
>>> build eeprom
>>> update -e ka7aa*
Now proceed with installing the update:
>>> set auto_action halt
>>> boot -flag 0,0,0 -file vax7000_v07_3 exa0 # or fxa0
... LFU is booted and run, update ka7aa*, exit ...
>>> build eeprom
>>> update -e ka7aa*
>>> build nvr # on each cpu
>>> set config
>>> set xxx yyy # restore environment
# variable settings
# previously recorded.
-------------------------------------------------------------
This is an example in the use of the 'BOOT_ALT' environment
variable:
The system disk (dua22) is dual ported between HSC00 and HSC02.
In the following console log extract, DUA21, DUA22, and DUA23
are all seen by HSC00, and DUA22 is also seen by HSC02.
>>> show device cixcd0
polling for units on cixcd0, slot 2, xmi0...
·
·
dua21.14.0.2.0 DUA21 (HSC00) RA82
dua22.14.0.2.0 DUA22 (HSC00) RA82
dua23.14.0.2.0 DUA23 (HSC00) RA82
·
·
dua22.2.0.2.0 DUA22 (HSC02) RA82
·
·
>>>
^
|
This - digit, after the first period, indicates
HSC NODE number.
HSC00 bus node number 14 decimal.
HSC02 bus node number 02 decimal.
dua22.14.0.2.0
|| || | | +--- hose
|| || | +----- slot (xmi)
|| || +------- channel
|| ++-------- node (primary HSC)
++----------- unit
The system operator would set the BOOTDEF_DEV to attempt
to boot dua22 first through the HSC00,to boot through the
HSC02.
>>> set bootdef_dev dua22.14.0.2.0, dua22.2.0.2.0
bootdef_dev set to dua22.14.0.2.0,dua22.2.0.2.0
>>>
Define the BOOT_ALT environment variable to indicate to the
console alternate HSC paths exist. The console then can
attempt to locate the unit, if the original boot path no longer
has the unit available, when the system is shut down or it
crashes.
>>> create -nv boot_alt 2,E
boot_alt set to 2,E
>>>
The first argument in 'boot_alt' correlates to the first
argument in the 'bootdef_dev' string, the second argument to
the second string, etc.
bootdef_dev dua22.14.0.2.0, dua22.2.0.2.0
^^ ^
| |
and its alternate path
| |
v v
boot_alt 2 , E
When the system crashes, a first attempt is made to locate the
system disk - on the DUA22.14.0.2.0 path ... if the device
cannot be found, the console will replace the HSC node value in
that argument with the value it finds in the first argument of
BOOT_ALT and try that path next.
o DOSD does not work on the following OpenVMS VAX systems:
VAX 65x0
VAX 66x0
When everything is set up properly to run DOSD, the following
message is generated when it is run:
SYSBOOT-I-DOSD, dump off system disk behavior is not enabled
INSTALLATION NOTES:
In order for the corrections in this kit to take effect, the system must be
rebooted. If the system is a member of a VAXcluster, the entire cluster
should be rebooted.
This patch can be found at any of these sites:
Colorado Site
Georgia Site
Files on this server are as follows:
vaxdosd06_062.README
vaxdosd06_062.CHKSUM
vaxdosd06_062.CVRLET_TXT
vaxdosd06_062.a-dcx_vaxexe
vaxdosd06_062.b-dcx_vaxexe
vaxdosd06_062.c-dcx_vaxexe
|