{"id":1416,"date":"2010-11-19T13:01:47","date_gmt":"2010-11-19T06:01:47","guid":{"rendered":"http:\/\/www.jfdesignnet.com\/?p=1416"},"modified":"2010-11-19T13:01:47","modified_gmt":"2010-11-19T06:01:47","slug":"redmine-on-klixs","status":"publish","type":"post","link":"https:\/\/www.jfdesignnet.com\/?p=1416","title":{"rendered":"redmine on klixs"},"content":{"rendered":"

Redmine is a powerful and flexible project management web apps written on ruby on rails framework. I’ve been using trac for years and want to try this redmine for further functionality and exploring possibility. Been lucky to install redmine on my klixs server on the first try, and here is the steps I want to share :<\/p>\n

Installation<\/h2>\n

Redmine won’t run on ruby 1.9.x so I’m using ruby 1.8.7 and RubyGems 1.3.5 from klixs 2010 packages.<\/p>\n

1. Install ruby 1.8.7 and RubyGems from klixs-repository<\/p>\n

2. rails and rake gem :<\/p>\n

[root@localhost redcomm]# gem install rails -v=2.3.5<\/strong>\nSuccessfully installed activesupport-2.3.5\nSuccessfully installed activerecord-2.3.5\nSuccessfully installed actionpack-2.3.5\nSuccessfully installed actionmailer-2.3.5\nSuccessfully installed activeresource-2.3.5\nSuccessfully installed rails-2.3.5\n6 gems installed\nInstalling ri documentation for activesupport-2.3.5...\nInstalling ri documentation for activerecord-2.3.5...\nInstalling ri documentation for actionpack-2.3.5...\nInstalling ri documentation for actionmailer-2.3.5...\nInstalling ri documentation for activeresource-2.3.5...\nInstalling ri documentation for rails-2.3.5...\nInstalling RDoc documentation for activesupport-2.3.5...\nInstalling RDoc documentation for activerecord-2.3.5...\nInstalling RDoc documentation for actionpack-2.3.5...\nInstalling RDoc documentation for actionmailer-2.3.5...\nInstalling RDoc documentation for activeresource-2.3.5...\nInstalling RDoc documentation for rails-2.3.5...<\/em><\/pre>\n
[root@localhost redcomm]# gem install rack -v=1.0.1<\/strong>\nSuccessfully installed rack-1.0.1\n1 gem installed\nInstalling ri documentation for rack-1.0.1...\nInstalling RDoc documentation for rack-1.0.1...<\/em><\/pre>\n
3. Download<\/a> and extract the archive or checkout<\/a> Redmine, and extract to some folder.<\/p>\n
4. Create an empty database (I’m using mysql) and accompanying user named redmine<\/code> for example.<\/p>\n
create database redmine character set utf8;\ngrant all privilege on redminedb.* to user@localhost identified by '<password>';\nflush privileges;<\/pre>\n
5. Copy config\/database.yml.example<\/code> to config\/database.yml<\/code> and edit this file in order to configure your database settings for “production” environment.<\/p>\n
Example for a MySQL database :<\/p>\n
production:\n  adapter: mysql\n  database: redmine\n  host: localhost\n  username: redmine\n  password: my_password\n<\/pre>\n
6. Generate a session store secret. According to redmine wiki, this step is required on the trunk<\/strong> version of Redmine at r2493<\/a> or above and the released 0.8.7 version or above.<\/p>\n
rake generate_session_store<\/pre>\n
7. Create the database structure, by running the following command under the application root directory :<\/p>\n
RAILS_ENV=production rake db:migrate<\/pre>\n
it will follow by a bunch of log output :<\/p>\n
[root@localhost redcomm]# RAILS_ENV=production rake db:migrate\n(in \/var\/www\/html\/redcomm)\n==  Setup: migrating ==========================================================\n-- create_table(\"attachments\", {:force=>true})\n   -> 0.0151s\n-- create_table(\"auth_sources\", {:force=>true})\n   -> 0.0269s\n-- create_table(\"custom_fields\", {:force=>true})\n   -> 0.0049s\n-- create_table(\"custom_fields_projects\", {:force=>true, :id=>false})\n   -> 0.0071s\n-- create_table(\"custom_fields_trackers\", {:force=>true, :id=>false})\n   -> 0.0080s\n-- create_table(\"custom_values\", {:force=>true})\n   -> 0.0075s\n-- create_table(\"documents\", {:force=>true})\n   -> 0.0272s\n-- add_index(\"documents\", [\"project_id\"], {:name=>\"documents_project_id\"})\n   -> 0.0062s\n-- create_table(\"enumerations\", {:force=>true})\n   -> 0.0059s\n\n....\n\n==  ChangeChangesPathLengthLimit: migrating ===================================\n-- change_column(:changes, :path, :text, {:null=>true, :default=>nil})\n   -> 0.0083s\n-- change_column(:changes, :path, :text, {:null=>false})\n   -> 0.0086s\n-- change_column(:changes, :from_path, :text)\n   -> 0.0152s\n==  ChangeChangesPathLengthLimit: migrated (0.0329s) ==========================\n\n==  EnableCalendarAndGanttModulesWhereAppropriate: migrating ==================\n==  EnableCalendarAndGanttModulesWhereAppropriate: migrated (0.0041s) =========\n<\/pre>\n
just ignore it and only pay attention at the end of it, as long as there are no error word, it’s ok \ud83d\ude42\u00a0 It will create tables and an administrator account. Just in case you get this error :<\/p>\n
Rake aborted!\nno such file to load -- net\/https\n<\/pre>\n
then you probably doesn’t have openssl library on the system, install openssl package from repository.<\/p>\n
8. Insert default configuration data in database, by running the following command :<\/p>\n
[root@krsprogdomain redcomm]# RAILS_ENV=production rake redmine:load_default_data\n(in \/var\/www\/html\/redcomm)\n\nSelect language: bg, bs, ca, cs, da, de, el, en, en-GB, es, eu, fi, fr, gl, he, hr, hu, id, it, ja, ko, lt, lv, mk, mn, nl, no, pl, pt, pt-BR, ro, ru, sk, sl, sr, sr-YU, sv, th, tr, uk, vi, zh, zh-TW [en] en\n====================================\nDefault configuration data loaded.<\/pre>\n
This step is optional but highly recommended<\/strong>, as you  can define your own configuration from scratch. It will load default  roles, trackers, statuses, workflows and enumerations. I’m using default english language.<\/p>\n
9. Setting up permissions<\/p>\n
The user who runs Redmine must have write permission on the following subdirectories: files<\/code>, log<\/code>, tmp<\/code> (create the last one if not present).<\/p>\n
Assuming you run Redmine with a user<\/code> user :<\/p>\n
chown -R user:user files log tmp public\/plugin_assets\/\nchmod -R 755 files log tmp public\/plugin_assets<\/pre>\n
10. Test the installation by running WEBrick web server :<\/p>\n
ruby script\/server webrick -e production<\/pre>\n
[root@localhost redcomm]# ruby script\/server webrick -e production\n=> Booting WEBrick\n=> Rails 2.3.5 application starting on http:\/\/0.0.0.0:3000\n=> Call with -d to detach\n=> Ctrl-C to shutdown server\n[2010-11-23 13:42:36] INFO  WEBrick 1.3.1\n[2010-11-23 13:42:36] INFO  ruby 1.8.7 (2009-06-12) [i586-linux]\n[2010-11-23 13:42:41] INFO  WEBrick::HTTPServer#start: pid=28679 port=3000\n\nProcessing WelcomeController#index (for 10.10.13.33 at 2010-11-23 13:43:06) [GET]\n  Parameters: {\"action\"=>\"index\", \"controller\"=>\"welcome\"}\nRendering template within layouts\/base\nRendering welcome\/index\nCompleted in 136ms (View: 42, DB: 34) | 200 OK [http:\/\/10.10.13.7\/]<\/pre>\n
Once WEBrick has started, point your browser to http:\/\/localhost:3000\/<\/a>. You should now see the application welcome page.<\/p>\n
Note: Webrick is not<\/strong> suitable for normal use, please  only use webrick for testing that the installation up to this point is  functional. It is not recommended to use webrick for anything other than  development. Use one of the many other guides in this wiki to setup  redmine to use either passenger (aka mod_rails) or mongrel to serve up  your redmine.<\/em><\/pre>\n
11. Use default administrator account to log in:<\/p>\n