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.
Difference between revisions of "EPF Wiki Upgrade to Edge"
(New page: Will be available shortly) |
(Adding the EPF category) |
||
(20 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
− | + | This guide describes how to upgrade your existing EPF Wiki (1.5) installation to [https://github.com/ostraaten/epfw '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 [mailto:epf-dev@eclipse.org Eclipse Process Framework Project Developers List]. | ||
+ | |||
+ | == 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<br> | ||
+ | |||
+ | == Install Edge EPF Wiki == | ||
+ | |||
+ | Using the [https://github.com/ostraaten/epfw 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 <code>git clone</code> to get latest version of EPF Wiki in a folder <strong>epfw2</strong>. | ||
+ | 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 <code>vi</code> (or <code>nano</code>). 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 | ||
+ | [[Category:EPF]] |
Latest revision as of 09:10, 24 October 2019
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