Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: for the plan.

Jump to: navigation, search

EPF Wiki Upgrade to Edge

This guide describes how to upgrade your existing EPF Wiki (1.5) installation to 'Edge' EPF Wiki.

If you are using EPF Wiki on Ubuntu with Ruby 1.8.7 is strongly recommended you upgrade to Edge EPF Wiki. EPF Wiki was released when Ruby 1.8.6 was the current Ruby version and so EPF Wiki was never tested to work with 1.8.7

If you have any questions about this guide or EPF Wiki please use the Eclipse Process Framework Project Developers List.


Of course you create regular backups of you existing EPF Wiki installation. First thing you would do is to take the old site offline (shutdown Apache2) and run the backup procedure one last final time. The backup has two components.

A dump of the database for example

mysqldump --default-character-set=latin1 --allow-keywords --quote-names --skip-opt -uepfwiki -p***** -h epfwiki_2 1> epfwiki_dump.sql

A copy of the EPF Wiki root. This directory has folders such as app, config, lib, public. The important bits, the bits will we need for the migration are in the folder public. The folders we will need are:

  • bp
  • wikis
  • uploads

Install Edge EPF Wiki

Using the README on Github. This will give an environment for running EPF Wiki which has all the latest components:

  • RVM
  • Ruby 1.9.2
  • Rails 3
  • Apache2
  • MySQL

Create a new EPF Wiki root

On the new machine we can deploy new site with migrated data.

We do git clone to get latest version of EPF Wiki in a folder epfw2.

git clone epfw2

We reuse the MySQL user epfwiki that we created in the previous steps as described in the README on Github. So at this point we don't need to create a MySQL user.

Create and edit the database configuration file using vi (or nano). Rename the database from epfwiki to epfwiki2 as we already have a database epfwiki.

cd ~/epfw2/config
cp database.yml.example database.yml
vi database.yml

After edit the production environment entry is

  adapter: mysql2
  database: epfwiki2
  host: localhost
  username: epfwiki
  password: ikiwpur
  encoding: utf8

Create the production environment configuration file. See the readme on Github for instructions

cd ~/epfw2/config/environments
cp production.rb.example production.rb

Configure the mailer, see the readme on Github for instructions.

Copy the folders bp, wikis, uploads to ~/epfw2/public. Make sure the permissions are set correctly.

Create database

Create the database and this time we don't create the database schema because it will be imported including data from our backup files

cd ~/epfw2
rake db:create RAILS_ENV=production

Import database schema and data

mysql -hlocalhost -uepfwiki -pikiwpur epfwiki2 < epfwiki_dump.sql

Apache2 configuration

Create a new virtual host. Edit apache configuration file

sudo vi /etc/apache2/sites-enabled/000-default

Add entry to 000-default

<VirtualHost *:3001>
  ServerName localhost
  DocumentRoot /home/ostraaten/epfw2/public    

Add the port 3001

sudo vi /etc/apache2/ports.conf

Restart Apache2 is activate changes

sudo /etc/init.d/apache2 restart

Back to the top