Telepítés forrásból (Linux, Unix)

1. lépés: a .tar.gz telepítése

Ha forrásból szeretné telepíteni az OTRS-t, akkor először töltse le a forrásarchívumot .tar.gz, .tar.bz2 vagy .zip fájlként az http://www.otrs.com/try/ oldalról.

Bontsa ki az archívumot (például a tar használatával) az /opt könyvtárba, és nevezze át a könyvtárat otrs-x.x.x névről otrs névre (lást a lenti parancsfájlt).

shell> tar xzf /tmp/otrs-x.x.x.tar.gz
shell> mv otrs-x.x.x /opt/otrs
        

2. lépés: további Perl-modulok telepítése

Használja a következő parancsfájlt, hogy áttekintést kapjon az összes telepített és szükséges CPAN-modulról.

shell> perl /opt/otrs/bin/otrs.CheckModules.pl
o CGI..............................ok (v3.60)
o Crypt::PasswdMD5.................ok (v1.3)
o Crypt::SSLeay....................Not installed! (Optional - Required for Generic Interface SOAP SSL connections.)
o CSS::Minifier....................ok (v0.01)
o Date::Format.....................ok (v2.22)
o Date::Pcalc......................ok (v1.2)
...
            

A hiányzó Perl-modulok telepítéséhez a következőket teheti:

a) Telepítse a csomagokat a Linux disztribúció csomagkezelőjén keresztül

  • Red Hat, CentOS, Fedora vagy ezekkel kompatibilis rendszereknél:

    shell> yum install "perl(Digest::MD5)"
                            

  • SUSE Linux Enterprise Server, openSUSE vagy ezekkel kompatibilis rendszereknél: először határozza meg a csomag nevét, amely a modult szállítja. Általában a Saját::Modul modulhoz tartozó csomagot „perl-Saját-Modul” néven hívják.

    shell> zypper search Digest::MD5
                            

    Ezután telepítse:

    shell> zypper install perl-Digest-MD5
                            

  • Debian, Ubuntu vagy ezekkel kompatibilis rendszereknél először határozza meg a csomag nevét, amely a modult szállítja. Általában a Saját::Modul modulhoz tartozó csomagot „libsaját-modul-perl” néven hívják.

    shell> apt-cache search Digest::MD5
                            

    Ezután telepítse:

    shell> apt-get install libdigest-md5-perl
                            

    Vegye figyelembe, hogy előfordulhat, hogy nem található meg minden modul vagy azok szükséges verziói a disztribúció tárolójában. Ebben az esetben választhatja ezen modulok telepítését a CPAN-on keresztül (lásd alább).

b) Telepítse a szükséges modulokat a CPAN parancsértelmezőn keresztül

Ne feledje, hogy amikor Linux rendszeren van, akkor a CPAN-t a rendszergazda fiókkal kell futtatnia, mert a moduloknak hozzáférhetőnek kell lenniük mind az OTRS fióknak, mind annak a fióknak, amely alatt a webkiszolgáló fut.

shell> perl -MCPAN -e shell;
...
install Digest::MD5
install Crypt::PasswdMD5
...
                

A parancsfájl által felsorolt bármely opcionális modult a célrendszer speciális követelményeitől függően kell telepítenie.

3. lépés: OTRS felhasználó létrehozása

Felhasználó létrehozása:

shell> useradd -d /opt/otrs -c 'OTRS user' otrs
            

Felhasználó hozzáadása a webkiszolgáló csoportjához (ha a webkiszolgáló nem az OTRS felhasználójaként fut):

shell> usermod -G www otrs
(SUSE=www, Red Hat/CentOS/Fedora=apache, Debian/Ubuntu=www-data)
            

4. lépés: alapértelmezett beállítófájlok bekapcsolása

