# --
# INSTALL description of OpenTRS
# Copyright (C) 2001,2002 Martin Edenhofer <martin+code@otrs.org>
# --
# $Id: INSTALL,v 1.6 2002/04/08 14:17:40 martin Exp $
# --
# This software comes with ABSOLUTELY NO WARRANTY. For details, see 
# the enclosed file COPYING for license information (GPL). If you 
# did not receive this file, see http://www.gnu.org/licenses/gpl.txt.
# --

Software requirements?
======================

  On all Perl-Platforms! You need:
    * min. Perl5
    * Database (e. g. MySQL, PostgreSQL)
    * Webpserver (mod_perl isn't required but very nice to have)
    * some CPAN-Module (CGI, MIME::Words, Mail::Internet, MIME::Parser, DBI,
      DBD::mysql, Digest::MD5) and for stats (GD, GD::Graph, GD::Graph::lines, Date::Calc)

Instalation:
============

1. Install CPAN Modules (if needed):
   perl -MCPAN -e shell;
   ...
   install MIME::Words
   install MIME::Parser
   ...

2. create user and install tar.gz 

   $shell: mkdir /opt/OpenTRS/
   $shell: useradd -d /opt/OpenTRS/ otrs
   $shell: cd /opt/OpenTRS/
   $shell: tar -xzvf OpenTRS-xxxx-xx-xx.tar-gz
   $shell: chown -r /opt/OpenTRS/* otrs
   
3. Database:
   [follow README.database --> Setup Example]

4. Webserver:
   [follow README.webserver] 

5. Config file ($HOME/Kernel/Config.pm):
   Set some Kernel::Config Options

6. First Login:
   http://host/cgi-bin/index.pl
   User: root@localhost
   PW: root

   --> goto AdminArea and set some config setings.

7. First Email:
   use the procmailrc of the OpenTRS-User --> /opt/OpenTRS/.procmailrc

   --> send emails to the otrs user (e. g. otrs@localhost)

   or pipe an email directly into $OpenTRS_HOME/bin/Postmaster.pl
    (e. g. 'cat /tmp/email | $OpenTRS_HOME/bin/Postmaster.pl').

Have a lot of fun.

 Martin Edenhofer 

(January 2002 Frankfurt/Germany)

