A vezérlőpult átköltöztetése új doménre vagy aldoménre

A MainWP vezérlőpultot új doménre vagy aldoménre is átviheted (például dash.example.com címről mainwp.example.com címre), ugyanazon a szerveren vagy másikon. Ha a teljes WordPress-telepítést átviszed, a MainWP beállításai, az ügyfelek, a Child-webhelyek rekordjai és a kiegészítők adatbázisban tárolt adatai megmaradnak, nem kell újrakezdened.

Fontos: a domain keresés-cseréje előtt zárd ki a wp_mainwp_wp és a wp_mainwp_wp_sync táblát. A wp_ helyére a saját tábla-előtagodat írd. Ha a csere a Child-webhelyek címére is illeszkedik, megváltoztatja azokat, és megszakad a kapcsolat. A két táblát a mentésbe és az átvitelbe be kell venni, csak a keresés-cseréből kell kihagyni.

Előfeltételek

• Rendszergazdai hozzáférés a vezérlőpulthoz, és szükség esetén a Child-webhelyekhez.
• Hozzáférés a tárhely migrációs eszközeihez, a fájlokhoz és az adatbázishoz, vagy a tárhelyszolgáltatód segítsége.
• Friss, teljes mentés a vezérlőpult fájljairól és adatbázisáról.
• A Child-webhelyek helyes URL-jeinek listája az összehasonlításhoz.

Ha csak a szerver változik, a vezérlőpult címe viszont nem, olvasd el a vezérlőpult átköltöztetése másik szerverre fejezetet.

Mi marad meg az átvitelkor

Az adatbázis tartalmazza a MainWP beállításait, az ügyfeleket, a Child-webhelyek rekordjait és beállításait, valamint a kiegészítők adatbázisban tárolt adatait. A fájlok tartalmazzák a WordPressből, a MainWP vezérlőpultból, a telepített kiegészítőkből (például Pro Reports), a feltöltésekből és a titkosítókulcs-fájlokból álló telepítést. Mindkettőt másold át. Csak adatbázist átvinni nem elég: a kiegészítők kódja és a kapcsolati kulcsok visszafejtéséhez szükséges kulcsfájlok hiányoznának.

Őrizd meg a MainWP feltöltési mappáját teljes egészében. Ez általában a wp-content/uploads/mainwp/, benne a pk mappával. Ha a feltöltések helye egyedi, az ott lévő megfelelő mappát vidd át. Az átvitel után ellenőrizd a kiegészítők licencaktiválását az új címen. Előfordulhat, hogy újra kell aktiválni őket, de az ügyfeleket, a webhelyrekordokat és a jelentésbeállításokat nem kell újra létrehozni.

Honnan jön a kockázat

A MainWP a Child-webhelyek címeit a wp_mainwp_wp táblában tárolja. A keresés-csere csak akkor módosít egy Child-webhely URL-t, ha a keresett szöveg előfordul benne. Ha például az example.com szöveget az example.net szövegre cseréled az egész adatbázisban, a https://client.example.com cím https://client.example.net lesz. Ha a Child-webhely továbbra is az eredeti címen van, a vezérlőpult rossz címre próbál csatlakozni. Azok a Child-webhelyek, amelyek címe nem tartalmazza a keresett szöveget, nem változnak.

Egyes migrációs bővítmények és tárhelyek egykattintásos eszközei automatikusan cserélik az URL-eket. Indulás előtt nézd meg, melyik táblákat módosítják, és van-e külön kizárási lehetőségük kifejezetten a keresés-cserére. Az a beállítás, amely a táblát a migrációs mentésből zárja ki, nem helyettesíti ezt.

Teendők a domain módosítása előtt

