Windows® Upgrade Guide (MySQL) for Release 5.1
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 Windows 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
Windows Upgrade Guide (MySQL)
  • Backup existing data
  • Obtain Latest ScrumWorks Pro
  • Shut down any existing ScrumWorks service
  • Upgrade ScrumWorks Pro Server
  • Start-up and Shutdown Options
  • Changing the amount of memory available to the ScrumWorks Server
Documentation Home

Windows Upgrade Guide (MySQL)

Backup existing data

The first upgrade step is to backup the ScrumWorks Pro server you intend to upgrade. Although the upgrade process should not affect your existing data, it is always a good idea to back up data before upgrading.

Please refer to the backup documentation.

» top

Obtain Latest ScrumWorks Pro

Existing customers can obtain the latest stable version of ScrumWorks Pro Windows distribution from the ScrumWorks Pro download web site. Note, the same binaries are used for both upgrades and fresh installations.

  1. Open the ScrumWorks Pro download web site in a web browser.
  2. Enter your Case ID number and the maximum users in your license. These two values can be found by opening the license file in a text editor. Alternatively, existing customers will find the values for the "Case ID" and "Licensed Users" in the "Help > About" menu in the Desktop Client.
  3. Select the latest Windows platform MySQL distribution and download. The distribution file is an archive named:
    scrumworks-pro-[version]-win-[arch].zip
  4. Extract the ZIP file into a temporary directory.

» top

Shut down any existing ScrumWorks service

The ScrumWorks Pro service must be shutdown prior to running the setup program in the next step. This is done one of two ways:

  • from the Windows Start Menu, locate the ScrumWorks Pro Server folder and select the Shutdown option; or
  • locate "Services" from the Control Panel and shutdown ScrumWorks Pro server.

» top

Upgrade ScrumWorks Pro Server

  1. Run Setup. Extract the zip archive and run the ScrumWorks Server Setup.exe file. Review and accept the License, or click "Cancel" to exit at any time. An administrator user account is required to upgrade ScrumWorks Pro server on all Windows platforms.
  2. Choose Install Location. The upgrader will now request that you specify the location of an existing ScrumWorks Pro Server installation.
    • Input the location of the existing installation to be upgraded in the Destination Folder field on the "Choose Install Location" screen. Click "Next".
    • The upgrader will now verify the validity of the existing ScrumWorks Pro Server installation. Once verified, the next screen will summarize steps taken by the upgrade process. Click "Next" to continue.
    • Note, custom JVM options (such as memory tweaks) will remain intact via this upgrade process.
  3. Choose Start Menu Folder. Click Install to finish the installation.
  4. Confirm your installation. ScrumWorks Pro takes a few moments to start, and once started the login screen shall be visible locally on the server via a web browser at http://localhost:8080/scrumworks/.
Please check our Support Resources for more help with upgrades.

» top

Start-up and Shutdown Options
  • To shutdown the ScrumWorks Pro Server, open your "Start Menu", and navigate to the ScrumWorks Pro Server folder. Click the "Stop ScrumWorks Pro Service" menu item.

    You can also stop the ScrumWorks Pro Server via the Services dialog in the Windows Control Panel Administrative Tools.

  • By default, the ScrumWorks Pro Server will be started automatically the next time you reboot. Locate the ScrumWorks Pro Service in "Administrative Tools" > "Services" to modify start up options.

» top

Changing the amount of memory available to the ScrumWorks Server

By default, ScrumWorks Pro is permitted to use up to 768MB of memory. If you would like to modify the amount of memory used by the ScrumWorks Pro Server, run the memory.exe tool located under the utils folder inside ScrumWorks Pro Server folder and select the desired amount of Allocated Memory.

You must run the memory.exe tool as Administrator. Right click on the file and click "Run as Administrator".

You will need to restart the server for the changes to take effect.

Note that if the allocated memory is too large, the service will fail to start. In this case, the amount of allocated memory needs to be lowered. Please check with your Windows administrator for advice on adjusting ScrumWorks Pro server's memory allocation.

» top

Documentation Home | Web Client User Guide | Support and Training | ScrumWorks Desktop Client
Copyright © 2011 CollabNet, Inc. All rights reserved.