Installing WePS
***************

========================================================================

1. Download
2. Requirements
3. Installation
    3.1. Automatic
    3.2. Manual
4. Upgrade
    4.1. Automatic
    4.2. Manual
5. Troubleshooting
6. Mailing lists
7. Bug reporting

========================================================================

1. Download
   ==========

  WePS  is  distributed as  a  tarball  available  for download  in  the
  following URL:

      http://www.weps.org

  After you  have downloaded  the tarball, unpack  it in a  directory of
  your choice using the command:

      tar zxvf weps-X.Y.Z.tar.gz

  where X.Y.Z stands for the downloaded version.


2. Requirements
   ==============

  In  order  to install  WePS,  you  will  need the  following  packages
  installed in your system:

   - Apache Web Server 1.3.X or greater (http://httpd.apache.org)

   - PHP: Hypertext Preprocessor 4.1.0 or greater (http://www.php.net)
     Note: Compiled with PostgreSQL or MySQL support.

   - PostgreSQL database 6.X or greater (http://www.postgresql.org)

     or

   - MySQL database 3.23 or greater (http://www.mysql.com)


3. Installation
   ==============

  You  should follow  the next steps to install WePS:

  3.1 Automatic
      ===========

    1. Become root

    2. Execute

      cd scripts
      ./install.pl


  3.1 Manual
      ========

    1. Become root

    2. Create a directory  where you want to install  WePS, for example,
       /var/www/weps,  and the  subdirectory  that will  hold your  WePS
       repository (must be called 'repository'):

      mkdir /var/www/weps
      mkdir /var/www/weps/repository

    3. Copy  content of  weps/  directory recursively  to the  directory
       created above:

      cp -R /path/to/weps.X.Y.Z/weps/* /var/www/weps

    4. Create WePS  database using the files located  in scripts/, these
       are weps.psql and weps.mysql, depending your database system:

      a) PostgreSQL

        createdb -U USER NAME
        psql -U USER -f weps.psql NAME

      b) MySQL

        mysql -u USER -pPASSWORD -e "create database NAME"
        mysql -u USER -pPASSWORD NAME < weps.mysql

      You should  change USER for  the owner of WePS  database, PASSWORD
      for this  user password in the  database system and  NAME for WePS
      database name (normally called weps).

    5. Copy file inc/config.php.in to inc/config.php:

      cd /var/www/weps/inc
      cp config.php.in config.php

    6. Edit inc/config.php to configure WePS system.

    7. Configure your HTTP server to access WePS.


  That's all! You now should be able to access WePS from your browser at
  your specified URL.

  For  any problems in  the installation  process go  to Troubleshooting
  section or report the problem to  WePS mailing lists if you are unable
  to solve it.


4. Upgrade
   =========

  Please,  make  sure  that you  have  a  copy  of your  WePS  directory
  (including repository) before  trying to upgrade to a  new version. If
  you have any problem with  the automatic upgrade, please, recover your
  backup of WePS and report your problem.

  Note, that  if you have made any  changes to default themes  or any of
  the default  php files,  this changes will  be overwritten by  the new
  files.

  You should follow the next steps in order to upgrade WePS:

  4.1 Automatic
      ===========

    1. Become root

    2. Execute

      cd scripts
      ./upgrade.pl


  4.2 Manual
      ========

    1. Become root

    2. Copy  content  of  weps/   directory  recursively  to  your  WePS
       directory overwriting old  content (/var/www/weps or wherever you
       have WePS installed):

      cp -Rf /path/to/weps.X.Y.Z/weps/* /var/www/weps

    3. Copy file inc/config.php.in to inc/config.php (make sure that you
       have a backup of your old config.php file):

      cd /var/www/weps/inc
      cp config.php.in config.php

    4. Edit inc/config.php to configure WePS system (it will probably be
       similar to your old version).


  That's all! You now should be able to access new WePS version.

  For any problems in the  upgrade process go to Troubleshooting section
  or report the problem to WePS mailing lists if you are unable to solve
  it.


5. Troubleshooting
   =================

  - If you  can't become root  ask your system administrator  to install
    WePS.

  - Make sure you have changed  the owner of the repository directory to
    the user  that's running the  web server.  That's very  important if
    you want to be able to upload files to WePS.

  - If you experience problems creating  the database make sure the user
    has rights to create databases.

  - If  WePS is  unable to  connect to  your database  and you  get this
    error:

    Warning: Unable to connect to PostgreSQL server: FATAL 1: IDENT
    authentication failed for user "weps" in ...

    This  error  occurs  when  PostgreSQL  is configured  to  use  IDENT
    authetication.    If  you   checkout  "pg_hba.conf"   (mine   is  in
    /etc/postgresql) you will see a line like this:

    host     all     127.0.0.1     255.0.0.0     ident sameuser

    Comment it out and add this new one:

    host     all     127.0.0.1     255.0.0.0     password

    Now, restart PostgreSQL and try WePS again.

  - If  you are  unable to  upload  files to  WePS, make  sure that  the
    variable  "file_uploads" is set  to "On"  in PHP  configuration file
    (php.ini,  mine is  in /etc/php4/apache).  If  it is  not, you  will
    see the error:

    "There was a problem uploading the file."

  - You'd probably want  to upload large files to  WePS.  Make sure that
    the    variable   MAX_FILE_SIZE    in   WePS    configuration   file
    (inc/config.php)  is big  enough.  If  you're still  having problems
    with really big files, increase the variables "upload_max_filesize",
    "post_max_size"  and   "memory_limit"  in  your   PHP  configuration
    file and restart  your web server. The common  errors when you don't
    increase these variables are:

    "Invalid call to WePS system"

    "There was a problem uploading the file."

  - There  are also  problems  with large  files  if you  use the  Squid
    proxy.   The variable  "request_body_max_size"  needs to  be set  to
    "unlimited" or whatever you need to upload your files.

    This  problem was  reported by  Waitman C.   Gobble, II.   Check the
    mailing lists for the complete report.


6. Mailing lists
   ===============

  - User support list

    To subscribe:
        http://lists.sourceforge.net/mailman/listinfo/weps-users

    Searchable archives:
        http://www.geocrawler.com/redir-sf.php3?list=weps-users

  - Development list

    To subscribe:
        http://lists.sourceforge.net/mailman/listinfo/weps-devel

    Searchable archives:
        http://www.geocrawler.com/redir-sf.php3?list=weps-devel


6. Bug reporting
   =============

  You can  report WePS's  bugs to the  SourceForge bug  tracking system,
  available at:

      http://sourceforge.net/projects/weps

========================================================================

---
$Id: INSTALL,v 1.23 2002/10/20 19:07:05 aleix Exp $