1. Szinkronizáld a webhelyeket, és jegyezd fel az URL-jeiket. Nyisd meg a MainWP → Webhelyek → Webhelyek kezelése oldalt, és a fejlécben kattints a Szinkronizálás gombra. Jegyezd fel a Child-webhelyek jelenlegi címeit, vagy exportáld a webhelylistát az összehasonlításhoz. A webhelylista nem helyettesíti a teljes mentést.
2. Készíts és ellenőrizz teljes mentést. Mentsd a vezérlőpult teljes adatbázisát, az összes WordPress-fájlt és a beállításokat. Legyen benne a MainWP és a kiegészítők táblája, a telepített kiegészítők fájljai, valamint a MainWP feltöltési mappája a titkosítókulcs-fájlokkal. Mielőtt továbblépsz, győződj meg róla, hogy a mentés lefutott, és tartalmazza ezeket. Ha használod a beépített mentéseket, vidd át a privát mentési mappát is (lásd a másik szerverre költöztetést).
3. Erősítsd meg a keresés-csere kizárásait. Állítsd be az eszközben, vagy kérd meg a tárhelyszolgáltatót, hogy a wp_mainwp_wp és a wp_mainwp_wp_sync tábla kimaradjon az URL-cseréből. Ellenőrizd, hogy ugyanez érvényes az import vagy a visszaállítás közbeni automatikus cserére is. Ha az eszköz ezt nem tudja, kérj a tárhelytől ellenőrzött, kézi módszert.
4. Készítsd elő a célhelyet. Állítsd be az új domaint vagy aldomaint a vezérlőpult telepítésére, és gondoskodj érvényes HTTPS-tanúsítványról. Szerverváltásnál ellenőrizd, hogy az új szerver megfelel a MainWP vezérlőpult követelményeinek.

A telepítés átvitele

Szerverváltásnál vagy másik WordPress-mappába költözésnél vidd át a teljes adatbázist és a fájlokat. Őrizd meg a MainWP és a kiegészítők adatait és a titkosítókulcs-fájlokat. Ha kell, frissítsd az adatbázis-kapcsolat adatait a wp-config.php fájlban. Csak domaint érintő módosításnál a meglévő fájlok és adatbázis a helyén maradnak. Mindkét esetben az alábbi módszerek egyikével frissítsd a vezérlőpult saját WordPress-címeit, és védd meg a Child-webhelyek adatait.

Az eredeti mentést tartsd meg az ellenőrzés végéig. Az átvitel után az új vezérlőpult az aktív telepítés. A régi másolaton állítsd le az ütemezett feladatokat, hogy két példány ne kezelje ugyanazokat a Child-webhelyeket.

Az URL-ek megsérülésének megelőzése

1. módszer: táblák kizárása WP-CLI-vel

