gmcdonald

This upgrade advice is unofficial in a number of ways.

• 5.0-dev itself is Unofficial
• I’m no Roller expert and not involved with the project what-so-ever
• I’m not responsible if you break it or lose any information
• Use at your own risk and don’t come crying to me

I assuming you have Roller 4.0.1 installed running under Tomcat 6.

1. Backup your roller database – $ mysqldump -uroot -p rollerdb > rollerdb.dump
2. Enter password when promted
3. Backup your roller directories
4. Double Triple Check you backup up ok!!
5. Download and extract Roller 5.0-dev somewhere
6. Edit roller-custom.properties and change from manual to auto
7. open tomcat manager in web browser and Undeploy current /roller
8. create a new webcontext /roller5 and point it to new Roller 5 /webapp/roller directory
9. Deploy new /roller5 webapp
10. navigate to yoursite.com/roller5
11. roller wlll ask confirmation to upgrade database table, click yes.
12. Edit roller-custom.properties and change to auto.
13. Job done if all went well.

Right after the upgrade you may hit the 500 error (planet not bootstrapped) if you previously had aggregation turned on for your front page. Go into your Global Admin area and disable it. The  your blog front page should show up. If you need aggregation on your blogs into the front page you’ll need to follow the install guide section 9.1.

IF things did not go well and you want to roll back.

1. Swear like a trooper
2. Open tomcat manager and undeploy your new /roller5
3. Restore database with – $ mysql –uroot –p rollerdb < rollerdb.dump
4. in tomcat manager recreate your original webcontext /roller and point to your old Roller 4.0.1 /webapp/roller directory
5. in your web browser go to yoursite.com/roller and breath a sigh of relief

All of the above, both the upgrade and the restore in neccessary should first be performed in a test environment.
At any step anywhere above you may need to restart tomcat for a change to take effect. (hit & miss with me whether it needed to or not)

The Official documentation for upgrading Roller is in the v4.0.1 Installation Guide (Section 9.4 for manual table upgrade, Section 10.2 for auto upgrade)

Anyway hope it was of some use.