Siirtäminen

Voit siirtää Clover Shop® X4/2019-2026 -verkkokauppaohjelmiston vanhasta kotisivutilasta (webhotellista) uuteen noudattamalla tällä sivulla olevia ohjeita.

Siirtäminen tapahtuu periaatteessa seuraavalla tavalla.

• Kopioi MySQL-tietokannan taulukot.
• Kopioi ohjelmiston kansiot ja tiedostot.
• Vaihda MySQL-tunnukset kahteen config_inc.php -tiedostoon.
• Siirrä verkkotunnus.
• Päivitä verkkokaupan hallintaliittymän asetukset / sähköpostiyhteydet -kohdassa olevat kortit.

Käytännössä siirtäminen kannattaa tehdä seuraavalla tavalla.

• Pyydä vanhasta webhotellista verkkotunnuksen välittäjän vaihtoavain. Älä pyydä verkkotunnuksen siirtoavainta.
• Ota FTP-ohjelmalla SFTP/SSH-yhteys vanhaan kotisivutilaan. Siirrä (kopioi) kaikki julkisessa juurikansiossa olevat kansiot ja tiedostot omalle tietokoneellesi kansioon, jonka nimi on esimerkiksi examplecom_vanha.
  - Julkinen juurikansio on yleensä public_html tai website -niminen.
  - Yleensä ohjelmiston asennus on tehty niin, että verkkokaupan tiedostot sijaitsevat julkisessa juurikansiossa. Tällöin verkkokauppa näkyy esimerkiksi osoitteessa https://www.example.com. Yleensä verkkokaupan hallintaliittymän tiedostot sijaitsevat julkisessa juurikansiossa olevassa kansiossa, esimerkiksi adm_C2tgS73Ksf23SQQdf2, jonka nimi on erilainen jokaisessa eri verkkokaupassa. Tällöin verkkokaupan hallintaliittymä näkyy esimerkiksi osoitteessa https://www.example.com/adm_C2tgS73Ksf23SQQdf2/.
  - Tärkeää! Joissain kotisivutiloissa FTP-ohjelmat näyttävät kansioissa enintään 9998 tiedostoa, vaikka tiedostoja olisi esimerkiksi 25148. Vaarana on, että et tule siirtäneeksi (kopioneeksi) kaikkia tiedostoja! Tällainen vaara on graphics-kansioissa (2 kpl) ja niiden alikansioissa kuvatiedostojen osalta.
• Avaa jokin ohjelmiston php-tiedosto, esimerkiksi cleans.php. Tiedoston alussa mainitaan, minkä PHP:n ja ionCube Loaderin versioiden kanssa tiedostot ovat yhteensopivia.
  

  // This installation package is compatible only with
  // PHP 8.1 with ionCube Loader 13.0.0-
  // PHP 8.2 with ionCube Loader 13.0.0-
  // PHP 8.3 with ionCube Loader 13.0.0-
  

  Uuden kotisivutilan on oltava tiedostojen kanssa yhteensopiva. Näet PHP:n version uuden webhotellin hallintapaneelista. Jos PHP:n versio ei ole yhteensopiva, ohjelmisto on päivitettävä uudessa kotisivutilassa uusimpaan ohjelmistoversioon. Palaamme tähän asiaan myöhemmin tässä ohjeessa. Ohjeissamme mainittiin aiemmin, että ohjelmisto on päivitettävä vanhassa kotisivutilassa uusimpaan ohjelmistoversioon ennen siirtämistä. Tämä on edelleen suositeltavaa, mutta ei aivan välttämätöntä.
• Kirjaudu sisään uuden webhotellin hallintapaneeliin. Vaihda PHP:n versio yhteensopivaksi. Varmista, että PHP:n yleisten laajennusten (jotka ovat aina päällä) lisäksi ainakin nämä laajennukset ovat päällä: (dom), gd, ioncube_loader, (mb_string), nd_mysql, json, xmlwriter ja zip. Suluissa mainitut meillä on tapana laittaa päälle varmuuden vuoksi. Luultavasti dom ja mb_string ovat tarpeettomia. Jos opcache on päällä, kytke se pois päältä varmuuden vuoksi.
• Seuraavaksi kannattaa tarkistaa uuden kotisivutilan PHP:n ja ionCube Loaderin versiot. Luo omalla tietokoneellasi php-tiedosto, jonka sisällä on seuraavat rivit.
  

  <?php
  echo phpinfo();
  ?>
  

  Nimeä tiedosto vaikka nimellä phpinfo.php. Siirrä tiedosto FTP-ohjelmalla uuden kotisivutilan julkiseen juureen. Uusi kotisivutila näkyy väliaikaisessa www-osoitteessa ennen verkkotunnuksen siirtämistä. Saat väliaikaisen www-osoitteen selville uuden webhotellin hallintapaneelista. Kun olet saanut sen selville, vieraile www-selaimella phpinfo.php -sivulla. Sen osoite voi olla esimerkiksi https://customer123.hostingexample.com/phpinfo.php. Näet sivun alkupuolelta PHP:n ja ionCube Loaderin version. Huomioi, että joissain kotisivutiloissa PHP:n version vaihtaminen saattaa kestää 15 minuuttiakin. Poista lopuksi tiedosto (phpinfo.php) turvallisuussyistä.
