Using the RIP File Annotator

Using the RIP File Annotator.

You Can View User Feedback To This Tip

Here is an Admin tip that a lot of people already know about, but for those who don't it could be a big help. It may even save you a few hours on hold with Tech Support... Tracing through the threads in a notes.rip file after a server crash is always tiresome, frustrating and almost always unfruitful. There is, however, a tool ("RIP file annotator") available from lotus.com ( http://fulfill.lotus.com/support/CZ7H2NA.exe) that defines the function calls in each DLL or EXE for each thread active when the crash occurred. You can then use these function calls to search the Knowledge Base for known NOTES RIP files and their solutions or work-arounds.

Here is some documentation on how it works:

I. How To Use the Annotator

1. Download the Annotator from the Support Downloads area of the Lotus Support Web site.
2. Run the file CZ7H2NA.EXE to extract the Annotator file ANTW32.EXE
3. Launch ANTW32.
4. In the "Input From" section, click the Browse button to locate the NOTES.RIP file.
5. After locating the RIP file in the "Input From" section, the "Output From"
section lists the location of the annotated RIP file to be called NOTES.ANT.
6. In the "PUB/SYM Files" section, click the Browse button to point to the symbol
files for the Annotator to reference. These files are necessary to properly
annotate the RIP file.

For example C:SYMv4.61dW32 (where C:SYMv4.61dW32 is where the SYM files for Notes Release 4.61d for Windows 95 and Windows NT were copied to.)

II. Why Are SYM Files Necessary?

SYM files are needed to define the function call within the dynamic link library (DLL) or executable file (EXE). In order to annotate the RIP file correctly, the annotator must cross-reference the SYM files to get the proper definition of the function call. In order to achieve this, it is critical that the proper version and platform of Notes SYM files are installed on the hard drive

III. What To Do With an Annotated RIP File

Notes RIP files are basically a dump of threads and their function calls. A NOTES.RIP file may contain more than one thread. The thread that crashed the server (the faulting thread), is the first thread in a RIP file. To identify a thread, the RIP file contains a header stating the following:

State Dump for Thread ID 0 5

Each thread contains function calls on what Notes was doing at the time of the crash.

Sample annotated result (extracted from an annotated NOTES.RIP file):

             Stopped at 005095AB (0001:000085AB in d:notesnnotes.dll) Base=0x00500000 
          RVA=0x00001000 
          -> _AllocDBlock

 


 
-->


 
+006B <- 
          04A5F8DC 04A5F8F0 00509535 008D7280 0000F81A |....5.P..r......|
          04A5F8EC 01ABFCE0 04A5F914 00508E32 008D7280 |........2.P..r..|

          Called from 00509535 (0001:00008535 in d:notesnnotes.dll)
          Base=0x00500000 RVA=0x00001000
          -> _OSAllocDBlock@12+0015 <-
          04A5F8F0 04A5F914 00508E32 008D7280 0000F81A |....2.P..r......|
          04A5F900 01ABFCE0 0000F81A 01ABFCD0 0000821C |................|
          04A5F910 008D6F20 04A5F934 00508D57 00CB0004 | o..4...W.P.....|

          Called from 00508E32 (0001:00007E32 in d:notesnnotes.dll)
          Base=0x00500000 RVA=0x00001000
          -> _DPoolAlloc@16+00A2 <-

Use these function calls to search the Lotus Knowledge Base for known NOTES.RIP files. To search on the function calls, highlight the function call after the underscore ( "_" ) and before the "at" (" @ ") symbol and it copy to the clipboard. Next, open Knowledge Base and paste in the function calls to search for a possible match.

Example: Based on the sample NOTES.RIP file above, the function calls that would be used to search Notes Knowledge Base would be the following:

AllocDBlock and OSAllocDBlock and DPoolAlloc

When comparing your search results with your annotated RIP file, look for matching patterns within the faulting thread. The combination and pattern of the annotated RIP file is what distinguishes the crash. If no matches are found, contact Lotus Notes Support to further troubleshoot your crash.

Supporting Information:

IMPORTANT: Notes/Domino SYM files are used in conjunction with the Notes RIP File Windows Annotator. Each Release 4 and Release 5 version of Notes/Domino requires different SYM files. These SYM files are publicly available on the Lotus Support web site at:

Release 5.x
5.0 Support Downloads, http://fulfill.lotus.com/support/CZ7K2NA.exe
5.0a Support Downloads, http://fulfill.lotus.com/support/CZ7JNNA.exe
5.0.1 Support Downloads, http://fulfill.lotus.com/support/CZ7JMNA.exe
5.0.1a Support Downloads, http://fulfill.lotus.com/support/CZ7JLNA.exe
5.0.1b Support Downloads, http://fulfill.lotus.com/support/CZ7HBNA.exe
5.0.2 Support Downloads, http://fulfill.lotus.com/support/CZ7HANA.exe
5.0.2a Support Downloads, http://fulfill.lotus.com/support/CZ7H9NA.exe
5.0.2b Support Downloads, http://fulfill.lotus.com/support/CZ7H8NA.exe
5.0.2c Support Downloads,http://fulfill.lotus.com/support/CZ7H7NA.exe
5.0.3 Support Downloads, http://fulfill.lotus.com/support/CZ7H6NA.exe
5.0.4 Support Downloads, http://fulfill.lotus.com/support/CZ7H3NA.exe
5.0.4a Support Downloads, http://fulfill.lotus.com/support/CZ6SSNA.EXE
5.0.5 Support Downloads, http://fulfill.lotus.com/support/CZ7C1NA.exe
5.0.6 Support Downloads, http://fulfill.lotus.com/support/CZ7YUNA.exe
5.0.6a Support Downloads, http://fulfill.lotus.com/support/CZ7YUNA.exe

