The following is my notes on installing Redmine on Perfect Server Debian 6 with ISPConfig3. If you are ISPConfig3 users and would like to install Redmine, this walk-though maybe helpful.
This guide assume you have ISPConfig 3 setup already. ISPConfig is a hosting control panel, you can use it to setup web, email, MySQL database with ease. If you don't know what is ISPConfig, please find the following link:
After installed your perfect server and ISPConfig, go ahead to create a client, then a website and database for the new client.
Next, download Redmine, extract the archive to /var/lib/redmine, then follow the procedures below.
==Installing Ruby==
apt-get install libapache2-mod-passenger librmagick-ruby1.8 libmysql-ruby rake
The following packages will be installed:
Setting up ruby1.8 (1.8.7.302-2squeeze1) ...
Setting up ruby (4.5) ...
Setting up rubygems1.8 (1.3.7-3) ...
Setting up rubygems (1.3.7-3) ...
Setting up librack-ruby1.8 (1.1.0-4) ...
Setting up libjs-jquery (1.4.2-2) ...
Setting up librack-ruby (1.1.0-4) ...
Setting up libjs-prototype (1.6.1-1) ...
Setting up libapache2-mod-passenger (2.2.11debian-2) ...
Setting up librmagick-ruby1.8 (2.13.1-2) ...
Setting up ruby1.8-dev (1.8.7.302-2squeeze1) ...
Setting up libmysql-ruby1.8 (2.8.2-1) ...
Setting up libmysql-ruby (2.8.2-1) ...
Setting up rake (0.8.7-2) ...
==Installing Rails== !!!don't install 3.2.1, it won't work!!!
gem install rails -v=2.3.14
==Setup MySQL==
Use ISPConfig to setup a new database
**Configure Redmine database** !!!ensure configure are UNIX file format!!!
echo "production:
adapter: mysql
database:
host: localhost
username:
password:
encoding: utf8
schema_search_path: public" > config/database.yml
RAILS_ENV=production rake config/initializers/session_store.rb
rake generate_session_store
RAILS_ENV=production rake db:migrate
RAILS_ENV=production rake redmine:load_default_data
==Configure SMTP server== !!!ensure configuration files are UNIX file format!!!
cd /var/lib/redmine/config
cp configuration.yml.example configuration.yml
vi configuration.yml
!!!If you got 501 error, use the default and changed the delivery_method to sendmail
# default configuration options for all environments
default:
# Outgoing emails configuration (see examples above)
email_delivery:
delivery_method: :sendmail
smtp_settings:
address:
!!!Ensure database.yml and configuration.yml permission!!!
chown www-data:www-data database.yml configuration.yml
==Configure Apache2==
clientX and webY is created by ISPConfig for client
ln -s /var/lib/redmine/public /var/www/clients/clientX/webY/redmine
In ISPConfig, insert this line in Website -> Options -> Apache Directives
RailsBaseURI /redmine
==Configure LDAP==
In Redmine Administration Panel -> LDAP authentication
Port: 389
Account:
Password:
Base DN: CN=Users,DC=
On-the-fly user creation: checked
Attributes (for Active Directory)
Login: sAMAccountName
First name: givenName
Lastname: sn
Email: mail
==Other settings==
!!!If Redmine tab Information -> Plugin assets directory writable has error, change the permission for the following directory
chown -R www-data:www-data /var/lib/redmine/public/plugin_assets
Reference
http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_on_Debian_Squeeze_with_Postgresql_Ruby-on-Rails_and_Apache2-Passenger
http://www.he1ix.org/2010/08/installing-redmine-on-debianlenny-using-mod_passenger/
http://blog.philippklaus.de/2011/05/redmine-on-debian-squeeze/