Naar hoofdinhoud springen

Gebruikers overdragen tussen FASTPANEL-servers

Inleiding​

Dit artikel beschrijft het proces van het overdragen van gebruikersaccounts en de bijbehorende gegevens (websites, databases, e-mail, enz.) van de ene FASTPANEL-server naar de andere met behulp van het ingebouwde migratiehulpprogramma.

Belangrijke termen​

  • Bronserver - De server waarvan gegevens worden overgedragen.
  • Doelserver - De server waarnaar gegevens worden overgedragen.

Belangrijke opmerkingen​

  • Migratie werkt standaard alleen correct voor sites met een standaard FASTPANEL-configuratie.

  • Sites met wijzigingen in de handmatige configuratie kunnen alleen worden overgedragen als de vlag -m wordt gebruikt voor IP-adrestoewijzing.

  • Als een versleuteld wachtwoord voor een database-eigenaar niet beschikbaar is, wordt de database niet overgedragen.

  • Als een website niet wordt overgedragen, worden de bijbehorende databases ook niet overgedragen.

  • Alleen lokale databases kunnen worden overgedragen.

Migratieproces​

Verbinding​

De doelserver maakt via SSH verbinding met de bronserver. Tijdens de eerste verbinding installeert de doelserver een SSH-sleutel op de bronserver (ofwel vooraf verstrekt of gegenereerd op basis van een wachtwoord).

Migratiestappen​

  • Module-installatie
  • Informatie verzamelen over overdraagbare objecten
  • Gebruikers aanmaken
  • SSL-certificaten overdragen
  • Websites, FTP-accounts, e-maildomeinen en e-mailaccounts aanmaken
  • Databases en databasegebruikers aanmaken
  • Websitebestanden en e-mailpostvakbestanden overdragen
  • Cronjobs overdragen

Bestandsoverdracht wordt uitgevoerd met rsync. Databases worden overgedragen door een dump te maken via een SSH-tunnel.

Opdracht om migratie te starten​

De opdracht wordt uitgevoerd op de doelserver als een gebruiker met rootrechten:

/usr/local/fastpanel2/fastpanel transfer run [SSH_PARAMETERS] [IP_PARAMETERS] [ADDITIONAL_OPTIONS]

Opdrachtregelvlaggen​

SSH-verbinding​

  • --remote_host="SOURCE_IP" - IP-adres van de bronserver.
  • --remote_port="SSH_PORT" - SSH-poort.
  • --remote_username="SSH_USER" - Gebruiker (moet root zijn).
  • --remote_password="USER_PASSWORD" - Wachtwoord voor de opgegeven SSH-gebruiker.
  • --ssh_key_path="PATH_TO_KEY" - Pad naar de privésleutel voor SSH op de doelserver om verbinding te maken met de bronserver. Als een sleutel wordt gebruikt, is het wachtwoord (--remote_password) niet nodig.

IP-adressen​

U moet slechts één van de volgende vlaggen gebruiken om IP-adressen van sites tijdens de overdracht te beheren. De vlag -m heeft prioriteit.

  • -i "IP_ADDRESS_ON_DESTINATION" - Wijst het opgegeven IP-adres toe aan alle overgedragen sites op de doelserver. Om meerdere IP's op te geven (bijvoorbeeld als er meerdere op de bronserver waren), herhaalt u de vlag voor elk bron-IP dat moet worden overgedragen.

  • -m "SOURCE_IP,DESTINATION_IP" - Aanbevolen methode. Stelt een directe toewijzing in: alle sites die SOURCE_IP gebruiken op de bronserver, gebruiken DESTINATION_IP op de doelserver. Deze vlag kan meerdere keren worden opgegeven voor verschillende IP-paren. Verplicht voor het overdragen van sites met handmatige configuratiebewerkingen, omdat hiermee IP-adressen in listen-richtlijnen correct kunnen worden vervangen.

Aanvullende instellingen​

  • --users="USER_LIST" - Draagt alleen de opgegeven gebruikers over (door komma's gescheiden). Als dit niet is opgegeven, worden alle gebruikers overgedragen.
  • --disable_disk_quota - Schakelt de overdracht van schijfquota van gebruikers uit.
  • --with_user_data - Omvat het kopiëren van de volledige inhoud van de homedirectories van gebruikers (behalve de subdirectory logs/). Wees voorzichtig met het gebruik hiervan, aangezien dit de overdrachtstijd en de hoeveelheid overgedragen gegevens aanzienlijk kan vergroten.
  • --only_data - Draagt alleen gegevens over (websitebestanden, e-mailbestanden, databasedumps). Nuttig als de initiële structuurmigratie (gebruikers, sites, DB's, enz.) succesvol was, maar er fouten optraden tijdens de fase van het kopiëren van bestanden of dumps. Maakt het mogelijk om alleen het deel voor het kopiëren van gegevens opnieuw uit te voeren.
  • --transfer_timeout - Stel de time-out voor de bewerking in (standaard is 60 minuten).

Voorbeeldopdracht​

Draag alle gebruikers over van server 11.22.33.44 naar de huidige server. Op de oude server gebruikten sites de IP's 11.22.33.44 en 11.22.33.55; op de nieuwe server moeten ze respectievelijk 99.88.77.66 en 99.88.77.67 gebruiken. Verbinding via SSH met een wachtwoord.

/usr/local/fastpanel2/fastpanel transfer run \
--remote_host=11.22.33.44 \
--remote_username=root \
--remote_password=YourSourceRootPassword \
-m 11.22.33.44,99.88.77.66 \
-m 11.22.33.55,99.88.77.67

Mogelijke problemen en fouttypen​

Een fout in het migratielogboek wijst niet altijd op een kritisch probleem, maar kan de reden aangeven waarom een specifiek object niet is overgedragen.

  • Conflicten: Treden op wanneer het overdragen van een object onmogelijk is vanwege de huidige configuratie van de doelserver (bijv. als een gebruiker of site met dezelfde naam al bestaat) of als de configuratie van de site op de bronserver onbekend is voor het paneel (bijv. door uitgebreide handmatige bewerkingen).

  • Ontbrekend opgeslagen wachtwoord: Zoals eerder vermeld, kunnen MySQL-databasegebruikers zonder een opgeslagen wachtwoord in FASTPANEL op de bronserver niet worden overgedragen.

  • Handmatige instellingen en IP-adressen: Als een site op de bronserver handmatige bewerkingen in de webserverconfiguratie heeft en de vlag -m niet wordt gebruikt tijdens de migratie om het IP-adres toe te wijzen, wordt zo'n site niet overgedragen omdat het paneel niet weet welk IP-adres in de configuratie op de doelserver moet worden opgegeven.