The first migration step is to backup the ScrumWorks Pro server you intend to migrate. Although the migration 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.

You must upgrade your existing Windows-based ScrumWorks Pro server installation to the latest release before migrating.

Follow the appropriate upgrade instructions before continuing this migration guide.

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.

The following instructions apply for ScrumWorks Pro server installations using the Hypersonic database.

1. Download the latest ScrumWorks Pro Unix-Hypersonic release and follow the Linux installation instructions or the Mac OS X installation instructions.
2. Before starting your new Unix version, you need to copy your data from Windows to Unix:

   Hypersonic Database

   • SCRUMWORKS_HOME/server/scrumworks/data/hypersonic/scrumworks.script
   • SCRUMWORKS_HOME/server/scrumworks/data/hypersonic/scrumworks.properties
3. Start the Unix server as described in the Linux installation instructions or the Mac OS X installation instructions.
4. To confirm your migration, open a web browser on local server and point to:

   http://localhost:8080/scrumworks/

   Login to confirm that the data has been migrated.

The following instructions apply for ScrumWorks Pro server installations using the MySQL database.

1. You may need to move your MySQL database. Refer to the MySQL Backup and Restoration section of the manual.
2. Download the latest ScrumWorks Pro Unix-MySQL release and follow the Linux installation instructions or the Mac OS X installation instructions.
3. During the installation process, select either your newly installed MySQL database (from Step 1) or your existing MySQL database location and credentials.
4. Start the Unix server as described in the Linux installation instructions or the Mac OS X installation instructions.
5. To confirm your migration, open a web browser on local server and point to:

   http://localhost:8080/scrumworks/

   Login to confirm that the data has been migrated.