1. Qube 6.7
2. Qube! Documentation
3. Administrator's Guide
4. Additional Installation Information
5. Upgrading Qube!

Upgrading Qube!

Qube! versioning is indicated by major, minor, and point releases in the format major.minor.point (e.g. 5.5.0).

If you plan to upgrade the major or minor version of Qube!, you will have the best results if you upgrade all of your systems to the latest version. While it is possible to run a mix of older versions of Qube!, there are number of feature enhancements that are not strictly backwards compatible with previous versions. Point releases (5.4.x) are forwards and backwards compatible with other point releases of that minor version (ie. All 5.4 versions) unless noted otherwise.

Due to the number of possible combinations and possibilities for unexpected problems, we cannot support mixed major release environments (4.X with 5.X, etc). Mixing minor releases can sometimes be done, but is not encouraged.

Upgrading with the Installer

This is the recommended way to upgrade Qube! The installer will take care of stopping and restarting services, and so requires very little input from the admin. Simply start the Qube! installer (for download instructions, see this page) and run it as root or Administrator. Click through to the Selection Screen and choose "Upgrade Installed".

That's it! The installer will take care of stopping and starting services, downloading and installing software, etc.

Upgrading Manually

You may still wish to upgrade Qube! manually. Here are the steps for doing that. You will have to either perform these actions as an Administrator (or root) or use sudo.

Upgrade Supervisor

1. Stop Activity on the Farm
   It's good practice to first stop current farm activity before doing an upgrade of the Supervisor. Run the following from a command shell to block Workers from picking up new work:
   
   1. % qblock --all
      Wait for all activity to stop, or pause any running jobs.
   
   
2. Stop the Supervisor service
   Linux:        /sbin/service supervisor stop
   OS X:        SystemStarter stop supervisor 
   Win: (dialog):  Services Window->Supervisor->stop
   Win (cmdline): net stop qubesupervisor
   
   
3. Uninstall the old version of Qube! and install the new version
   Linux: 
   1. rpm -e qube-core-ver-releaseos.arch.rpm 
   2. rpm -e qube-supervisor-ver-release-os.arch.rpm 
   3. rpm –ivh qube-core-ver-releaseos.arch.rpm 
   4. rpm –ivh qube-supervisor-ver-release-os.arch.rpm 

   OS X:
   1. Follow the standard installation with the .pkg/.mpkg installers (see Installation section for details). The installers will show "Update" instead of "Install" to indicate this is an update. 
   Windows:
   1. Open the "Start->Control Panel->Add/Remove Programs" and remove the Qube Components ("Qube! Supervisor Service", "Qube! Core", etc).
   
   
4. Install the new Qube Core and Supervisor (see Installation section for details)
5. Restart Services
   Linux Only: /sbin/service supervisor start
   All OSs:      qbunlock --all

Upgrade Workers

1. Shut down the Worker daemon
   Linux:               /sbin/service worker stop
   OS X:               SystemStarter stop worker
   Win: (dialog):   Services Window->Worker->stop
   Win (cmdline):  net stop qubeworker
   
   
2. Uninstall the old version of Qube and install the new version
   Linux:
   
   1. rpm –Uvh qube-core-ver-release-os.arch.rpm
   2. rpm –Uvh qube-worker-ver-release-os.arch.rpm
   OS X:
   
   1. Follow the standard installation with the .pkg/.mpkg installers (see Installation section for details). The installers will show "Update" instead of "Install" to indicate this is an update. 
   Windows:
   
   1. Open the "Start->Control Panel->Add/Remove Programs" and remove the Qube Components ("Qube! Worker Service", "Qube! Core", Qube Jobtypes, etc). Install the new Qube Core, Qube Worker, and Jobtypes (see Installation section for details). 
   
   
3. [Linux only] Manually restart the Worker daemon
   
   1. /sbin/service worker start
      
      
4. Restart activity on the farm
   
   1. % qbadmin supervisor --unset stop_activity
   2. % qbadmin supervisor --unset reject_submit