This version of the WRE is a complete rewrite of the WRE from the ground up.  All templates, file locations, APIs, etc have been changed in this release. Therefore there is no direct upgrade path from previous WRE versions to WRE 0.8.0.

 

This document has been created to help you migrate from older versions of the WRE to 0.8. This document is a work in progress, so if you find tips or tricks for other users along the way, please share them here.

 

Before you begin the migration process backup WebGUI, the WRE, your domains folder, and anything else just in case something goes wrong.

 

Your sites will be offline while you perform this process, so plan in advance for downtime and prepare your users. Now shutdown your old WRE  and move it:

rc.webgui stop

cd /data

mv wre wre.old

mv WebGUI WebGUI.tmp

Download WRE 0.8 and install it following the instructions in the install.txt file that comes with it.

 

When it asks if you want to do Automated or Manual install, stop. Move your WebGUI directory back into place:

 

mv WebGUI.tmp WebGUI

 

Then go back to the console and click the Manual install button. 

Copy your old site configs from /data/wre.old/etc/ into /data/wre/etc. You're looking for files that look like:

www.example.com.modproxy

www.example.com.modperl

awstats.www.example.com.conf

 

If you used any version of the WRE prior to 0.7.2 you'll need to rename your domains folders. Older versions created folders like this:

/data/domains/example.com/www/public

We need the domains folders to look like:

/data/domains/www.example.com/public

Don't forget to also modify your WebGUI config files your modperl, modproxy, and awstats files in your /data/wre/etc folder. 

 

In /data/wre.old/etc you'll find a bunch of old config files like wremonitor.conf, backup.conf, and logrotate.conf. Open the new WRE Console and go to the settings tab. Now copy any settings from the old config files into the WRE Console settings page. Hit save when you're finished. In addition, if you've made any customizations to the /data/wre.old/prereqs/apache/conf/httpd.modproxy.conf, /data/wre.old/prereqs/apache/conf/httpd.modperl.conf, /data/wre.old/prereqs/apache/conf/startup.pl, or /data/wre.old/prereqs/mysql/my.cnf files then make sure to apply those customizations to /data/wre/etc/modproxy.conf, /data/wre/etc/modperl.conf, /data/wre/etc/modperl.pl, and /data/wre/etc/my.cnf files respectively.

 

Now move your old 0.7.2 databases into place in the new WRE.

cd /data/wre/var/mysqldata

mv mysql /tmp/

cp -Rfp /data/wre.old/prereqs/mysql/var/mysql ./

cp -Rfp /data/wre.old/prereqs/mysql/var/www_example_com ./

And make sure that whatever user you used during the WRE 0.8 install process owns all these folders and files.

chown -R webgui.webgui *

Remove all the old cron jobs you had running, and update them with the ones in the install.txt file that comes with the WRE.

Now that you've migrated everything, it's time to see if it all works. Start up each service one at a time.

wreservice.pl --start mysql

wreservice.pl --start modperl

wreservice.pl --start modproxy

wreservice.pl --start spectre

If any of them fails, consult the log files. All logs in WRE 0.8 have been moved into /data/wre/var/logs.

The Next Day

Verify that your backups are still working if you were using the backup.pl that came with the previous wre, you may need to enable backups again. Also, I had to recreate the file /data/wre/etc/backup.exclude.

Troubleshooting

If you get this error in the modperl log when modperl tries to start

[notice] child pid xxxx exit signal Segmentation fault (11)

change the first line in /data/wre/etc/sitename.modperl file

from <VirtualHost *:81> to <VirtualHost *:8081>

and restart modperl with

wreservice.pl --restart modperl

That's all folks!