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  

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)