Project

General

Profile

Migrate Joomla! 10 (incl VirtueMart) to Joomla! 15 » History » Version 2

Roland Dalmulder, 02/14/2010 06:34 AM
Fix typo

1 2 Roland Dalmulder
h1. Migrate Joomla! 1.0 (including VirtueMart) to Joomla! 1.5
2 1 Roland Dalmulder
3 1 Roland Dalmulder
h2. Why migrate instead of update?
4 1 Roland Dalmulder
5 1 Roland Dalmulder
    * Joomla 1.5 uses UTF-8 for table collations, Joomla! 1.0 usually did not
6 1 Roland Dalmulder
    * Links (especially SEF Links) have changed, so it's necessary to track legacy backlinks
7 1 Roland Dalmulder
    * Database table structure has changed in many ways, so a simple update via SQL is not possible
8 1 Roland Dalmulder
9 1 Roland Dalmulder
h2. Basic Steps for the Migration
10 1 Roland Dalmulder
11 1 Roland Dalmulder
    * Upgrade to VirtueMart 1.1 (while you're still on VirtueMart 1.0, because VirtueMart 1.0 is NOT compatible with Joomla! 1.5) 
12 1 Roland Dalmulder
    * Let the "Migrator" Component generate an SQL dump of your Joomla! 1.0 tables
13 1 Roland Dalmulder
    * Do a base Joomla! 1.5 install
14 1 Roland Dalmulder
    * At the Migration Step, either upload via FTP or HTTP
15 1 Roland Dalmulder
    * Run the Migration Wizard and finish Installation
16 1 Roland Dalmulder
    * Copy your VirtueMart tables to the new Joomla! 1.5 Database
17 1 Roland Dalmulder
    * Copy your VirtueMart files to the new J! 1.5 Site (for example, using "eXtplorer":http://extplorer.sourceforge.net/)
18 1 Roland Dalmulder
19 1 Roland Dalmulder
h2. Getting the Migrator Software
20 1 Roland Dalmulder
21 1 Roland Dalmulder
    Download available on the web: "mtwMigrator":http://www.matware.com.ar/downloads/mtwmigrator/index.php
22 1 Roland Dalmulder
23 1 Roland Dalmulder
h2. Joomla! 1.5 Installation
24 1 Roland Dalmulder
25 1 Roland Dalmulder
    * We now start creating a new Joomla! 1.5 installation.
26 1 Roland Dalmulder
    * Create a new directory for J! 1.5 and upload a fresh J! 1.5 distribution
27 1 Roland Dalmulder
    * Start the installation
28 1 Roland Dalmulder
    * Don't upload an SQL-Dump/Migration package in Step 6 
29 1 Roland Dalmulder
30 1 Roland Dalmulder
h2. Install VirtueMart
31 1 Roland Dalmulder
32 1 Roland Dalmulder
    * you need to install VirtueMart first, because so you have the component entry in the database
33 1 Roland Dalmulder
    * install all the modules & plugins you need 
34 1 Roland Dalmulder
35 1 Roland Dalmulder
 
36 1 Roland Dalmulder
ATTENTION! The following step requires that you already have VirtueMart 1.1. on your old Joomla! installation
37 1 Roland Dalmulder
38 1 Roland Dalmulder
    * finally copy all files related to VirtueMart from your old Joomla! installation (except modules & mambots)
39 1 Roland Dalmulder
          o /administrator/components/com_virtuemart
40 1 Roland Dalmulder
          o /components/com_virtuemart
41 1 Roland Dalmulder
42 1 Roland Dalmulder
h2. Copy the VirtueMart Files
43 1 Roland Dalmulder
44 1 Roland Dalmulder
    * If the new J! 1.5 installation is on the same webspace as your old J! 1.0 installation, you can easily copy VirtueMart by using "eXtplorer or joomlaXplorer":http://joomlacode.org/gf/project/joomlaxplorer/ or by using the file manager of your control panel (cPanel / Plesk).
45 1 Roland Dalmulder
    * You need to copy the directories
46 1 Roland Dalmulder
      /administrator/components/com_virtuemart/ and /components/com_virtuemart/
47 1 Roland Dalmulder
    * Copy all their directory contents to the new J! 1.5 directory
48 1 Roland Dalmulder
    * If the new J! 1.5 installation resides on a different webspace, you might need to download the VirtueMart component  directories via FTP and re-upload them to the new webspace
49 1 Roland Dalmulder
50 1 Roland Dalmulder
h2. Copy the Modules and Mambots?
51 1 Roland Dalmulder
52 1 Roland Dalmulder
p=. *NO!*
53 1 Roland Dalmulder
54 1 Roland Dalmulder
    * The old modules and mambots don't work on J! 1.5, so they cannot be copied
55 1 Roland Dalmulder
    * You must install the new modules and plugins from the VirtueMart distribution for Joomla! 1.5 (yes, there's a separate "Complete Package" available for Joomla! 1.5)
56 1 Roland Dalmulder
57 1 Roland Dalmulder
h2. Install the mtwMigrator Component
58 1 Roland Dalmulder
59 1 Roland Dalmulder
    * Install into the new Joomla! 1.5 site using the Extension Manager
60 1 Roland Dalmulder
61 1 Roland Dalmulder
h2. Using mtwMigrator
62 1 Roland Dalmulder
63 1 Roland Dalmulder
    * Now go to "mtwMigrator" in the Admin Section of your J! 1.5 site
64 1 Roland Dalmulder
    * Click "Global Configuration"
65 1 Roland Dalmulder
    * First of all fill in the Database Access information to your "old" Joomla! site
66 1 Roland Dalmulder
    * Click on "Apply" to refresh the view
67 1 Roland Dalmulder
    * Now the button for VirtueMart should be enabled, because mtwMigrator has detected VirtueMart tables in that database
68 1 Roland Dalmulder
    * Finally check the other import options and click "Save" to leave the configuration form
69 1 Roland Dalmulder
70 1 Roland Dalmulder
h2. Migration finished...?!
71 1 Roland Dalmulder
72 1 Roland Dalmulder
    * All the necessary basic steps to migrate VirtueMart to Joomla! 1.5 are done now
73 1 Roland Dalmulder
    * You might still need to fix some things in your new Joomla! 1.5 site
74 1 Roland Dalmulder
    * You're probably using other extensions - those need to be migrated as well
75 1 Roland Dalmulder
    * Is it worth it? Yes! Joomla! 1.5 is the future and all extensions and templates will be developed for J! 1.5 only, so you can't use them in J! 1.0