Project Zomboid -palvelimet voivat kaatua tai jättää käynnistymättä useista tunnetuista syistä. Tämä opas käsittelee yleisimpiä syitä, joita Legion Hostingin tukipyynnöissä on havaittu — Build 42 -muistivirheestä, joka vaatii ylimääräistä RAM-muistia käynnistyksessä, varmuuskopioiden ylivuotoon, joka täyttää /tmp-kansion, ja vioittuneisiin määritystiedostoihin. Käy alla olevat osiot läpi järjestyksessä.

Ennen kuin aloitat — Etsi kaatumislokit

Lähes jokainen Project Zomboid -kaatuminen jättää jäljen toiseen kahdesta paikasta. Tarkista molemmat ennen minkään korjauksen yrittämistä, jotta tiedät, mikä tämän oppaan osio koskee sinua.

GPanel-konsolin tuloste

1. Kirjaudu sisään GPaneliin.
2. Valitse Project Zomboid -palvelimesi palvelinlistasta.
3. Napsauta Console-välilehteä.
4. Selaa tulosteen alaosaan. Etsi rivejä, joissa lukee ERROR, FATAL, OutOfMemoryError tai Exception. Viimeiset 20–30 riviä ennen palvelimen pysähtymistä ovat yleensä merkityksellisimpiä.
5. Jos konsoli on tyhjä, palvelinprosessi päättyi ennen kuin se ehti kirjoittaa mitään — tämä on itsessään vihje (katso alla oleva B42-muistiosio).

Palvelimen debug.log-tiedosto

Project Zomboid kirjoittaa yksityiskohtaisen lokin debug.log-tiedostoon palvelimen tietohakemistossa. Tämä tiedosto sisältää usein täydellisen Java-pinojäljen, joka osoittaa suoraan kaatumisen syyhyn.

1. Mene GPanelissa File Manager -välilehdelle.
2. Siirry hakemistoon /.cache/Logs/. Näet tiedostoja, joiden nimet ovat esimerkiksi debug.log, DebugLog-server.txt tai päivättyjä lokitiedostoja.
3. Avaa uusin lokitiedosto. Käytä Ctrl+End tai selaa aivan alaosaan ja lue sieltä ylöspäin.
4. Etsi avainsanoja OutOfMemoryError, IOException, NullPointerException tai SandboxVars. Kopioi olennaiset rivit — tarvitset niitä, jos avaat tukipyynnön.

Korjaus 1 — Build 42:n korkea muistinkäyttö käynnistyksessä (tunnettu pelivirhe)

Jos palvelimesi sulkeutuu välittömästi käynnistyksen yhteydessä ilman virhettä konsolissa tai konsoli näyttää OutOfMemoryError- tai Java-keon tilavirheen, palvelimelta loppuu muisti ennen kuin maailman lataus on valmis.

Oireet

• Palvelin käynnistyy, konsoli vierittyy muutaman sekunnin ja pysähtyy ilman pelaajalle näkyvää virhettä.
• Konsoli näyttää java.lang.OutOfMemoryError: Java heap space tai GC overhead limit exceeded.
• Palvelin toimii joillakin uudelleenkäynnistyksillä mutta ei toisilla (muistin saatavuus vaihtelee).
• Palvelin toimi hyvin B41:ssä, mutta kaatuu johdonmukaisesti B42:een päivittämisen jälkeen.

Vaiheet

1. Napsauta GPanelissa palvelintasi ja mene Console-välilehdelle. Huomaa palvelimesi nykyinen RAM-varaus, joka näkyy resurssipalkissa tai palvelimen tietopaneelissa.
2. Jos pakettisi sisältää vähemmän kuin 10 Gt RAM-muistia, palvelin voi kaatua käynnistyksen aikana, koska B42 vaatii noin 9 Gt alustukseen. Sinun on päivitettävä pakettisi tai odotettava, että Indie Stone julkaisee korjauksen.
3. Jos paketissasi on jo 10 Gt tai enemmän ja palvelin kaatuu silti käynnistyksessä, mene Startup-välilehdelle GPanelissa.
4. Etsi kenttä, jonka nimi on Java Memory, Max RAM tai Xmx. Varmista, että se on asetettu enintään 80–85 %:iin käytettävissä olevasta kokonais-RAM-muististasi. Esimerkiksi 12 Gt:n paketissa aseta se arvoon 10240 (10 Gt megatavuissa). Älä aseta sitä yhtä suureksi tai suuremmaksi kuin kokonais-RAM — käyttöjärjestelmä ja muut prosessit tarvitsevat myös muistia.
5. Napsauta Save Startup-välilehdellä ja käynnistä palvelin uudelleen.
6. Tarkkaile konsolia käynnistyksen aikana. Jos palvelin saavuttaa rivin SERVER STARTED tai LuaManager: Loading lua files... valmistuu kaatumatta, muistivaraus on nyt riittävä.

