Home > Installation
login

© Metadot Corporation

Windows Installation  

If you want to run Metadot 7 on Windows, we recommend to use the 2-click installer available at the download site

Linux Installation overview  

In order to install Metadot 7 on your machine follow these steps (of course skip those which are already done): 

  1. Install MySQL
  2. Install Ruby - version 1.8.5 or 1.8.6
  3. Install Rubygems
  4. Install Rake - rake should be version 0.7.3
  5. Install Ferret, MySQL & fcgi gems - needs ruby1.8-dev and mysql-dev (if can't be found, try libmysql++-dev) installed:
    yum install ruby-devel
    yum install mysql-devel
    yum install fcgi fcgi-devel
    gem install ferret -v 0.11.5
    gem install mysql -- --with-mysql-config=/usr/bin/mysql_config --with-mysql-lib=/usr/lib/mysql
    gem install fcgi -v 0.8.7
  6. Install Metadot 7
  7. Install FastCGI
  8. Setup Apache (Setting up a web server for Rails)
  9. Create search index:
    cd metadot-rails
    rake create_search_index RAILS_ENV=production
  10. Setup a cron job/scheduled task (for Linux - use the crontab for apache user, so generated index files would be accessible for the web server):
    0,15,30,45 * * * * cd /path_to_your_metadot_installation/metadot-rails/ && /usr/local/bin/rake periodic_processing RAILS_ENV=production

 

To test the project installation run the following command:

ruby script/server

the output should be something like this:

[2009-01-22 13:48:36] INFO WEBrick 1.3.1
[2009-01-22 13:48:36] INFO ruby 1.8.6 (2007-09-24) [i486-linux]
[2009-01-22 13:48:36] INFO WEBrick::HTTPServer#start: pid=16196 port=3000

The site should be available at http://your-machine-ip:3000

That will run the site in DEVELOPMENT mode - use this command only to test how the software is installed.If you want to run the site in PRODUCTION mode under Webrick you may execute the following command:

ruby script/server -e production

Do not use Webrick for production purposes, since it is single-threaded and therefor very slow.

In order to run the software in PRODUCTION mode you have to have installed Apache web server with installed mod_fastcgi (or mod_fcgid) - see steps 7 and 8.



Initial login:
email: admin@yoursite.com
password: admin123

Configuration  

There are several configuration constants located at config/environment.rb file which should be considered for update:

HOST_BASE - the domain name used to access the web site ("metadot.net" by default). This constant is used in generation of links and should be changed properly.

EMAIL_SUBJECT_TAG - the prefix in the emails description (default: "[Metadot Portal Server]")

EMAIL_FOOTER - default: "<<< Metadot Portal Server >>>"

WEB_PAGE_FOOTER - default: <a href="http://www.metadot.com?ref=app">powered by Metadot</a>

SYSTEM_NOTIFIER_SENDER - default: "Metadot Administrator" <metadot-admin@metadot.com>

SYSTEM_NOTIFIER_RECIPIENTS - default: metadot-admin@metadot.com

Updating the software  

  1. Get the installation package file from http://download.metadot.com/v7
  2. Go to your site folder (e.g. /var/www/metadot) and copy the package file there.
  3. Unpack the package file.
  4. Run "update" command - make sure the previous installation exists in the folder "metadot-rails", since the command will look for a database configuration file in there (config/database.yml).
  5. For linux systems - update the ownership of new metadot-rails directory to the web server user (i.e. apache)

Metadot 7 Installation on Red Hat Enterprise Linux 5  

This article has been contributed by Trent R. at www.investec.com.au.

Metadot 7 Installation
on Red Hat Enterprise Linux 5
To install Metadot 7 on Red Hat Enterprise Linux 5, complete the following steps, skipping those which are
already complete:-
1. Install Apache HTTP Server
# yum install httpd*
2. Install MySQL
# yum install mysql mysql-devel mysql-server
3. Install Ruby
# yum install ruby*
4. Install FCGI
Download current stable release
# wget http://www.fastcgi.com/dist/fcgi-current.tar.gz
Untar tar ball
# tar zxvf fcgi-current.tar.gz
# cd fcgi-x.x.x
Compile and install
# ./configure
# make
# make install
5. Install mod_fastcgi
First, ensure required packages to compile mod_fastcgi are installed
# yum install libtool httpd-devel apr-devel apr
Download the latest mod_fastcgi source code
# wget http://www.fastcgi.com/dist/mod_fastcgi-current.tar.gz
Untar tar ball
# tar zxvf mod_fastcgi-current.tar.gz
# cd mod_fastcgi-x.x.x/
Make a copy of Makefile.AP2 (for 32-bit systems)
# cp Makefile.AP2 Makefile
Compile and install mod_fastcgi
# make top_dir=/usr/lib/httpd
# make install top_dir=/usr/lib/httpd
Configure mod_fastcgi
# vi /etc/httpd/conf.d/mod_fastcgi.conf
Add the following configuration directive
LoadModule fastcgi_module modules/mod_fastcgi.so
Restart Apache
# service httpd restart
6 Install Rubygems
NB. Ruby 1.8.5 is the latest version available through the Red Hat Enterprise Linux 5 repository. The latest
version of Rubygems that will work this version of Ruby is 1.3.5.
Download source
Visit http://rubyforge.org/projects/rubygems/
Locate Latest File Releases and click Download.
Locate rubygems-1.3.5.tgz
Right-click and Copy Link Location (Mozilla Firefox) / Copy Shortcut (Internet Explorer)
# wget <right-click mouse button to insert download link>
Untar tar ball
# tar zxvf rubygems-1.3.5.tgz
Install
# cd rubygems-1.3.5
# ruby setup.rb
7. Install fcgi, ferret and rake gems
NB. fcgi gem version 0.8.7 required. You must force installation of this version.
# gem install fcgi -v0.8.7
# gem install ferret rake
8. Install Metadot 7
Create a folder where your site will reside (e.g. /var/www/html/intranet).
# mkdir /var/www/html/intranet
Change to the site folder and download the latest release of Metadot 7
# cd /var/www/html/intranet
# wget http://download.metadot.com/v7/mdot-lin-7.4.6.tar.gz
Untar tar ball
# tar zxvf mdot-lin-7.4.6.tar.gz
Run "install" command
# ./install db_name_prefix [db_root_password]
Where:
db_name_prefix - database prefix name
db_root_password - database password for the MySQL root user (optional)
For example
# ./install intranet
Create the search index for the production database
# cd metadot-rails
# rake create_search_index RAILS_ENV=production
Setup a cron job to generate index files under the ‘apache’ user.
# crontab –e –u apache
0,15,30,45 * * * * cd /var/www/html/intranet/metadot-rails/ && /usr/bin/rake
periodic_processing RAILS_ENV=production >/dev/null 2>&1
9. Configure Apache for Rails and create new virtual host
# vi /etc/httpd/conf/httpd.conf
Add the following configuration directives
AddHandler fastcgi-script .fcgi
FastCgiIpcDir /tmp/fcgi_ipc/
FastCgiConfig -maxProcesses 16
NameVirtualHost *:80
<VirtualHost *:80>
ServerName <insert FQDN of your Metadot host here>
DocumentRoot /var/www/html/intranet/metadot-rails/public
<Directory /var/www/html/intranet/metadot-rails/public>
Options -Indexes FollowSymLinks ExecCGI
AllowOverride All
Order allow,deny
Allow from all
</Directory>
</VirtualHost>
10. Restart Apache
# service httpd restart
Installation is now complete. Initial login for the site:
Email Address: admin@yoursite.com
Password: admin123

To install Metadot 7 on Red Hat Enterprise Linux 5, complete the following steps, skipping those which are already complete:

 

1. Install Apache HTTP Server

# yum install httpd*

 

2. Install MySQL

# yum install mysql mysql-devel mysql-server

 

3. Install Ruby

# yum install ruby*

 

4. Install FCGI

Download current stable release

# wget http://www.fastcgi.com/dist/fcgi-current.tar.gz

Untar tar ball

# tar zxvf fcgi-current.tar.gz
# cd fcgi-x.x.x

Compile and install

# ./configure
# make
# make install

5. Install mod_fastcgi

First, ensure required packages to compile mod_fastcgi are installed

# yum install libtool httpd-devel apr-devel apr

Download the latest mod_fastcgi source code

# wget http://www.fastcgi.com/dist/mod_fastcgi-current.tar.gz

Untar tar ball

# tar zxvf mod_fastcgi-current.tar.gz
# cd mod_fastcgi-x.x.x/

Make a copy of Makefile.AP2 (for 32-bit systems)

# cp Makefile.AP2 Makefile

Compile and install mod_fastcgi

# make top_dir=/usr/lib/httpd
# make install top_dir=/usr/lib/httpd

Configure mod_fastcgi

# vi /etc/httpd/conf.d/mod_fastcgi.conf

Add the following configuration directive

LoadModule fastcgi_module modules/mod_fastcgi.so

Restart Apache

# service httpd restart

6 Install Rubygems

NB. Ruby 1.8.5 is the latest version available through the Red Hat Enterprise Linux 5 repository. The latest version of Rubygems that will work this version of Ruby is 1.3.5.

Download source

Visit http://rubyforge.org/projects/rubygems/

Locate Latest File Releases and click Download.

Locate rubygems-1.3.5.tgz

Right-click and Copy Link Location (Mozilla Firefox) / Copy Shortcut (Internet Explorer)

# wget <right-click mouse button to insert download link>

Untar tar ball

# tar zxvf rubygems-1.3.5.tgz

Install

# cd rubygems-1.3.5
# ruby setup.rb

7. Install fcgi, ferret and rake gems

NB. fcgi gem version 0.8.7 required. You must force installation of this version.

# gem install fcgi -v0.8.7
# gem install ferret rake

 

8. Install Metadot 7

Create a folder where your site will reside (e.g. /var/www/html/intranet).

# mkdir /var/www/html/intranet

Change to the site folder and download the latest release of Metadot 7

# cd /var/www/html/intranet
# wget http://download.metadot.com/v7/mdot-lin-7.4.6.tar.gz

Untar tar ball

# tar zxvf mdot-lin-7.4.6.tar.gz

Run "install" command

# ./install db_name_prefix [db_root_password]

Where:

db_name_prefix - database prefix name

db_root_password - database password for the MySQL root user (optional)

For example

# ./install intranet

Create the search index for the production database

# cd metadot-rails
# rake create_search_index RAILS_ENV=production

Setup a cron job to generate index files under the ‘apache’ user.

# crontab –e –u apache

0,15,30,45 * * * * cd /var/www/html/intranet/metadot-rails/ && /usr/bin/rake

periodic_processing RAILS_ENV=production >/dev/null 2>&1

 

9. Configure Apache for Rails and create new virtual host

# vi /etc/httpd/conf/httpd.conf

Add the following configuration directives

AddHandler fastcgi-script .fcgi

FastCgiIpcDir /tmp/fcgi_ipc/

FastCgiConfig -maxProcesses 16

NameVirtualHost *:80

<VirtualHost *:80>

ServerName <insert FQDN of your Metadot host here>

DocumentRoot /var/www/html/intranet/metadot-rails/public

<Directory /var/www/html/intranet/metadot-rails/public>

Options -Indexes FollowSymLinks ExecCGI

AllowOverride All

Order allow,deny

Allow from all

</Directory>

</VirtualHost>

 

10. Restart Apache

# service httpd restart

 

Installation is now complete. Initial login for the site:

Email Address: admin@yoursite.com
Password: admin123