View source for EPF Wiki Installation Guide for Ubuntu

== Introduction ==

This guide describes how to install EPF Wiki 1.7 on Ubuntu Server, Red Hat and CentOS using Apache2 and Phusion Passenger (a.k.a mod_rails). EPF Wiki 1.7 uses Rails 3.2 and was tested using Ruby 2.0.0 and 1.9.3. Ruby 2.0.0 is recommended. This guide was tested with Ubuntu Server 12.04.3 and CentOS 6.4. CentOS 6.4. is very similar to Red Hat 6.4.

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]. The install files can be found on the [[EPF Wiki Downloads]] page.

More information on EPW Wiki can be found in 
# [[EPF Wiki User Guide]]
# [[EPF Wiki Development Guide]]
# [[EPF Wiki Downloads]]
# [[EPF Wiki Upgrading]]
# [[EPF Wiki Upgrade to Edge]] (obsolete)

== Ubuntu Server ==

If you want to take EPF Wiki for a spin, it is recommended to use Ubuntu Server, CentOS or Red Hat. EPF Wiki was tested using Ubuntu Server 12.04.3 and CentOS 6.4. Other Linux distributions will work equally well but you will have to make adjustments in the commands and versions.

You can easily create EPF Wiki as a [http://en.wikipedia.org/wiki/Virtual_appliance virtual appliance] using for example VirtualBox and the instructions in this document. This is the recommended approach for taking EPF Wiki out for a spin.

When you enable bridged networking this will allow easy access to EPF Wiki box for administration tasks. Also you can access EPF Wiki from anywhere on the network. The command <code>ifconfig</code> will show the IP address that is assigned to the machine on your network. After that you can easily creat http, ssh or sftp connections to the machine. To activate changes do sudo <code>/etc/init.d/networking restart</code>

== MySQL ==
Open a terminal window to install MySQL client and server
For Ubuntu
 sudo apt-get install mysql-client mysql-server libmysqlclient15-dev

For CentOS/Red Hat you use
 sudo yum -y install mysql mysql-server mysql-devel

Create database user for EPF Wiki
 mysql -uroot
 create user 'epfwiki'@'localhost' identified by 'ikiwpur';
 grant all privileges on *.* to 'epfwiki'@'localhost';
 grant usage on *.* to 'epfwiki'@'localhost';

== RVM ==

RVM is the recommended approach for installing Ruby and related libraries.
 \curl -L https://get.rvm.io | bash # Install RVM
 source ~/.rvm/scripts/rvm # RVM is not immediately available, you need to login again but you can also issue this command in the current session
 type rvm | head -1
 rvm install 2.0.0
 rvm use 2.0.0
 rvm gemset create epfwiki
 rvm use 2.0.0@epfwiki

== EPF Wiki ==

Extract the EPF Wiki zip file that you can find as a download on http://www.eclipse.org/epf. Open a terminal window and navigate to the folder
 gedit config/database.yml
This will open an editor. Now you can change the database settings to match your mysql-server setup (database user and password)

Create the database
 export RAILS_ENV=production
 rake db:create db:migrate

Mail server settings
 gedit config/environments/production.rb

Few options what you can do here. Use sendmail
 ActionMailer::Base.delivery_method = :sendmail
Use a SMTP server
 ActionMailer::Base.smtp_settings = {
 :address => 'mail.eclipse.org',
 :port => 25,
 :domain => 'epf.eclipse.org',
 :user_name => 'optional',
 :password => 'optional',
 :authentication => :login
 }

If email is not working you will see error messages with the text 'Broken pipe'.

Note: email is used for registration (users sign up using valid email address) and reports. If you are just testing and/or don't have access to a mail server you can disable email
 ActionMailer::Base.delivery_method = :test
EPF Wiki will work but users that sign up do not receive the email with the confirmation link. The confirmation link is visible in the log file log/production.log. 

You can now start the interal WebRick server to check if things are working
 ruby script/server production
Navigate to http://localhost:3000, this will redirect you to http://localhost:3000/login/new_cadmin where you can create the first account.

Note: make sure read-access is granted to all users, otherwise Apache will be unable to start EPF Wiki.

EPF Wiki uses jobs to send reports and update Wiki sites. Such a job is unaware of the Web server configuration as no Web server is involved in the operation, so we have to tell EPF Wiki the host and port the Web server is using. We do this by creating the configuration file for the production environment (config/environments/production.rb). You create this file by renaming or the copying the example file *production.rb.example*. Then you can edit the file. 

 gedit /config/environments/production.rb

There are a lot of variables in this file but the two important ones are 
 ENV['EPFWIKI_REPLY_ADDRESS'] = "no-reply@epf.eclipse.org"
 ENV['EPFWIKI_BASE_URL'] = "http://examp.com/"

The variable EPFWIKI_BASE_URL is important. Here you put the base url where EPF Wiki is located. Including a trailing slash.

== Apache2 ==

Terminal
 sudo apt-get install apache2
For Phusion Passenger more of Apache is needed 
 sudo apt-get install apache2-prefork-dev
 sudo apt-get install libapr1-dev
 sudo apt-get install libaprutil1-dev
 
== Phusion Passenger (a.k.a mod_rails) == 

 sudo gem install passenger
 sudo passenger-install-apache2-module

== Apache Configuration ==

Add for example to configuration file /etc/apache2/sites-enabled/000-default
 LoadModule passenger_module /usr/lib/ruby/gems/1.8/gems/passenger-2.2.4/ext/apache2/mod_passenger.so
 PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-2.2.4
 PassengerRuby /usr/bin/ruby1.8
 <VirtualHost *:3000>
   ServerName epfwiki
   DocumentRoot /home/tonyclifton/epfwiki/public    
 </VirtualHost>
If you are just testing and don't have a proper domain name for your server you can just add anything to the hosts file
 sudo gedit /etc/hosts
Restart apache to activate changes
 sudo /etc/init.d/apache2 restart
Now you should be able to see EPF Wiki when you navigate to http://epfwiki:3000

NOTE: The passenger version number may be different, currently it is 2.2.7. You may have to change it in the paths above.

== HTML Tidy ==

 sudo apt-get install tidy

== TinyMCE ==


To install TinyMCE navigate to the application folder
 rake epfw:tinymce

Alternatively, do it manually 

To integrate TinyMCE with EPF Wiki:

# Download '''TinyMCE 3.2.0.2''' from [https://github.com/downloads/tinymce/tinymce/tinymce_3.4.4.zip github.com]
# Extract the contents and copy the folder '''tinymce\jscripts\tiny_mce''' to '''[application install dir]\public\javascripts'''. The folder '''javascripts\tiny_mce''' should now contain Javascript library '''tiny_mce.js'''

== Add a Cron Job ==

Terminal 
 crontab -e
To create a Cron job. You can use an online tool [http://cron.nmonitoring.com/cron-generator.html Crobtab Generator] to generate the exact command to enter. 

This job will send reports (daily, weekly, monthly) and will update Wiki sites if updates have been scheduled. It should run from the EPF Wiki Application root 

A command like the following runs the daily job
 cd /home/user/epfwiki && ruby script/runner -e production 'job_daily'

The crontab entry that runs the job each night 20:00 hours would be 
 * 20 * * * cd /home/user/epfwiki && ruby script/runner -e production 'job_daily'

Or you can run the job each hour
 0 * * * * cd /home/user/epfwiki && ruby script/runner -e production 'job_daily'
 
This job should run at night or at when ever your site is used the least.


[[Category:EPF]]