Mambo 4.5.4 to 4.6 Patch Installation Instructions:

Below you will find the steps to bring a Mambo 4.5.4 system up to the 4.6 version.  This will NOT bring prior versions up to date.  You should first try to bring prior versions up to the 4.5.4 patch level before applying the 4.6 patch.

The Mambo 4.5.4 to 4.6 upgrade process is a bit more complicated than other recent upgrades since 4.6 is a minor release.  4.6 is called a minor upgrade since not a ton of visual changes have taken place, but in reality the core of Mambo has had a significant rewrite and a number of new features added.  4.6 is an important milestone for the project that lays the ground work for future versions of Mambo.  The team has worked hard on this release and has done a lot of work trying to maintain compatibility with existing 3rd party components, modules, mambots while at the same time trying to move the project forward.  That being said it is important that you throughly test all your 3rd party components with 4.6 prior to upgrading your installation.  It is possible that some of your extensions have not yet been made compatible with Mambo 4.6 since it is so new.  We did go through an extended release candidate testing period to work on 3rd party compatibility and provide 3rd party developers with lots of time to start preparing their extensions for the new release.  We recommend you report any issues you find during testing back to the corresponding 3rd party developers.  The Mambo team will assist 3rd developers as best we can with making their extensions compatible with the new branch. 

Upgrading Steps:

1) Again... test your 3rd party extensions and upgrade after you are confident they are working to your satisfaction.
2) Backup your site (both database & site files)
3) Note: If you never installed the 4.5.4 version of the MOStlyCE (WYSIWYG editor) mambot and/or the MOStlyCE Admin component then you can skip this step.

If you have installed the 4.5.4 versions of the MOStlyCE (WYSIWYG editor) mambot and/or the MOStlyCE Admin component you will need to uninstall them as they were ported versions specific to 4.5.4.  After uninstalling the mambot change your default editor to TinyMCE or No Editor in your Global Configuration if it is not already set this way. 

When you finish with the upgrade to 4.6 you can install the 4.6 version of MOStlyCE & MOStlyCE Admin from the new Add-On Installer on the Installers menu if you have PHP5 or by downloading the 4.6 versions manually from The Source (http://source.mambo-foundation.org).

4) Take your site offline:  Site->Global Configuration->Site Offline (YES).
5) Remove the following files and whole directories:

Directories:
/includes/patTemplate
/includes/domit
/help

Files:
/includes/mamboxml.php
/globals.php
/administrator/includes/auth.php
/administrator/components/com_weblinks/weblinks_item.xml
/administrator/components/com_languages/admin.languages.html.php

6)  Run the SQL statements in the file called 454_to_46_upgrade.sql in the upgrades folder via your normal database interface (ie) phpMyAdmin, MySQL commandline, etc.  You will need to replace "#__" with whatever your table prefix is.  By default the Mambo table prefix is set at "mos_". 

Example:  #__containers would change to mos_containers (that is a single underscore). 

7)  Upload and/or extract all files inside the patch into your Mambo installation. Let them overwrite the existing files.
8)  Open your configuration.php file 
  a)  If your $mosConfig_lang is set to 'english' then change $mosConfig_lang = 'english'; to $mosConfig_lang = 'en';
  b)  Change $mosConfig_helpurl to be $mosConfig_helpurl = 'http://docs.mambo-foundation.org';
  c)  Add the following lines:
      $mosConfig_usecaptcha = '0';
      $mosConfig_locale_use_gettext = 0;
      $mosConfig_locale_debug = 0;

9) If you are using SEO then remove your old .htaccess file and rename the new htaccess.txt file to .htaccess.
10)  Bring your site back online:  Site->Global Configuration->Site Offline (NO).
11)  Remove the upgrade folder

That's it.  Patch complete.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Additional Note - The following are new features of 4.6 that are not present in the patch from 4.5.4 or the Mambo Lite version of 4.6:

MOStlyCE, MOStlyDBAdmin, mosComment, latest content module, and additional sample templates.

They are present in the full version of 4.6 and available as installable addons via the new Add-On installer for those with PHP5 and/or as a manual download from The Source (http://source.mambo-foundation.org).