Az OTRS frissítése 4-ről 5-re

Ezek az utasítások olyan embereknek szólnak, akik az OTRS-t a 4-es verzióról az 5-ös verzióra frissítik, vagy egy 5-ös verzióról egy későbbi 5-ös javítócsomag szintű kiadásra, és ez vonatkozik az RPM és forráskód (tarball) frissítésekre is.

Ha az OTRS alacsonyabb verzióját futtatja, akkor először a 4-re történő frissítési útvonalat kell követnie (1.1->1.2->1.3->2.0->2.1->2.2->2.3->2.4->3.0->3.1->3.2->3.3->4)! Teljes frissítést kell végrehajtania minden köztes verzióhoz, beleértve az adatbázis változtatásokat és a Perl-parancsfájlok frissítését is.

Vegye figyelembe, hogy ha a 2.2-es OTRS-ről vagy korábbiról frissít, akkor egy további lépést is kell tennie.

Egy önálló kisebb verzión belül kihagyhatja a hibajavító szintű kiadásokat, ha frissíteni szeretne. Például az 5-ös verziójú OTRS 2. hibajavító verziójáról közvetlenül frissíthet az 5-ös verzió 6. hibajavító verziójára. Ha egy ilyen „hibajavító szintű frissítést” kell elvégeznie, akkor ki kell hagynia a 6., 10., 11., 14., 17. és 18. lépéseket.

Nagyon ajánlott először egy próbafrissítést végrehajtani egy elkülönített tesztelési gépen.

1. lépés: minden fontos szolgáltatás leállítása

Győződjön meg arról, hogy nincs-e több olyan futó szolgáltatás vagy cron-feladat, amely megpróbál hozzáférni az OTRS-hez. Ez a szolgáltatás beállításától fog függeni. Itt egy példa:

shell> /etc/init.d/cron stop
shell> /etc/init.d/postfix stop
shell> /etc/init.d/apache stop
            

Állítsa le az OTRS cron-feladatokat és az ütemezőt vagy a démont (ebben a sorrendben) annak az OTRS verziójától függően, amelyről frissít:

shell> cd /opt/otrs/
shell> bin/Cron.sh stop
shell> bin/otrs.Scheduler.pl -a stop
            

vagy

shell> cd /opt/otrs/
shell> bin/Cron.sh stop
shell> bin/otrs.Daemon.pl stop
            