Két OTRS beállítófájl van az $OTRS_HOME/Kernel/*.dist és az $OTRS_HOME/Kernel/Config/*.dist fájlba csomagolva. Be kell kapcsolnia azokat a „.dist” fájlnév-kiterjesztés nélkül történő átmásolással.

shell> cd /opt/otrs/
shell> cp Kernel/Config.pm.dist Kernel/Config.pm
shell> cp Kernel/Config/GenericAgent.pm.dist Kernel/Config/GenericAgent.pm
    

5. lépés: annak ellenőrzése, hogy minden szükséges modul telepítve van-e

shell> perl -cw /opt/otrs/bin/cgi-bin/index.pl
/opt/otrs/bin/cgi-bin/index.pl syntax OK

shell> perl -cw /opt/otrs/bin/cgi-bin/customer.pl
/opt/otrs/bin/cgi-bin/customer.pl syntax OK

shell> perl -cw /opt/otrs/bin/otrs.PostMaster.pl
/opt/otrs/bin/otrs.PostMaster.pl syntax OK
            

A „syntax OK” azt mondja, hogy az összes kötelező Perl-modul telepítve van.

6. lépés: az Apache webkiszolgáló beállítása

Mindenek előtt telepítenie kell az Apache2 webkiszolgálót és a mod_perl modult. Ezt jellemzően a rendszerek csomagkezelőjéből kellene megtenni. Lent fogja megtalálni az Apache beállításához szükséges parancsokat a legnépszerűbb Linux disztribúciókon.

# rhel / centos:
shell> yum install httpd mod_perl

# suse:
shell> zypper install apache2-mod_perl

# debian/ubuntu:
shell> apt-get install apache2 libapache2-mod-perl2
        

Az OTRS webes felületének egy rövid URL-en keresztül történő hozzáféréséhez az Alias és a ScriptAlias bejegyzések szükségesek. A legtöbb Apache telepítésnek van egy conf.d könyvtára mellékelve. Linux rendszereknél általában ez a könyvtár az /etc/apache vagy az /etc/apache2 alatt található. Jelentkezzen be root felhasználóként, lépjen be a conf.d könyvtárba, és kapcsolja hozzá az /opt/otrs/scripts/apache2-httpd.include.conf fájlban található megfelelő sablont egy zzz_otrs.conf nevű fájlhoz az Apache beállítási könyvtárában (hogy meggyőződhessen arról, hogy betöltődik az egyéb beállítások után).

Indítsa újra a webkiszolgálót az új konfigurációs beállítások betöltéséhez. A legtöbb rendszeren a webkiszolgálót az /etc/init.d/apache2 restart paranccsal indíthatja el vagy indíthatja újra.

Most már a webkiszolgálónak beállítva kell lennie az OTRS-hez.

7. lépés: fájljogosultságok

A fájljogosultságokat be kell állítani, hogy az OTRS képes legyen olvasni és írni a fájlokat:

otrs.SetPermissions.pl [ --otrs-user= OTRS felhasználó, alapértelmezetten „otrs” ] { --web-group= a webkiszolgáló felhasználójának csoportja }

Például:

  • Olyan webkiszolgálónál, amely az OTRS felhasználóként fut:

    shell> bin/otrs.SetPermissions.pl --web-user=otrs
                    

  • A wwwrun felhasználóval futó webkiszolgálónál (például SUSE):

    shell> bin/otrs.SetPermissions.pl --web-group=wwwrun
                    

  • Apache felhasználóval futó webkiszolgálónál (például Red Hat, CentOS):

    shell> bin/otrs.SetPermissions.pl --web-group=apache
                    

  • A www-data felhasználóval futó webkiszolgálónál (például Debian, Ubuntu):

    shell> bin/otrs.SetPermissions.pl --web-group=www-data
                    

8. lépés: adatbázis-beállítás és alapvető rendszerbeállítás

Használja a http://localhost/otrs/installer.pl címen elérhető webes telepítőt (cserélje ki a „localhost” nevet az OTRS gépnevével) az adatbázis beállításához és az alapvető rendszerbeállításokhoz, mint például az e-mail fiókok.

9. lépés: első bejelentkezés

Most már készen áll a rendszerre való bejelentkezéshez a http://localhost/otrs/index.pl címen a webes telepítőben beállított hitelesítési adatokkal (felhasználó: root@localhost).

Ezzel a lépéssel az alapvető rendszerbeállítás befejeződött.

10. lépés: első e-mail

Az e-mail fogadás ellenőrzéséhez átküldhet egy e-mailt közvetlenül az /opt/otrs/bin/otrs.Postmaster.pl fájlnak:

shell> cat /opt/otrs/doc/sample_mails/test-email-1.box | /opt/otrs/bin/otrs.PostMaster.pl
    

11. lépés: cron-feladatok az OTRS felhasználóhoz

Számos alapértelmezett OTRS cron-feladat van az /opt/otrs/var/cron/*.dist fájlokban. Ezek a „.dist” fájlnév-kiterjesztés nélkül történő átmásolással kapcsolhatók be.

shell> cd var/cron
shell> for foo in *.dist; do cp $foo `basename $foo .dist`; done
    

Ezen cron-feladatok ütemezéséhez a rendszeren használhatja a Cron.sh parancsfájlt. Győződjön meg arról, hogy az OTRS rendszer felhasználójaként hajtsa végre!

A cron-feladatok ütemezése első alkalommal:

shell> /opt/otrs/bin/Cron.sh start
    

A cron-feladatok ütemezésének frissítése, ha változtat rajtuk:

shell> /opt/otrs/bin/Cron.sh restart
    

A cron-feladatok leállítása (karbantartáskor hasznos):

shell> /opt/otrs/bin/Cron.sh stop
    

Megjegyzés: a 3.3.7-es verziótól az OTRS ütemező egy cron-feladatot használ az indításhoz és az életben tartáshoz. Győződjön meg arról, hogy a scheduler_watchdog cron-feladat be van-e kapcsolva.

12. lépés: további információk

Azt tanácsoljuk, hogy olvassa el az OTRS teljesítmény-hangolási fejezetét.

Ha problémákkal szembesül a telepítésnél, akkor az otrs@otrs.org levelezőlistánkra küldhet üzenetet (http://lists.otrs.org/).

Kérdezhet az OTRS csoporttól is, hogy segítsenek az OTRS tervezésében vagy telepítésében, illetve nézzék át a telepített OTRS rendszert. A professzionális szolgáltatásunkat arra tervezték, hogy segítsen az OTRS gyorsabb telepítésében, és hogy a legtöbb hasznot hozza ki az OTRS-ből.