Korjaus 2 — BackupsOnStart ylittää /tmp:n (kaatuminen käynnistyksessä)

Project Zomboid voidaan määrittää luomaan täysi maailman varmuuskopio joka kerta, kun palvelin käynnistyy. Kun tämä varmuuskopio kirjoitetaan /tmp-kansioon — jonka koko on rajoitettu useimmilla Linux-isännillä — palvelin kaatuu kesken käynnistyksen levynkirjoitusvirheeseen, kun /tmp täyttyy.

Oireet

• Palvelin kaatuu luotettavasti jokaisella uudelleenkäynnistyksellä, mutta toimi aiemmin.
• Konsoli tai debug.log sisältää virheitä, kuten IOException: No space left on device tai mainintoja kirjoittamisesta /tmp/-kansioon.
• Kaatumiset pahenevat ajan myötä, kun maailman tallennus kasvaa.
• Palvelin käynnistyy joskus, jos yrität pian isäntäsolmun puhtaan uudelleenkäynnistyksen jälkeen (ennen kuin /tmp täyttyy uudelleen).

Vaiheet — Poista BackupsOnStart käytöstä

1. Mene GPanelissa File Manager -välilehdelle.
2. Siirry hakemistoon /.cache/server/. Etsi palvelimesi määritystiedosto — sen nimi on tyypillisesti servertest.ini tai palvelimesi nimi, jota seuraa .ini (esim. MyServer.ini).
3. Avaa .ini-tiedosto muokkausta varten.
4. Käytä selaimen hakutoimintoa (Ctrl+F) etsiäksesi BackupsOnStart.
5. Muuta arvo true arvoon false:

   BackupsOnStart=false

6. Tarkista tiedostossa myös BackupsOnVersionChange-asetus ja aseta se arvoon false, jos levytila on huolenaihe:

   BackupsOnVersionChange=false

7. Tallenna tiedosto ja käynnistä palvelin uudelleen. Tarkkaile konsolia varmistaaksesi, että palvelin saavuttaa SERVER STARTED -rivin.

Korjaus 3 — Vioittunut SandboxVars.lua tai palvelimen määritys

Project Zomboid tallentaa maailman asetukset Lua-tiedostoon nimeltä SandboxVars.lua. Jos tätä tiedostoa muokataan manuaalisesti ja tallennetaan syntaksivirheellä, tai jos tiedostonsiirto keskeytyi, palvelin kaatuu välittömästi käynnistyksessä, kun se yrittää jäsentää tiedoston.

Oireet

• Konsoli näyttää ERROR: SandboxVars, LuaManager error tai Lua-jäsennysvirheen rivinumerolla.
• Kaatuminen alkoi tapahtua heti sen jälkeen, kun muokkasit asetuksia .ini-tiedostossa tai SandboxVars.lua-tiedostossa suoraan.
• Palvelin saattaa näyttää Bad argument #1 to tai vastaavia Lua-suoritusaikavirheitä.

Vaiheet — Tarkista ja korjaa SandboxVars.lua

