2. fejezet - Telepítés

Az OTRS-t különböző adatbázis háttérprogramokkal használhatja: MySQL, PostgreSQL vagy Oracle. A legnépszerűbb adatbázis az OTRS telepítéséhez a MySQL. Ez a fejezet a MySQL beállításához szükséges lépések megtételét mutatja be egy SUSE-alapú kiszolgálón. Természetesen az adatbázist egy dedikált adatbázis-kiszolgálóra is telepítheti, ha a skálázhatóság vagy más célok miatt ez szükséges.

Telepítse a MySQL adatbázis-kiszolgálót a következő parancs rendszergazdaként való végrehajtásával:

linux:~ # zypper install mysql perl-DBD-mysql
        

Ez az alapértelmezett beállításokkal fogja telepíteni a MySQL-t a rendszerre. Meg kell változtatnia az alapértelmezéseket azért, hogy alkalmassá tegye az OTRS-hez. Egy szövegszerkesztővel nyissa meg az /etc/my.cnf fájlt, és adja hozzá a következő sorokat a [mysqld] szakasz alá:

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

Most hajtsa végre a systemctl restart mysql.service parancsot az adatbázis-kiszolgáló újraindításához és a változtatások bekapcsolásához. Ezután futtassa a /usr/bin/mysql_secure_installation parancsot, és kövesse a képernyőn lévő utasításokat az adatbázis root jelszavának beállításához, a névtelen hozzáférés eltávolításához és a teszt adatbázis eltávolításához. Végül futtassa a systemctl enable mysql.service parancsot azért, hogy meggyőződhessen arról, hogy a MySQL automatikusan elindul a kiszolgáló indításakor.

Telepítse az OTRS-t parancssoron keresztül a zypper használatával. Ez le fog húzni néhány függőséget is, mint például az Apache webkiszolgáló és néhány Perl-modul. Győződjön meg arról, hogy átmásolta az OTRS RPM fájlt a jelenlegi könyvtárba.

otrs-sles:~ # zypper install otrs*.rpm
....
Retrieving package otrs-x.x.x-01.noarch (1/26), 17.5 MiB (74.3 MiB unpacked)
Installing: otrs-x.x.x-01 [done]
Additional rpm output:
Check OTRS user ... otrs added.

...

otrs-sles:~ #
        

Most indítsa újra az Apache webkiszolgálót a systemctl restart apache2.service paranccsal a konfigurációs változtatások betöltéséhez az OTRS-nél.

Az OTRS-nek szüksége van több modulra, amelyek alapértelmezetten a csomagkezelővel telepíthetők. Ezeket utólag is telepítheti kézzel. A /opt/otrs/bin/ könyvtárban található otrs.CheckModules.pl parancsfájl futtatása el fogja árulni, hogy mely modulok hiányoznak, illetve melyeket kell vagy lehet telepíteni. A választható modulok közé tartozhatnak azok, amelyek IMAP(S) protokollon keresztül történő MDA-kal való kommunikációhoz vagy PDF kimenet előállításához szükségesek.

SLES rendszeren hozzá kell adnia egy további tárolót azért, hogy beszerezze a hiányzó modulokat. Válassza ki az operációs rendszer verziójához szükséges tárolót innen: http://download.opensuse.org/repositories/devel:/languages:/perl/. Példaként a SLES 11 SP 3 tárolóját ehhez hasonlóan kellene hozzáadni:

zypper ar -f -n perl http://download.opensuse.org/repositories/devel:/languages:/perl/SLE_11_SP3 Perl
            

Az openSUSE 12.3-as verzióján a további tároló csak a Mail::IMAPClient modulhoz szükséges, amelyre csak akkor lehet szüksége, ha egy TLS-sel titkosított IMAP-kiszolgálóról kell a leveleket begyűjteni. A megfelelő sor ehhez hasonlóan nézhet ki:

zypper ar -f -n perl http://download.opensuse.org/repositories/devel:/languages:/perl/openSUSE_12.3/ Perl
            

A zypper első alkalommal történő használatakor, miután hozzáadta ezt a tárolót, meg fogja kérni, hogy adja meg annak a kulcsát. Most már telepítheti a hiányzó modulokat, ahogy alább látható.

otrs-sles:/opt/otrs # zypper install -y "perl(YAML::LibYAML)"
Refreshing service 'susecloud'.
Retrieving repository 'perl' metadata [\]

New repository or package signing key received:
Key ID: DCCA98DDDCEF338C
Key Name: devel:languages:perl OBS Project <devel:languages:perl@build.opensuse.org>
Key Fingerprint: 36F0AC0BCA9D8AF2871703C5DCCA98DDDCEF338C
Key Created: Wed Oct 10 22:04:18 2012
Key Expires: Fri Dec 19 22:04:18 2014
Repository: perl

