Fedena/Installation

Fedena is a web application meant to install in a server and accessed using browsers in client computers. You can install and use Fedena in your personal computer or LAN using the steps given below. If you want to make use of the complete features of Fedena, you should install it in a cloud computing server.

Download
The Fedena source code is available on github. You can clone the repository by using the following in the command line:
 * https://github.com/projectfedena/fedena

Windows
Download and install One-Click Ruby Installer for Windows. http://rubyforge.org/frs/download.php/72085/rubyinstaller-1.8.7-p302.exe (Old link, rubyforge not active, use below link.) http://dl.bintray.com/oneclick/rubyinstaller/rubyinstaller-1.8.7-p374.exe?direct
 * Step 1: Install Ruby

Now we can use the RubyGems package manager to download and install Rails 2.3.5(Note: Version should be 2.3.5), if error occurs with rake, run "gem install rake -v=0.8.7"
 * Step 2: Install Rails
 * 1) Open a command window and run the command
 * 1) Then, run the command
 * Step 3: Install MySQL
 * 1) Download and install the "essential" version of the MySQL installer v5.0 http://downloads.mysql.com/archives/mysql-5.0/mysql-essential-5.0.90-win32.msi
 * 2) Copy libmysql.dll from MySQL bin directory (usually C:\Program Files\MySQL\MySQL Server 5.0\bin) to Ruby bin directory (usually C:\Ruby\bin)

gem install bundler -v=1.16.2 gem install rake -v=0.8.7 gem install rails -v=2.3.5 gem install i18n -v=0.4.2 gem install mysql -v=2.8.1
 * Step 4: Prep for Fedena Setup
 * 1) Download Fedena source code from GitHub. Extract the ZIP/TAR archive and save to a folder (say C:\Fedena).
 * 2) Now go to the fedena source directory in the command window. (EG "CD C:\FEDENA" or "CD C:\projectfedena-fedena-84b5ad9")
 * 3) We need to install the correct MySQL gem, must be a specific version also. (Note, it will generate a bunch of output "No definition for ___", but this is normal. To verify it was installed, scroll up and if it shows "1 gem installed," you are fine.)
 * 4) Install Declarative Authorization:
 * 5) Install i18n:
 * 6) Since the "rake" command installed is most likely higher version than what Fedena is written for, we need to check for that. Run the command:   If you have anything but 0.8.7 installed, remove it/them.  It will say that dependencies will not be met, but this is OK, remove it anyway; also remove the executable when you are prompted.
 * 7) Then install the correct version, enter the command:
 * 8) Install the gem:
 * 9) Now we need to update the gem system to the proper one:
 * 10) And last gem to install:
 * 11) Finally, you need to check your gem list versions or install them by specific versions from the beginning As
 * Step 5: Set up Fedena
 * 1) Update the MySQL database details in .  You will need to supply the correct MySQL 'root' password.  It is recommended to use a text editor like the "edit" command at the command prompt, notepad doesn't show correct formatting.
 * 2) Run the command   This will create the required databases.
 * 3) Run the command   This will populate the database with required tables. NOTE: If you receive errors at this point, you may need to run the following command: "gem install rubygems-update -v 1.3.5" and re-enter "rake db:migrate".
 * 4) Install the plugins:
 * 5) Finally, run the command   This would start the server and it will be accessible at http://localhost:3000 NOTE: The default username is admin and the default password is admin123.


 * Step 6:Install RMagick for Fedena
 * 1) (This installation is needed to solve error when uploading student profile picture)


 * 1) Download RMagick-2.12.0-ImageMagick-6.5.6-8-Q8.zip


 * 1) Unzip ImageMagick-6.5.6-8-Q8.zip
 * 2) Go to the unzip result folder and run ImageMagick-6.5.6-8-Q8-windows-dll.exe to install it.
 * 3) Unzip RMagick-2.12.0.tar.gz
 * 4) Copy the result, Rmagick-2.12.0 folder to C:\
 * 5) Copy rmagick-2.12.0-x86-mswin32.gem to C:\RMagick-2.12.0
 * 6) Navigate into folder C:\RMagick-2.12.0 using Windows Command Prompt
 * 7) Run the command gem install rmagick—local


 * Running in Production Mode
 * If you want to run Fedena in production mode, run the command  For this, Production database details should be given in config/database.yml
 * For quicker running, run the following commands, then you can once again use the above command to launch:
 * 1) Install Mongrel
 * 2) Run the command:
 * 3) Open another terminal instance, go to the Fedena source directory, and run the following command:


 * Making a Windows Service
 * If you want to run Fedena as a Windows Service (which automatically starts), do the following commands:
 * 1) Open the Ruby Command prompt and go to your Fedena Installation director
 * 2) Install a Gem:
 * 3) Install a Gem:
 * 4) Run the command:    (Replace C:\FEDENA with whatever your Fedena installation Directory is.)  You may also wish to change the port from 3001 to 80 so when entering the address from other computers, it is not required that you enter a port.
 * 5) Go to windows search at the start menu, type:
 * 6) Look for service named 'Fedena' and set it to automatic
 * 7) Restart your computer and see if the fedena start automatically. Always make sure that your server is running.

