Using the LND tool to analyze IBM Lotus Notes and Domino hangs and crashes

This article explains the steps to analyze IBM Lotus Notes and Domino hangs and crashes using the Lotus Notes diagnostic (LND) tool, a process that is also Useful for analyzing the files in the IBM technical support folder.

Showtable of contentshidetable OF CONTENTS 1 Overview 2 downloading and installing the LND Tool 3 using the tool 3.1 processing a semaphore File 3.2 processing a memory dump file 3.3 processing a dxl File 4 Conclusion 5 resources 6 about the author Overview Everyone who uses Lotus Notes/Domino shoshould know what to do when notes/Domino hangs or crashes. this article explains how to use the main features of the Lotus Notes diagnostic (LND) tool; specifically, we discuss which notes/Domino diagnostic files can be Processed using LND and describe how: Process an automatic diagnostic collection (ADC) Database Analyze and compare NSDS Analyze memory dumps Analyze semaphore files Reconstruct server configuration documents ents Downloading and installing the LND Tool TheIBM Support Assistant (ISA) Tool enables you to gather configuration and log files that can help Lotus technical support troubleshoot issues you may have with IBM products. in order get the LND, if you don't already have access to ISA, first refer to support te #1410608, "IBM Support Assistant (ISA) Quick Start Guide, "For all the details to get started. Figure 1 shows the ISA welcome page: Figure 1. IBM Support Assistant welcome page To analyze the various configuration and log files, follow the steps below: 1. Choose which tools you want to add for supporting the IBM products by selecting Update-find new-tools add-ons (see figure 2 ): Figure 2. Tools add-ons Figure 3 shows the tools catalog window, with the tool name you want to download; in this case, IBM Lotus Notes diagnostics (Tech Preview ): Figure 3. IBM Lotus Notes diagnostics (Tech Preview) In Figure 4, ISA is checking the registry for the Lotus Notes diagnostics, after which the tool is opened in the Notes client. Figure 4. Registering the LND Tool Note that, after installation, you may be prompted to restart the Lotus Notes client. Using the tool Figure 5 shows the LND tool user interface: Figure 5. LND tool UI Figure 6 shows the open and process a file option in the LND tool's inbox: Figure 6. Open and process a file option 1. Now, to automatically process an NSD file, right-click on the "nsd_W32I_S1LD852_2011_01_30@17_47_22.log" NSD and select Lotus Notes diagnostic-automatic process, as shown in Figure 7: Figure 7. Automatic Process Option The LND database shocould open automatically (see Figure 8). You can use the tool to compare two NSD's and create several NSD's to investigate a performance problem. It shoshould provide general information on memory blocks that are causing problems, and you can even select different tabs such as stacks, memory usages, top 10 memory blocks used, etc. the analysis shows the changes that took place in the stacks. Figure 8. LND memory block Analysis 2. Select the KnowledgeBase tab to see relevant content matches found by the LND (see figure 9 ): Figure 9. Knowledgebase Tab 3. Select the thread & process Infos tab to see more information about stacks (see figure 10 ): Figure 10. Thread & process Infos Tab We can even find the replication of an unread entry involved, and we can see the databases involved or used (see figure 11 ). Figure 11. Database (s) involved 4. Select the client or server Infos tab to see memory usage, top 10 shared memory-blocks usage, log entries, and system information (see figure 12 ): Figure 12. Client or server Infos Tab You are also able to find the unusually high memory usage for the crashing process (see figure 13 ): Figure 13. Unusually high memory usage for crashing process Processing a semaphore File To process a semaphore file: 1. Right-click the semdebug. txt file and select Lotus Notes diagnostic-automatic process, as shown in figure 14: Figure 14. semdebug. txt Automatic Process 2. the semaphore debug view shown in Figure 15 shocould open automatically. select the frequency tab and expand "Owning Threads" (you may be able to determine from the stack that a search that was in progress caused the semaphore ): Figure 15. semaphore debug View Processing a memory dump file To process a memory dump file: 1. Right-click the memory dump file and select Lotus Notes diagnostic-annotate all memory dumps, as shown in Figure 16 (you will find two new files created in the directory ): Figure 16. annotate all memory dumps Option Figure 17 shows the Command Prompt window providing information about identifying the memory dumps in the designated directory: Figure 17. Command Prompt window 2. Right-click the memory dump file, and select Lotus Notes diagnostic-analyze all annotated dumps (see figure 18 ): Figure 18. analyze all annotated dumps Option The view in Figure 19 opens, showing the memory used by each memory block. Figure 19. memory used by each memory block 3. As you click on the highlighted tabs in the figure above, you can see important diagnostic information (such as the amount of memory used by each memory block ). Processing a dxl File To process a domino XML language (dxl) file: 1. Right-click the. dxl file and select Lotus Notes diagnostic-Automatic Process (see figure 20 ): Figure 20. Automatic Process for. dxl File 2. After processing the file, you see a server document in which you can check for the configuration settings, as shown in Figure 21: Figure 21. server document configuration settings Conclusion You shoshould now be able to perform the troubleshooting procedures to analyze and fix Lotus Notes/Domino hangs and crashes, using the LND tool. Resources Read the Lotus Notes Wiki article, "analyzing IBM Lotus Notes client hangs and crashes :" Http://www-10.lotus.com/ldd/dominowiki.nsf/dx/06262009085854AMWEBH8V.htm Refer to the IBM Support Assistant Home Page: Http://www.ibm.com/software/support/isa/ Watch the LND instructional video: Http://www-10.lotus.com/ldd/dominowiki.nsf/xsp/.ibmmodres/domino/OpenAttachment/ldd/dominowiki.nsf/BBC5B2E80E0F77D68525760100709873/attach/LND.swf Developerworks Lotus Notes and Domino product page: Http://www.ibm.com/developerworks/lotus/products/notesdomino/