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

Ezek az utasítások olyan embereknek szólnak, akik az OTRS-t a 3.3-as verzióról a 4-es verzióra frissítik, vagy egy 4-es verzióról egy későbbi 4-es 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 3.3 frissítési útvonalát 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)! 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 a 4-es verziójú OTRS 2. hibajavító verziójáról közvetlenül frissíthet a 4-es 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., 11., 13. és 14. 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 (ebben a sorrendben):

shell> cd /opt/otrs/
shell> bin/Cron.sh stop
shell> bin/otrs.Scheduler.pl -a 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

  • 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/GenericAgent.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.

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

Két lehetősége van: visszaváltoztathatja a MySQL alapértelmezett tárolómotorját MyISAM értékre azért, hogy az új tábláknak ugyanaz a tárolómotorjuk legyen mint a meglévő tábláknak, vagy változtassa meg a meglévő táblákat, hogy InnoDB-t használjanak tárolómotorként.

A tárolómotorra vonatkozó bármilyen problémát az otrs.CheckDB.pl parancsfájl fog jelenteni, ezért futtassa le a lehetséges problémák ellenőrzéséhez.

shell> cd /opt/otrs/
shell> bin/otrs.CheckDB.pl
shell> cat scripts/DBUpdate-to-4.mysql.sql | mysql -p -f -u root otrs
                

PostgreSQL:

shell> cd /opt/otrs/
shell> cat scripts/DBUpdate-to-4.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-4.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: saját témák

Megjegyzés: A 3.3-as OTRS témák NEM kompatibilisek az OTRS 4-es verziójával, ezért ne használja a régi témáit!

A témák az /opt/otrs/Kernel/Output/HTML/*/*.tt fájlok alatt találhatók.

Vegye figyelembe, hogy az OTRS 4 egy új sablonozó motorral érkezik a Template::Toolkit alapján. Az összes személyre szabott sablont át kell alakítani DTL-ről az új formátumra. A részletes utasításokért nézze meg a fejlesztői kézikönyvet.

8. 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> bin/otrs.RebuildConfig.pl
shell> bin/otrs.DeleteCache.pl
        

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

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

Megjegyzés

A 3.3-as OTRS csomagjai NEM kompatibilisek az OTRS 4-es 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):

  • OTRSGenericInterfaceREST

  • OTRSMyServices

  • OTRSStatsRestrictionByDateTimeDF

  • Support

11. lépés: általános ügyintéző feladatok ellenőrzése

Ha rendelkezik bármilyen olyan általános ügyintéző feladatokkal (vagy akár bármilyen egyedi fejlesztésekkel), amelyek automatikusan beállítják a ProcessID vagy az ActivityID dinamikus mezőket, akkor frissítenie kell ezeket, hogy az új hosszú EntityID-khoz állítsák be a mezőket, amelyeket a DBUpdate-to-4.pl állított elő.

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

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. Tegye ezt meg, hogy meggyőződhessen arról, hogy beszerezte a cron-feladatok legújabb verzióit és az új cron-feladatokat is.

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

Ellenőrizze az átmásolt fájlokat, és alkalmazzon újra minden személyre szabást, amelyet esetleg elvégzett. 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 felhasználóként hajtja-e végre!

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

Ez is az OTRS ütemező indítását fogja okozni.

13. lépés: ügyfél-adatbázis beállításainak frissítése

Ha külső ügyfél-adatbázist használ, és ez az adatbázis NEM biztosítja az OTRS-specifikus mezőket (create_time, create_by, change_time és change_by), akkor állítson be ForeignDB => 1 értéket a $Self->{CustomerUser} és a $Self->{CustomerCompany} beállításoknál (lásd: Kernel/Config/Defaults.pm).

14. lépés: jegyindex újraépítése

Futtassa le a bin/otrs.RebuildTicketIndex.pl parancsfájlt a jegyindex újbóli előállításához. Ez megtehető a háttérben a jegyszámok kiszámításához a várólista nézet képernyőknél. Most már használhatja is a rendszerét.

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