Utilities

Utilities in Adeptia Connect are built in features that help you find and troubleshoot a problem in the production environment. For example, some diagnostic utilities give you information about the Adeptia Connect and thread dump of Kernel and WebRunner. If any problem occurs in the production environment, you can use this information for troubleshooting and investigating the cause of an unexpected behavior.

Tracer Utility

This utility helps in gathering information of Adeptia Connect including that of Thread Dump. Perform the following steps to run the tracer utility for gathering information:

For Windows:

1. Go to the <Adeptia-Installation-Folder>/ServerKernel/tracer folder.
2. Execute server-info.bat file.
3. The zip folder, in the format server_info_<date>_<time>.zip, is created, in the tracer folder, containing all the required information.

For Linux:

1. Open the terminal.
2. Go to the <Adeptia-Installation-Folder >/ServerKernel/tracer folder.
3. Execute ./server-info.sh file. Make sure that file has execute permission.
4. The zip folder, in the format server_info_<date>_<time>.zip, is created, in the tracer folder, containing all the required information.  

To gather information about Adeptia's files, folders, and databases

1. Go to the <Adeptia-Installation-Folder >/ServerKernel/tracer/etc folder.
2. Configure application.xml file.
3. Execute ./server-info.sh file or server-info.bat file.

Thread Dump

Thread Dump utility helps you to know thread dump information of Kernel and WebRunner. Before continuing further, you must be familiar with the following two terms:

Thread Dump: A thread dump is a list of all the Java threads that are currently active in a Java Virtual Machine.

Memory Dump: A memory dump is a process in which the contents of the memory are displayed and stored that helps to diagnose, identify and resolve the problem that led to the failure.

This section will let you know how to gather thread dump information of Kernel and WebRunner on Windows and Linux.

For Windows:

1. Go to the <Adeptia-Installation-Folder>/ServerKernel/diagnostic folder.
2. Execute either KernelDump.bat or WebRunnerDump.bat.
3. The console window appears prompting you with the options - Thread Dump or Memory Dump. Following files will be created in the diagnostic folder.
   
   KernelDump.bat
   For Thread Dump, the file will be in the format: KN_Thread_Dump_Date_time.log
   For Memory Dump, the file will be in the format: KN_Memory_Dump_Date_time.hprof

          WebRunnerDump.bat
          For Thread Dump, the file will be in the format: WB_Thread_Dump_Date_time.log
          For Memory Dump, the file will be in the format: WB_Memory_Dump_Date_time.hprof 

You must have administrative rights to execute the steps mentioned above. 

For Linux:

1. Go to the <Adeptia-Installation-Folder>/ServerKernel/diagnostic folder.
2. Execute either KernelDump.sh or WebRunnerDump.sh.
3. The console window appears prompting you with the options - Thread Dump or Memory Dump. Following files will be created in the diagnostic folder.
   

   For KernelDump.sh
   For Thread Dump, the file will be in the format: KN_Thread_Dump_Date_time.log
   For Memory Dump, the file will be in the format: KN_Memory_Dump_Date_time.hprof

          For WebRunnerDump.sh

          For Thread Dump, the file will be in the format: WB_Thread_Dump_Date_time.log
          For Memory Dump, the file will be in the format: WB_Memory_Dump_Date_time.hprof