Aan het einde van deze handleiding draait je RedM-server op de serverversie van Cfx.re die je hebt gekozen: de aanbevolen versie, de nieuwste of een vast buildnummer. Je weet welke bestanden de update vervangt en welke blijven. Daarnaast ken je de weg terug als een resource niet werkt met de nieuwe build.

Vereisten

  • Een RedM-server in je klantenpaneel. Alleen de eigenaar van de server kan opnieuw installeren.
  • Wat tijd waarin niemand speelt. De server stopt tijdens de update.

Hoe de serverversie werkt

Cfx.re publiceert de server voor RedM als artefact met een buildnummer. In de versielijst van Cfx.re staan onder andere een aanbevolen build (recommended) en de nieuwste build (latest). De bestanden zelf staan op de artefactpagina van Cfx.re.

Volgens het txAdmin-project is txAdmin een onderdeel van de server. Met het artefact werk je dus ook txAdmin bij. Welke txAdmin-versie bij welke build hoort, staat eveneens in de versielijst.

Je server haalt het artefact alleen op bij een installatie. Een normale herstart laadt geen nieuwe versie.

Huidige versie aflezen

Open Files & worlds → Bestanden en daarin het bestand .gsh-cfx-installed in de bovenste map. De regel artifact= bevat het adres van het geïnstalleerde artefact. Het getal vóór het streepje in het pad is het buildnummer. Noteer het voordat je bijwerkt. Bij de volgende installatie wordt het bestand overschreven.

Versie kiezen

  1. Open Game settings → Servervariabelen.
  2. Vul in het veld „Cfx.re-artefactversie” een van deze waarden in:
    • recommended voor de door Cfx.re aanbevolen build. Dit is de standaardinstelling.
    • latest voor de nieuwste build.
    • Een buildnummer, bijvoorbeeld het genoteerde getal, om bij een bepaalde build te blijven.
  3. Sla de wijziging op.

Is het buildnummer niet te vinden op de artefactpagina, dan installeert de server de aanbevolen build. In de console staat tijdens de installatie dan Requested version … unavailable; using recommended.

Update uitvoeren

  1. Maak onder Backups & recovery een back-up aan. Het paneel maakt vóór een herinstallatie weliswaar zelf een back-up, maar met een eigen back-up weet je precies welke stand dat is.
  2. Klik in de bedieningsbalk van de server op Opnieuw installeren.
  3. Bevestig de herinstallatie. Vraagt het paneel naar de naam van je server, typ die dan in.
  4. Wacht tot de installatie klaar is. Dat duurt meestal een paar minuten.
  5. Start de server en controleer in de console of in de „Live Console” van txAdmin of de server zonder fouten opstart.

Wat bij de update behouden blijft

De installatie vervangt de map alpine met de serverbestanden volledig. Het volgende blijft behouden:

  • De map txData met je txAdmin-configuratie, je admins en je servermap uit de configuratie.
  • Eigen resources in de map resources. Uit het standaardpakket van Cfx.re worden alleen bestanden toegevoegd die daar nog ontbreken.
  • Een bestaande server.cfg in de bovenste map. De installatie zet daarin alleen resources in commentaar die FXServer niet meer meelevert, zoals sessionmanager, en alleen als je ze niet zelf hebt geïnstalleerd.

Terug naar de oude versie

Werkt een resource niet met de nieuwe build, vul dan het genoteerde buildnummer weer in bij „Cfx.re-artefactversie” en installeer opnieuw. Helpt dat niet, zet dan de back-up terug via Backups & recovery. Cfx.re vermeldt in de versielijst onder support_policy een einddatum voor oudere builds. Blijf daarom niet permanent op een oude build.

Veelvoorkomende fouten

Probleem Oorzaak en oplossing
Na de herstart is de versie ongewijzigd Een herstart laadt geen nieuwe versie. Voer Opnieuw installeren uit.
De aanbevolen build is geïnstalleerd in plaats van jouw build Het buildnummer bestaat niet op de artefactpagina. Controleer het getal en vul alleen cijfers in.
Installatie breekt af met Cfx.re returned no valid Linux artifact URL Cfx.re heeft geen geldig adres geleverd. Probeer het later opnieuw of kies recommended.
Installatie meldt Incomplete Cfx.re artifact De download was onvolledig. Start de installatie opnieuw.
Opnieuw installeren is niet beschikbaar Alleen de eigenaar van de server mag opnieuw installeren. Log in met dat account.
Een resource start niet na de update Lees de foutregel in de console. Ga indien nodig terug naar het genoteerde buildnummer.

Volgende stappen

Hoe je admins, herstarttijden en de allowlist in txAdmin instelt, lees je in Admins en herstarts in txAdmin. Slots en locaties vind je op de RedM-bestelpagina.