1. Mene GPanelissa File Manager -välilehdelle ja siirry hakemistoon /.cache/saves/multiplayer/<YourServerName>/.
2. Avaa SandboxVars.lua muokkausta varten.
3. Tarkista, että tiedosto alkaa VERSION = 1, (tai vastaavalla) SandboxVars = { -lohkon sisällä ja päättyy sulkevaan }-merkkiin. Mikä tahansa puuttuva pilkku, sulkematon aaltosulku tai harhautunut merkki aiheuttaa jäsennysvian.
4. Jos et voi tunnistaa virhettä, turvallisin korjaus on poistaa SandboxVars.lua kokonaan. Palvelin luo sen uudelleen oletusarvoilla seuraavassa käynnistyksessä. Huomaa: tämä nollaa hiekkalaatikkoasetuksesi (saalis, zombimäärä jne.) oletusarvoihin — karttadataasi ja pelaajadataasi ei vaikuteta.
5. Tarkista myös .ini-tiedosto kansiossa /.cache/server/ samanlaisten ongelmien varalta, jos olet hiljattain muokannut sitä käsin. Varmista, että jokainen rivi noudattaa Key=Value-muotoa ilman tyhjiä rivejä arvon sisällä.
6. Tallenna muutokset ja käynnistä palvelin uudelleen.

Korjaus 4 — Tyhjä admin-salasana aiheuttaa kaatumisen

Project Zomboid vaatii ei-tyhjän admin-salasanan moninpelipalvelimen käynnistämiseen. Jos salasanakenttä on tyhjä, palvelinprosessi sulkeutuu välittömästi, kun se yrittää alustaa admin-tilin.

Oireet

• Aivan uusi palvelin tai hiljattain nollattu palvelin epäonnistuu joka käynnistysyrityksellä.
• Konsolitulos on hyvin lyhyt — palvelin tulostaa muutaman alustusrivin ja sitten pysähtyy.
• debug.log saattaa sisältää viittauksen admin-tiliin tai salasanan vahvistukseen.

Vaiheet

1. Napsauta GPanelissa palvelintasi ja mene Startup-välilehdelle.
2. Etsi kenttä, jonka nimi on Admin Password tai RCON Password. Varmista, että se sisältää arvon — se ei saa olla tyhjä.
3. Jos kenttä on tyhjä, syötä salasana. Käytä vähintään 8 merkkiä. Vältä erikoismerkkejä kuten !, #, $ tai @ admin-salasanassa, sillä jotkin PZ-versiot eivät jäsennä niitä oikein käynnistysargumenteissa.
4. Napsauta Save ja käynnistä palvelin uudelleen.
5. Toissijaisena tarkistuksena avaa .ini-tiedosto kansiossa /.cache/server/ ja varmista, että rivillä AdminPassword= on arvo yhtäsuuruusmerkin jälkeen.

Korjaus 5 — Maailman nollaus (viimeinen keino jatkuvien kaatumisten varalta)

Jos maailman tallennus vioittuu — esimerkiksi kovan palvelinkaatumisen, epäonnistuneen päivityksen tai tiedostojärjestelmävirheiden jälkeen — itse tallennusdata voi olla palautumaton. Tässä tapauksessa maailman poistaminen ja tuoreelta aloittaminen on ainoa vaihtoehto.

Vaiheet

1. Pysäytä palvelimesi GPanelissa ennen kuin teet muutoksia tallennustiedostoihin. Käynnissä olevan palvelimen tiedostojen muokkaaminen voi aiheuttaa lisävaurioita.
2. Mene GPanelissa File Manager -välilehdelle.
3. Siirry hakemistoon /.cache/saves/multiplayer/.
4. Näet yhden tai useamman kansion palvelimesi nimellä (esim. servertest). Ennen poistamista voit halutessasi ladata kansion varmuuskopioksi valitsemalla sen ja käyttämällä latausvaihtoehtoa — jopa vioittunut tallennus voi olla osittain palautettavissa myöhemmin.
5. Poista palvelimesi nimeä vastaava kansio Multiplayer/-kansion sisältä. Älä poista itse Multiplayer-kansiota.
6. Siirry myös hakemistoon /.cache/db/ ja poista <YourServerName>.db-tiedosto. Tämä tietokanta sisältää pelaajatilastoja ja saattaa viitata vanhaan maailmaan — sen uudelleengeneroiminen välttää epäjohdonmukaisuudet.
7. Käynnistä palvelimesi. Se luo tuoreen maailman käyttäen .ini-tiedoston asetuksia.

Pikadiagnostiikan viite

Yhä kaatuu kaikkien vaiheiden jälkeen?