Changes between Version 1 and Version 2 of Installation


Ignore:
Timestamp:
Jul 5, 2013, 12:59:39 PM (8 years ago)
Author:
david.vanenckevort@…
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Installation

    v1 v2  
    1 = Installation =
    2 If you check out from subversion, the modules are separated from the framework.
    3 The files from each module you pick must be copied into the fgweb root
    4 directory.
     1= FGWeb Installation Manual =
     2Copyright 2001-2010 Sacha van Hijum
     3Copyright 2010 Netherlands Bioinformatics Centre
     4This software is co-developed by the Netherlands Bioinformatics Centre
    55
    6 If you downloaded the compressed tar archives you extract the files in
    7 a common installation directory (e.g. /opt/fgweb).
     6This file is part of FG Web.
    87
    9 == Common ==
    10  1. Place the files from the distribution in a common directory (/opt/fgweb).
    11  2. Set the following environment variables:
    12    * PERL5LIB, include /opt/fgweb/lib/perl (e.g. export PERL5LIB=${PERL5LIB}:/opt/fgweb/lib/perl)
    13    * FGWEB_DIR point to the installation directory (e.g. export FGWEB_DIR=/opt/fgweb)
    14    In most systems you can configure the variables globally with /etc/environment
    15  3. Review the included etc/fgweb.ini and make changes where necessary
    16  4. Create a daily and monthly cron job for the
    17    /opt/fgweb/cron/fgweb_update_{daily,monthly} scripts.
    18  5. Currently !AppArmor or SELinux is not supported, make sure you disable them.
    19    Contributions to support them are welcome.
    20  6. Apache needs to have read access to all files, and write access to the
    21    work directory.
     8FG Web is free software: you can redistribute it and/or modify
     9it under the terms of the GNU Affero General Public License as published by
     10the Free Software Foundation, either version 3 of the License, or
     11(at your option) any later version.
    2212
    23 == Apache httpd & PHP Configuration ==
    24  1. Review /etc/php.ini and adjust the following settings if necessary.
     13FG Web is distributed in the hope that it will be useful,
     14but WITHOUT ANY WARRANTY; without even the implied warranty of
     15MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     16GNU Affero General Public License for more details.
     17
     18You should have received a copy of the GNU Affero General Public
     19License along with FG Web. If not, see <http://www.gnu.org/licenses/>.
     20
     21== INSTALLATION ==
     22
     231.      Copy the files from main/src to your web server's document root
     242.      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.
     253.      Copy the files from php-lib/src to your PHP include path or add this directory to the PHP include path
     263.      Download and install the software listed in REQUIRED SOFTWARE
     274.      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
     28
     29=== APACHE & PHP CONFIGURATION ===
     301. Review /etc/php.ini and adjust the following settings if necessary.
    2531{{{
    26  [PHP]
    27  register_long_arrays = On
    28  post_max_size = 75M
    29  upload_max_filesize = 75M
    30  default_socket_timeout = 120
     32[PHP]
     33register_long_arrays = On
     34; To allow for large uploads
     35post_max_size = 75M
     36upload_max_filesize = 75M
     37default_socket_timeout = 120
    3138}}}
    32  2. Create a virtual host for fgweb.
    33 See the included apache.conf in the doc directory for an example.
    34  3. Restart Apache to make these changes active.
     392. Create a virtual host for fgweb.
    3540
    36 == MySQL database ==
    37  1. Create a database and a user that has access to the database. Make sure the name of the database and the login details match what is specified in the configuration files.
    38  2. The database must support transactions and foreign keys, this means that you MUST use InnoDB on MySQL. If InnoDB is not installed please refer to the MySQL manual on how to configure MySQL to use InnoDB. Otherwise SET storage_engine=InnoDB; will do the trick.
     413. Restart Apache to make these changes active.
    3942
    40 == Required Software ==
     434. Go to http://localhost/html/admin/index.php to setup the initial user database.
     44
     45=== REQUIRED SOFTWARE ===
    4146Make sure the following software is installed:
    4247   * Perl 5 with:
    43      * Config::!IniFiles
     48     * Config::IniFiles
    4449     * Data::Dumper
    4550     * GD
     
    5156   * dos2unix
    5257   * PHP 5.1+ with:
     58     * Pear Log
    5359     * Smarty
    54      * Pear Log
    55      * MySQL support
    56    * !GhostScript & LaTeX
    57    * Doxygen
    58    * MySQL 5 with InnoDB support
    5960
    60 For !RedHat the EPEL repository is required, see http://fedoraproject.org/wiki/EPEL for installation instructions.
     61==== Red Hat ====
     62For RedHat the EPEL repository is required, see [http://fedoraproject.org/wiki/EPEL] for installation instructions.
     63
    6164{{{
    62 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 php-mysql php-pear-PHPUnit tetex-latex
    63 }}}
    64 Or for Debian / Ubuntu:
    65 {{{
    66 apt-get install libsoap-lite-perl libgd-graph-perl libconfig-inifiles-perl libdevel-cover-perl libtest-class-perl php-log smarty3 php-mysql phpunit texlive-latex-base texlive-latex-recommended texlive-fonts-recommended
     65yum install perl-SOAP-Lite perl-GD perl-IO-All perl-Data-Dump perl-Config-IniFiles perl-Devel-Cover perl-Test-Class \
     66  php-pear-Log php-Smarty
    6767}}}
    6868
    69 == Additional Tools ==
     69==== Debian / Ubuntu ====
     70
     71{{{
     72apt-get install libsoap-lite-perl libgd-graph-perl libconfig-inifiles-perl libdevel-cover-perl libtest-class-perl \
     73 php-log smarty3 phpunit
     74}}}
     75
     76==== On Mac OS X ====
     77Download [http://www.apachefriends.org/en/xampp-macosx.html XAMPP] and [http://www.smarty.net Smarty]
     78
     79Smarty can be placed in the /Applications/XAMPP/xamppfiles/lib/php/ or include the installation directory in your PHP include path
     80
     81== ADDITIONAL TOOLS ==
    7082Depending on your usage you want to install one or more of the following tools
    7183in the tools directory. Each tool has it's own directory, make sure you