Server artifacts FiveM obsoleti: come aggiornare FXServer in sicurezza

txAdmin mostra un avvertimento che i tuoi server artifacts sono obsoleti, o una risorsa chiede una build più recente di quella che esegui. La correzione è sostituire il programma FXServer con una build attuale. Richiede cinque minuti se mantieni i tuoi dati separati da esso, e così si fa.

#Cosa sono gli artifacts

Gli "artifacts" sono i binari di FXServer: il programma che esegue il tuo server. Non sono le tue risorse e non sono la tua configurazione. Un layout tipico è così:

FXServer/
  server/          <- artifacts (FXServer.exe or run.sh and its files)
  server-data/     <- your server.cfg and resources
  txData/          <- txAdmin data and profiles

L'aggiornamento significa sostituire quello che è nella cartella degli artifacts. Non tocchi gli altri due. Se le tue cartelle sono mescolate insieme, scopri cosa è cosa prima di sostituire qualcosa: la cartella degli artifacts è quella che contiene FXServer.exe su Windows o run.sh su Linux.

#Consigliato o più recente

Le pagine di download contrassegnano due build vicino alla parte superiore:

• Consigliato: la build che Cfx.re considera stabile. Sceglilo per un server live.
• Più recente: la build più nuova. Ha i fix e le funzioni più recenti, e una chance più alta di nuovi bug.

Se txAdmin ti dice che è necessaria una build specifica e quella consigliata è più vecchia di quella, prendi una build più recente dall'elenco. Non passare a quella più recente solo perché è la più recente.

#Dove scaricare

Le build sono ospitate da Cfx.re su runtime.fivem.net:

• Windows: https://runtime.fivem.net/artifacts/fivem/build_server_windows/master/
• Linux: https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/

Scarica da queste pagine solo. Non prendere build di server da un post del forum, un file Discord o un sito di terze parti.

Su Windows ottieni un archivio server.7z, che apri con 7-Zip. Su Linux ottieni un archivio fx.tar.xz.

#Fai il backup prima

Prima di sostituire qualcosa, copia:

1. La cartella degli artifacts attuale (l'intera cartella server).
2. La tua cartella server-data, o almeno server.cfg e resources.
3. La cartella txData.
4. Un dump del tuo database, se ce n'è uno. Usa il tuo solito strumento, o mysqldump sulla macchina.

Se la nuova build si comporta male, puoi rimettere la vecchia cartella e essere di nuovo in esecuzione in un minuto.

Attenzione: ferma completamente il server e txAdmin prima di sostituire i file. Sovrascrivere FXServer mentre gira fallisce su Windows, e su Linux lascia un mix rotto di file vecchi e nuovi.

#Aggiornamento su Windows

1. Ferma il server e chiudi txAdmin.
2. Scarica server.7z della build che vuoi.
3. Rinomina la vecchia cartella degli artifacts, ad esempio in server_old.
4. Crea una nuova cartella server ed estrai l'archivio al suo interno.
5. Avvia FXServer.exe nel modo che hai fatto prima, dallo stesso posto e con lo stesso collegamento o argomenti.

txAdmin trova il suo txData dal percorso che gli hai dato, e non l'hai cambiato, quindi il tuo profilo, le impostazioni e gli admin sono ancora lì.

#Aggiornamento su Linux

sudo systemctl stop fivem        # or stop the screen session

cd ~/fivem
mv server server_old
mkdir server && cd server

wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/<build>/fx.tar.xz
tar xf fx.tar.xz
rm fx.tar.xz

Sostituisci <build> con il nome della cartella che copi dalla pagina di download. Riavvia il server con il tuo solito comando o servizio. Se non l'hai ancora configurato, vedi esecuzione di un server FiveM su Linux.

#Verifica che abbia funzionato

All'avvio, la console stampa la versione di FXServer. Confrontala con il numero di build nella pagina di download. txAdmin mostra anche la versione sul suo dashboard, e l'avvertimento obsoleto dovrebbe essere scomparso.

Se qualcosa si rompe dopo l'aggiornamento:

• Le risorse non si avviano: leggi il primo errore nella console. Una risorsa che dipendeva da un comportamento vecchio potrebbe aver bisogno di un aggiornamento. Vedi couldn't start resource.
• Il server non si avvia affatto: rimetti la vecchia cartella server_old, avviala, e segnala il numero di build che ha fallito.
• Un nuovo avvertimento sulla build del gioco: questa è un'impostazione diversa, vedi sv_enforceGameBuild e DLC.

#Con quale frequenza aggiornare

Non devi inseguire ogni build. Una regola ragionevole: aggiorna quando txAdmin ti avverte, quando una risorsa ha bisogno di una build più recente, o quando colpisci un bug che una build più recente risolve. Prova sempre un aggiornamento su una copia del server per primo se esegui server pagati o occupati, e fallo quando poche persone sono online.

#Checklist