<title>Install OTRS</title>
<para>
The described way of installing the OTRS is tested on a newly installed system. In case you have trouble to install it on your working system please try it with a new Linux installation. Most of the installation problems are caused by messy apache configurations and forgotten mysql database passwords. So please use a fresh system installation in case like this occurs.
</para>
<para>
We tried to keep the installation as easy as possible, but the OTRS is a very powerful and complex application which can not just be unpacked in some directory and used.
</para>
<section id="installing-the-quick-and-easy-way">
<title>Installing the rpm on a SuSE Linux (the quick and easy way)</title>
<para>
This section is a guide for installing OTRS on a SuSE Linux. We tested the SuSE Linux versions 7.3, 8.0, 8.1, 8.2, 9.0 and 9.1. Before starting the installation have a look at <ulink url="http://www.otrs.org/"><citetitle>http://otrs.org/</citetitle></ulink> and check if a newer and better version of the rpm file is available. If so please download it and use the newer documentation and the newer rpm.
</para>
<para>
Install the otrs.rpm with YaST (YaST2) or on the command line with rpm (what ever you prefer). Please be aware of the fact that OTRS needs some Perl modules which are not installed by default in a typical SuSE installation. So it might be a good idea to use YaST to install the rpm because it will handle and solve all the dependencies.
</para>
<para>
In case you prefer the command line rpm way (you have to have installed the needed modules first otherwise rpm will ask you to do so):
<screen>
ernie:~ # rpm -ivh /tmp/otrs.rpm 
otrs                        ##################################################
Check OTRS user (/etc/passwd)... otrs exists.

Next steps: 

[SuSEconfig]
 Execute 'SuSEconfig' to configure the webserver.

[start Apache and MySQL]
 Execute 'rcapache restart' and 'rcmysql start' in case they don't run.

[install the OTRS database]
 Use a webbrowser and open this link:
 http://localhost/otrs/installer.pl

[OTRS services]
 Start OTRS 'rcotrs start-force' (rcotrs {start|stop|status|restart|start-force|stop-force}).

Have fun!

 Your OTRS Team
 http://otrs.org/

ernie:~ # 
</screen>
Know it's time to start SuSEconfig:
<screen>
ernie:~ # SuSEconfig 
Starting SuSEconfig, the SuSE Configuration Tool...
Running in full featured mode.
Reading /etc/sysconfig and updating the system...
Executing /sbin/conf.d/SuSEconfig.aaa_at_first...
Executing /sbin/conf.d/SuSEconfig.apache...
Including /opt/otrs/scripts/apache-httpd.include.conf
Executing /sbin/conf.d/SuSEconfig.bootsplash...
Executing /sbin/conf.d/SuSEconfig.ispell...
Executing /sbin/conf.d/SuSEconfig.perl...
Executing /sbin/conf.d/SuSEconfig.permissions...
Executing /sbin/conf.d/SuSEconfig.postfix...
Setting up postfix local as MDA...
Setting SPAM protection to "off"...
Executing /sbin/conf.d/SuSEconfig.profiles...
Finished.
</screen>
</para>
<para>
Once you installed the otrs.rpm on your system you have to restart the apache by rcapache restart to force apache to reload the config file. 
<screen>
ernie:~ # rcapache restart
Shutting down httpd                                         done
Starting httpd [ PERL ]                                     done
ernie:~ # 
</screen>

Now you have to setup the databases. Please open <ulink url="http://localhost/otrs/installer.pl"><citetitle>http://localhost/otrs/installer.pl</citetitle></ulink> to do so.

<screenshot>
<screeninfo>installer.pl screen - license (1/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer.png"></graphic>
</screenshot>

<screenshot>
<screeninfo>installer.pl screen - database (2/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer1.png"></graphic>
</screenshot>
</para>
<warning>
<para>
It is not a good idea to keep using the default passwords. You are installing a very important piece of software and you do not want anybody to be able to hack your database just because you didn't change the default password!
</para>
</warning>
<para>
<screenshot>
<screeninfo>installer.pl screen - database (2/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer2.png"></graphic>
</screenshot>
<screenshot>
<screeninfo>installer.pl screen - system (3/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer3.png"></graphic>
</screenshot>
<screenshot>
<screeninfo>installer.pl screen - finish (4/4)</screeninfo>
<graphic srccredit="installer.pl - screenshot" scale="40" fileref="screenshots/installer4.png"></graphic>
</screenshot>
</para>
<para>
OK, now it is time to fire up OTRS. Do so on the command line:
<screen>
ernie:~ # rcotrs restart-force
Shutting down OTRS 
 Disable /opt/otrs/bin/PostMaster.pl ... done.
no crontab for otrs
 Shutting down cronjobs ... failed!
Shutting down OTRS (completely)
 Shutting down Apache ... done.
 Shutting down MySQL ... done.
                                                                     done
Starting OTRS (completely)
 Starting Apache ... done.
 Starting MySQL ... done.
Starting OTRS
 Checking Apache ... done.
 Checking MySQL ... done.
 Checking database connect... (It looks Ok!).
 Enable /opt/otrs/bin/PostMaster.pl ... done.
 Checking otrs spool dir...  done.
 Creating cronjobs (source /opt/otrs/var/cron/*) ... done.

  -->> http://ernie.example.com/otrs/index.pl &lt;&lt;-- 
                                                                     done
                                                                     done
ernie:~ # 
</screen>
</para>
<para>
Finished! Wasn't that a piece of cake? ;-)
</para>
<para>
You can use OTRS by opening the http://ernie.example.com/otrs/index.pl link.
</para>
</section>
