This tutorial is based on the following assumptions:
- Ubuntu is being used as OS
- Java is installed on your system
- Glassfish is installed (%GLASSFISH_HOME% will be used in the following to refer to the installation directory)
- All downloads go to /tmp
Install JRubyIn order to run Redmine, a Ruby runtime has to be installed first. We will use JRuby 1.1.4 (the current version at the time of this writing - 1.1.5 - didn't work, probably due to this bug). Download it and add JRuby to your path as follows:
Verify that JRuby is set up properly by issuing:
$sudo tar -xzvf /tmp/jruby-bin-1.1.4.tar.gz
$sudo ln -s jruby-1.1.4 jruby
This should yield in:
jruby 1.1.4 (ruby 1.8.6 patchlevel 114) (2008-08-28 rev 7570) [i386-java]
Download required gemsHaving JRuby up and running, we need to install the ActiveRecord JDBC MySQL adapter for Rails. Furthermore it is recommended to install JRuby's Open SSL support as well. Finally, we need Warbler, which will allow us to package the Redmine application as a WAR archive. Using the RubyGems package manager, this is easy:
$ sudo gem install jruby-openssl activerecord-jdbcmysql-adapter warblerAll required dependent gems (such as activerecord-jdbc-adapter) will automatically be downloaded by RubyGems.
Install and set up MySQL database serverNext, the database to be used by Redmine needs to be set up. We will be using MySQL, as it is a very common companion for RoR apps, though other database servers should do the trick as well.
Install the server:
$ sudo apt-get install mysql-serverLogin into MySQL:
$ mysql -u root -p %YOUR_PASSWORD%Create a database:
mysql> CREATE DATABASE redmine_production character set utf8;Create a database user:
mysql> GRANT ALL ON redmine_production.* TO 'redmine'@'localhost' IDENTIFIED BY 'redmine';Repeat the latter two steps for schemas redmine_test and redmine_development and leave the MySQL shell.
Create data source in GlassfishIn order to set up a MySQL based data source in Glassfish, the server has to be provided with the MySQL JDBC driver. Ensure that Glassfish is stopped for the following. So let's download the driver, un-tar it and copy it into the server's lib dir:
$ wget dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-5.1.7.tar.gz/from/http://sunsite.informatik.rwth-aachen.de/mysql/ $ tar -xzvf mysql-connector-java-5.1.7.tar.gz $ sudo cp /mysql-connector-java-5.1.7/mysql-connector-java-5.1.7-bin.jar %GLASSISH_HOME/lib/Now start up Glassfish:
$ %GLASSISH_HOME/bin/asadmin start-domain domain1Create a connection pool and a JDBC resource (if you prefer a more visual way of doing such things, help can be found here):
$ %GLASSISH_HOME/bin/asadmin create-jdbc-connection-pool --datasourceclassname com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource --restype javax.sql.DataSource --property "User=redmine:Password=redmine:URL=jdbc\:mysql\://localhost\:3306/redmine_production" jdbc/RedminePool $ %GLASSISH_HOME/bin/asadmin create-jdbc-resource --connectionpoolid jdbc/RedminePool jdbc/Redmine
Install and set up RedmineNow it's time to install Redmine itself (refer to the official installation guide for further information). So download and extract the archive:
$ wget rubyforge.org/frs/download.php/39477/redmine-0.7.3.tar.gz $ tar -xzvf redmine-0.7.3.tar.gzCreate a new database environment "production_setup" and the database config file:
$ cp config/environments/production.rb config/environments/production_setup.rb $ cp config/database.yml.example config/database.ymlEdit config/database.yml:
production: adapter: jdbc jndi: jdbc/Redmine production_setup: adapter: jdbcmysql database: redmine_production host: localhost username: redmine password: redmine encoding: utf8 development: adapter: jdbcmysql database: redmine_development host: localhost username: redmine password: redmine encoding: utf8 test: adapter: jdbcmysql database: redmine_test host: localhost username: redmine password: redmine encoding: utf8The "production" environment is configured to use the data source, which we previously created within the Glassfish server. No credentials are stored here, as they are part of the connection pool's configuration. Note the special environment "production_setup" which we'll use now to initialize the database:
$ rake db:migrate RAILS_ENV="production_setup" $ rake redmine:load_default_data RAILS_ENV="production_setup"Now we can test the application using Webrick:
$ jruby script/server -e production_setup
Package and deploy RedmineRunning the application on Webrick is fine for testing purposes, but now let's deploy Redmine on Glassfish. For this target, the Warbler gem comes into play. It takes a Rails application and creates a WAR archive from it. Besides the application itself, JRuby and all required gems are packaged into the archive as well. Therefore, this WAR is fully self-contained and can be deployed on every web container or application server. First, we have to create the Warbler configuration:
$ warble configThis will create the file config/warble.rb. Edit this file, find the line beginning with "config.dirs ..." and replace it with the following:
config.dirs = %w(app config lib log vendor tmp extra files lang)This will cause the named directories to be packaged into the resulting WAR. Find the line beginning with "#config.gems += " and uncomment it, allowing for the gems active-record-jdbcmysql-adapter and jruby-openssl to be packaged into the WAR as well.
Having configured warbler, the web archive can be created. Go to the application's root dir and enter:
$ warbleThe resulting WAR file can now be deployed to the app server. Either do this within the admin console or just by copying it to Glassfish's auto deploy folder:
$ cp redmine-0.7.3.war %GLASSFISH_HOME%/domains/domain1/auto-deployUpon success, Redmine can be accessed at http://localhost:8080/redmine-0.7.3. Click "Sign in" in the upper right, log in using "admin"/"admin" as user/password and you should see your personal Redmine page as depicted below.
Typically, you would now create a project or other user accounts, which can be done under "Administration".