This document describes the setup and operations of the MantisBT surveys.
The tool we’re using to manage surveys is an open-source solution called LimeSurvey.
Edit the mantisbt site’s configuration file (as root):
Alias /surveys /srv/www/surveys/
service apache2 reload
Reference: LimeSurvey manual
This installation procedure uses a fork of LimeSurvey's repository rather than relying on the distribution’s packages.
The mantisbt custom survey template was created based on the “Default Reloaded” template. See Modifying the mantisbt template for further details and instructions on how to further customize it.
As of this writing, the surveys branch is based on LimeSurvey Release 2.00+ Build 130406.
cd /srv/www git clone https://github.com/mantisbt/LimeSurvey.git surveys cd surveys git remote add upstream https://github.com/LimeSurvey/LimeSurvey.git git fetch upstream git checkout surveys
chgrp -R www-data tmp/ upload/ application/config/ chmod -R g+w tmp/ upload/ application/config/
CREATE USER surveys@localhost IDENTIFIED BY 'XXX'; GRANT USAGE ON *.* TO surveys@localhost IDENTIFIED BY 'XXX'; CREATE DATABASE IF NOT EXISTS surveys; GRANT ALL PRIVILEGES ON surveys.* TO surveys@localhost;
MySQL, localhost, surveys, (password), surveys, (remove prefix)then click Next
The Administrator’s account and password can be found in root user’s
Individual accounts should be created for Survey Administrators and added as members of the MantisBT group
Backup the code and the database before you start !!
Please refer to LimeSurvey manual for generic upgrade instructions. This assumes a minor upgrade.
Carefully review the LimeSurvey documentation as well as the release notes to make sure this process applies. If not, adjust as necessary. Make backups and tests !
Execute the commands below as root:
cd /srv/www/surveys tar -czf ../surveys-backup_$(date +'%Y%m%d-%H%M%S').tar.gz . git co master git pull upstream git co surveys git rebase ReleaseTagName
After completing this, login to LimeSurvey as admin and verify that the default template has not been changed
Perform necessary tests to ensure the new version works as expected, and delete the backup file when no longer needed.
The relevant files can be found in the repository’s surveys branch (./upload/templates/mantisbt on the file system).
To modify the template’s source files (.pstpl, .css, image files, etc):
Update the template on mantisbt.org (as root):
cd /srv/www/surveys git co surveys git pull
Surveys can be created directly on the server.
Alternatively, for additional flexibility and better performance as well as to facilitate testing, the tool can be installed locally using a XAMPP package provided by the LimeSurvey team. The survey can be uploaded to the server once it is ready.