Mac OS X® Upgrade Guide (MySQL) for Release 3.2

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 Mac OS X 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:
      # launchctl stop scrumworks

    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 Mac OS X 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 Mac OS X platform distribution and download. The distribution file is an archive named: scrumworks-pro-version-mac_linux-mysql.tar.bz2

  4. Extract the new version of ScrumWorks Pro one of two ways:

    • Open the Terminal utility found in the Applications/Utilities folder.
      At the prompt, enter: tar -jxvf scrumworks-version-mac_linux.tar.bz2

    • Extract the archive by double-clicking the icon for the file: 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.

    1. Open the Terminal utility found in Applications/Utilities

    2. Change to the ScrumWorks Pro directory:
      # cd /path/to/scrumworks-version

  7. Run the setup.sh shell script. 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. Your database configuration settings will be copied from this location.

  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