Project

General

Profile

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

Roland Dalmulder, 02/14/2010 06:33 AM
Initial text

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