Do you want to reject the key, trust temporarily, or trust always? [r/t/a/?] (r): a
Retrieving repository 'perl' metadata [done]
Building repository 'perl' cache [done]
Loading repository data...
Reading installed packages...
'perl(YAML::LibYAML)' not found in package names. Trying capabilities.
Resolving package dependencies...

The following NEW package is going to be installed:
  perl-YAML-LibYAML

The following package is not supported by its vendor:
  perl-YAML-LibYAML

Retrieving package perl-YAML-LibYAML-0.38-12.4.x86_64 (1/1), 75.0 KiB (196.0 KiB unpacked)
Retrieving: perl-YAML-LibYAML-0.38-12.4.x86_64.rpm [done (55.7 KiB/s)]
Installing: perl-YAML-LibYAML-0.38-12.4 [done]
            

A következő lépés az OTRS beállítása a webes telepítő használatával, amint az ebben a szakaszban le van írva.

Most elindíthatja az OTRS démont, és bekapcsolhatja a megfelelő felügyeleti cron-feladatot (ezt az otrs felhasználónak kell megtennie):

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

Ennyi volt, gratulálunk!

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

Az OTRS-t különböző adatbázis háttérprogramokkal használhatja: MySQL, PostgreSQL vagy Oracle. A legnépszerűbb adatbázis az OTRS telepítéséhez a MySQL. Ez a fejezet a MySQL beállításához szükséges lépések megtételét mutatja be egy RHEL-alapú kiszolgálón. Természetesen az adatbázist egy dedikált adatbázis-kiszolgálóra is telepítheti, ha a skálázhatóság vagy más célok miatt ez szükséges.

Telepítse a MySQL (vagy MariaDB) adatbázis-kiszolgálót a következő parancs rendszergazdaként való végrehajtásával:

shell> yum -y install mariadb-server
        

Ez az alapértelmezett beállításokkal fogja telepíteni a MySQL-t a rendszerre. Meg kell változtatnia az alapértelmezéseket azért, hogy alkalmassá tegye az OTRS-hez. Egy szövegszerkesztővel hozzon létre egy új /etc/my.cnf.d/zotrs.cnf fájlt a következő tartalommal:

[mysqld]
max_allowed_packet   = 64M
query_cache_size     = 32M
innodb_log_file_size = 256M
        

Most hajtsa végre a systemctl start mariadb parancsot az adatbázis-kiszolgáló újraindításához és a változtatások bekapcsolásához. Ezután futtassa a /usr/bin/mysql_secure_installation parancsot, és kövesse a képernyőn lévő utasításokat az adatbázis root jelszavának beállításához, a névtelen hozzáférés eltávolításához és a teszt adatbázis eltávolításához.

Telepítse az OTRS-t parancssoron keresztül a yum használatával. Ez le fog húzni néhány függőséget is, mint például az Apache webkiszolgáló és néhány Perl-modul. Győződjön meg arról, hogy átmásolta az OTRS RPM fájlt a jelenlegi könyvtárba.

shell> yum install --nogpgcheck otrs-x.x.*.rpm
...
Dependencies Resolved

================================================================================
 Package                    Arch   Version                Repository       Size
================================================================================
Installing:
 otrs                       noarch x.x.x-01               /otrs-x.x.x-01.noarch
                                                                           74 M
Installing for dependencies:
 apr                        x86_64 1.3.9-5.el6_2          updates         123 k
 ...
 procmail                   x86_64 3.22-25.1.el6          base            163 k

Transaction Summary
================================================================================
Install      26 Package(s)

Total size: 80 M
Total download size: 6.0 M
Installed size: 88 M
Downloading Packages:
(1/25): apr-1.3.9-5.el6_2.x86_64.rpm                     | 123 kB     00:00
...
(25/25): procmail-3.22-25.1.el6.x86_64.rpm               | 163 kB     00:00
--------------------------------------------------------------------------------
Total                                           887 kB/s | 6.0 MB     00:06
Running rpm_check_debug
Running Transaction Test
Transaction Test Succeeded
Running Transaction
  Installing : apr-1.3.9-5.el6_2.x86_64                               1/26
  ...
  Installing : otrs-x.x.x-01.noarch                                   26/26
Check OTRS user ... otrs added.

...

shell>
        

Most indítsa újra az Apache webkiszolgálót a systemctl restart httpd.service paranccsal a konfigurációs változtatások betöltéséhez az OTRS-nél.

Az OTRS-nek szüksége van néhány modulra, amelyek az RPM által telepíthetők. Ezeket ezután telepítheti kézzel. Az /opt/otrs könyvtárban található bin/otrs.CheckModules.pl parancsfájl futtatásával ellenőrizheti, hogy mely modulok hiányoznak. Néhány modul csak olyan opcionális funkcionalitáshoz szükséges, mint például IMAP(S) kiszolgálókkal történő kommunikáció vagy PDF-előállítás. Red Hat vagy CentOS rendszeren ezen modulok telepítését az EPEL tárolóból javasoljuk, amely a Fedora projekt által karbantartott tároló, és kiváló minőségű csomagokat biztosít a RHEL és származékai számára. További információkért nézze meg az EPEL weboldalát.

