John, > I've been searching for an open source PM and Issue tool for > a while. I > think that Eventum is a good fit so far. Has anyone used this > as a Project. Eventum is being released as a GPL project to gather community involvement in its development. Installation notes for Windows; Common problems during install. Bryan Alsdorf edited. What is Eventum. Eventum is a user friendly and very flexible issue tracking system. [Windows](Installation notes for Windows.
Doing a fresh install Navigate this page:. Installation Process Before starting, check first. Installation is pretty simple and quick. Download the tarball, and unpack it. Eventum already bundles PHP libraries that it needs to work properly, see docs/DEPENDENCIES.md from release tarball for details.
Windows Installation Vista
Point your webserver to that /path-to-eventum/htdocs/. Open it up with your browser and Eventum should redirect you to the installation screen, and it will try to guess some of required parameters, like path in the server and etc.
PLEASE NOTE: The whole eventum directory should NOT be accessible under the webserver, only /path-to-eventum/htdocs/ If Eventum's installation script finds that it needs a few directories or permissions changed, it will print the warnings before actually displaying the installation screen. Just fix what it says is wrong/missing and everything should go well. After the installation is done, you should go and take all of the available privileges from the htdocs/setup directory, so other people are not allowed to go in there and mess with your configuration.
IMPORTANT: If you already have an installation of Eventum, please read the file. IMPORTANT: If you are having trouble getting Eventum to work, please read the trouble shooting section of the file. IMPORTANT: By default, the admin user login is set to to during installation. Be sure to change this to a valid email address with a new password immediately. Note that eventum will attempt to send the new password to the specified address, which should be valid to prevent the password from being exposed if the email is bounced. Scheduled Tasks Regular maintenance in Eventum is accomplished by running scheduled tasks or cron jobs. Alternatively, some of these tasks may be performed with a GET request to a URL, if administrative access is not available on the host machine to run the scripts directly from the filesystem.
It may be desirable to limit access to these URLs, in such a case. NOTE: Be sure to specify the path to the same PHP binary used by the web server in all cron entries. This is especially important on machines with multiple installations of PHP. Mail Queue Process (processmailqueue.php) In Eventum, emails are not sent immediately after clicking on the send button. Instead, they are added to a mail queue table that is periodically processed by a cron job or scheduled task. If an email cannot be sent, it will be marked as such in the mail queue log, and sending will be retried whenever the processmailqueue.php script is run. The SMTP server that Eventum uses to send these queued emails must be specified in: Administration General Setup SMTP (Outgoing Email) Settings This cron example will run the script every minute:.
/bin/processmailqueue.php There is a lock file that prevents the system from running multiple instances of the mail queue process. If you would like to keep the size of your mail queue table down you can truncate (remove the body of) messages that are older then 1 month by running the bin/truncatemailqueue.php script. Email Download (downloademails.php) To use email integration, you must check the Enabled button for: Administration General Setup Email Integration Feature To configure the accounts used with the email integration feature, go to: Administration Manage Email Accounts In order for Eventum's email integration feature to work, you need to set up a cron job to run the downloademails.php script every so often. The following is an example of the required crontab line (using an IMAP account): 0. /bin/downloademails.php username mail.example.com INBOX The above will run the command every hour, and will download emails associated with the given email account and IMAP mailbox. If you have more than one email account, you may add another crontab entry for the other accounts (or poll different IMAP mailboxes of the same account). NOTE: The mailbox parameter shown in the examples as INBOX is ONLY required for IMAP accounts.
Using that parameter on POP accounts causes 'Error: Could not find a email account with the parameter provided. Please verify your email account settings and try again.'
You can also call the downloademails.php script via the web using the following URL: NB: the web trick no longer works! Reminder System (checkreminders.php) The reminder system was designed to serve as a safety net for issues that need attention. Depending on what configuration you create, you may have several reminders (or alerts) to send out whenever an issue needs attention, for whatever parameter you may deem necessary./10. /bin/checkreminders.php It is recommended that you run the reminder cron job every 10 minutes, so it won't flood you with alerts, but it would still be enough to handle most cases. Heartbeat Monitor (monitor.php) The heartbeat monitor alerts the administrator whenever a common problem in Eventum is detected, such as the database server becoming unavailable, or if the recommended permissions for certain configuration files are changed.
Please note that before running the heartbeat monitor, you may need to customize some of the checks to be appropriate for your own system, particularly the permission and file checks on Monitor::checkConfiguration./10. /bin/monitor.php Other Features Requiring System Setup Note: Starting with Eventum 1.5.2 there is a new (optional) way of routing emails, notes and drafts. You will need to setup up a wildcard address to route all messages that should be in Eventum (usually issue-@, note-@ and draft-@) to an email account. Then add that email account to Eventum by going to the email account administration page: Administration Manage Email Accounts When setting up the account, check Use account for email/note/draft routing. Once the account is added, set the account to be downloaded as described above (in ). Email Routing Script (routeemails.php) The email routing feature is used to automatically associate a thread of emails into an Eventum issue.
By setting up the mail server (MTA) to pipe emails sent to a specific address (usually issue-@) into the above script, users are able to use their email clients to reply to emails coming from Eventum, and those replies will be automatically associated with the issue and broadcast to the issue's notification list. The entire email message should be passed as standard input to the script, and the only parameter to it should be the email account to which this email should be associated. The following is an example of a successful run of this script: bin/routeemails.php '1' @) into the above script, users are able to use their email clients to reply to internal notes coming from Eventum, and those replies will be automatically associated with the issue and broadcast to the issue's notification list staff members. The entire email message should be passed as standard input to the script.
The following is an example of a successful run of this script: bin/routenotes.php @) to the above script, users are able to send drafts written in their mail client to be stored in Eventum. These drafts will NOT broadcasted to the notification list. The entire email message should be passed as standard input to the script.
The following is an example of a successful run of this script: bin/routedrafts.php. Define( 'APPBASEURL ', '. APPRELATIVEURL); Installing with PHP on FastCGI Using FastCGI you must consider the following:. Since Basic Authentication might not work, you might not be able to access the Custom Search RSS. Running php scripts from command line will probably use different php.ini for WEB and CLI. You should pass the php.ini file path in the command for CRON and manual executions: php -c /path-to-php-ini/php.ini -f /path-to-eventum/misc/processmailqueue.php.