$OpenBSD: README,v 1.4 2012/03/15 12:48:05 ajacoutot Exp $
+-----------------------------------------------------------------------
| Running ${FULLPKGNAME} on OpenBSD
+-----------------------------------------------------------------------
TimeTrex has been installed into ${INSTDIR}
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:
${TRUEPREFIX}/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:
$ ${LOCALBASE}/bin/mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -p -u root mysql
* Configuring ${SYSCONFDIR}/php-${MODPHP_VERSION}.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 ${MODPHP_BIN} ${TRUEPREFIX}/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 ${SYSCONFDIR}/php-${MODPHP_VERSION}.ini ${SYSCONFDIR}/php-cli-${MODPHP_VERSION}.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 ${TRUEPREFIX}/timetrex/timetrex.ini.php and set:
installer_enabled = TRUE
* Finishing the update.
Point your web browser to:
http://<hostname>/timetrex/interface/install/install.php
