welcome: please sign in

Diff for "MemberManual/WebApplications/Redmine"

Differences between revisions 3 and 4
Revision 3 as of 2009-11-06 14:34:04
Size: 3677
Comment:
Revision 4 as of 2009-11-06 16:07:03
Size: 3972
Comment:
Deletions are marked like this. Additions are marked like this.
Line 43: Line 43:
Let's update both rake and rails: Start by creating the ~/.gemrc file with the following contents:
Line 45: Line 46:
lvillani@mire:~$ gem install --install-dir $HOME/.gem --no-ri --no-rdoc -y rake
lvillani@mire:~$ gem install --install-dir $HOME/.gem --no-ri --no-rdoc -y rails -v=2.1.2
cat > .gemrc << EOF
gem: --no-ri --no-rdoc -y
gemhome: $HOME/.gem
gempath:
 - $HOME/.gem
 - /var/lib/gems/1.8
EOF
}}}

Let's update both gem, rake (gets updated as part of gem update) and rails:
{{{
lvillani@mire:~$ gem update --system
lvillani@mire:~$ gem install rails -v=2.1.2
Line 51: Line 63:
Now, in order to use the ''new'' rake and rails command we need to prepend ~/.gem/bin to the PATH. Assuming that you are using the bash shell, open ~/.bashrc (create it if it doesn't exist) and add:

{{{
export PATH="$HOME/.gem/bin:$PATH"
}}}

We will also need to tell ruby where to find the ruby libraries we've just installed, this is done by exporting the GEM_HOME environment variable. Add the following to your ~/.bashrc:
Now, in order to use the ''new'' rake and rails command we need to prepend ~/.gem/bin to the PATH and alter GEM_HOME and GEM_PATH variables, thus making ruby "see" the newly installed versions. Assuming that you are using the bash shell, open ~/.bashrc (create it if it doesn't exist) and add:
Line 61: Line 67:
export GEM_PATH="$HOME/.gem:/var/lib/gems/1.8"
export PATH="$HOME/.gem/bin:$PATH"
Line 80: Line 88:
When you have created the database you are ready to configure redmine. The first thing we'll need to do is to tell redmine where to find our database. To do so we create a file called database.yml inside DOCROOT/redmine-0.8.6/config with the following contents: When you have created the database you are ready to configure redmine. The first thing we'll need to do is to tell redmine where to find our database. To do so we create a file called database.yml inside DOCROOT/redmine-0.8.6/config with the following contents where:
 * '''USERNAME''' is your UNIX username, the one appearing before the '@' in every shell prompt
 * '''DATABASE_PASSWORD''' is the password you set with dbtool mysql adduser (or dbtool mysql passwd, if you changed it later)
 * '''DBNAME''' is the database name. It is formed by your account name, an underscore and the actual database name.
Line 85: Line 96:
  database: '''DBNAME'''   database: DBNAME
Line 87: Line 98:
  username: '''USERNAME'''
  password: '''DATABASE_PASSWORD'''
  username: USERNAME
  password: DATABASE_PASSWORD
Line 91: Line 102:
Where:
 * '''USERNAME''' is your UNIX username, the one appearing before the '@' in every shell prompt
 * '''DATABASE_PASSWORD''' is the password you set with dbtool mysql adduser (or dbtool mysql passwd, if you changed it later)
 * '''DBNAME''' is the database name. It is formed by your account name, an underscore and the actual database name
Now we can create the database schema by issuing the following command from DOCROOT/redmine-0.8.6:

{{{
lvillani@mire:~/public_html/binaryhelix.org/default/redmine-0.8.6$ RAILS_ENV=production rake db:migrate
}}}

What is redmine?

Redmine is an open source, web-based project management and bug-tracking tool. It includes calendar and gantt charts to aid visual representation of projects and their deadlines. It supports multiple projects. Redmine is a FOSS solution which provides integrated project management features, issue tracking, and support for multiple version control options.

For more information: http://www.redmine.org

Installation

Foreword

In this walkthrough you will see several 'variables', you'll have to substitute them to suit your needs. You can safely "export" them in your shell environment if you wish.

In particular:

  • DBNAME: is the database name
    • this walkthrough assumes you will be using MySQL
  • DOCROOT: where Redmine will be unpacked
    • this walkthrough assumes that Redmine will be installed in: ~/public_html/binaryhelix.org/default

Retrieving Redmine

At the time of writing, the latest release of Redmine is 0.8.6. Redmine can be retrieved from: http://rubyforge.org/frs/?group_id=1850 In particular we'll be using: http://rubyforge.org/frs/download.php/66633/redmine-0.8.6.tar.gz

So let's get it started:

lvillani@mire:~$ cd public_html/binaryhelix.org/default
lvillani@mire:~/public_html/binaryhelix.org/default$ wget http://rubyforge.org/frs/download.php/66633/redmine-0.8.6.tar.gz
lvillani@mire:~/public_html/binaryhelix.org/default$ tar xf redmine-0.8.6.tar.gz
lvillani@mire:~/public_html/binaryhelix.org/default$ ls
redmine-0.8.6  redmine-0.8.6.tar.gz

Updating gems

Now we'll need to update some of the "gems" installed on HCoop servers. Please note that we'll be installing those gems inside your home directory thus wasting a little bit of space.

Start by creating the ~/.gemrc file with the following contents:

cat > .gemrc << EOF
gem: --no-ri --no-rdoc -y
gemhome: $HOME/.gem
gempath:
 - $HOME/.gem
 - /var/lib/gems/1.8
EOF

Let's update both gem, rake (gets updated as part of gem update) and rails:

lvillani@mire:~$ gem update --system
lvillani@mire:~$ gem install rails -v=2.1.2

The stuff will be installed inside ~/.gem.

Now, in order to use the new rake and rails command we need to prepend ~/.gem/bin to the PATH and alter GEM_HOME and GEM_PATH variables, thus making ruby "see" the newly installed versions. Assuming that you are using the bash shell, open ~/.bashrc (create it if it doesn't exist) and add:

export GEM_HOME="$HOME/.gem"
export GEM_PATH="$HOME/.gem:/var/lib/gems/1.8"
export PATH="$HOME/.gem/bin:$PATH"

Now make sure that the new settings are loaded in your current shell:

lvillani@mire:~$ . ~/.bashrc

Verify that you are actually using the latest rake:

lvillani@mire:~$ rake -V
rake, version 0.8.7

Database

To do some initial setup database please follow instructions at: MemberManual/Databases#MySQL

When you have created the database you are ready to configure redmine. The first thing we'll need to do is to tell redmine where to find our database. To do so we create a file called database.yml inside DOCROOT/redmine-0.8.6/config with the following contents where:

  • USERNAME is your UNIX username, the one appearing before the '@' in every shell prompt

  • DATABASE_PASSWORD is the password you set with dbtool mysql adduser (or dbtool mysql passwd, if you changed it later)

  • DBNAME is the database name. It is formed by your account name, an underscore and the actual database name.

production:
  adapter: mysql
  database: DBNAME
  host: mysql
  username: USERNAME
  password: DATABASE_PASSWORD

Now we can create the database schema by issuing the following command from DOCROOT/redmine-0.8.6:

lvillani@mire:~/public_html/binaryhelix.org/default/redmine-0.8.6$ RAILS_ENV=production rake db:migrate

MemberManual/WebApplications/Redmine (last edited 2018-10-20 18:22:32 by ClintonEbadi)