Difference between revisions of "Upgrading AWBS"

From AWBS Wiki
Jump to: navigation, search
Line 15: Line 15:
  
  
Preparing custom files
+
=== Preparing custom files ===
  
 
If you have any custom files, new changes will have to be merged to your custom work. We recommend [http://www.awbs.com/packages.php?spt=3 Beyond Compare], however there are several other softwares that will perform a file comparison function as well.
 
If you have any custom files, new changes will have to be merged to your custom work. We recommend [http://www.awbs.com/packages.php?spt=3 Beyond Compare], however there are several other softwares that will perform a file comparison function as well.
Line 21: Line 21:
 
Compare your current files to new files in the upgrade zip for changes. Add your custom code to the new files prior to uploading, making sure not to miss any new code we have added/changed.
 
Compare your current files to new files in the upgrade zip for changes. Add your custom code to the new files prior to uploading, making sure not to miss any new code we have added/changed.
 
New langauge is almost always added at the bottom of the language files to make for each file comparing while upgrading.
 
New langauge is almost always added at the bottom of the language files to make for each file comparing while upgrading.
 +
 +
Upgrade zips come with the business theme new templates. If you use coolblue, bare, or techy themes, get your new template files from the theme upgrade zips. If you have made a custom theme, use the business templates to upgrade your theme. It is important to upgrade your templates, we only make template changes when required to accomplish functionality of a new feature or fix.
 +
When preparing your upload, rename the business directory to your theme name or remove it if you use one of our other themes. Do this so your new templates will be uploaded to the correct theme directory and you won't have any other partial themes on your server.
 +
 +
=== Put your site into maintenance mode ===
 +
Login to your AWBS site as super admin. Click on the Configuration button at the top, then click on System Options link. There you'll find 'Close system and activate maintenance mode:', set that to True, Edit the text for maintenance mode as desired and click the Save Changes button at the bottom of that page.

Revision as of 09:43, August 22, 2008

AWBS Upgrades must be performed with each version in order of version release. View the Change Log for version release order.

Always download the upgrade zip and read the docs/readmexx file prior to doing anything. Each version has it's own instructions and any details on new setting changes, etc.

As a general rule, upgrades go like this:

  • Make a full file backup of your site (All AWBS files)
  • Get the correct download zip where you purchased AWBS. (Requires active support contract)
  • Read the docs/readmexx (xx = your AWBS version upgrade)
  • Prepare custom files if necessary
  • Put your AWBS site into maintenance mode
  • Make a db backup
  • Upload all new files with paths in binary mode, overwriting existing files
  • Make configuration changes if applicable as per the readme for that version
  • Turn off maintenance mode


Preparing custom files

If you have any custom files, new changes will have to be merged to your custom work. We recommend Beyond Compare, however there are several other softwares that will perform a file comparison function as well. Customized templates and langauge files are most common, but be sure you are aware of all custom files you have before you start your upgrade. Compare your current files to new files in the upgrade zip for changes. Add your custom code to the new files prior to uploading, making sure not to miss any new code we have added/changed. New langauge is almost always added at the bottom of the language files to make for each file comparing while upgrading.

Upgrade zips come with the business theme new templates. If you use coolblue, bare, or techy themes, get your new template files from the theme upgrade zips. If you have made a custom theme, use the business templates to upgrade your theme. It is important to upgrade your templates, we only make template changes when required to accomplish functionality of a new feature or fix. When preparing your upload, rename the business directory to your theme name or remove it if you use one of our other themes. Do this so your new templates will be uploaded to the correct theme directory and you won't have any other partial themes on your server.

Put your site into maintenance mode

Login to your AWBS site as super admin. Click on the Configuration button at the top, then click on System Options link. There you'll find 'Close system and activate maintenance mode:', set that to True, Edit the text for maintenance mode as desired and click the Save Changes button at the bottom of that page.