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 installation to encircle an installation problem in case it occures.
We try to keep the installation as easy as possible. But the OTRS is a very powerfull and complex application which can not just be untared in some directory and that's it.
This section is a guide for installing OTRS on a SuSE Linux. We tested the SuSE Linux versions 7.3, 8.0 and 8.1. Before starting the installation have a look at http://otrs.org/ 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.
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 OpenTRS 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.
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):
ernie:~ # rpm -ivh /tmp/otrs.rpm
otrs ##################################################
Check OpenTRS user (/etc/passwd)... otrs added.
SetPermissions.sh <$Revision: 1.4 $> - set OpenTRS file permissions
Copyright (c) 2002 Martin Edenhofer <martin@otrs.org>
Setting file permissions...
chown -R root.root /opt/OpenTRS
chown otrs.nogroup /opt/OpenTRS
chown otrs.nogroup /opt/OpenTRS/.fetchmailrc
chmod 0710 /opt/OpenTRS/.fetchmailrc
chown otrs.nogroup /opt/OpenTRS/.procmailrc
chmod 0644 /opt/OpenTRS/.procmailrc
chown -R otrs.nogroup /opt/OpenTRS/var/
chown -R wwwrun.nogroup /opt/OpenTRS/var/sessions/
otrs.nogroup /opt/OpenTRS/var/log/TicketCounter.log
chmod -R 755 /opt/OpenTRS/bin/
(chown && chmod 700) otrs.root /opt/OpenTRS/bin/DeleteSessionIDs.pl
chmod: getting attributes of `otrs.root': No such file or directory
(chown && chmod 700) otrs.root /opt/OpenTRS/bin/UnlockTickets.pl
(chown && chmod 700) otrs.root /opt/OpenTRS/bin/otrs.getConfig
Updating etc/sysconfig/otrs...
insserv: script postfix: service sendmail already provided!
Next steps:
[SuSEconfig]
Execute 'SuSEconfig' to configure the webserver.
[start Apache and MySQL]
Execute 'rcapache start' and 'rcmysql start' in case they don't run.
[install the OpenTRS database]
Use a webbrowser and open this link:
http://localhost/otrs/installer.pl
[OpenTRS services]
Start OpenTRS 'rcotrs start-force' (rcotrs {start|stop|status|restart|start-force|stop-force}).
Have fun!
Your OpenTRS Team
http://otrs.org/
ernie:~ # |
ernie:~ # SuSEconfig Starting SuSEconfig, the SuSE Configuration Tool... Running in full featured mode. Reading /etc/rc.config and updating the system... Executing /sbin/conf.d/SuSEconfig.aaa_at_first... Executing /sbin/conf.d/SuSEconfig.alljava... Executing /sbin/conf.d/SuSEconfig.apache... Installing new /etc/httpd/httpd.conf Installing new /etc/httpd/suse_include.conf Executing /sbin/conf.d/SuSEconfig.doublecheck... Executing /sbin/conf.d/SuSEconfig.fonts... Executing /sbin/conf.d/SuSEconfig.groff... Executing /sbin/conf.d/SuSEconfig.hostname... Executing /sbin/conf.d/SuSEconfig.inittab... Executing /sbin/conf.d/SuSEconfig.man_info... Executing /sbin/conf.d/SuSEconfig.news... Executing /sbin/conf.d/SuSEconfig.perl... Executing /sbin/conf.d/SuSEconfig.permissions... Checking permissions and ownerships - using /etc/permissions.d/postfix... setting /usr/sbin/sendmail to root.root 0555. Checking permissions and ownerships - using /etc/permissions.d/sendmail... setting /usr/sbin/sendmail to root.mail 2555. Executing /sbin/conf.d/SuSEconfig.postfix... Installing new /etc/postfix/main.cf Executing /sbin/conf.d/SuSEconfig.profiles... Executing /sbin/conf.d/SuSEconfig.sendmail... Executing /sbin/conf.d/SuSEconfig.sortpasswd... Finished. |
Once you installed the otrs.rpm on your system you have to reload the apache by rcapache reload to force apache to reload the config file. In case you haven't started the apache or mysql yet, it is a good time to do so (rcapache start and rcmysql start).
ernie:~ # rcapache reload PERL PHP4 Python Reload httpd done |

| Warning |
It is not a good idea to use the default passwords. You install 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! |
And because we want to keep the system as secure as possible we change some permissions by using the following script:
ernie:~ # /opt/OpenTRS/bin/SetPermissions.sh /opt/OpenTRS otrs wwwrun SetPermissions.sh <$Revision: 1.4 $> - set OpenTRS file permissions Copyright (c) 2002 Martin Edenhofer <martin@otrs.org> Setting file permissions... chown -R root.root /opt/OpenTRS chown otrs.nogroup /opt/OpenTRS chown otrs.nogroup /opt/OpenTRS/.fetchmailrc chmod 0710 /opt/OpenTRS/.fetchmailrc chown otrs.nogroup /opt/OpenTRS/.procmailrc chmod 0644 /opt/OpenTRS/.procmailrc chown -R otrs.nogroup /opt/OpenTRS/var/ chown -R wwwrun.nogroup /opt/OpenTRS/var/sessions/ otrs.nogroup /opt/OpenTRS/var/log/TicketCounter.log chmod -R 755 /opt/OpenTRS/bin/ (chown && chmod 700) otrs.root /opt/OpenTRS/bin/DeleteSessionIDs.pl chmod: getting attributes of `otrs.root': No such file or directory (chown && chmod 700) otrs.root /opt/OpenTRS/bin/UnlockTickets.pl (chown && chmod 700) otrs.root /opt/OpenTRS/bin/otrs.getConfig ernie:~ # |
ernie:~ # rcotrs restart-force
Shutting down OpenTRS
Disable /opt/OpenTRS/bin/PostMaster.pl ... done.
no crontab for otrs
Shutting down cronjobs ... failed!
Shutting down OpenTRS (completely)
Shutting down Apache ... done.
Shutting down MySQL ... done.
done
Starting OpenTRS (completely)
Starting Apache ... done.
Starting MySQL ... done.
Starting OpenTRS
Checking Apache ... done.
Checking MySQL ... done.
Checking database connect... (It looks Ok!).
Enable /opt/OpenTRS/bin/PostMaster.pl ... done.
Checking otrs spool dir... done.
Creating cronjobs (source /opt/OpenTRS/var/cron/*) ... done.
-->> http://ernie.example.com/otrs/index.pl <<--
done
done
ernie:~ # |
Finish! Wasn't that a piece of cake? ;-)
Your can use the OTRS by opening the http://ernie.example.com/otrs/index.pl link.