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
Windows Installation Guide instead.
Upgrade from ScrumWorks Basic
or ScrumWorks Pro to ScrumWorks Pro latest stable release
Before you begin, please back up your data.
Although the upgrade process should not affect
your existing data, it is always a good idea to
back up data before upgrading.
- Backup your data
Backup the existing ScrumWorks Basic/Pro database.
- Download the latest ScrumWorks Pro
Obtain the latest stable version of ScrumWorks Pro
Windows distribution from the ScrumWorks Pro Upgrade
web site. Note, the upgrade distribution is identical to the distribution used for fresh installations.
- Load the ScrumWorks Pro Upgrade web site in a web browser:
http://danube.com/scrumworks/pro/upgrade
- 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"
- Select the latest Windows platform distribution and download.
The distribution file is an archive named: scrumworks-pro-version-win.zip
- Extract the ZIP file into a temporary directory.
- 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 Start Menu or from the Services screen in the Control Panel.
- Run Installer
Run the "ScrumWorks Server Setup.exe" file.
Review and accept the License, or click "Cancel" to exit at any time.
-
Choose Install Location
Choose whether to upgrade an existing installation in place,
or install ScrumWorks Pro parallel to an existing installation. If installed in a parallel
location, the installer will still provide an option to migrate data from existing installation
without over-writing that installation.
Upgrade Existing Installation (Over-write)
- To upgrade an existing installation, input the location of the
installation to upgrade in the Destination Folder field on the "Choose Install Location" screen. Click "Next".
- If a valid installation of ScrumWorks is detected, 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.
Parallel Installation (Preserve Original Installation)
- Input a Destination Folder
other than the path to an existing ScrumWorks installation on the "Choose Install Location" screen. Click "Next" to continue.
- Choose between two options: Start with new data, or Migrate existing
ScrumWorks data from another installation of ScrumWorks.
If starting with new data:
- This option will include the sample database.
If migrating existing ScrumWorks data:
- If an existing local installation is
detected, the installer will pre-populate the "Choose folder" field of the Migrate option.
- If you want to migrate data from another computer, use the backup process on the source computer and
copy the resulting directory and database files (scrumworks.properties and scrumworks.script) to the destination computer. In the installer, set the "Choose Folder"
location to the directory of the ScrumWorks files obtained
from the source computer.
- Be sure that the existing ScrumWorks server to
be migrated is shut down. Migrating data from an existing ScrumWorks server will
not affect the existing installation.
- Be sure that the existing ScrumWorks server to be migrated is shut down.
Only one ScrumWorks server can be run at any one time.
Note: if your previous installation had non-default JVM options (such as memory settings), these options will not port to your parallel installation.
- Choose Start Menu Folder
Click Install to finish the installation.
- Confirm your installation
ScrumWorks Pro takes a few moments to start, and once
started the login screen shall be visible locally on the via a web browser at
http://localhost:8080/scrumworks/.
Please check our
Support
Resources for more help with upgrades.
Using MySQL Database with ScrumWorks Pro
If you wish to transfer from a Hypersonic to a MySQL database, please read the
Hypersonic-to-MySQL transfer documentation.
Caution: once transferred to MySQL, ScrumWorks Pro data cannot be transferred back to Hypersonic.