• Tietokoneellasi on examplecom_vanha-niminen kansio, jossa on kaikki vanhan kotisivutilan julkisessa juurikansiossa olleet kansiot ja tiedostot. Tätä kansiota ei kannata muokata vaan se kannattaa jättää ehjäksi varmuuskopioiksi. Kopioi examplecom_vanha-niminen kansio ja nimeä se esimerkiksi examplecom_uusi-nimiseksi. Tämän kansion sisältö tullaan myöhemmin siirtämään FTP-ohjelmalla uuteen kotisivutilaan.
• Kirjaudu sisään uuden webhotellin hallintapaneeliin. Luo MySQL-tietokanta ja sille käyttäjä, jolla on vähintään oikeudet SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP, RELOAD (TAI FLUSH TABLES) JA LOCK TABLES.
• Avaa tietokoneesi examplecom_uusi-nimisessä kansiossa olevat kaksi config_inc.php -tiedostoa, jotka löytyvät verkkokaupan config-kansiosta (config/config_inc.php) ja verkkokaupan hallintaliittymän config-kansiosta (adm_C2tgS73Ksf23SQQdf2/config/config_inc.php). Vaihda MySQL-tunnukset uusiin.
  

  $config['mysql5_database'] = "csx4_testikanta"; // MySQL-tietokannan nimi
  $config['mysql5_server'] = "localhost";         // MySQL-tietokantapalvelimen osoite (ei tarkoita www-osoitetta)
  
  $config['mysql5_readwrite_username'] = "clovertest"; // MySQL-käyttäjätunnus oikeuksilla: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, LOCK TABLES
  $config['mysql5_readwrite_password'] = "clovertest"; // MySQL-salasana
  
  $config['mysql5_read_username'] = "lue_clovertest"; // MySQL-käyttäjätunnus oikeuksilla: SELECT (tai sama kuin yllä)
  $config['mysql5_read_password'] = "lue_clovertest"; // MySQL-salasana (tai sama kuin yllä)
  

• Kirjaudu sisään vanhan webhotellin hallintapaneeliin. Luo MySQL-tietokannan taulukoista varmuuskopio phpMyAdmin–työkalulla. Varmuuskopio tapahtuu klikkaamalla vasemmalta tietokantaa. Jos tietokantoja on useita, tunnistat ohjelmiston käyttämän tietokannan siitä, että siinä olevat taulukot alkavat csx4_. Klikkaa tämän jälkeen ylhäältä Export-välilehteä. Varmuuskopiointi onnistuu nopeassa tilassa ("Quick - display only the minimal options"). Klikkaa Export-painiketta. Tallenna varmuuskopiotiedosto (esimerkiksi dbkaupp_examplecom.sql) omalle tietokoneellesi.
• Kirjaudu sisään uuden webhotellin hallintapaneeliin. Palauta MySQL-tietokannan taulukoista luomasi varmuuskopio phpMyAdmin–työkalulla. Palauttaminen tapahtuu klikkaamalla vasemmalta tietokantaa. Klikkaa tämän jälkeen ylhäältä Import-välilehteä. Valitse tiedosto tietokoneeltasi (dbkaupp_examplecom.sql). Klikkaa Import-painiketta. Näet ilmoituksen, jos palauttaminen onnistui.
• Ota FTP-ohjelmalla SFTP/SSH-yhteys uuteen kotisivutilaan. Siirrä (kopioi) kaikki examplecom_uusi-kansiossa olevat kansiot ja tiedostot uuden kotisivutilan julkiseen juurikansioon.
  - Julkinen juurikansio on yleensä public_html tai website -niminen.
  
• Vieraile uudessa verkkokaupassa. Verkkotunnusta ei ole vielä siirretty. Uusi verkkokauppa näkyy väliaikaisessa www-osoitteessa. Verkkokauppa näkyy esimerkiksi osoitteessa https://customer123.hostingexample.com/.
  -Jos verkkokauppa ei toimi, päivitä ohjelmisto uuteen kotisivutilaan.
