Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
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.
Contents
Preparation
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 epf.eclipse.org 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 https://github.com/ostraaten/epfw.git 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
production: 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 </VirtualHost>
Add the port 3001
sudo vi /etc/apache2/ports.conf
Restart Apache2 is activate changes
sudo /etc/init.d/apache2 restart