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

Előkészítés: SELinux letiltása

Megjegyzés

Ha a rendszere SELinuxot használ, akkor le kell tiltania azt, különben az OTRS nem fog megfelelően működni.

Itt van, hogy hogyan lehet letiltani a SELinux használatát RHEL/CentOS/Fedora rendszereknél:

  • Állítson be SELINUX=disabled értéket az /etc/selinux/config fájlban:

    # This file controls the state of SELinux on the system.
    # SELINUX= can take one of these three values:
    #       enforcing - SELinux security policy is enforced.
    #       permissive - SELinux prints warnings instead of enforcing.
    #       disabled - No SELinux policy is loaded.
    SELINUX=disabled
    # SELINUXTYPE= can take one of these two values:
    #       targeted - Targeted processes are protected,
    #       mls - Multi Level Security protection.
    SELINUXTYPE=targeted
                            

  • Indítsa újra a rendszert. Újraindítás után ellenőrizze, hogy a getenforce parancs Disabled értéket ad-e vissza:

    shell> getenforce
    Disabled
                            

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 https://www.otrs.com/download-open-source-help-desk-software-otrs-free/ 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)
...
            

Megjegyzés

Ne feledje, hogy az OTRS egy működő Perl telepítést igényel az összes „alapvető” modullal, mint például a version modul. Ezeket a modulokat kifejezetten nem ellenőrzi le a parancsfájl. Esetleg telepítenie kell egy perl-core csomagot néhány olyan rendszeren (mint például RHEL), amely alapértelmezetten nem telepíti az alapvető Perl-csomagokat.

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ájl bekapcsolása

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

shell> cp /opt/otrs/Kernel/Config.pm.dist /opt/otrs/Kernel/Config.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.Console.pl
/opt/otrs/bin/otrs.Console.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
        

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).

# Debian/Ubuntu:
shell> ln -s /opt/otrs/scripts/apache2-httpd.include.conf /etc/apache2/sites-enabled/zzz_otrs.conf
        

Az OTRS azt igényli, hogy néhány Apache modul be legyen kapcsolva az optimális működéshez. A legtöbb platformon az a2enmod eszközön keresztül győződhet meg arról, hogy azok be vannak-e kapcsolva.

shell> a2enmod perl
shell> a2enmod version
shell> a2enmod deflate
shell> a2enmod filter
shell> a2enmod headers
        

Most újraindíthatja a webkiszolgálót az új konfigurációs beállítások betöltéséhez. A legtöbb rendszeren ezt a systemctl restart apache2.service paranccsal teheti meg.

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

Hajtsa végre a következő parancsot root felhasználóként az OTRS fájl- és könyvtárjogosultságainak beállításához. Megpróbálja felismerni a beállításhoz szükséges helyes felhasználó- és csoportbeállításokat.

shell> cd /opt/otrs/
shell> bin/otrs.SetPermissions.pl
        

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.

Megjegyzés

A következő konfigurációs beállítások ajánlottak a MySQL rendszerekhez. Adja hozzá a következő sorokat az /etc/my.cnf fájlba a [mysqld] szakasz alá:

max_allowed_packet   = 64M
query_cache_size     = 32M
innodb_log_file_size = 256M
                

Megjegyzés

Ne feledje, hogy az OTRS utf8 használatát igényli az adatbázis-tárolás kódolásaként.

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: az OTRS démon elindítása

Az új OTRS démon felelős bármely aszinkron és ismétlődő feladat kezelésénél az OTRS-ben. Amik korábban a cron-fájl meghatározásokban voltak, azokat most az OTRS démon kezeli, amely mostantól szükséges az OTRS működéséhez. A démon kezeli az összes általános ügyintéző feladatot is, és az otrs felhasználótól kell elindítani.

shell> /opt/otrs/bin/otrs.Daemon.pl start
            

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

Két alapértelmezett OTRS cron-file van az /opt/otrs/var/cron/*.dist fájlban, és a céljuk annak ellenőrzése, hogy az OTRS démon fut-e. Be kell kapcsolni ezeket a „.dist” fájlnévkiterjesztés nélkül történő lemásolásukkal.

shell> cd /opt/otrs/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 az otrs felhasználóval.

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

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

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

12. lépés: bash automatikus kiegészítés beállítása (opcionális)

Az összes szabályos OTRS parancssori művelet a bin/otrs.Console.pl OTRS konzolfelületen keresztül történik. Ez automatikus kiegészítést biztosít a bash parancsértelmezőhöz, amely sokkal könnyebben teszi megtalálhatóvá a helyes parancsot és a kapcsolókat.

A bash automatikus kiegészítését a bash-completion csomag telepítésével kapcsolhatja be. Ez automatikusan fel fogja ismerni és be fogja tölteni az /opt/otrs/.bash_completion fájlt az otrs felhasználónál.

A parancsértelmező újraindítása után egyszerűen nyomja meg a TAB billentyűt a bin/otrs.Console.pl parancsot követően, és fel fogja sorolni az összes elérhető parancsot. Ha begépeli a parancs nevének néhány karakterét, akkor a TAB billentyű meg fogja jeleníteni az összes egyező parancsot. Egy teljes parancs begépelése után az összes lehetséges kapcsoló és argumentum meg fog jelenni a TAB megnyomásával.

13. 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 üzembe állításában, 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 üzembe állításában, és hogy a legtöbb hasznot hozza ki az OTRS-ből.