{"id":154,"date":"2011-04-08T17:19:39","date_gmt":"2011-04-08T21:19:39","guid":{"rendered":"http:\/\/www.samontab.com\/web\/?p=154"},"modified":"2012-12-18T04:49:58","modified_gmt":"2012-12-18T07:49:58","slug":"how-to-install-redmine-1-1-2-on-ubuntu-server-10-04","status":"publish","type":"post","link":"https:\/\/www.samontab.com\/web\/2011\/04\/how-to-install-redmine-1-1-2-on-ubuntu-server-10-04\/","title":{"rendered":"How to install Redmine 1.1.2 on Ubuntu Server 10.04"},"content":{"rendered":"

Redmine<\/a> is an excellent project management tool written using Ruby on Rails. It provides everything you need to organise your workplace or personal projects. Once you see it working<\/a> you definitely will want to use it on your own projects. Everything is great until you want to install it since redmine only works with very specific versions of its dependencies. There are many steps that you need to take into consideration, even if you install the outdated version in the repositories. In this guide, I will show you how to install redmine 1.1.2 (the latest version at the time of writing) on Ubuntu Server 10.04 32 bits (latest LTS version at the time of writing).<\/p>\n

Make sure that you installed Ubuntu Server 10.04<\/a> with SSH (optional) and LAMP support. Both can be selected to be automatically installed at the end of the normal Ubuntu Server 10.04 installation. Once it is installed, remember to update and upgrade your system.<\/p>\n

\r\nsudo apt-get update\r\nsudo apt-get upgrade\r\n<\/pre>\n
First, let’s install some dependencies:<\/p>\n
\r\nsudo apt-get install ruby1.8-dev rubygems1.8 libmysql-ruby libmysqlclient-dev rake libopenssl-ruby libapache2-mod-passenger imagemagick libmagickcore-dev libmagickwand-dev\r\n<\/pre>\n
Now we can install the required packages for ruby, or gems. Note that some packages will take a long time to install and provide no output, so just be patient. Also, you will see some warnings like No definition for X<\/strong>. Ignore those, they mean that some documentation was not installed, and we can live with that.<\/p>\n
\r\nsudo gem install rails -v=2.3.5\r\nsudo gem install mysql\r\nsudo gem install ruby-openid\r\nsudo gem install i18n -v=0.4.2\r\nsudo gem install passenger\r\nsudo gem install rmagick\r\n<\/pre>\n
Now we have to prepare the database. Enter the MySQL console as root:<\/p>\n
\r\nmysql -uroot -p\r\n<\/pre>\n
Provide the root password. This is the password you set in the early LAMP installation. Now, inside the MySQL console, execute these commands:<\/p>\n
\r\ncreate database redmine character set utf8;\r\ncreate user 'redmine'@'localhost' identified by 'myPassword';\r\ngrant all privileges on redmine.* to 'redmine'@'localhost';\r\nexit\r\n<\/pre>\n
Remember to change myPassword<\/strong> with your actual password. This is the one that will be used for the user redmine in the database redmine at localhost.<\/p>\n
Now it is time to get the redmine code. Execute the following commands to get redmine 1.1.2.<\/p>\n
\r\ncd ~\r\nwget http:\/\/rubyforge.org\/frs\/download.php\/74419\/redmine-1.1.2.tar.gz\r\ntar -xvzf redmine-1.1.2.tar.gz\r\ncd redmine-1.1.2\r\n<\/pre>\n
Now setup the database configuration file to match our current environment:<\/p>\n
\r\ncp config\/database.yml.example config\/database.yml\r\nnano config\/database.yml\r\n<\/pre>\n
Put the details of the database on the specific fields, in particular username and password. Username should be redmine<\/strong> and password should be myPassword<\/strong> or the one you provided before. Make sure that you change both, production and development sections. When you are finished, just hold Control and then press X. This is the command for exiting nano. It will ask if you want to save the changes, just press y (as in yes) and hit enter. That’s it, file saved and back to the console.<\/p>\n
\"\"<\/a><\/p>\n
Now do the same for configuring email:<\/p>\n
\r\ncp config\/email.yml.example config\/email.yml\r\nnano config\/email.yml\r\n<\/pre>\n
For this example, we are going to use gmail, but you can use any email settings that you need. Make sure that address is smtp.gmail.com, port is changed to 587, domain is set to gmail.com (or your host if you use google apps) and that the user_name and password are your credentials. Also, make sure that you add a tls: true line. And finally, the most important part, is that you change login with plain<\/strong> in authentication.<\/p>\n
\r\nproduction:\r\n delivery_method: :smtp\r\n smtp_settings:\r\n address: smtp.gmail.com\r\n port: 587\r\n tls: true\r\n domain: gmail.com # or your domain\r\n authentication: :plain\r\n user_name: fancyUsername@gmail.com # or your domain\r\n password: secretPassword\r\n<\/pre>\n
For gmail to work, we need to install a script. Let’s get it:<\/p>\n
\r\nsudo apt-get install git-core\r\nruby script\/plugin install git:\/\/github.com\/collectiveidea\/action_mailer_optional_tls.git\r\n<\/pre>\n
Let’s proceed with the installation:<\/p>\n
\r\nrake generate_session_store\r\nsudo mkdir \/opt\/redmine\r\ncd \/opt\/redmine\r\nsudo cp -r ~\/redmine-1.1.2 .\r\ncd redmine-1.1.2\r\nsudo RAILS_ENV=production rake db:migrate\r\nsudo RAILS_ENV=production rake redmine:load_default_data\r\n<\/pre>\n
Press enter to accept the default language (English) and then execute the following:<\/p>\n
\r\nsudo chown -R www-data:www-data files log tmp public\/plugin_assets\r\nsudo chmod -R 755 files log tmp public\/plugin_assets\r\nsudo nano \/etc\/apache2\/mods-available\/passenger.conf\r\n<\/pre>\n
Add this line inside the <IfModule mod_passenger.c> tag:<\/p>\n
\r\nPassengerDefaultUser www-data\r\n<\/pre>\n
\"\"<\/a><\/p>\n
Now let’s configure apache:<\/p>\n
\r\nsudo nano \/etc\/apache2\/sites-available\/default\r\n<\/pre>\n
Just before the closing tag, <\/VirtualHost>, add the following:<\/p>\n
\r\nRailsEnv production\r\nRailsBaseURI \/redmine\r\n<\/pre>\n
\"\"<\/a><\/p>\n
Now we put a link to our application to be accessible from apache and restart it:<\/p>\n
\r\nsudo ln -s \/opt\/redmine\/redmine-1.1.2\/public \/var\/www\/redmine\r\nsudo \/etc\/init.d\/apache2 restart\r\n<\/pre>\n
Some clean up…<\/p>\n
\r\ncd ~\r\nrm -r redmine-1.1.2\r\nrm redmine-1.1.2.tar.gz\r\n<\/pre>\n
The installation process is finished. Open a web browser in another computer and go to yourServerIP\/redmine and you should see the initial page of redmine. If it does not show, then something is wrong in your installation. Go back and carefully follow the steps from the beginning. If you do not know your IP address, just run ifconfig from the server.
\n\"\"<\/a>
\nClick on Sign-in. Enter admin<\/strong> for user and password. Now you are logged in as the redmine administrator. Go to Administration<\/strong> and then click on Information<\/strong>. You should see the following:
\n\"\"<\/a>
\nNote that Redmine 1.1.2 stable is installed correctly with RMagick and the directories that it needs are writeable. The only thing left to do here is to change the details of the administrator account (that is why there is one error sign), and start creating users and projects and manage them with this great tool. Once you change your administrator account, you should see no errors on the information page:<\/p>\n
\"\"<\/a><\/p>\n
And now you can enjoy all the features of this great project manager: Gantt charts, Roadmaps, wiki, file repositories, multiple project support, forums, and much more…<\/p>\n","protected":false},"excerpt":{"rendered":"
Redmine is an excellent project management tool written using Ruby on Rails. It provides everything you need to organise your workplace or personal projects. Once you see it working you definitely will want to use it on your own projects. Everything is great until you want to install it since redmine only works with very […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[21,4],"tags":[],"class_list":["post-154","post","type-post","status-publish","format-standard","hentry","category-open-source","category-programming"],"_links":{"self":[{"href":"https:\/\/www.samontab.com\/web\/wp-json\/wp\/v2\/posts\/154","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.samontab.com\/web\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.samontab.com\/web\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.samontab.com\/web\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.samontab.com\/web\/wp-json\/wp\/v2\/comments?post=154"}],"version-history":[{"count":0,"href":"https:\/\/www.samontab.com\/web\/wp-json\/wp\/v2\/posts\/154\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.samontab.com\/web\/wp-json\/wp\/v2\/media?parent=154"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.samontab.com\/web\/wp-json\/wp\/v2\/categories?post=154"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.samontab.com\/web\/wp-json\/wp\/v2\/tags?post=154"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}