Release 4.6x
4.6 Support Downloads, http://fulfill.lotus.com/support/CZ68QNA.exe>
4.6a Support Downloads,http://fulfill.lotus.com/support/CZ68PNA.exe
4.6.1 Support Downloads, http://fulfill.lotus.com/support/CZ68MNA.exe
4.6.1a Support Downloads, http://fulfill.lotus.com/support/CZ68LNA.exe
4.6.1b Support Downloads, http://fulfill.lotus.com/support/CZ68KNA.exe
4.6.1c Support Downloads, http://fulfill.lotus.com/support/CZ68INA.exe
4.6.1d Support Downloads,http://fulfill.lotus.com/support/CZ68HNA.exe
4.6.2 Support Downloads, http://fulfill.lotus.com/support/CZ68FNA.exe
4.6.2a Support Downloads, http://fulfill.lotus.com/support/CZ68DNA.exe
4.6.2b Support Downloads, http://fulfill.lotus.com/support/CZ68BNA.exe
4.6.2c Support Downloads, http://fulfill.lotus.com/support/CZ681NA.exe
4.6.3 Support Downloads, http://fulfill.lotus.com/support/CZ67ZNA.exe
4.6.3a Support Downloads, http://fulfill.lotus.com/support/CZ7YXNA.exe
4.6.3b Support Downloads, http://fulfill.lotus.com/support/CZ7YWNA.exe
4.6.3c Support Downloads, http://fulfill.lotus.com/support/CZ7YVNA.EXE
4.6.4 Support Downloads, http://fulfill.lotus.com/support/CZ67YNA.exe
4.6.4a Support Downloads, http://fulfill.lotus.com/support/CZ67XNA.exe
4.6.4b Support Downloads,http://fulfill.lotus.com/support/CZ67WNA.exe
4.6.4c Support Downloads, http://fulfill.lotus.com/support/CZ67UNA.exe
4.6.5 Support Downloads, http://fulfill.lotus.com/support/CZ7LGNA.exe
4.6.5a Support Downloads, http://fulfill.lotus.com/support/CZ7LCNA.exe
4.6.5b Support Downloads, http://fulfill.lotus.com/support/CZ7LBNA.exe
4.6.6 Support Downloads, http://fulfill.lotus.com/support/CZ7L9NA.exe
4.6.6a Support Downloads, http://fulfill.lotus.com/support/CZ7L8NA.exe
4.6.6b Support Downloads, http://fulfill.lotus.com/support/CZ7K3NA.exe
4.6.6c Support Downloads, http://fulfill.lotus.com/support/CZ7BDNA.exe
4.6.7 Support Downloads, http://fulfill.lotus.com/support/CZ7BENA.exe

Please note: There are some problems using the GUI version of the annotator with releases after R5.0.4, but I understand that there is a DOS version of the annotator that works better for the newer versions of Domino. If anyone knows where this DOS version can be found, I would appreciate a note.

USER FEEDBACK TO THIS TIP

  • The DOS Annotator (which works for all Domino versions including 5.04+) is available at Lotus.com as Customer Support Online Resource document #2446.—Mike Andrews
  • < LI >

    Since 5.04 RIP Annotator Win9x (ANTW32.EXE) is not working, you can use this tip as a workaround. Instead, you can use the DOS version (ANT.EXE) which has been tested up to the 5.07 system files. You can download it from Lotus Support Online Resource Files.Search the following document:
    DOS Annotator 3.L - For Use With Notes/Domino 5.x, Notes/Domino 4.x and Notes 3.x
    Doc number 2446.
    Follow the instructions.—Antonio Freitas

This was first published in May 2001

Dig deeper on Lotus Notes Domino Administration Tools

0 comments

Oldest 

Forgot Password?

No problem! Submit your e-mail address below. We'll send you an email containing your password.

Your password has been sent to:

-ADS BY GOOGLE

SearchWindowsServer

Search400

  • iSeries tutorials

    Search400.com's tutorials provide in-depth information on the iSeries. Our iSeries tutorials address areas you need to know about...

  • V6R1 upgrade planning checklist

    When upgrading to V6R1, make sure your software will be supported, your programs will function and the correct PTFs have been ...

  • Connecting multiple iSeries systems through DDM

    Working with databases over multiple iSeries systems can be simple when remotely connecting logical partitions with distributed ...

SearchEnterpriseLinux

SearchDataCenter

SearchExchange

SearchContentManagement

Close