Difference between revisions of "Joomla! 1.5 Specific FAQs"

From Joomla! Documentation

Line 12: Line 12:
  
 
===How do I upgrade to Joomla! 1.5?===
 
===How do I upgrade to Joomla! 1.5?===
 +
 +
 +
You can migrate a Joomla! 1.0.x site or a Mambo 4.5.x to Joomla! 1.5.
 +
 +
Joomla 1.5 does not provide an upgrade path from earlier versions. Converting an older site to a Joomla 1.5 site requires creation of a new empty site using Joomla 1.5 and then populating the new site with the content from the old site. This migration of content is not a one-to-one process and involves conversions and modifications to the content dump.
 +
 +
There are two ways to perform the migration:
 +
 +
*An automated method of migration has been provided which uses a migrator component to create the migration dump out of the old site (Mambo 4.5.x up to Joomla 1.0.x) and a smart import facility in the Joomla 1.5 Installation that performs required conversions and modifications during the installation process.
 +
* Migration can be performed manually. This involves exporting the required tables, manually performing required conversions and modifications and then importing the content to the new site after it is installed.
 +
 +
Automated migration
 +
 +
This is a two phased process using two tools. The first tool is a migrator component named 'com_migrator'. This component has been contributed by Harald Baer and is based on his 'eBackup' component. The migrator needs to be installed on the old site and when activated it prepares the required export dump of the old site's data. The second tool is built into the Joomla 1.5 installation process. The exported content dump is loaded to the new site and all conversions and modification are performed 'on-the-fly'.
 +
 +
Step 1 - Using com_migrator to export data from old site:
 +
* Install the com_migrator component on the old site. It can be found at joomlacode.org .
 +
* Select the component in the component menu of the administrator.
 +
* Click on the 'Dump it' icon. Three exported gzipped export scripts will be created. The first is a complete backup of the old site. The second is the migration content of all core elements which will be imported to the new site. The third is a backup of all 3PD component tables.
 +
* Click on the download icon of the particular exports files needed and store locally.
 +
* Multiple export sets can be created.
 +
* The exported data is not modified in anyway and the original encoding is preserved. This makes the com_migrator tool a recommended tool to use for manual migration as well.
 +
 +
Step 2 - Using the migration facility to import and convert data during Joomla 1.5 installation:
 +
 +
Note: This function requires use of the iconv function in PHP to convert encodings. If iconv is not found a warning will be provided.
 +
* In step 6 - Configuration select the 'Load Migration Script' option in the 'Load Sample Data, Restore or Migrate Backed Up Content' section of the page.
 +
* Enter the table prefix used in the content dump. For example: '#_' or '#__' are acceptable values.
 +
* Select the encoding of the dumped content in the dropdown list. This should be the encoding used on the pages of the old site. (As defined in the _ISO variable in the language file or as seen in the browser page info/encoding/source)
 +
* Browse the local host and select the migration export and click on 'Upload and Execute'
 +
* A success message should appear or alternately a listing of db errors # Complete the other required fields in the Configuration step such as Site Name and Admin details and advance to the final step of installation. (Admin details will be ignored as the imported data will take priority. Please remember admin name and password from the old site)
 +
 
===What happened to the locale setting?===
 
===What happened to the locale setting?===
 
===Where did the installer go?===
 
===Where did the installer go?===

Revision as of 08:25, 19 January 2008

What is a Release Candidate (RC)?[edit]

In the software development cycle, a release candidate is a release that could potentially be a final product. A release candidate can be used for production sites, but it is still possible that changes could be made prior to the general release.

Do I have to upgrade to version 1.5?[edit]

For the time being the Joomla! 1.0.x release will continue to be supported and updated if security or other major issues arise. Eventually, support for the 1.0.x will cease, but this will not be in the near future.

How do I install Joomla! 1.5?[edit]

Instructions for installation can be found here. http://help.joomla.org/content/section/48/302/

How do I upgrade to Joomla! 1.5?[edit]

You can migrate a Joomla! 1.0.x site or a Mambo 4.5.x to Joomla! 1.5.

Joomla 1.5 does not provide an upgrade path from earlier versions. Converting an older site to a Joomla 1.5 site requires creation of a new empty site using Joomla 1.5 and then populating the new site with the content from the old site. This migration of content is not a one-to-one process and involves conversions and modifications to the content dump.

There are two ways to perform the migration:

  • An automated method of migration has been provided which uses a migrator component to create the migration dump out of the old site (Mambo 4.5.x up to Joomla 1.0.x) and a smart import facility in the Joomla 1.5 Installation that performs required conversions and modifications during the installation process.
  • Migration can be performed manually. This involves exporting the required tables, manually performing required conversions and modifications and then importing the content to the new site after it is installed.

Automated migration

This is a two phased process using two tools. The first tool is a migrator component named 'com_migrator'. This component has been contributed by Harald Baer and is based on his 'eBackup' component. The migrator needs to be installed on the old site and when activated it prepares the required export dump of the old site's data. The second tool is built into the Joomla 1.5 installation process. The exported content dump is loaded to the new site and all conversions and modification are performed 'on-the-fly'.

Step 1 - Using com_migrator to export data from old site:

  • Install the com_migrator component on the old site. It can be found at joomlacode.org .
  • Select the component in the component menu of the administrator.
  • Click on the 'Dump it' icon. Three exported gzipped export scripts will be created. The first is a complete backup of the old site. The second is the migration content of all core elements which will be imported to the new site. The third is a backup of all 3PD component tables.
  • Click on the download icon of the particular exports files needed and store locally.
  • Multiple export sets can be created.
  • The exported data is not modified in anyway and the original encoding is preserved. This makes the com_migrator tool a recommended tool to use for manual migration as well.

Step 2 - Using the migration facility to import and convert data during Joomla 1.5 installation:

Note: This function requires use of the iconv function in PHP to convert encodings. If iconv is not found a warning will be provided.

  • In step 6 - Configuration select the 'Load Migration Script' option in the 'Load Sample Data, Restore or Migrate Backed Up Content' section of the page.
  • Enter the table prefix used in the content dump. For example: '#_' or '#__' are acceptable values.
  • Select the encoding of the dumped content in the dropdown list. This should be the encoding used on the pages of the old site. (As defined in the _ISO variable in the language file or as seen in the browser page info/encoding/source)
  • Browse the local host and select the migration export and click on 'Upload and Execute'
  • A success message should appear or alternately a listing of db errors # Complete the other required fields in the Configuration step such as Site Name and Admin details and advance to the final step of installation. (Admin details will be ignored as the imported data will take priority. Please remember admin name and password from the old site)

What happened to the locale setting?[edit]

Where did the installer go?[edit]

Only one edit window! How do I create "Read more..."?[edit]

Where did the Mambots go?[edit]

Where is the static content?[edit]

Will my 1.0 extensions still work?[edit]

How do I create a custom module?[edit]

How do I set global preferences for content?[edit]

Why won't my legacy extension install?[edit]