Upgrading 5.3 - Step by Step Guide

Permalink
OK. So last night... I upgraded my 100 pages concrete5 japan site to 5.3.

It took me about 8 hours to figure out.

If you want to save the time... read my step by step guide.

========================================
Step by Step Guide of How to Upgrade from 5.2.1 to 5.3
========================================

----------------------------------------
BEFORE YOU UPGRADE
----------------------------------------

Back up your site
Back up your MySQL database

Again, I will repeat thousands times,

Back up your site, and back up your MySQL database!!!

0. Your site should be 5.2.1. (recommended)

1. Turn off Pretty URL if you are using one

2. Go to [Dashboard] - [Sitewide Setting] - [Debug}

3. Turn on Development Mode (so that you can see the PHP error message)

4. Go to [Dashboard] - [Sitewide Setting] - {Access]

5. Turn on the Maintenance Mode

6. Back up your site

7. Back up your MySQL database



----------------------------------------
ATTENTION: INTERNATIONAL USERS
----------------------------------------

If you've EVER used non-ASCII characters in your site, you must read this and convert your MySQL data

http://www.concrete5.org/community/forums/internationalization/upgr...

----------------------------------------
Initial Upgrade
----------------------------------------

1. Upload C5.3 file onto your site
* SSH plus "unzip -u" command comes in handy

2. Access the following URL
[YOUR_C5_URL/index.php/tools/required/upgrade.php

3. Proceed to upgrade

4. Your MySQL data is now being upgraded



----------------------------------------
Post-Upgrade Upgrade :-)
----------------------------------------

*Since 5.3 has a tons of new features.... I needed to go through these processes... also I referenced to other posts in this forum... so the credit of trying out these goes to them...

1. CLEAR the cache of YOUR BOWSER!

2. Login to Dashboard

3. Go to [Sitewide Setting] - [Debug] and disable cache

4. Go to [File Manager]

5. Under search, try to increase the number in the "Result", and leave the input box blank so that you can see as many images as possible in your file manager

6. Select ALL images

7. Select "Rescan" from the menu which is left of Type

*If YOU ONLy SEE BLANK, that may be because your browser has some weird cache. I was using Safari 3.2.1, and all I had to do was to clear my browser cache

*Also if you get an error message liks "Cannot Write", it may be some permission problem

8. go to {Page and Theme] - [Single Pages]

9. Scroll down to the bottom of the page.. and add the following as new single page

----------
profile
profile/edit
profile/avatar
dashboard/users/registration
----------

This is the bug of upgrading script of 5.3...
5.3.1 may be fixed.

10. And then you are DONE~!

----------------------------------------
Finishing Upgrade :-)
----------------------------------------

1. Go back to [Sitewide Setting] and turn off maintenance mode

2. Check your front page sites to check if nothing is missing, or get PHP error

3. [Sitewide Setting] - [Maintenance]

turn Pretty URL back if you were using one.
Turn Production Mode on,
and enable Cache


Now you should be done~!

----------------------------------------
Order of Left menu bar
----------------------------------------

So if you upgrade from 5.2.1 to 5.3, you noticed that the order of left side menu is changed.

There is nothing wrong with it.

If you clean install 5.3, File Manager is located between Sitemap and Report. And Scrapbook is located between User & Groups and Page & Theme.

But when you upgraded from 5.2.1 to 5.3, the File Manager and Scrapbook are located at the bottom.

It's because File Manager and Scrapbook are the new menu... and new menu are added at the bottom.

So it's no problem.. and it's not an error.

But if you feel weird like I did :-), here is the instruction.

1. Go to Sitemap
2. Click "Show System Pages" on the right bottom of the page
3. Open Dashboard
4. Click any pages and select "Change Page Order"
************
From 5.3, you can NO LONGER change the page order by drag and drop. Due to some technical stuff... you must enter "Change Page Order" mode in order to move pages.
************
5. Change the page order as you wish of left menu bar

And the page order of your left menu will be re-ordered.

That's it.

So this is my step by step 5.3 upgrade guide.

katz515
 
andrew replied on at Permalink Reply
andrew
The profile and dashboard user settings pages should DEFINITELY be created by the upgrade scripts. This must be an oversight. We can add them in in the next upgrade (obviously checking first whether they're created or not.)