Abend Troubleshooting Guide
(Last modified: 14Jul1997)
This document (2927789) is provided subject to the disclaimer at the end of this document.
Click the filename to download: tabnd2a.exe 418576 bytes 14Jul1997 05:27PM
This file contains diagnositic programs / utilities, and documentation to help in troubleshooting NW v3.x and NW v4.x server Abends, hangs, page faults, GPPE's, NMI's, etc.
The document "TABEND.WP6" is a general troubleshooting guide which suggests a logical flow for troubleshooting a server Abend, or hang condition. You will also find specific suggestions and ideas to aid your troubleshooting. This document will also direct you to other applicable files or documents, most of which are included in Tabnd2.exe.
RCSI.APP Found in the directory "Docs\." This document is a reprint of the February 1995 Application Note, "Resolving Critical Server Issues."
RECOVERY.APP Found in the directory "Docs\." This document is a reprint of the June 1995 Application Note, "Abend Recovery Techniques for NetWare 3 and 4 Servers."
RECOVERY.BMP Flow Chart graphic from the article in "Recovery.APP."
TABEND.wp6 Found in the directory "Docs\." This document,
"Troubleshooting Abends," is a general troubleshooting guide for dealing with server hangs, Abends, Page Faults, etc. It can also serve as a guideline for troubleshooting server problems in general.
TABEND.TXT Tabend.wp6 document in ascii text form.
TABENDS.WPG Troubleshooting Abends flow chart graphic in WordPerfect format.
Compression and High Utilization Technical Information Document (TID) 1005736. This document is a discussion of high utilization vs. file compress at the NW4.1 server.
Suballocation and High Utilization Technical Information Document (TID) 1005436. This document is a discussion of high utilization vs. NW4.1 file system suballocation.
Troubleshooting High Utilization Technical Information Document (TID) 1005963. This document is a discussion of troubleshooting ideas and issues when troubleshooting a NW4.1 high utilization.
Most of the ideas in the document also apply to NW3.x.
Technical Information Document (TID) 2905856. This document is an addendum to TID1005963, found in HIGHUTIL.TRB. The document recommends set parameter changes to be made to server with an average of 100 or more connections in use.
Found in the directory "Diags\IMGCopy\." Imgcopy (Image Copy)
is used to transfer a core dump, that has been initially copied to your servers dos partition, to a NetWare volume. This method usually allows you to bring your server up more quickly.
IMGCOPY can either be run from a floppy drive or can be copied to
SYS:SYSTEM. After an image file has been generated and the server
brought back up, type the following at the file server console
LOAD IMGCOPY <<S=source path> <D=destination path> <P=priority>>
NOTE: For both 3.11 and 4.10 SFT III. Load IMGCOPY in the
Mirrored Server Engine. Depending on how the parameter "MSEngine
Use Primary Server For DOS I/O" is set will determine which
machines' DOS hard drive will be used. You will need to either
set this to on or off depending on where the image to be copied
SOURCE PATH Full path (including file name) of the image file
which resides on the local hard drive. If no source path is
specified, the default is C:\COREDUMP.IMG.
DESTINATION PATH The location on the SYS: volume where the
image file should be copied. This must be a complete NetWare path
specification, including volume and file names. The default
destination path is SYS:COREDUMP\COREDUMP.IMG. If the destination path does not already exist, IMGCOPY will attempt to create that directory on the network drive. If the file specified already
exists, it will be overwritten without any warning to the user.
PRIORITY This parameter specifies what priority level is to be
used when copying the image file. The valid options are LOW,
MEDIUM, and HIGH. If no priority is given, MEDIUM is assumed.
When running at LOW priority, IMGCOPY allows the file server to
service user requests for longer intervals. LOW priority will
exhibit the least amount of server degradation, but it will take
much longer to complete the file transfer. At MEDIUM priority,
there is no degradation of server functionality, although the
transfer time is reduced considerably. At HIGH priority, the
server will almost exclusively be processing transfer requests,
thereby making it nearly impossible for the file server to
perform other duties until the file has been transferred. This is
the fastest transfer priority available.
Note that all the above parameters are optional, and may be
specified in any order.
Once loaded, IMGCOPY will immediately begin to transfer the
image file from the server's local DOS partition, to the network
drive. A status screen will be displayed, showing the selected
source and destination files, as well as the priority level.
Also, a counter indicating the number of bytes successfully
transferred will be display. The user can toggle out of the
IMGCOPY screen by typing Alt + Esc.
When the image file has been successfully transferred, IMGCOPY
will display a message to the file server console and
automatically unload itself. File server activity will then
resume at normal operating levels. It is possible to abort the
file transfer by unloading IMGCOPY while the transfer is taking
A note about Real and Protected mode:
During normal operation, the file server runs in protected mode.
However, in order to access the local DOS partition to read the
image file, the file server must switch to real mode each time a
read request is processed. While in real mode, all normal file
server activity ceases. Due to this frequent state switching,
users may experience loss of keystrokes at the file server
console if a key was pressed while the server was in real mode.
These keystrokes are stored in a real mode buffer and will not be
seen at the file server console. The higher the priority level,
the more apparent this will become. At the MEDIUM and HIGH
priority settings, users may not be able to toggle between
screens easily or type anything at the server console. This
condition will disappear as soon as the file has been transferred
and IMGCOPY has been unloaded.
Found in the directory "Diags\NetAlive\." This nlm is also used for core dumps. It gives you the option of having a core dump sent to
another servers volume. This is usually the fastest way to get a core dump.
First, on the server where the memory image is to be downloaded from, load the client drivers for the selected card and login to the server where the memory image is to be downloaded to (NOTE: you will need to know the drive letter that was used when connecting to the server where the memory image will be downloaded to when the memory image is executed). Then, bring the server up. Once the server is up, load the NETALIVE.NLM with the following syntax:
LOAD (path):NETALIVE server_name
Example: Assume a server named "747" is where the memory image is going to be downloaded from and that a regular user connection is being made (via a second lan card) to prv- temp-pse (i.e. the server where the memory image will be downloaded to). The syntax for loading the NETALIVE.NLM would be as follows:
LOAD A:NETALIVE 747 PRV-TEMP-PSE
This will start a timer at 300 seconds. When the timer counts down to 0, a message will show that each server is being notified, then the timer will reset to 300 seconds. Checking the connection information in monitor for the client card, the request count will increment by 1.
Found in the directory "Diags\CDump\," Hdump.nlm and the other
files here are used to aid you in taking a core dump on a NW3.11 server. A core dump is an image of the servers memory, which is in the form of a file. This file can then be sent to Novell for anaylsis. Don't take a core dump unless you have an open tech support incident with Novell and you have been asked to get the core dump by a tech support engineer.
To install HDUMP, simply place the HDUMP.NLM file in the same directory as the other NLM files (SYS:SYSTEM or DOS partition). From the file server console screen, type:
load hdump <destination path>
If no destination path/filename is specified, HDUMP will use
C:\COREDUMP.IMG as the default. HDUMP will attempt to create the
destination directory if it does not already exist. The user will be warned
if the destination file already exists, and given the option to overwrite
the existing image file on the local drive or exit. If HDUMP must abort for any reason, the user will be given the option of writing the coredump to floppy disk.
If an ABEND occurs, or a coredump is forced, HDUMP will automatically begin execution and will display the following:
Writing diagnostic dump to: <destination path>
Reading memory range x of x.
Dumping sector x of x.
Upon successful completion, the message "Diagnostic dump complete" will be displayed. At this point, it may be useful to use the IMGCOPY.NLM and/or CHOP.EXE utilities to copy the file from the DOS partition. See their respective documentation for details.
PATCHMAN.NLM (v.2.20) will only operate on NetWare 386 v3.11. Future versions of NetWare 386 will require a version of PATCHMAN specific to that release and may also require a different version of HDUMP.
Used to down a file server from a workstation. Found in the
directory "Diags\Fconsole\." This file and the related files shipped with NW 3.x and is used to down a file server from a workstation. Fconsole did not ship with NW4.x and has not been tested, however, it has been seen to work without problem in most cases to down a 4.x server.
Found in the directory "Diags\PBOFF\." This nlm is used for troubleshooting where you want to disable packet burst at the server. This is for troubleshooting only since disabling packet burst will severely reduce your servers performance.
Found in the directory "Diags\Config\." Used to document your
server configuration. This is useful to document a servers configuration for your own records. Also, we will often ask for this information if you call Novell with a tech support issue. Config.nlm is a command line utility. ConfgNut.nlm is included and is a menu driven utility.
The CONFIG.NLM program collects the following information:
Volume size in Megabytes
Loader version on Nw v4.x
ABEND.LOG on NW v4.11
whether COMPRESSION, SUBALLOCATION, and MIGRATION are enabled on each volume.
CONFIG.NLM and CONFGNUT.NLM work on all versions of NetWare.
If when loading CONFIG or CONFGNUT, the error LOADER
CAN'T FIND PUBLIC SYMBOL appears then update CLIB.NLM, NWSNUT.NLM, and MATHLIBC.NLM.
Installation Instructions for CONFIG.NLM
Copy CONFIG.NLM and CONFGNUT.NLM to the SYS:SYSTEM directory of the server. At the console prompt type LOAD CONFIG or LOAD CONFGNUT and press return. CONFIG.NLM and CONFGNUT.NLM create a text file (CONFIG.TXT) in the SYS:SYSTEM
directory. If CONFIG.TXT exists CONFIG.NLM will overwrite the file. CONFGNUT and CONFIG can append or overwrite CONFIG.TXT. CONFIG.NLM no longer creates its own SCREEN, so watch the SERVER CONSOLE SCREEN for CONFIG IS DONE or any other
messages that CONFIG.NLM will post. By default CONFIG will not include the SYSTEM files or the SET parameters. LOAD CONFIG /d to include the SYSTEM file listings. LOAD CONFIG /s to include the SET parameters and LOAD CONFIG /a to append to CONFIG.TXT. LOAD CONFIG /ads to get set parameters, file listing, and append to CONFIG.TXT. CONFIG.TXT has a list of all the MODULES that were loaded on the server when CONFIG.NLM was run. It also has the contents of all NCF files on the default local drive and in the SYS:SYSTEM directory. It includes CONFIG.SYS and AUTOEXEC.BAT files for the server. A directory of SYS:SYSTEM
and your local drive is also placed in CONFIG.TXT if /d is put on the command line. The SET parameters can be obtained by putting /s on the command line. On NW SFT III servers, load CONFIG or CONFGNUT in both IOENGINES and in the MSENGINE. When loading CONFIG on SFT III it is loaded 3 times. On the 2nd and 3rd times you load CONFIG be sure to use the /a to append to CONFIG.TXT. CONFGNUT is a GUI version and should be self explanatory. There are many more options available in CONFGNUT.
Self-Extracting File Name: tabnd2a.exe Files Included Size Date Time Version Checksum \ DOC 1914 14Jul1997 03:35PM TABND2A.TXT 16316 14Jul1997 05:26PM \DIAGS\CONFIG CONFGNUT.NLM 50874 17Mar1997 03:26PM CONFIG.NLM 43998 17Mar1997 03:48PM \DIAGS\FCONSOLE FCONSOLE.EXE 213984 11Aug1993 03:58PM FCONSOLE.HLP 131647 07Feb1991 10:11AM IBM$RUN.OVL 2400 13Jul1989 09:30AM SYS$ERR.DAT 9170 10Dec1990 01:37PM SYS$HELP.DAT 14092 29Jan1991 02:39PM SYS$MSG.DAT 25138 30Jan1991 03:10PM \DIAGS\HDUMP HDUMP.NLM 4194 02Oct1991 09:37AM IMGCOPY.DOC 6062 03Oct1991 11:14AM IMGCOPY.NLM 4775 03Sep1991 02:08PM \DIAGS\HDUMP\CHP CHOP.DOC 2416 29Jun1992 12:43AM CHOP.EXE 18288 10Jun1992 12:14AM UNCHOP.EXE 19434 10Jun1992 12:18AM \DIAGS\HDUMP\PCHMN220 PATCHMAN.DOC 4240 10Oct1991 03:16PM PATCHMAN.NLM 8923 10Oct1991 09:09AM \DIAGS\IMGCOPY IMGCOPY.NLM 4775 04Sep1991 08:35AM \DIAGS\NETALIVE NETALIVE.NLM 3693 24Aug1994 09:00AM \DIAGS\PBOFF PBRSTOFF.NLM 1110 09Mar1995 01:38PM PM410.NLM 18652 08Mar1995 10:46AM \DOCS RCSI.APP 119867 11Apr1995 12:46AM RECOVERY.APP 163866 18Jun1996 10:23AM RECOVERY.BMP 622320 23May1995 01:28PM TABEND.TXT 42834 21Jun1996 12:14AM TABEND.WP6 100479 21Jun1996 12:15AM TABENDS.WPG 6663 20Jun1996 03:03PM
|Document Title:||Abend Troubleshooting Guide|
|Novell Product Class:||Groupware|
Novell BorderManager Services
The Origin of this information may be internal or external to Novell. Novell makes all reasonable efforts to verify this information. However, the information provided in this document is for your information only. Novell makes no explicit or implied claims to the validity of this information.
Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.