75 lines
2.6 KiB
Plaintext
75 lines
2.6 KiB
Plaintext
$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
|