• Kirjaudu sisään uudessa kotisivutilassa olevaan verkkokaupan hallintaliittymään. Verkkotunnusta ei ole vielä siirretty. Verkkokaupan hallintaliittymä näkyy esimerkiksi osoitteessa https://customer123.hostingexample.com/adm_C2tgS73Ksf23SQQdf2/. Klikkaa asetukset / asennus. Vaihda verkkokaupan ja hallintaliittymän verkko-osoitteet väliaikaisiksi.
  - Tärkeää! Jos et vaihda, et voi testata verkkokaupan toimintaa kunnolla, sillä sivut ohjautuvat vanhaan verkkokauppaan. Lisäksi saatat tuhota vahingossa tietoja, kun luulet olevasi kaupassa, jossa et olekaan.
• Pyydä, että verkkokauppias luo uuden webhotellin hallintapaneelin kautta uudet sähköpostilaatikot niille sähköpostiosoitteille, jotka ovat käytössä vanhassa webhotellissa. Korosta hänelle, että verkkotunnuksen siirron jälkeen hänen on luettava sähköpostit uudesta webmailista tai päivitettävä sähköpostiasetukset sähköpostiohjelmaansa.
• Kaiken pitäisi nyt olla valmista verkkotunnuksen siirtämiselle.
• Kirjaudu sisään vanhassa kotisivutilassa olevaan verkkokaupan hallintaliittymään (https://www.example.com/adm_C2tgS73Ksf23SQQdf2/). Klikkaa asetukset / on/off. Poista merkintä Verkkokauppa avoinna -kohdasta ja klikkaa Päivitä -painiketta. Verkkokaupassa näkyy nyt huoltokatkoilmoitus.
• Koska aikaa on kulunut, siirrä (kopio) MySQL-tietokannan taulukot toiseen kertaan phpMyAdmin-työkalun avulla. Osana tätä siirtoa joudut tuhoamaan uuden kotisivutilan MySQL-tietokannan taulukot. Ole tarkkana ennen tuhoamista, että olet todella uuden kotisivutilan phpMyAdmin-työkalussa. Siirrä (kopioi) uudelleen myös graphics-kansiot (2 kpl).
• Tärkeää! Kirjaudu sisään uudessa kotisivutilassa olevaan verkkokaupan hallintaliittymään (https://customer123.hostingexample.com/adm_C2tgS73Ksf23SQQdf2/). Klikkaa asetukset / on/off. Merkitse Verkkokauppa avoinna -kohta ja klikkaa Päivitä -painiketta. Tarkista, että asetukset / asennus -kohdassa olevissa verkko-osoitteissa on oikea verkkotunnus (ei väliaikainen). Tässä vaiheessa vanha verkkokauppa ei toimi, eikä uusikaan toimi kunnolla, koska verkkotunnusta ei ole vielä siirretty.
• Siirrä verkkotunnus noudattamalla uuden webhotellin ohjeita. Tarvitset verkkotunnuksen välittäjän vaihtoavaimen. Verkkotunnuksen siirto kestää muutamia tunteja riippuen verkkotunnuksen TTL-arvosta (time to live).
• Selvitä uuden kotisivutilan webhotellin ohjeista sähköpostilaatikoiden SMTP-tunnukset. Päivitä ne alustavasti uudessa kotisivutilassa olevan verkkokaupan hallintaliittymän asetukset / sähköpostiyhteydet -kohtaan. Passivoi sähköpostiyhteyskortit, koska niissä on vähintäänkin väärät salasanat, ellet sitten tiedä salasanoja. Passivointi tarkoittaa sitä, että merkitset kortin vasemmalla olevasta luettelosta ja klikkaat keltaista rastikuvaketta. Jos et passivoi kortteja, verkkokaupan tilaustapahtumassa on monen sekunnin viive, koska automaattinen tilausvahvistus yritetään lähettää väärillä SMTP-tunnuksilla. Kun verkkotunnus on siirretty, aktivoi kortit ja kokeile, ovatko asetukset oikein. Tämä tapahtuu klikkaamalla korttien Päivitä-painiketta. Jos asetukset ovat väärin jossain kortissa, passivoi kortti.

Hyvä tietää

Jos haluat välttää huoltokatkon kokonaan, älä sulje vanhaa verkkokauppaa asetukset / on/off -kohdasta. Tällöin sinun pitää kuitenkin tarkistaa, onko vanhaan verkkokauppaan tullut tilauksia verkkotunnuksen siirron aikana. Vanha verkkokaupan hallintaliittymä näkyy verkkotunnuksen siirron jälkeen väliaikaisessa www-osoitteessa, joka on eri kuin uuden kotisivutilan väliaikainen www-osoite.

Katso myös

• Asentajan työkalupakki
• Tekninen tuki