Upgrade from VBS 2.0 to VBS 2.1 is not much different from other VBS upgrades. It boils down to:
This upgrade guide is not as thorough as instructions for upgrading VBS 1.2 to 2.x, to which you can refer if you get lost in the process.
Do not overwrite old VBS! If you are upgrading VBS with Testopia, don't forget to install Testopia add-on on VBS 2.1.
Use VMWare Player or Workstation to open and start both old VBS and new VBS. When new VBS starts, write down its IP address, which is shown in Bugzilla URL.
Use console, shown in the VMWare window, or a SSH client. The password is 'bugzilla', unless it has been changed.
If the old VBS is accessible while you are migrating data from it, someone may make changes which will be lost or will get in the way.
The easiest way is to stop Apache web server:
Database dump contains all user data from Bugzilla. To create it, use mysqldump utility:
If using Testopia:
Use the following commands:
If using Testopia:
If you have customized Virtual Bugzilla Server somehow, create a tar archive with your custom configuration files. You will then unpack and apply them on the new server.
Use command:
When asked about authenticity, enter yes.
When asked for password, enter bugzilla — the default password for bugzilla account on the new VBS.
Use account bugzilla/bugzilla. You can login on console or use SSH client.
If importing Testopia, use the same commands to recreate database testopia.
Command: mysql -uroot -proot bugs <bugs.sql
For testopia: mysql -uroot -proot testopia <testopia.sql
For Testopia:
It's probable that you will see warnings about time stamps — ignore them.
You probably need to change database access parameters in localconfig file: db_name, db_user and db_pass.
Use joe localconfig to launch file editor and make arbitrary changes.
Run checksetup.pl, the Bugzilla's installation and upgrade uberscript.
For Testopia:
At last, you need to change the urlbase parameter in data/params file.
If your old VBS is still using numerical URL (with IP address), you can try to run this command: /vbs/update-bugzilla-urlbase.sh:
Otherwise, edit data/params manually.
Other configuration files, like Apache and MySQL setup may be moved in the same way.
This is it. If there were no errors during the upgrade, you should now be able to access new Bugzilla (Testopia) with your old data and settings.
Copyright (C) ALM Works, 2007