Ubuntu Linux
Ruby, rubygems, rails and other required packages can be installed by :
 * Setting up the Rails development environment

Fedena uses mysql, so run, Do remember the mysql password you set during this step, it is required in step five.
 * Setting up MySQL server

Download Fedena source code from GitHub. Extract the downloaded .tar archive to a convenient location where you would be running fedena. Let us say we extracted it to a directory named fedena in my home(~) directory.
 * Download the latest Fedena source code from github

Fedena runs on version 2.3.5 of rails, so open a terminal and run,
 * Install Rails version 2.3.5

Open the file database.yml in the config folder of the fedena soucre. Change the following details: database: fedena - The name of the database you want to use for fedena username: root - Mysql username for fedena password: mypass - The password for the above mysql user
 * Setup your database details in the database.yml

Run
 * Install the prawn gem

Open a terminal and navigate to the fedena source directory, install the rest of the gems by running
 * Install the rest of the gems

From the Fedena source directory in terminal run,  followed by,
 * Set up Fedena databases

From the same directory grant executable permissions for the files in script directory by,
 * Change permissions for scripts

If everything went fine till now, you are ready to run fedena server by running the following from fedena source folder,
 * Run the inbuilt server

Web Server - Centos
Installing Fedena on Centos is a bit tricky since most of the stack used to run fedena is not available as packages and has to be compiled and installed from their sources. The Centos version 5.4, the version I used to test fedena, comes with a version of Ruby that is very old. So here is what you should do to get Fedena up and running. First the plan. Our plan is to install the Centos, Nginx (and passenger), MySQL and RoR stack and then install fedena. The instructions here are for installing on a VPS with a VM, installing it on your laptop or other hardware is similar.

Assuming that you have a working installion of Centos either on your laptop, server or a VM on the cloud here are the activities that you should do to get fedena up and running.

Fedena requires Ruby 1.8.7 and Rails 2.3.5, The version numbers are extremely important and you should verify that these specific versions of ruby and rails have been installed before you proceed executing the subsequent steps.
 * Installing Ruby and Rails

Do a check on the version of ruby installed

If you have a 64bit version of Centos you can make it a 64bit version

Check the version of ruby, again

After installing ruby you should install ruby gems. Like in the case of ruby, you should install ruby gems from source because the packages install a very old version of ruby gems. First download the source code from the repository to a directory "source" or "src". If you haven't got a directory then create one then make that directory your present working directory.
 * Installing rubygems

Fedena requires ruby gems 1.3.7 so lets download it

Unpack the sources. Once done you should see a directory rubygems-1.3.7.

Compile and install rubygems

You should see the following message and some information on notes and bugs

Check the gems version

You should see So far so good

Now install the gem: prawn. Ensure you install the specific version mentioned here.

You should install the Rails framework. Do not update the gems. You should also check if rake is version 0.8.7 otherwise do a gem uninstall rake and a gem install rake -v 0.8.7
 * Installing Rails

Some distributions come with MySQL 5.0.77-4.el5_6.6 so first lets remove it
 * Installing MySQL

Now install the MySQL database You should see the following message Complete!

Now lets start MySQL and secure the "root" user

Test your password using the following command

Now install support for rails

Thats quick. Lets check to see if its properly installed. Start the interactive ruby shell Now its time to install a server to serve your rails application over the web. Lets install Phusion's passenger

There are other servers like Thin, Mongrel etc however Phusion is the preferred because it doesn't replicate the http request handling functionality of apache/nginx/lighttpd but instead latches on to apache and nginx as a module.
 * Phusion's Passenger

We'll now need to install the Passenger server to serve Fedena to all http requests coming in through Nginx.

Its very likely that you see the following messages At this point install the missing software and install ruby again with openssl support Lets first install zlib support Lets install openssl

Install the passenger nginx module. If all is well you should see the following message Download fedena from Github. The—no-check-certificate flag allows wget to connect without checking the certificate A file "master" will be downloaded. Now rename the file as shown below The contents of the file will be extracted into a directory
 * Download and setup Fedena

Recollect the password you provided when you installed MySQL' Open the file database.yml in the config folder of the fedena source. Change the following details: database: fedena - The name of the database you want to use for fedena username: root - Mysql username for fedena password: mypass - The password for the above mysql user
 * Make changes to the database configuration file

From the Fedena source directory in terminal run, followed by,
 * Set up Fedena databases


 * Install rest of the gems

Restart the nginx server.
 * Configure the virtual hosts

Thats all there is to it. Visit the URL and you should see the fedena login page.

Other Options
A dedicated operating system iso of Fedena is available in Turnkey linux. Single click installer of Fedena for windows and Linux is available from certain Fedena Pro Service companies.