Frissítés¶
Két különböző forgatókönyv létezik egy újabb OTRS-verzió beszerzéséhez:
- Hibajavító szintű frissítés: Ön az OTRS 7-et használja, és az OTRS 7 legújabb verzióját szeretné használni.
- Főverzió frissítés: Ön az OTRS 6-ot használja, és az OTRS 7 legújabb verzióját szeretné használni.
- Frissítés az OTRS 7 egy korábbi verziójáról
Frissíthet közvetlenül bármely előző hibajavító szintű kiadásról az elérhető legfrissebb hibajavító szintű kiadásra.
Megjegyzés
Erősen ajánlott először egy próbafrissítést végrehajtani egy elkülönített tesztelési gépen.
- Frissítés OTRS 6-ról
Az OTRS frissíthető bármely OTRS 6 hibajavító szintű kiadásról az elérhető legfrissebb OTRS 7 hibajavító szintű kiadásra.
Megjegyzés
Az OTRS programot az Ügyfélmegoldások csapat frissíti. Vegye fel velünk a kapcsolatot a support@otrs.com e-mail-címen vagy az OTRS Portálon.
- Frissítés OTRS 5-ről vagy egy korábbi verzióról
Az OTRS nem frissíthető az OTRS 5-ről vagy egy korábbi kiadásról közvetlenül az OTRS 7-re. Ehelyett el kell végezni az összes elérhető főverzióra történő frissítést egymás után. Például ha az OTRS 4-ről indul, akkor az OTRS-t először az OTRS 5-re kell frissíteni, majd az OTRS 6-ra és végül az OTRS 7-re.
Megjegyzés
Az OTRS programot az Ügyfélmegoldások csapat frissíti. Vegye fel velünk a kapcsolatot a support@otrs.com e-mail-címen vagy az OTRS Portálon.
1. lépés: az összes kapcsolódó szolgáltatás és az OTRS démon 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 és az OTRS verziójától fog függeni.
A következő systemctl parancsok csak példák, és eltérhetnek a célrendszeren, ha az különböző levelezőprogramot vagy webkiszolgálót használ.
root> systemctl stop postfix
root> systemctl stop apache2
Ha OTRS 6-ról frissít, akkor le kell állítania a régi OTRS cron-feladatokat és a démont (ebben a sorrendben):
otrs> /opt/otrs/bin/Cron.sh stop
otrs> /opt/otrs/bin/otrs.Daemon.pl stop
Ha hibajavító szintű frissítést hajt végre az OTRS 7-en belül (az új systemd fájlok használatával), akkor állítsa le az OTRS szolgáltatásokat a systemd parancson keresztül:
root> systemctl stop otrs-daemon
root> systemctl stop otrs-webserver
2. lépés: fájlok és adatbázis biztonsági mentése¶
Készítsen biztonsági mentést a következő fájlokról és mappákról:
Kernel/Config.pm- egyéni fájlok a
Kernel/Config/Files/mappában Kernel/Config/Files/User/*Kernel/WebApp.conf(csak az OTRS 7 hibajavítás szintű frissítése esetén, és csak akkor, ha a fájlt módosították)var/*- azok a fájlok, amelyek nem részei a hivatalos kiadási csomagnak, hanem kézzel lettek hozzáadva a rendszerhez (egyéni nyelvi fájlok, logók, CSS-stíluslapok, XML-beállítások stb.)
- valamint az adatbázisról
Megjegyzés
Ajánlott, hogy legyen egy naprakész lista azokról a fájlokról, amelyek kézzel lettek hozzáadva vagy megváltoztatva a rendszerben.
Figyelem
Ne folytassa a rendszer teljes biztonsági mentése nélkül. Használja a Biztonsági mentés parancsfájlt ehhez.
3. lépés: az új kiadás telepítése¶
Megjegyzés
Az OTRS 7-tel az RPM-csomagok többé nem érhetők el. Az RPM-alapú telepítéseket át kell költöztetni az RPM-csomagok eltávolításával (ez nem fogja eldobni az adatbázist) és helyettük a forrásarchívumokat kell használni.
Beszerezheti akár az otrs-patchlevel-update-x.y.z.tar.gz vagy az otrs-patchlevel-update-x.y.z.tar.bz2 fájlt is. Bontsa ki a forrásarchívumot (például a tar használatával) az /opt könyvtárba, és hozzon létre egy /opt/otrs szimbolikus hivatkozást, amely az /opt/otrs-x.y.z helyre mutat.
Ne felejtse el kicserélni a verziószámokat!
Megjegyzés
A bzip2 csomag néhány rendszeren nincs alapértelmezetten telepítve. Győződjön meg arról, hogy a bzip2 telepítve van-e, mielőtt az otrs-patchlevel-update-x.y.z.tar.bz2 fájlt kibontaná.
Kibontási parancs az otrs-patchlevel-update-x.y.z.tar.gz fájlhoz:
root> tar -xzf otrs-patchlevel-update-x.y.z.tar.gz -C /opt
Kibontási parancs az otrs-patchlevel-update-x.y.z.tar.bz2 fájlhoz:
root> tar -xjf otrs-patchlevel-update-x.y.z.tar.bz2 -C /opt
Ajánlott egy /opt/otrs nevű szimbolikus hivatkozást létrehozni, amely mindig a legújabb OTRS verzióra mutat. A szimbolikus hivatkozás használata egyszerűbbé teszi az OTRS frissítések kezelését, mert így érintetlenül hagyhatja az előző verzió könyvtárát, mindössze a szimbolikus hivatkozást kell megváltoztatni.
Futtassa ez a parancsot egy szimbolikus hivatkozás létrehozásához:
root> ln -fns /opt/otrs-x.y.z /opt/otrs
Ha vissza kell vonnia a frissítést, akkor visszaváltoztathatja a szimbolikus hivatkozás célját, ha még nem futtatta a 4. lépésben lévő költöztető parancsfájlt. Ha a költöztető parancsfájl végrehajtásra került, akkor az adatbázist a biztonsági mentésből kell helyreállítani egy visszaállítás esetén.
Régi beállítófájlok visszaállítása¶
Kernel/Config.pm- egyéni fájlok a
Kernel/Config/Files/mappában Kernel/Config/Files/User/*Kernel/WebApp.conf(csak az OTRS 7 hibajavítás szintű frissítése esetén, és csak akkor, ha a fájlt módosították)- azok a fájlok, amelyek nem részei a hivatalos kiadási csomagnak, hanem kézzel lettek hozzáadva a rendszerhez (egyéni nyelvi fájlok, logók, CSS-stíluslapok, XML-beállítások stb.)
Nézze meg a rejtett fájlokat az ls -a paranccsal az előző OTRS könyvtárban. Ilyenek például a .fetchmailrc, .mailfilter és .procmailrc. Ha ezek a fájlok léteznek .dist kiterjesztés nélkül, akkor másolja át azokat az OTRS mappájába a cp -p parancs használatával, hogy megőrizze a jogosultságokat.
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.
A már telepített alapértelmezett statisztikák visszaállítása¶
Ha alapértelmezett statisztikákkal rendelkező további csomagjai vannak, akkor vissza kell állítania a statisztikák XML-fájljait az *.installed utótaggal az /opt/otrs/var/stats mappába.
root> cd OTRS-BACKUP/var/stats
root> cp *.installed /opt/otrs/var/stats
Fájljogosultságok beállítása¶
Futtassa a következő parancsot a fájl- és könyvtárjogosultságok beállításához az OTRS számára. Megpróbálja felismerni a beállításhoz szükséges helyes felhasználó- és csoportbeállításokat.
root> /opt/otrs/bin/otrs.SetPermissions.pl
Szükséges programok és 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 és egyéb külső függőségekről.
root> perl /opt/otrs/bin/otrs.CheckEnvironment.pl
Checking for Perl Modules:
o Archive::Tar.....................ok (v1.90)
o Archive::Zip.....................ok (v1.37)
o Crypt::Eksblowfish::Bcrypt.......ok (v0.009)
...
Megjegyzés
Ne feledje, hogy az OTRS-hez működő Perl-telepítés szükséges az összes alapvető modullal, mint például a version modul. Ezeket a modulokat közvetlenül nem ellenőrzi a parancsfájl. Esetleg telepítenie kell egy perl-core csomagot néhány olyan rendszeren, mint például a RHEL, amely nem telepíti az alapvető Perl-csomagokat alapértelmezetten.
A szükséges és választható csomagok telepítéséhez használhatja a CPAN-t vagy a Linux disztribúciója csomagkezelőjét is.
Futtassa ezt a parancsot, hogy megkapjon egy telepítési parancsot a hiányzó függőségek telepítéséhez:
root> /opt/otrs/bin/otrs.CheckEnvironment.pl --list
Az OTRS-hez szükséges, hogy a Node.js egy támogatott stabil verziója telepítve legyen. Nézze meg a Node.js telepítési utasításait.
4. lépés: a költöztető parancsfájl futtatása¶
A frissítő parancsfájl számos ellenőrzést fog végrehajtani a rendszerén, és tanácsot ad azzal kapcsolatban, hogy hogyan telepítse a hiányzó Perl-modulokat és egyebeket, ha az szükséges. Ha az összes ellenőrzés sikeres, akkor a szükséges költöztető lépések végre lesznek hajtva.
Megjegyzés
Futtassa ezt a parancsfájlt hibajavító szintű frissítések esetén is.
Futtassa a költöztető parancsfájlt:
otrs> /opt/otrs/scripts/DBUpdate-to-7.pl
Figyelem
Ne folytassa a frissítési folyamatot, ha ez a parancsfájl nem működött megfelelően Önnél. Egyébként hibás működés vagy adatvesztés történhet.
A költöztető parancsfájl azt is ellenőrzi, hogy az ACL-ek és a rendszerbeállítások helyesek-e. Bármilyen érvénytelen rendszerbeállítási érték esetén a parancsfájl fel fog ajánlani egy lehetőséget annak javításához a lehetséges értékek egy listából való kiválasztásával. Abban az esetben, ha a parancsfájl nem interaktív módban fut, megpróbálja automatikusan javítani az érvénytelen beállításokat. Ha ez meghiúsul, akkor arra fogja kérni, hogy kézzel frissítse a beállításokat a költöztetés után.
Ha elavult ACL-ek találhatók, akkor a rendszer nem lesz képes automatikusan javítani, hanem az adminisztrátornak kell javítania azokat. A részletekért nézze meg az utolsó lépést a kézi változtatáshoz.
5. lépés: telepített csomagok frissítése¶
Megjegyzés
Az OTRS 6 csomagjai nem kompatibilisek az OTRS 7-tel, és frissíteni kell azokat.
Használhatja a lenti parancsot az összes telepített csomag frissítéséhez. Ez működik az összes olyan csomagnál, amely elérhető az internetes tárolókból. Az egyéb csomagokat frissítheti később is a csomagkezelőn keresztül (ez futó OTRS démont igényel).
otrs> /opt/otrs/bin/otrs.Console.pl Admin::Package::UpgradeAll
otrs> /opt/otrs/bin/otrs.Console.pl Admin::Package::ReinstallAll
6. lépés: szolgáltatások indítása¶
Az OTRS 7 saját beépített webkiszolgálóval érkezik, amely az Apache fordított proxyként (vagy bármely más fordított proxy kiszolgálóként) történő használata mögött található. Az OTRS 6-ról történő frissítésnél az Apache beállításait frissíteni kell az /opt/otrs/scripts/apache2-httpd.include.conf fájlban lévő új verzióval, ha az másolva volt és nem csak hivatkozva.
Ne feledje azt se, hogy míg a mod_perl többé már nem szükséges, más Apache modulok szükségesek most:
mod_headersmod_proxymod_proxy_httpmod_proxy_wstunnel
Ezután a szolgáltatások elindíthatók. Ez a szolgáltatás beállításaitól függ, itt egy példa:
root> systemctl start postfix
root> systemctl start apache2
Megjegyzés
Az OTRS démon szükséges az OTRS helyes működéséhez, mint például e-mailek küldéséhez. Kapcsolja be a következő lépésben leírtak szerint.
7. lépés: az OTRS démon és webkiszolgáló elindítása¶
Az OTRS démon felelős minden aszinkron és ismétlődő feladat kezeléséért az OTRS-ben. A beépített OTRS webkiszolgáló-folyamat kezeli az Apache által átadott webkéréseket.
Az OTRS példa systemd beállítófájlokkal érkezik, amelyek ahhoz használhatók, hogy biztosítva legyen az OTRS démon és webkiszolgáló automatikus elindítása, miután a rendszer elindul.
root> systemctl start otrs-daemon
root> systemctl start otrs-webserver
Most már bejelentkezhet a rendszerre.
8. lépés: feladatok és változtatások kézi költöztetése¶
Figyelem
Olvassa el figyelmesen ezt a lépést, és csak akkor alkalmazza a műveleteket, ha azok az Ön rendszerére vonatkoznak.
Mivel a régi ügyfélfelület képernyői többé nincsenek meg, néhány ACL-t kézzel kell javítania az adminisztrátornak. A költöztető parancsfájl már tájékoztatta Önt, ha ez az eset áll fenn.
Azok az ACL-ek érintettek, amelyek egy nemlétező ügyfélfelület képernyőre hivatkoznak az Action beállításban. Ezt az előtétprogram Action szabályt kell kicserélni a megfelelő Endpoint szabállyal. Alább egy táblázat látható a lehetséges leképezésekkel.
| Művelet | Végpont |
|---|---|
CustomerTicketPrint |
Nincs helyettesítés (a funkció dobva lett) |
CustomerTicketZoom |
ExternalFrontend::TicketDetailView |
CustomerTicketProcess |
ExternalFrontend::ProcessTicketCreate vagy ExternalFrontend::ProcessTicketNextStep |
CustomerTicketMessage |
ExternalFrontend::TicketCreate |
Az RPC teljesen át lett alakítva az OTRS 7-ben, és az rpc.pl többé nem létezik. Van egy Generic::RPC nevű művelet a SOAP-on belül.
Az RPC webszolgáltatások többé nem használhatók probléma nélkül. Vetnie kell egy pillantást a webszolgáltatásaira az OTRS 7-re történő frissítés után, és valószínűleg más módon kell újraépíteni azokat.
Lehetősége van tanácsadó segítségét is kérnie, aki Önnel együttműködve segít újraépíteni a webszolgáltatásait.
Az Elasticsearch frissítése¶
Frissítse az Elasticsearch telepítését, ha újabb verzió érhető el. További információkért olvassa el az Elasticsearch frissítése fejezetet (angolul) a hivatalos dokumentációban.
Lásd még
Nézze meg a Hardver- és szoftverkövetelmények fejezetet a támogatott verziókért.
Ezenkívül az OTRS-nek szüksége van bővítmények telepítésére az Elasticsearchbe. Ha újabb Elasticsearch verzió kerül telepítésre, akkor a bővítményeket el kell távolítani és újra kell telepíteni.
root> /usr/share/elasticsearch/bin/elasticsearch-plugin remove analysis-icu
root> /usr/share/elasticsearch/bin/elasticsearch-plugin remove ingest-attachment
root> /usr/share/elasticsearch/bin/elasticsearch-plugin install --batch ingest-attachment
root> /usr/share/elasticsearch/bin/elasticsearch-plugin install --batch analysis-icu
Megjegyzés
Ezután indítsa újra az Elasticsearch programot, különben az indexek nem lesznek felépítve.
Az Elasticsearch telepítés ellenőrzéséhez használhatja a következő parancsot:
otrs> /opt/otrs/bin/otrs.Console.pl Maint::DocumentSearch::Check
Trying to connect to cluster...
Connection successful.
Az Elasticsearch 7.x megváltoztatott néhány konfigurációs beállítást és viselkedést. Az Elasticsearch 6.x és 7.x közötti változtatások teljes listája átnézhető az Elasticsearch hivatkozásban.
A beállítások egyike kifejezetten érdekes az OTRS-nél. Ez a nyitott görgetési környezetek legnagyobb száma, amely az Elasticsearch 6.x legutolsó verziójáig 1000-es értékkel rendelkezett, és az Elasticsearch 7.x verzióiban le lett csökkentve 500-ra.
Normál helyzetekben ezt az értéket nem lenne szabad elérni, de azt javasoljuk, hogy állítsa vissza ezt az értéket 1000-re a következő beállítással, amelyet az elasticsearch.yml beállítófájlhoz kell hozzáadni:
search.max_open_scroll_context: 1000
Program biztonságos futtatásának engedélyezése¶
Az OTRS által futtatandó külső programok biztonsági okok miatt alapértelmezetten tiltva vannak. Hozzá kell adnia a programot az engedélyezési listához, ahogy az Adminisztrátori kézikönyvben le van írva.