La ricetta non termina con "Duplicate entry '1' for key 'PRIMARY'"

Il database è già popolato da un'installazione precedente, quindi i dati di seed della ricetta entrano in conflitto con quelli presenti. Il "Delete Database" di txAdmin spesso non lo svuota, perché non tocca l'operatore di sincronizzazione. Apri il server nella tua dashboard e usa il pulsante Reimposta database nell'intestazione del pannello: svuota il database su tutti i tuoi nodi mantenendo i file del server e la configurazione di txAdmin, così puoi rieseguire la ricetta in modo pulito. Cancella tutti i dati di gioco: di norma è un'installazione che non ha ancora memorizzato nulla, ma se hai dei dati, fai prima un dump SQL (il backup dell'operatore di sincronizzazione), perché il backup del volume non può ripristinare un database attivo.

Come configurare txAdmin sul tuo server FiveM

Il tuo server viene distribuito con txAdmin attivo e il server di gioco volutamente trattenuto. Cinque passaggi nella procedura guidata lo portano online, e uno di essi, la connessione al database, è il punto in cui quasi tutti si fermano, perché i suoi campi sono nascosti dietro un pulsante. Il pulsante e i valori sono in questa pagina.

Primo: un server offline è normale qui

Una distribuzione FiveM nuova avvia txAdmin e nient'altro. La porta di gioco resta silenziosa di proposito finché non hai reclamato l'account admin, fornito una chiave di licenza e scelto una build del server, perché un server FiveM senza nessuna di queste non può partire. Quindi nei primi minuti dopo la distribuzione, la dashboard che mostra il server come non ancora in grado di accettare giocatori è lo stato previsto, non un guasto.

La dashboard lo indica chiaramente: la scheda del server diventa arancione con Azione richiesta: completa la configurazione in txAdmin, e aprendola ottieni il link a txAdmin e il PIN descritto sotto. Niente in questa pagina richiede un ticket di supporto.

I cinque passaggi

1. Apri txAdmin

Non devi cercare un indirizzo. Nella tua dashboard, il banner arancione sulla scheda del server apre un pannello con un pulsante Apri txAdmin, e lo stesso pulsante compare nella scheda Players dopo aver cliccato Manage. Punta al dominio txAdmin del tuo server, che continua a funzionare dopo un failover perché si risolve sempre nell'istanza attualmente primaria. Per questo lo linkiamo invece di stampare un IP del nodo: un IP è corretto finché un giorno non lo è più.

2. Reclama l'account admin con il PIN

Al primo avvio txAdmin chiede un PIN che stampa solo nella console del server, e poi ti chiede di creare un username e una password master admin per il pannello stesso. Su un server gestito quella console di solito non la vedi, quindi la dashboard legge il PIN dal log del container e lo mostra nello stesso pannello del pulsante txAdmin, pronto da copiare.

Il login master admin non è il tuo account Flux, né il tuo account Cfx.re, né la password del database. È una terza credenziale, è la via di ritorno nel tuo pannello, e nessuno può resettarla per te. Salvala prima di andare avanti. Se il PIN è scaduto quando lo usi, riavvia il server dalla dashboard e ne viene stampato uno nuovo.

3. Scegli una build del server

La procedura guidata offre poi una ricetta o un server esistente. Una ricetta come qbcore, qbox o ESX scarica il framework, le sue risorse e il suo schema SQL, e importa lo schema nel tuo database, che è la via più rapida verso un server roleplay funzionante. Scegline una e txAdmin la mostra in una schermata chiamata Step 1: Review Recipe. Continua, e arrivi a Step 2: Input Parameters, dove avvengono i due passaggi successivi.

4. Aggiungi la tua chiave di licenza cfx.re

Il primo campo in Input Parameters è Server Registration Key. Genera una chiave gratuita su portal.cfx.re e incolla il valore cfxk_. La chiave è emessa al tuo account e non al nostro, ed è il motivo per cui il server è tuo da spostare; la distribuzione imposta NO_LICENSE_KEY=1 così che venga fornita qui invece che incorporata nell'app. Se in futuro rigeneri la chiave, puoi cambiarla dopo senza rifare la procedura guidata: è un campo nella scheda Impostazioni del server del pannello di gestione.

5. Apri le opzioni del database e collega il database

Questo è il passaggio che genera più ticket di supporto, perché i campi del database sono nascosti. Subito sotto la chiave c'è un pulsante grigio, Show/Hide Database options (advanced). Cliccalo. Solo allora compaiono i campi Host, Porta, Nome utente, Password e Nome del database. Se salti il pulsante, la ricetta parte con i valori predefiniti di txAdmin e la connessione al database fallisce.

I campi arrivano precompilati, con localhost come host e 3306 come porta. Quei valori predefiniti sono sbagliati su questo server. Sostituisci il contenuto di ogni campo con questi valori:

Campo	Valore	Perché
Host	operator	L'operatore di sincronizzazione, non il container del database
Port	3307	La porta su cui l'operatore è in ascolto all'interno della tua app
Username	root	Impostato dalla specifica, non modificabile
Password	MYSQL_ROOT_PASSWORD	Quello che hai scelto al momento della distribuzione. Mostralo in Impostazioni di distribuzione
Database	fivem	Creato vuoto per te prima dell'avvio del server

L'host è l'operatore di sincronizzazione e non il container del database, la password è quella scelta alla distribuzione, e il database stesso viene creato vuoto per te prima che il server parta.

La password si trova nel pannello di gestione sotto Impostazioni di distribuzione, come MYSQL_ROOT_PASSWORD, con un pulsante per rivelarla e uno per copiarla. Il pannello stampa anche questi quattro valori fissi su una scheda accanto, così puoi copiarli direttamente in txAdmin senza tornare qui.

Due ipotesi meritano di essere nominate, perché entrambe sono sbagliate e sembrano giuste. L'host non è localhost: txAdmin e il database sono container separati. L'host non è neppure mariadb, anche se esiste un componente con quel nome. Tutto passa dall'operatore, che replica ogni scrittura sulle altre istanze; scrivere direttamente su un singolo MariaDB desincronizzerebbe la tua città e la perderebbe a un failover.

Poi esegui la ricetta. txAdmin scarica l'artifact di FiveM, importa lo schema, scrive server.cfg e avvia il server, e la tua dashboard diventa verde in pochi minuti. Se hai scelto un server esistente invece di una ricetta, non ci sono campi del database da compilare: imposta la connessione nel tuo server.cfg, come mostrato nelle domande qui sotto.

Se txAdmin dice che non riesce a connettersi

Controlla prima host e porta, perché localhost e mariadb sono le ipotesi comuni e nessuna delle due funziona. Se quelli sono corretti, è un mancato accordo sulla password. Il database è predisposto con MYSQL_ROOT_PASSWORD e l'operatore si autentica con DB_INIT_PASS, e i due devono essere identici perché il database venga inizializzato. Il pannello li tiene collegati proprio per questo: modificarne uno riscrive l'altro, e il campo è segnato come collegato, così il comportamento non sembra un modulo che rifiuta il tuo input. Quello che digiti in txAdmin deve essere quello stesso valore.

Come rientrare dopo

Dopo la procedura guidata, txAdmin è il pannello quotidiano: console live, risorse, ban, l'editor CFG e i riavvii programmati. Lo stesso pulsante Apri txAdmin ti porta lì, e accedi con l'account master admin del passaggio 2. La dashboard tiene il livello sottostante: riavvii e ridistribuzioni, il browser dei file, l'hardware, lo stato del database su tutti i nodi e i backup.

Non ancora distribuito?

txAdmin al proprio indirizzo, il database creato e collegato prima che si carichi la prima risorsa, e entrambe le porte pubblicate senza un firewall da toccare. Prima settimana gratis se il tuo account Flux è nuovo.

Domande frequenti

Cosa inserisco nelle impostazioni del database di txAdmin?

Per prima cosa clicca Show/Hide Database options (advanced) nella schermata Input Parameters, sotto la chiave di registrazione, perché i campi restano nascosti finché non lo fai. Poi sostituisci i valori precompilati con host operator, porta 3307, nome utente root, database fivem e la MYSQL_ROOT_PASSWORD scelta alla distribuzione. txAdmin non trova l'operatore da solo. La password si rivela e si copia da Impostazioni di distribuzione nel pannello di gestione.

Perché il mio server FiveM è offline subito dopo la distribuzione?

Perché non è ancora stato configurato, ed è voluto. La distribuzione parte senza configurazione predefinita e senza chiave di licenza, quindi txAdmin si avvia al proprio indirizzo e la porta di gioco resta silenziosa finché non reclami l'account admin, aggiungi la tua chiave cfx.re e distribuisci una build del server. Va online qualche minuto dopo la fine della procedura guidata.

Dove trovo il PIN di txAdmin?

Nella tua dashboard. txAdmin la stampa solo nella console del server, quindi la dashboard la legge dal log del container e la mostra, pronta da copiare, accanto al pulsante Apri txAdmin. Se è scaduta, riavvia il server e ne viene stampata una nuova.

Posso collegarmi direttamente a MariaDB invece?

No, e vale la pena sapere perché. Ogni scrittura deve passare dall'operatore sulla porta 3307, che la replica sulle altre istanze. Puntare qualsiasi cosa direttamente a un container MariaDB scrive su una sola macchina, e quei dati sono quelli che perdi la prossima volta che cambia il primario.

Devo usare una ricetta come qbcore o ESX?

No. Una ricetta è il percorso più veloce perché importa per te lo schema SQL del framework nel tuo database, ma l'opzione vuota c'è per chi porta una build esistente. In ogni caso puoi caricare risorse dal browser dei file e importare un dump SQL in seguito.

Nessuna risorsa riesce a raggiungere il database: «mysql_connection_string structure was invalid»

La password del database contiene un carattere che in un URL va codificato in percent-encoding, come @, % o ^, quindi la stringa mysql:// che oxmysql costruisce non è un URI valido e nulla si connette. Non devi cambiare la password né ricostruire niente: metti invece la forma con il punto e virgola in server.cfg, perché viene letta alla lettera invece di essere interpretata come URL. Usa set mysql_connection_string "server=operator;port=3307;user=root;password=YOUR_PASSWORD;database=fivem" con la password di Impostazioni di distribuzione, e riavvia. I server distribuiti da qui in poi ricevono già una password sicura in un URL, quindi questo riguarda solo quelli più vecchi, e la dashboard li segnala sulla scheda del server con entrambe le soluzioni: questa, e una rigenerazione e ricostruzione guidata per un'installazione senza dati da conservare.

La ricetta non si completa: «Duplicate entry ‘1’ for key ‘PRIMARY’»

Il database è già popolato da un'installazione precedente, quindi i dati seed della ricetta entrano in conflitto con quelli che ci sono. Il pulsante «Delete Database» di txAdmin spesso non lo svuota, perché non tocca l'operatore di sincronizzazione. Apri il server nella dashboard e usa il pulsante Reset database nell'intestazione del pannello: svuota il database su tutti i nodi mantenendo i file del server e la configurazione di txAdmin, così puoi rieseguire la ricetta in modo pulito. Cancella tutti i dati di gioco. Normalmente è un'installazione che non ha ancora salvato nulla, ma se hai dei dati, fai prima un dump SQL (il backup dell'operatore di sincronizzazione), perché il backup del volume non può ripristinare un database attivo.

Ho perso la password master admin di txAdmin. Puoi resettarla?

Non da parte nostra: quell'account vive dentro txAdmin sul tuo server e non nella nostra fatturazione o nella dashboard, quindi non abbiamo nulla da resettare. Si recupera dal server stesso, e il pannello di gestione ti dà la console e il browser dei file di cui hai bisogno. Apri un ticket di supporto e ti guidiamo, perché non è un motivo per ridistribuire e perdere la città.