Time Tracker Virtual Appliance Administration Guide

Content - Use the Time Tracker Appliance menu on top to see more pages in this section.

This page describes administration issues of Anuko Time Tracker Virtual Appliance.

Login to Operating System

The appliance runs CentOS 5 operating system. Use root as user name without password to login into your appliance.

Configuring Mail

Time Tracker Appliance can send mail. You may need mail to receive reports and invoices. Also, when logins are defined as emails in the form "user@domain.com" password reset requests may be sent to users too (when DB authentication is used).

Mail functionality is configured in /var/www/html/WEB-INF/config.php file in the following fragment of code:

// Sending mode. Can be 'mail' or 'smtp'.
// 'mail' - sending through php mail() function
// 'smtp' - sending directly through SMTP server
define('MAIL_MODE', 'smtp');
define('MAIL_SMTP_HOST', 'localhost');
define('MAIL_SMTP_DEBUG', false);

As you can see there are 2 modes to send mail - either directly through SMTP server or through php mail() function.


Configuring SMTP Mail

If you have SMTP server installed on localhost you do not have to change anything. If you don't, specify your SMTP server for MAIL_SMTP_HOST. It is the simplest method to get mail working.


Configuring through PHP mail() Function

If you define MAIL_MODE as mail then mail will go through PHP mail() function as configured in php.ini. In our case PHP uses sendmail internally. You can specify SMTP host for sendmail by defining the SMART_HOST value and re-making the sendmail configuration file (/etc/mail/sendmail.cf). The steps are:

• Find the line containing SMART_HOST in /etc/mail/sendmail.mc, type in your SMTP server name there and uncomment the line, so that it becomes similar to this:

define(`SMART_HOST`, `shawmail.vc.shawcable.net`)dnl
In the above example shawmail.vc.shawcable.net is a sample SMTP server name where you must provide your own instead.

• Copy your old /etc/mail/sendmail.cf file just in case:

cp /etc/mail/sendmail.cf /etc/mail/sendmail.cf.orig

• Generate a new sendmail.cf by running m4:

m4 /etc/mail/sendmail.mc > /etc/mail/sendmail.cf

• Restart sendmail:

/sbin/service sendmail restart

Now you can check if mail works from the appliance.

Content - Use the Time Tracker Appliance menu on top to see more pages in this section.