DocMoto
Server

How to find DocMoto server logs

The DocMoto server keeps logs in a secure area in /var/opt/docmoto.

Server logs come in pairs, DocMotoServer.XX.XX.XX.log which contains any errors and ServerRequest.XX.XX.XX.log which lists all the activity.

The DocMoto server creates a new pair of logs files whenever it starts. It continues to write to these logs until it is stopped.

If you have had to restart a DocMoto server the log pair prior to the restart will be the most useful.

Understanding log file names

Both DocMotoServer and ServerRequest logs take the date as part of their name.

For example a log file called DocMotoServer.2014-08-15T08:05:18Z.log was created 15th of August 2014 at 08:05 (and 18 seconds) zulu (GMT) time.

Accessing the log files

To access them you need to open a Terminal window to work as a superuser.

Terminal is accessible in Finder. You will find it in the Utilities folder in Applications.

Once you have opened Terminal you need to make yourself a "superuser". The superuser has access to everything on the Mac.

To make yourself a superuser type the following:

sudo -s

You will be asked for a superuser's password which you will need to enter. The password you enter is usually the one you must enter whenever you make changes to applications.

If at any time you want to know which user you are, simply type the following:

whoami

If you are the superuser it will return "root" as the answer.

Accessing the log directory

To move to the log folder type the following:

cd /var/opt/docmoto

If at any time you want to know which folder you are in, type the following

pwd

To view the log files simply type the following:

ls -l *.log

The date showing in front of the file name is the date and time at which the log file was last amended.

Viewing a log file

The simplest method to view a log file is to use the "less" command. As follows:

less ServerRequest.2014-10-21T06:59:14Z.log

This instruction lists the contents on the file to the screen, to move down through the file use the space bar on your keyboard. To come out of the listing type "q".

Zipping up log files

Sometimes it's useful to zip up log files. It may be so that you can send them to CHL for analysis.

To zip log files use the zip command. The example below will add all log files from October 2014 to a zip file called myZip.

zip myZip *2014-10*.log

To copy the zip file to the home directory you can typically use the following command:

cp myZip.zip ~/