Icon

    This is the documentation for for an older version of Qube.

    Documentation for the latest release is available here.

    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.

    Icon

    It is always a good idea to back up your current installation before proceeding with an update. You should also block all Workers from picking up new jobs, and either stop all running jobs, or let all running jobs complete.

    To block the workers, use the WranglerView UI or the qblock command. See this page for details.

    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
    • No labels