No final deste guia, o teu servidor RedM corre na versão de servidor da Cfx.re que escolheste: a recomendada, a mais recente ou um número de build fixo. Ficas a saber que ficheiros a atualização substitui e quais se mantêm. Além disso, conheces o caminho de volta, caso um recurso não funcione com o novo build.

Pré-requisitos

  • Um servidor RedM no teu painel de cliente. Só o proprietário do servidor pode reinstalá-lo.
  • Algum tempo em que ninguém esteja a jogar. O servidor para durante a atualização.

Como funciona a versão do servidor

A Cfx.re publica o servidor para RedM como um artefacto com um número de build. Na lista de versões da Cfx.re constam, entre outros, um build recomendado (recommended) e o build mais recente (latest). Os ficheiros propriamente ditos estão na página de artefactos da Cfx.re.

Segundo o projeto txAdmin, o txAdmin faz parte do servidor. Ou seja, ao atualizares o artefacto, também atualizas o txAdmin. A versão do txAdmin que corresponde a cada build também consta da lista de versões.

O teu servidor só descarrega o artefacto durante uma instalação. Um reinício normal não carrega uma nova versão.

Consultar a versão atual

Abre Files & worlds → Ficheiros e, aí, o ficheiro .gsh-cfx-installed na pasta de topo. A linha artifact= contém o endereço do artefacto instalado. O número antes do hífen no caminho é o número de build. Aponta-o antes de atualizares. Na próxima instalação, o ficheiro é substituído.

Escolher a versão

  1. Abre Game settings → Variáveis do servidor.
  2. No campo „Versão do artefacto Cfx.re“, introduz um destes valores:
    • recommended para o build recomendado pela Cfx.re. É o valor predefinido.
    • latest para o build mais recente.
    • Um número de build, por exemplo o número que apontaste, para te manteres num build específico.
  3. Guarda a alteração.

Se o número de build não existir na página de artefactos, o servidor instala o build recomendado. Durante a instalação, a consola mostra então Requested version … unavailable; using recommended.

Executar a atualização

  1. Cria uma cópia de segurança em Backups & recovery. O painel cria uma automaticamente antes de uma reinstalação, mas com uma tua sabes exatamente que estado é esse.
  2. Na barra de controlo do servidor, clica em Reinstalar.
  3. Confirma a reinstalação. Se o painel pedir o nome do teu servidor, escreve-o.
  4. Espera até a instalação terminar. Normalmente demora alguns minutos.
  5. Inicia o servidor e verifica na consola ou na „Live Console“ do txAdmin se o servidor arranca sem erros.

O que se mantém na atualização

A instalação substitui por completo a pasta alpine com os ficheiros do servidor. O seguinte mantém-se:

  • A pasta txData com a tua configuração do txAdmin, os teus administradores e a pasta do servidor criada na configuração.
  • Os teus próprios recursos na pasta resources. Do pacote padrão da Cfx.re só são adicionados os ficheiros que ainda lá não existem.
  • Um server.cfg existente na pasta de topo. A instalação apenas comenta nele os recursos que o FXServer já não inclui, como o sessionmanager, e só se não os tiveres instalado tu próprio.

Voltar à versão anterior

Se um recurso não funcionar com o novo build, volta a introduzir o número de build que apontaste em „Versão do artefacto Cfx.re“ e reinstala. Se isso não resolver, restaura a cópia de segurança em Backups & recovery. Na lista de versões, a Cfx.re indica em support_policy uma data de fim para builds mais antigos. Por isso, não fiques permanentemente num build antigo.

Erros comuns

Problema Causa e solução
Depois do reinício, a versão continua igual Um reinício não carrega uma nova versão. Executa Reinstalar.
Foi instalado o build recomendado em vez do teu O número de build não existe na página de artefactos. Verifica o número e introduz apenas algarismos.
A instalação é interrompida com Cfx.re returned no valid Linux artifact URL A Cfx.re não forneceu um endereço válido. Tenta novamente mais tarde ou escolhe recommended.
A instalação indica Incomplete Cfx.re artifact A transferência ficou incompleta. Inicia a instalação novamente.
Reinstalar não está disponível Só o proprietário do servidor pode reinstalar. Inicia sessão com essa conta.
Um recurso não arranca depois da atualização Lê a linha de erro na consola. Se necessário, volta ao número de build que apontaste.

Próximos passos

Como configurar administradores, horários de reinício e a allowlist no txAdmin está explicado em Administradores e reinícios no txAdmin. Encontras slots e localizações na página de compra do RedM.