Szerverváltásnál a parancsot a célszerveren visszaállított vezérlőpulton futtasd. Csak domainváltásnál a meglévő telepítésen. A példacímeket cseréld a vezérlőpult teljes régi és új címére, a séma (https://) és az esetleges mappa is számít. Mindkét táblanévben a wp_ helyére a saját előtagodat írd. Először szárazon futtatva nézd meg, mit változtatna:

wp search-replace \
  'https://dash.example.com' \
  'https://mainwp.example.com' \
  --skip-tables=wp_mainwp_wp,wp_mainwp_wp_sync \
  --skip-columns=guid \
  --dry-run

Ha a kilistázott táblák és cserék megfelelnek a szándékodnak, futtasd ugyanezt --dry-run nélkül:

wp search-replace \
  'https://dash.example.com' \
  'https://mainwp.example.com' \
  --skip-tables=wp_mainwp_wp,wp_mainwp_wp_sync \
  --skip-columns=guid

A példa a WP-CLI alapértelmezett táblaválasztását használja. Ha további táblákat is érinteni kell, kérd ki a tárhelyszolgáltató véleményét, mielőtt bővíted a műveletet. A kizárások csak erre a parancsra vonatkoznak, a migrációs eszköz külön automatikus cseréjét is be kell állítani.

2. módszer: a tárhelyszolgáltatóval végeztetett kizárás

Add meg a tárhelynek a vezérlőpult régi és új címét, és kérd meg, hogy:

• a teljes adatbázist és a fájlokat vigye át, a MainWP titkosítókulcs-fájljaival együtt;
• a wp_mainwp_wp és a wp_mainwp_wp_sync táblát minden automatikus és kézi domain-cseréből hagyja ki (a saját előtaggal);
• a Child-webhelyek címeit hagyja változatlanul, és ellenőrizze őket az eredeti listával.

3. módszer: kézi domainváltás

1. Csak a vezérlőpult wp_options táblájának siteurl és home sorát írd át az új WordPress-címre (a saját előtaggal). Ha a wp-config.php fájlban már megadtál WP_SITEURL vagy WP_HOME értéket, azt is frissítsd.
2. Ha a vezérlőpult tartalmában még a régi cím szerepel, használj olyan eszközt, amely kezeli a szerializált adatokat, és csak a szükséges WordPress-magtáblákon cserélj. Előbb nézd meg, mit változtatna.
3. A MainWP táblákat hagyd érintetlenül. Kerüld az egész adatbázisra futtatott általános SQL-cserét.

Az átköltöztetés után

1. Ellenőrizd a hozzáférést és az adatokat. Jelentkezz be az új címen. Nézd meg, hogy megvannak-e a beállítások, az ügyfelek, a Child-webhelyek rekordjai és a telepített kiegészítők. Ellenőrizd a kiegészítők mentett beállításait, például a Pro Reports sablonjait és ütemezéseit.
2. Nézd meg a kiegészítők licenceit. Nyisd meg a MainWP → Kiegészítők → Kiegészítők kezelése oldalt. Ha aktiválás kell, aktiváld újra a kiegészítőket.
3. Szinkronizáld az összes Child-webhelyet. A MainWP → Webhelyek → Webhelyek kezelése oldalon kattints a Szinkronizálás gombra. Hasonlítsd össze a Child-webhelyek címeit a mentett listával, és nézd meg a szinkron eredményét. A sikeres szinkron automatikusan frissíti a MainWP Child által tárolt vezérlőpult-címet.
4. Próbáld ki a Child-webhelyek elérését. Néhány Child-webhelyen használd a WP-admin megnyitását, és nézd meg, hogy a Frissítések nézet betölti-e az aktuális adatokat.

Ha a webhelyek még mindig nem kapcsolódnak

Az újracsatlakozás előtt nézd meg a hibaüzenetet:

Ellenőrzés	Teendő
Helytelen Child-webhely-URL	Hasonlítsd a mentett listához, és keresés-csere okozta eltérésnél használd az alábbi javítást
Hiányzó kulcsfájlok	Ellenőrizd, hogy az eredeti MainWP feltöltési mappa és a titkosítókulcs-fájlok hiánytalanul átkerültek
A Child-webhely nem elérhető	Nyisd meg közvetlenül a címét, és nézd meg, hogy a MainWP Child aktív-e
Szerverváltás után blokkolt kérések	Nézd meg, hogy a Child-webhely tűzfalának vagy biztonsági szolgáltatásának engedélyeznie kell-e az új vezérlőpult-szerver IP-címét

Miután az alapvető okot javítottad, a Webhelyek → Webhelyek kezelése oldalon az érintett webhely műveleti menüjében használd az újracsatlakozást. Ha kéri, add meg a Child-webhely aktuális egyedi biztonsági azonosítóját. A MainWP Childban nincs szerkeszthető vezérlőpult-URL mező, és nem kell minden Child-webhelyen kézzel átírni ezt a címet.

Megsérült Child-webhely-URL-ek javítása

Ezt a részt csak akkor használd, ha egy korábbi keresés-csere megváltoztatta a Child-webhelyek címeit. A vezérlőpulton a Child-webhely URL-mezőjében a gazdanév nem szerkeszthető, ezért a javításhoz adatbázis-hozzáférés kell.

Mielőtt belenyúlsz, készíts friss adatbázismentést, és tartsd meg az átköltöztetés előtti mentést és az eredeti webhelylistát. Minden lekérdezésben a wp_ helyére írd a saját előtagodat. A lekérdezéseket csak a vezérlőpult adatbázisán futtasd.

Az érintett webhelyek megkeresése

Nyisd meg a vezérlőpult adatbázisát phpMyAdminban, Adminerben vagy a tárhely adatbáziskezelőjében, és keresd meg a hibás domaint tartalmazó rekordokat:

SELECT id, name, url
FROM wp_mainwp_wp
WHERE url LIKE '%wrongdomain.com%';

A wrongdomain.com helyére a korábbi csere által bevitt hibás szöveget írd. Hasonlítsd össze az eredményeket az eredeti webhelylistával: az, hogy egy sor megfelel a lekérdezésnek, még nem bizonyítja, hogy a cím hibás.

Kevés webhely kézi javítása

Kevés érintett webhelynél szerkeszd a wp_mainwp_wp táblában az azonosított sorokat: írd át az url mezőt a Child-webhely pontos eredeti címére, és mentsd. A webhelyazonosítók és a többi mező maradjon változatlan.

Sok webhely javítása SQL-lel

Tömeges cserét csak akkor használj, ha minden kiválasztott URL ugyanazt a javítást igényli. A 12, 34 példaazonosítók helyére az ellenőrzött azonosítókat írd, a hibás és a helyes domainszöveget is cseréld. Először nézd meg a jelenlegi és a javasolt URL-t:

SELECT id, name, url AS current_url,
       REPLACE(
         url, 'wrongdomain.com', 'correctdomain.com'
       ) AS proposed_url
FROM wp_mainwp_wp
WHERE id IN (12, 34)
  AND url LIKE '%wrongdomain.com%';

Ellenőrizd minden javasolt URL-t az eredeti listával. Utána ugyanazokkal az azonosítókkal és szövegekkel futtasd a módosítást:

UPDATE wp_mainwp_wp
SET url = REPLACE(
  url, 'wrongdomain.com', 'correctdomain.com'
)
WHERE id IN (12, 34)
  AND url LIKE '%wrongdomain.com%';

Ha a webhelyek különböző javítást igényelnek, javítsd őket egyenként vagy külön ellenőrzött csoportokban. Ne fordítsd vissza a domaincserét az egész adatbázisban, mert a vezérlőpult szándékos címváltozását is visszavonhatná.

Olvasd vissza a javított rekordokat:

SELECT id, name, url
FROM wp_mainwp_wp
WHERE id IN (12, 34);

A javítás után

Ismételd meg a fenti szinkron- és Child-webhely-elérési ellenőrzést. Ezek a lekérdezések csak a kapcsolati URL-mezőt javítják. Ha a korábbi csere más MainWP-adatot is módosított, kérd a tárhelyszolgáltató vagy a MainWP támogatásának segítségét a migráció előtti mentésből való helyreállításhoz.

Ellenőrzőlista

• Az átvitel előtt ellenőrzött, teljes fájl- és adatbázismentés van.
• A MainWP táblák benne vannak az átvitelben, és ki vannak zárva a domain keresés-cseréjéből.
• A MainWP titkosítókulcs-fájljai megvannak.
• A vezérlőpult elérhető az új domainen vagy aldomainen.
• A beállítások, az ügyfelek, a Child-webhelyek rekordjai és a kiegészítők adatai megvannak.
• A kiegészítők licencei ellenőrizve.
• A Child-webhelyek címei változatlanok, vagy az eredeti lista alapján javítva.
• A szinkron és a Child-webhely-elérés ellenőrzése sikeres.
• A régi vezérlőpult-másolaton leálltak az ütemezett feladatok.