„Server pri štarte proste spadne" je najčastejšia sťažnosť okolo modovaného Minecraftu na akomkoľvek fóre a obvyklé odpovede sú len hádanie: pridaj RAM, preinštaluj, skús iný balík. My sme chceli dáta, tak sme 100 najpopulárnejších CurseForge modpackov nabootovali na vlastnom hardvéri. Každý balík, ktorý zlyhal, dostal druhý nezávislý pokus a zlyhanie sa počítalo len vtedy, keď sa zopakovalo. To pravidlo bolo dôležité: šesť balíkov, ktoré na prvý pokus vyzerali rozbito, na druhý nabootovalo v poriadku, medzi nimi aj All the Mods 10.
Hlavný výsledok: dnes zo 100 najpopulárnejších modpackov nabootuje 74. Keď sme s testovaním začínali, bolo ich 46, šesť bolo hod mincou a 48 zlyhalo v oboch pokusoch. A teraz to nepríjemné: keď sme tých 48 zlyhaní dotiahli ku koreňovým príčinám, väčšina z nich bola naša chyba, nie chyba balíkov. Číslo posunula oprava našej vlastnej pipeline. Nájdené príčiny nie sú špecifické pre nás, a práve preto ich zverejňujeme: modpackové servery padajú z rovnakých dôvodov všade.
Najväčší nález: väčšina balíkov beží na hrane pamäte
Ešte pred taxonómiou zlyhaní číslo, ktoré zmenilo náš pohľad na modovaný hosting: z 94 balíkov, ktoré nám dali použiteľné meranie, ich 43 bežalo s rezervou pamäte 5 % alebo menšou. Väčšina tých hodnôt je nečinných, na čerstvo vygenerovanom svete a s nula pripojenými hráčmi. Desať zo štyridsiatich troch je moment, keď pack narazil na svoj strop a skončil. Osemnásť z nich hlásilo 0 %, teda každý megabajt svojho limitu mali obsadený v momente, keď dokončili štart. Všetky namerané hodnoty zverejňujeme pack po packu.
Toto vysvetľuje najotravnejší príznak modovaného Minecraftu: server, ktorý včera fungoval a dnes padá. Balík nečinne na 99 % svojho pamäťového limitu nemá stabilný stav a o tom, či prežije štart, rozhoduje načasovanie garbage collectora. Pridaj jedného hráča, jeden nápor generovania chunkov, jednu rušnú farmu na moby, a ten istý server, ktorý päťkrát po sebe nabehol, na šiestykrát zabije OOM. Ak ti modovaný server padá občas, rezerva pamäte má byť tvoj prvý podozrivý, nie posledný.
Taxonómia zlyhaní
Toto opakované zlyhania naozaj zabíjalo, zhruba v poradí od najčastejšieho.
Klientske mody na serveri. Modpacky vychádzajú v dvoch podobách: klientsky balík, ktorý si inštalujú hráči, a server pack, ktorý autor pripraví bez klientskych modov. Keď server pack chýba alebo sa ignoruje, klientske mody skončia na serveri a loader pri štarte spadne. Zákernejšia verzia: niektoré staršie balíky server pack zverejnia, ale nástroje ho ticho neodhalia, takže inštalátor sa bez slova vráti ku klientskym súborom. Ak crash log menuje mod a ten mod je minimapa, shader alebo čokoľvek kozmetické, máš príčinu.
Zlý build loadera. Balík je postavený na konkrétnom builde Forge, Fabricu alebo NeoForge. Nainštaluj ho na „latest" a balíky nabité mixinmi padnú spôsobom, ktorý vyzerá ako náhodné chyby modov. Riešenie, na ktorom sme skončili, si vie skopírovať každý správca: manifest.json samotného balíka uvádza loader, jeho presný build aj verziu Minecraftu. Ver manifestu, nie stránke s výpisom a už vôbec nie „latestu".
Zlá verzia Minecraftu. Štítky v katalógoch modpackových stránok sú hrubšie než manifest a občas rovno nesprávne. Štyri balíky v našom teste zlyhali preto, že verzia naznačená vo výpise nebola verzia, na ktorej bol balík postavený. Riešenie je rovnaké: pravdu má manifest.
„Server packy", ktoré sú v skutočnosti inštalátory. Sedem balíkov malo „server pack", v ktorom nebol žiadny server, len inštalačný skript určený na ručné spustenie. Nahraný na hosting, ktorý čaká pripravené súbory, nenainštaluje nič a server okamžite skončí. Ak sa ti server „spustí" a do sekundy zomrie s takmer prázdnym logom, pozri sa, čo v tom zipe naozaj je.
Obyčajný nedostatok pamäte. Osem balíkov nedokázalo nabootovať pri RAM, ktorá je pre ne odporúčaná; jednu 468-modovú obludu zabil OOM pri viac než 2 GB rozbalených serverových súborov. Dve pasce z našej vlastnej analýzy logov: exit code 137 je kernel, ktorý proces zabil pre pamäť, nie chyba modu, a my sme dva takéto prípady najprv zaradili zle. A desivo vyzerajúci riadok invalid dist DEDICATED_SERVER sa objavuje aj na úplne zdravých serveroch, tak ho nenaháňaj.
Zlyhania sťahovania a balenia. Zvyšok: balíky, ktorých súbory sa vôbec nepodarilo stiahnuť, a zle označené uploady, kde „serverový" súbor bol klientsky zip. Nudné príčiny, skutočné zlyhania.
Čo s tým, keď ti server padá
Praktický zoznam, v poradí, platný na akomkoľvek hostingu:
- Pozri sa na ukončenie. Zabité s exit 137 alebo s riadkom o OOM? Je to pamäť. Zdvihni limit alebo balík orež, nič iné to nevyrieši.
- Prečítaj si prvý menovaný mod v crashi. Kozmetický alebo klientsky? Beží ti klientsky balík, zožeň autorov server pack.
- Over si loader a verziu proti
manifest.jsonbalíka, nie proti výpisu na stránke. Presný build, nie latest. - Pozri dovnútra serverového zipu. Ak je to inštalačný skript, spusti ho lokálne alebo si nájdi hosting, ktorý tento tvar zvláda.
- Až potom podozrievaj samotný balík. V našich dátach boli naozaj rozbité balíky malá menšina.
Ako sa crash log naozaj číta
Taxonómia vyššie hovorí, čo sa pokazí. Tu je poradíe, v akom to overovať, a to poradíe je dôležitejšie než samotný zoznam. Niekoľko týchto zlyhaní sa totiž navzájom vydáva jedno za druhé. Je to to isté poradíe, aké používa náš vlastný klasifikátor pri každom spadnutom kontajneri.
1. Zabil ho niekto zvonku? exit 137. To nie je mód ani stack trace, ale OOM killer jádra, ktorý kontajner zastavil. Log preto často končí uprostred vety a bez čohokoľvek, čo by vyzeralo ako chyba. Všetko nad tým je len prejav, nie príčina.
2. unable to create native thread nie je problém s pamäťou. Príde ako java.lang.OutOfMemoryError, a presne preto sa číta zle. JVM nedokázala vytvoriť vlákno, čo je strop na procesy alebo PID, nie halda. Spustí sa aj na stroji, kde sú gigabajty voľné. Toto treba kontrolovať ešte pred vzormi pre haldu, pretože holý java.lang.OutOfMemoryError na konci riadku sedne aj na ne.
Sami sme to mali zle a cena bola veľmi konkrétna: panel ľuďom povedal, nech si kupujú väčší plán, oni si ho kúpili a limit, do ktorého naozaj narážali, sa nepohol.
3. Až teraz skutočné pamäťové zlyhania. OutOfMemoryError: Java heap space znamená, že väčšia halda naozaj pomôže. OutOfMemoryError: Metaspace je o metadátach tried, nie o dátach sveta, a veľké packy do neho nazárajú aj s celkom zdravou haldou. GC overhead limit exceeded hovorí, že Java strávila takmer všetok čas upratovaním pamäte a vzdala to, čo je tá istá tieseň v inom kabáte.
4. Verzia Javy ešte pred čímkoľvek, čo vyzerá na módy. Unsupported class file major version a hlášky typu „requires Java 17“ rieši verzia Javy. Žiadne odoberánie módov s tým nepohne.
5. ClassNotFoundException nie je vždy mód. Ak má server vlastné argumenty JVM, začni pri nich. Neuzavretá medzera v hodnote -D rozdelí argument, zvyšný token sa vezme ako hlavná trieda a výsledná chyba vyzerá presne ako zlyhaný mód. Poslať niekoho prehrábať sa v mods/ kvôli preklepu v nastaveniach je zle hneď dvakrát, a na serveri bez jediného módu dokonca trikrát.
6. Teraz už môžeš obviňovať mód. ModLoadingException, „missing or unsupported mandatory dependencies“, „loading errors have occurred“. V tejto fáze býva meno vo výpise naozaj ten vinník.
7. Address already in use znamená, že port drží niečo iné. Skoro vždy predchádzajúci proces, ktorý ešte nestihol skončiť.
Jeden riadok, ktorý nikdy nie je príčinou
Forge píše invalid dist DEDICATED_SERVER aj na úplne zdravých serveroch. Vyzerá to ako chyba, objaví sa to hneď na začiatku logu a neznamená to nič. Počas tohto testovania sme to dvakrát zapisovali ako príčinu, kým sme to neoverili proti serverom, ktoré bežali úplne v poriadku. Ak v logu hľadáš prvý znepokojivý reťazec, toto je ten, ktorý ti zožerie popoludnie.
Poctivý záver
Do testu sme išli s očakávaním, že zdokumentujeme rozbité modpacky, a zdokumentovali sme hlavne vlastné chyby. Tridsaťosem zo 48 opakovaných zlyhaní viedlo na stranu hostingu: zvolená zlá inštalačná cesta, nepripnutý build loadera, verzia prevzatá zo štítkov namiesto manifestu, príliš tenké odporúčania RAM. Balíky zverejňujú všetko, čo je na ich správne nabootovanie potrebné. Zlyhania vznikli z toho, že sa to nečítalo.
Z toho plynie aj rada pri výbere hostingu pre modpack: opýtaj sa, ako vyberajú serverové súbory, či pripínajú build loadera z manifestu a akú RAM odporúčajú pre tvoj konkrétny balík, a či to číslo pochádza z merania alebo z odhadu. Naše merania pre jednotlivé balíky dnes poháňajú odporúčania RAM na stránkach modpackov a pozadie k dimenzovaniu nájdeš v článku koľko RAM potrebuje Minecraft server.
Modpackový server, ktorý nechce naštartovať, nie je takmer nikdy záhada. Je to jedna zo šiestich príčin a päť z nich sa dá overiť do desiatich minút s crash logom a manifestom balíka pred sebou.