Ha RHEL 7 vagy CentOS 7 rendszereken van, akkor erről az oldalról szerezheti be a legújabb csomagot az EPEL-hez. Egyúttal hozzáadhatja ezt a tárolót a yum programhoz az ezen az oldalon talált RPM URL másolásával és a következő parancs végrehajtásával:

shell> yum -y install http://download.fedoraproject.org/pub/epel/7/x86_64/e/epel-release-7-8.noarch.rpm

...

Installed:
  epel-release.noarch 0:7-8

Complete!
            

A yum első alkalommal történő használatakor, miután hozzáadta ezt a tárolót, meg fogja kérni, hogy adja meg annak a kulcsát. Most már telepítheti a hiányzó modulokat, ahogy alább látható.

shell> yum -y install "perl(Text::CSV_XS)"

...

Installed:
  perl-Text-CSV_XS.x86_64 0:0.85-1.el6

Complete!
shell>
            

A következő lépés az OTRS beállítása a webes telepítő használatával, amint az ebben a szakaszban le van írva.

Most elindíthatja az OTRS démont, és bekapcsolhatja a megfelelő felügyeleti cron-feladatot (ezt az otrs felhasználónak kell megtennie):

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

Ennyi volt, gratulálunk!

Ha az OTRS-t egy Oracle adatbázisra szeretné telepíteni, akkor a DBD::Oracle adatbázis-illesztőprogram lefordítására és telepítésére lesz szüksége. Ez némileg bonyolultabb bármely egyéb csomagok telepítésénél. Ez azért van, mert az Oracle egy szabadalomvédett adatbázis, és sem a Red Hat, sem a CentOS projekt nem jogosult az illesztőprogramok terjesztésére az RPM-tárolóikban.

Mindenek előtt telepítenünk kellene a gcc, a make és a CPAN programokat, hogy le tudjuk fordítani és telepíteni tudjuk az illesztőprogramot. Alább láthatja a CentOS rendszeren szükséges parancsot. Más verzióknál egy kicsit másképp nézhet ki.

shell> yum -y install gcc make "perl(CPAN)"
            

A következő lépés az adatbáziskliens beszerzése és telepítése. Ehhez regisztrálnia kellene egy ingyenes fiókot az Oracle weboldalán. Az illesztőprogramokat erről az oldalról töltheti le: http://www.oracle.com/technetwork/database/features/instant-client/index-097480.html. Válassza ki a rendszere architektúrájának megfelelő Linux x86 vagy x86-64 verziót. Ezt az uname -i paranccsal ellenőrizheti. Ez vagy „x86_64” az x86-64 verzióhoz, vagy „i386” az x86-hoz. Le kell töltenie az „Instant Client Package - Basic”, az „Instant Client Package - SQL*Plus” és az „Instant Client Package - SDK” csomagokat. Mentse el ezeket valahova a lemezen. Most a root felhasználóként telepítheti a csomagokat a következő parancs használatával:

shell> yum install oracle-instantclient*
            

Ezután be kell állítania két környezeti változót, és le kell fordítania a DBD::Oracle illesztőprogramot. Ezeket a feladatokat ismét a root felhasználóként hajtsa végre. A lépéseket az alábbiakban ismertetjük. Vegye figyelembe, hogy a rövidség miatt a parancsok által kiírt sorok egy része eltávolításra került.

shell> export ORACLE_HOME=/usr/lib/oracle/11.2/client64
shell> export LD_LIBRARY_PATH=$ORACLE_HOME/lib
shell> cpan
cpan[1]> look DBD::Oracle
...
Fetching with LWP:
  http://www.perl.org/CPAN/authors/id/P/PY/PYTHIAN/CHECKSUMS
Checksum for /root/.cpan/sources/authors/id/P/PY/PYTHIAN/DBD-Oracle-1.62.tar.gz ok
Scanning cache /root/.cpan/build for sizes
DONE
...
Working directory is /root/.cpan/build/DBD-Oracle-1.62-ZH6LNy
[root@localhost DBD-Oracle-1.62-ZH6LNy]# perl Makefile.PL
...
[root@localhost DBD-Oracle-1.62-ZH6LNy]# make
...
[root@localhost DBD-Oracle-1.62-ZH6LNy]# make install
...
cpan[2]> exit
Terminal does not support GetHistory.
Lockfile removed.
            

Most szerkesztenie kell a Kernel/Config.pm fájlt az ORACLE_HOME megadásához. A következő lépés az OTRS beállítása a webes telepítő használatával, amint az ebben a szakaszban le van írva.