2. lépés: biztonsági mentés készítése az /opt/otrs/ alatt mindenről

  • Kernel/Config.pm

  • Kernel/Config/GenericAgent.pm (csak hivatkozásként, erre a fájlra többé nincs szükség)

  • Kernel/Config/Files/ZZZAuto.pm

  • var/*

  • valamint az adatbázis

3. lépés: győződjön meg arról, hogy mindent lementett-e ;-)

4. lépés: az új kiadás telepítés (tar vagy RPM)

4.1. lépés: tarball segítségével:

shell> cd /opt
shell> mv otrs otrs-old
shell> tar -xzf otrs-x.x.x.tar.gz
shell> mv otrs-x.x.x otrs
            
Régi beállítófájlok visszaállítása

  • Kernel/Config.pm

  • Kernel/Config/Files/ZZZAuto.pm

TicketCounter.log visszaállítása

Azért, hogy az OTRS a helyes jegyszámokkal mehessen tovább, állítsa vissza a TicketCounter.log fájlt az /opt/otrs/var/log/ könyvtárba. Ez különösen fontos, ha növekvő jegyszámokat használ.

Bejegyzésadatok visszaállítása

Ha úgy állította be az OTRS-t, hogy a bejegyzésadatokat a fájlrendszeren tárolja, akkor vissza kell állítania az article mappát az /opt/otrs/var/ mappába, vagy a rendszerbeállításokban megadott mappába.

Fájljogosultságok beállítása

Hajtsa végre a következő parancsot:

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

a rendszerbeállításhoz szükséges jogosultságokkal. Például:

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

    shell> bin/otrs.SetPermissions.pl --web-group=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
                    

4.2. lépés: RPM segítségével:

shell> rpm -Uvh otrs-x.x.x.-01.rpm
            

Ebben az esetben az RPM frissítés automatikusan visszaállítja a régi beállítófájlokat és beállítja a fájljogosultságokat.

5. lépés: a szükséges Perl-modulok ellenőrzése

Ellenőrizze, hogy minden szükséges Perl-modul telepítve van-e a rendszerre, és telepítsen minden olyan modult, amely esetleg hiányzik.

shell> /opt/otrs/bin/otrs.CheckModules.pl
        

6. lépés: az adatbázis-változtatások alkalmazása

6.1. lépés: adatbázisséma frissítése

MySQL:

Megjegyzés

Megjegyzés: a MySQL FRISSÍTÉSI folyamatában létrehozott új táblák a MySQL-kiszolgálón beállított alapértelmezett tábla tárolómotorral lesznek létrehozva. A MySQL 5.5-ös verziójában az InnoDB az új alapértelmezett típus. Ha a meglévő táblák, például a „users” a MyISAM tábla tárolómotorral rendelkeznek, akkor hiba lesz megjelenítve az idegen kulcs kényszereinek létrehozásakor. Ebben az esetben azt ajánljuk, hogy állítsa át az összes táblát InnoDB tárolómotorra a bin/otrs.Console.pl Maint::Database::MySQL::InnoDBMigration konzolparanccsal.

A tárolómotorra vonatkozó bármilyen problémát a bin/otrs.Console.pl Maint::Database::Check parancs fog jelenteni, ezért futtassa le a lehetséges problémák ellenőrzéséhez.

shell> cd /opt/otrs/
shell> cat scripts/DBUpdate-to-5.mysql.sql | mysql -p -f -u root otrs
shell> bin/otrs.Console.pl Maint::Database::Check
                    

PostgreSQL:

shell> cd /opt/otrs/
shell> cat scripts/DBUpdate-to-5.postgresql.sql | psql --set ON_ERROR_STOP=on --single-transaction otrs otrs
                

6.2. lépés: adatbázis-költöztető parancsfájl

Futtassa le a költöztető parancsfájlt (otrs felhasználóként, NE root felhasználóként):

shell> scripts/DBUpdate-to-5.pl
            

Ne folytassa a frissítési folyamatot, ha ez a parancsfájl nem működött megfelelően önnél. Egyébként adatvesztés fordulhat elő.

7. lépés: a beállítási gyorsítótár frissítése és a gyorsítótárak törlése

Futtassa le (otrs felhasználóként, ne root felhasználóként):

shell> cd /opt/otrs/
shell> bin/otrs.Console.pl Maint::Config::Rebuild
shell> bin/otrs.Console.pl Maint::Cache::Delete
        

8. lépés: szolgáltatások újraindítása

Például (a használt szolgáltatásoktól függően):

shell> /etc/init.d/apache start
shell> /etc/init.d/postfix start
shell> /etc/init.d/cron start
        

Most már bejelentkezhet a rendszerre.

9. lépés: telepített csomagok ellenőrzése

Megjegyzés

A 4-es OTRS csomagjai NEM kompatibilisek az OTRS 5-ös verziójával, ezért végre kell hajtania egy csomagfrissítést!

A következő csomagok automatikusan el lesznek távolítva a frissítési folyamat után (ha korábban telepítve voltak):

  • OTRSGenericInterfaceMappingXSLT

10. lépés: csomópont-azonosítók beállítása (csak több előtétprogramos fürtözött beállításoknál)

Megjegyzés

Ez a lépés csak akkor szükséges, ha fürtözött beállítással rendelkezik több előtétprogram géppel.

Az OTRS 5-től kezdve minden egyes előtétprogram kiszolgálónak saját egyedi NodeID értékének kell lennie. Az alapértelmezett érték 1, és így nem szükséges beállítani egyedülálló előtétprogram beállításoknál. Ha egynél több gépe van, akkor minden egyes gépnek be kell állítani ezt az értéket egy egyedi értékre 1 és 999 között. Ezt a beállítást a Kernel/Config.pm fájlban kell elvégezni:

$Self->{'NodeID'} =  '2';   # egyedi érték hozzárendelése minden előtétprogram kiszolgálóhoz
            

11. lépés: követőfelismerési beállítás ellenőrzése

A követőfelismerési beállítások átszervezésre kerültek. Az OTRS most alapértelmezetten az e-mail tárgya és a hivatkozások alapján keres a követők felismeréséhez. Ellenőrizze a Ticket -> Core::PostMaster adminisztrátori rendszerbeállításban, hogy szükséges-e valamilyen változtatást elvégeznie a követőfelismerési beállításon (például a törzsben, a mellékletekben vagy a nyers e-mail tartalomban történő kereséshez).

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

13. lépés: cron-feladatok frissítése és bekapcsolása

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
            

Ne feledje, hogy ha bármilyen egyéni cron-feladata volt, akkor meg kellene fontolnia azok áthelyezését a rendszerbeállításokba (Daemon -> Daemon::SchedulerCronTaskManager::Task), hogy azokat is az OTRS démon futtassa. Esetleg szükséges lehet az egyéni parancsfájlok átdolgozása is, mert mostantól a legtöbb OTRS parancsot a bin/otrs.Console.pl parancsfájl kezel az egyedüli parancsfájlok helyett.

Megjegyzés

A Dev::Code::Generate::ConsoleCommand parancssori utasítás segíthet egy új parancssori utasítás létrehozásában az egyéni parancsfájljaihoz. Ez a parancs egy sablont hoz létre, ahol a parancsfájl logikája és annak paraméterei hozzáigazíthatók.

14. lépés: a jegyértesítések átnézése

Az OTRS 5-tel a jegyértesítések eltérően vannak beállítva mint a korábbi verziókban. Ezek mostantól az „Esemény értesítések” részei, amelyek korábban is elérhetőek voltak (most egyszerűen „Jegyértesítéseknek” hívják). A meglévő jegyértesítései át lettek költöztetve a jegyértesítések listájába, de ki vannak kapcsolva. Megkapta az új alapértelmezett jegyértesítéseket is, amelyek alapértelmezetten be vannak kapcsolva.

Abban az esetben, ha nem módosította a régi jegyértesítéseket, nem kell semmit sem tennie. Ha helyi módosításokat vagy fordításokat csinált, akkor két választása van: a) átköltöztetheti a módosításait az új jegyértesítésekbe (ez az ajánlott), vagy b) kikapcsolhatja az új értesítéseket, és újra bekapcsolhatja a régi értesítéseket.

Nézze át az eszkalációs értesítés címzett beállításait is, és nézze meg, hogy megfelelnek-e az elvárásainak (ügyintézők, akik rendelkeznek a jeggyel az egyéni várólistájuk egyikében kontra összes ügyintéző olvasási jogosultságokkal). Ez korábban a (most elavult) Kernel/Config/GenericAgent.pm fájlban lévő beállításon keresztül volt beállítva, és mostantól a grafikus felhasználói felületen keresztül vezérelhető külön-külön minden egyes értesítésnél.

15. lépés: rendszerregisztráció frissítése (opcionális)

Ha a rendszer már regisztrálva van az OTRS csoporttal, akkor most erősen ajánlott a regisztrációs információk frissítése. Ez frissíteni fogja a rendszer regisztrált verzióját (többek között a változtatásokat) az OTRS csoport feljegyzéseiben annak érdekében, hogy még pontosabb információkat kapjon a felhőszolgáltatásról.

Ha nem frissíti kézzel a regisztrációs információkat, akkor az automatikusan el lesz végezve rendszeresen, de ez csak néhány óra vagy nap múlva történik meg. Ezen időszak alatt lehetséges lehet, hogy rossz információkat kap az olyan felhőszolgáltatásoktól, mint például az OTRS Business Solution™ frissítések.

shell> cd /opt/otrs/
shell> bin/otrs.Console.pl Maint::Registration::UpdateSend --force
shell> bin/otrs.Console.pl Maint::Cache::Delete
            

16. lépés: egyéni Perl alapú általános ügyintéző feladatok költöztetése (opcionális)

Ez csak akkor fontos, ha valamilyen egyéni általános ügyintéző feladata volt az olyan OTRS 4 Perl beállítófájlokban (mint például Kernel/Config/GenericAgent.pm), amelyeket nem lehet a szabályos jegyértesítésekkel kezelni. Az ilyen feladatokat most OTRS démon cron-feladatokként kell regisztrálni a rendszerbeállításokban (Daemon -> Daemon::SchedulerCronTaskManager::Task) azért, hogy rendszeresen végrehajtásra kerüljenek.

A rendszerbeállításokban 5 beállítás van előkészítve erre a célra (Daemon::SchedulerCronTaskManager::Task###GenericAgentFile1 - Daemon::SchedulerCronTaskManager::Task###GenericAgentFile5). Ha több beállítás szükséges, akkor azok egy egyéni rendszerbeállítási beállítófájlban adhatók hozzá.

Cserélje ki „<modulnevet>” azzal a fájllal, amely az egyéni általános ügyintéző feladatok beállításait tartalmazza, például Kernel::Config::GenericAgent a Kernel/Config/GenericAgent.pm fájl esetén, állítsa be az ütemezést, hogy egyezzen azzal az időszakossággal, ahogy korábban végre volt hajtva, jelölje meg a beállítást aktívként, és mentse el a változtatásokat.

Megjegyzés

További információkért a többi olyan paraméterrel kapcsolatban, amelyek az általános ügyintéző feladatok futtatása közben használhatók, hajtsa végre a következő parancsot:

shell> bin/otrs.Console.pl Maint::GenericAgent::Run --help
            

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

Az összes szabályos OTRS parancssori művelet mostantól 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.

18. lépés: a jegyművelet képernyő beállításainak átnézése (opcionális)

Néhány jegyművelet képernyőnek (mint például a „Jegyzet”) alapértelmezett tárgya volt az OTRS 4-ben (ebben az esetben a Ticket::Frontend::AgentTicketNote###Subject rendszerbeállításon keresztül állítható be). Ezek az alapértelmezett tárgyak eltávolításra kerültek a potenciálisan redundáns vagy értelmetlen adatok mennyiségének csökkentéséhez. Érdemes újra hozzáadni azokat, ha kötelezőek az Ön számára.

19. lépés: jegyesemény modul beállításainak átnézése

Egy OTRS 5s hibajavítás miatt néhány jegyesemény modul beállításának nevét meg kellett változtatni. Az összes lehetséges személyre szabást újra kell alkalmazni. Nézze át a Rendszerbeállítások -> Ticket -> Core::Ticket beállításait, és ellenőrizzen minden olyan beállítást, amely Ticket::EventModulePost kezdetű annak eldöntéséhez, hogy újra kell-e alkalmazni az egyedi fejlesztéseit. Ez például abban az esetben lehet, ha bekacsolta és úgy állította be az eseménykezelőt, hogy az ügyféladatokat a jegy dinamikus mezőibe mentse.

20. lépés: szép munka!