Overview

Log files are an important part of troubleshooting and diagnosing issues in the event where MetaMiner behaves unexpectedly. This section goes into deeper review of where to find them, what each one means and how to package them for sharing with Infolytik Support (support@infolytik.com) staff.

Log files - MetaMiner Server & Administrator

Server logs are stored in <installation drive>\Infolytik\MetaMiner\server\logs.
To bundle and email them to support, follow these steps:

  1. Log onto your MetaMiner Server machine
  2. Right-click on the logs folder located at the path described above
  3. Choose Send to file (compressed zip)
  4. Go to the MetaMiner server desktop, locate the zip file and email this to support@infolytik.com.

Video (MMS/MMA logs)

Log files - MetaMiner Client

MetaMiner client already has a built-in method of access your local log files it generates.

MetaMiner Client Logs

  1. Launch MetaMiner Client
  2. Go to File > Open MetaMiner Log Folder
  3. Now select all the files in the directory, right-click and then Send to compressed file and email this zip file to support@infolytik.com

Video (MMC logs)

Thread Dumps

When the MetaMiner JVM experiences contention (certain activities such as Web Intelligence metadata updates, for example), it's best to see what MetaMiner is doing at that very moment.

  1. Launch a web browser
  2. In the URL bar, enter: http://<metaminer host name>:<metaminer port>/td , for example: http://pg001.corp.infolytik.ik:49714/td
  3. Type Ctrl-S which then prompts a Save As dialog and save the file as "metaminer-thread-dump_.txt".
  4. Email this file to Infolytik Support (support@infolytik.com) with a description of the problem.

MetaMiner Port Number

The ":49714" in the example above was taken from the MetaMiner Administrator > Preferences > Settings : Server port, as show in this screenshot: MMDB Direct Access

Video (thread dump)

MetaMiner Java Virtual Machine Thread Dump

The MetaMiner Server engine has its own JVM or Java Virtual Machine. Although generating a thread dump is important to know how to do from an administrator perspective, you should never attempt to fix or troubleshoot your MetaMiner system on your own if the scope of the issue requires a thread dump analysis. Instead, provide the thread dump to Infolytik Support for further guidance.

Restarting MetaMiner Service & Flushing Logs

Log files can accumulate to the point where it becomes difficult to navigate through too many of them. The following steps may be requested by Infolytik support to help us work through a subset of log data.

You might also perform this step if you modify a server setting or make special use of a properties file and need to restart the service.

  1. Log onto the MetaMiner Server
  2. Launch a command prompt window as Administrator
  3. Type net stop metaminer and then enter; this will stop the MetaMiner service
  4. Paste the following lines into the command window to ensure full termination of all MetaMiner services:

taskkill /F /IM metamine*
taskkill /F /IM grafan*
taskkill /F /IM influx*
taskkill /F /IM comparepdf*
5. Navigate to \infolytik\metaminer\logs
6. Delete ALL files by selecting all files (Ctrl-A) and then permanent-delete (Shift-Delete). Backup these files if asked to first.
7. From the command prompt, type net start metaminer to start MetaMiner service.

The MetaMiner Server service is now running and any changes or modifications to the system will take place.