wiki:Installation

Version 3 (modified by david.vanenckevort@…, 8 years ago) (diff)

--

FGWeb Installation Manual

Copyright 2001-2010 Sacha van Hijum Copyright 2010 Netherlands Bioinformatics Centre This software is co-developed by the Netherlands Bioinformatics Centre

This file is part of FG Web.

FG Web is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

FG Web is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with FG Web. If not, see <http://www.gnu.org/licenses/>.

INSTALLATION

  1. Copy the files from main/src to your web server's document root
  2. Copy the modules you need from modules/ into the web server's document root. For the SysAdmin module only the code in modules/sysadmin/src should be copied into a sysadmin directory in the web root.
  3. Copy the files from php-lib/src to your PHP include path or add this directory to the PHP include path
  4. Download and install the software listed in REQUIRED SOFTWARE
  5. Configure the software. Review the following files php-lib/src/FGWeb/Config/Db.php, main/src/fgweb_cgi.inc.php, main/src/lib/php/global_info.inc.php

APACHE & PHP CONFIGURATION

  1. Review /etc/php.ini and adjust the following settings if necessary.
    [PHP]
    register_long_arrays = On
    ; To allow for large uploads
    post_max_size = 75M
    upload_max_filesize = 75M
    default_socket_timeout = 120
    
  2. Create a virtual host for fgweb.
  3. Restart Apache to make these changes active.
  4. Go to http://localhost/html/admin/index.php to setup the initial user database.

REQUIRED SOFTWARE

Make sure the following software is installed:

  • Perl 5 with:
    • Config::IniFiles?
    • Data::Dumper
    • GD
    • IO::File
    • SOAP::Lite
    • Devel::Cover
  • apache httpd
  • R
  • dos2unix
  • PHP 5.1+ with:
    • Pear Log
    • Smarty

Red Hat

For RedHat the EPEL repository is required, see http://fedoraproject.org/wiki/EPEL for installation instructions.

yum install perl-SOAP-Lite perl-GD perl-IO-All perl-Data-Dump perl-Config-IniFiles perl-Devel-Cover perl-Test-Class \
  php-pear-Log php-Smarty

Debian / Ubuntu

apt-get install libsoap-lite-perl libgd-graph-perl libconfig-inifiles-perl libdevel-cover-perl libtest-class-perl \
 php-log smarty3 phpunit

On Mac OS X

Download XAMPP and Smarty

Smarty can be placed in the /Applications/XAMPP/xamppfiles/lib/php/ or include the installation directory in your PHP include path

ADDITIONAL TOOLS

Depending on your usage you want to install one or more of the following tools in the tools directory. Each tool has it's own directory, make sure you remove the comment before the configuration in fgweb.ini and verify that the installation path matches what you specified there.