$OpenBSD: README,v 1.4 2012/03/15 12:48:05 ajacoutot Exp $

+-----------------------------------------------------------------------
| Running timetrex-5.0.3p0 on OpenBSD
+-----------------------------------------------------------------------

TimeTrex has been installed into /var/www/timetrex

You should point this to the DocumentRoot of your web-server:
 # ln -s ../timetrex /var/www/htdocs/timetrex
(make sure you use a relative symlink since Apache is chrooted)

If using LDAP authentication, you will need to install php-ldap.

The administrator Guide is available as a PDF here:
    /var/www/timetrex/documentation/Administrator_Guide_Standard_Edition_en.pdf


Installation
============

* Creating a dedicated user and database for TimeTrex.
  While TimeTrex supports MySQL and PostreSQL, MySQL will be used in the
  following example.

    $ mysql -u root -p mysql
    mysql> CREATE DATABASE `timetrex`;
    mysql> USE `timetrex`;
    mysql> GRANT ALL PRIVILEGES ON `timetrex` . *
        -> TO 'timetrex'@'localhost' IDENTIFIED BY 'yourpassword';
    mysql> QUIT

  If using MySQL, you must ensure that you have the proper time zone
  support by running the following command:

    $ /usr/local/bin/mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -p -u root mysql

* Configuring /etc/php-5.3.ini for TimeTrex:
  - memory_limit needs to be set to at least 512M

* Configuring maintenance jobs
  TimeTrex requires that maintenance jobs be run regularly throughout
  the day.  This is extremely important and without these maintenance
  jobs running TimeTrex will fail to operate correctly.
  Add the following line to root's crontab:

    * * * * * sudo -u www /usr/local/bin/php-5.3 /var/www/timetrex/maint/cron.php > /dev/null 2>&1

  If the php binary cannot access the default MySQL socket using the
  same path that the PHP module uses (because the module run in a
  chrooted installation), as root:
      # cp /etc/php-5.3.ini /etc/php-cli-5.3.ini
  then edit the mysql.default_socket path in /var/www/conf/php-cli.ini

* Finishing the installation.
  Point your web browser to:
    http://<hostname>/timetrex/interface/install/install.php


Update
======

* IMPORTANT!
  Create a backup of your current installation and timetrex database.
  The timetrex.ini.php file contains a cryptographic salt that if you
  lose you will not be able to login to TimeTrex nor access encrypted
  data ever again!

* Edit /var/www/timetrex/timetrex.ini.php and set:
    installer_enabled = TRUE

* Finishing the update.
  Point your web browser to:
    http://<hostname>/timetrex/interface/install/install.php
