Linux Upgrade Guide (Hypersonic) for Release 3.2

Documentation Home | Desktop Client User Guide | Web Client User Guide | Support and Training
The ScrumWorks Pro Upgrade Guide is intended to help administrators migrate from ScrumWorks Basic or older versions of ScrumWorks Pro with Hypersonic to the latest stable ScrumWorks Pro with Hypersonic. For users upgrading from ScrumWorks Basic, Windows upgrade is limited to ScrumWorks Basic version 1.8.3. If you are installing from scratch, then please refer to the Linux Installation Guide instead.
Quick Links


Documentation Home

Upgrading from ScrumWorks Basic 1.8.3/ScrumWorks Pro 2.x/ScrumWorks Pro 3.0+ (Hypersonic) to ScrumWorks Pro 3.2
  1. Before you begin, back up your data. Although correctly following the upgrade instructions will not affect your existing data, it is always a good idea to make a backup copy before upgrading. For help, see: Backing up your existing ScrumWorks Pro/Basic database.

  2. Shut down your old ScrumWorks Pro server. This is done one of two ways, depending on whether you've configured ScrumWorks to run as a background daemon or a foreground process (started manually via the shell prompt):

    • If it is running in the foreground, CTRL+C stops it.

    • If it is running as a daemon:
      # /etc/init.d/scrumworks_init.sh stop

    Note: You must shut down your existing ScrumWorks service in order to upgrade to the latest release. Failure to do so before the upgrade step will result in a broken installation.

  3. Download the latest ScrumWorks Pro
    Obtain the latest stable version of ScrumWorks Pro / MySQL Linux distribution from the ScrumWorks Pro Upgrade web site.

    1. Load the ScrumWorks Pro Upgrade web site in a web browser:
      http://danube.com/scrumworks/pro/upgrade

    2. Enter your Case ID number and the maximum users in your license. These two values can be found by loading the ScrumWorks Pro Desktop Client and navigating to the "Help" menu. Select "About" from the "Help" menu and note the values for the "Case ID" and "Licensed Users"

    3. Select the latest Linux platform distribution and download. The distribution file is an archive named: scrumworks-pro-version-mac_linux.tar.bz2

    4. Extract the ZIP file into a temporary directory.



  4. Extract the new version of ScrumWorks Pro using the "tar" command:

    # tar -jxvf scrumworks-version-mac_linux.tar.bz2

    A new folder named scrumworks-version will appear.

  5. Move the scrumworks-version folder where you ultimately want your new ScrumWorks installation to reside.

  6. Using a command-line shell, navigate into the scrumworks-version directory.

    # cd /path/to/scrumworks-version

  7. Run the setup.sh shell script. The setup.sh script will install a fresh installation of ScrumWorks Pro. Follow the prompts to download the required third-party files. These files are necessary for a successful installation of ScrumWorks Pro.

    # ./setup.sh

  8. You will be asked if this is an upgrade. Answer "y". When prompted, enter the path to the root of your old ScrumWorks installation.

  9. The upgrade process will copy existing data into your new installation of ScrumWorks Pro. Your existing data will not be affected, so if you choose to abort the upgrade process, your old installation of ScrumWorks will remain intact.

  10. After the upgrade is complete, ScrumWorks can be started. If you chose to run as a daemon background process, the server will be started automatically. If you chose to run as a foreground process:

    # cd /path/to/scrumworks-version/bin
    # ./scrumworks.sh

  11. In the future, if you wish to change whether ScrumWorks Pro runs as a daemon, shut down the server and run setup.sh again. During the setup.sh script, indicate whether ScrumWorks Pro starts as a daemon or not.

Please check our Support Resources for help with your upgrade.

» top


Documentation Home | Desktop Client User Guide | Web Client User Guide | Support and Training

© 2008 Scrumworks, LLC. All rights reserved.