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
- Open Game settings → Servervariabelen.
- Vul in het veld „Cfx.re-artefactversie” een van deze waarden in:
recommendedvoor de door Cfx.re aanbevolen build. Dit is de standaardinstelling.latestvoor de nieuwste build.- Een buildnummer, bijvoorbeeld het genoteerde getal, om bij een bepaalde build te blijven.
- 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
- 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.
- Klik in de bedieningsbalk van de server op Opnieuw installeren.
- Bevestig de herinstallatie. Vraagt het paneel naar de naam van je server, typ die dan in.
- Wacht tot de installatie klaar is. Dat duurt meestal een paar minuten.
- 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
txDatamet 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.cfgin de bovenste map. De installatie zet daarin alleen resources in commentaar die FXServer niet meer meelevert, zoalssessionmanager, 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.