Linux Upgrade Guide (MySQL) 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 an existing ScrumWorks Pro / MySQL installation to the latest version of ScrumWorks Pro / MySQL. If you are installing from scratch, then please refer to the Linux Installation Guide instead. If you want to move an existing ScrumWorks Pro / Hypersonic installation to MySQL, please refer to the MySQL Database Transfer Guide.
Quick Links


Documentation Home

Upgrading from ScrumWorks Pro 3.0+ (MySQL) to ScrumWorks Pro 3.2
  1. Before you begin, back up your data. The ScrumWorks Pro upgrade procedure modifies your existing MySQL database. After the upgrade starts, the database will no longer work correctly with the older version.

  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-mysql.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-mysql.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 upgrade your existing data to work with the new version of ScrumWorks Pro. Your existing database will be upgraded and will not work with the old version.

  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.