Windows® Installation Guide for Release 6.2.0
Thank you for installing ScrumWorks Pro release 6.2.0! The Windows Installation Guide is intended to help users install the Windows version of ScrumWorks Pro Server. Please see our Support Resources with any questions or issues.
Quick Links
Install ScrumWorks Pro Server on Windows
  • Prerequisites
  • Obtaining ScrumWorks Pro
  • Server Installation on Window
  • Start-up and Shutdown Options
  • Changing the default ports and configuring HTTPS
  • Changing the amount of memory available to the ScrumWorks Server
  • Using MySQL Database with ScrumWorks Pro
Documentation Home

Install ScrumWorks Pro Server on Windows

Prerequisites

ScrumWorks Pro is compromised of a Client and a Server component. This guide assists with installing the Windows version of the ScrumWorks Pro server-side component. For more information about the ScrumWorks Pro architecture, please read the Quick Start Guide.

  • ScrumWorks Pro Server Windows edition is supported on Windows XP, Vista, 7, Server 2003, or Server 2008.
  • An administrator user account is required to install ScrumWorks Pro server on all Windows platforms.
  • The host server will require about 700 MB of space initially, a minimum of 2 GB of RAM, and dual CPU cores.

Before installing ScrumWorks, please review the ScrumWorks Server Hardware Recommendations to assist with selecting an appropriate server to host the ScrumWorks Pro Server component.

» top

Obtaining ScrumWorks Pro

Evaluators

Please request a trial license. You will receive an email with instructions on how to obtain ScrumWorks Pro. For all support related questions during your Scrumworks Pro Trial please contact us at: http://community.danube.com/danube

Existing Customers

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 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

Server Installation on Window

If you're upgrading from a previous version of ScrumWorks Pro or ScrumWorks Basic, please follow the Windows Upgrade Guide instead.

Installation Wizard

After obtaining the distribution and unpacking the zip archive, locate the file named ScrumWorks Server Setup.exe and double-click it to engage the installation wizard. Note that an administrator user account is required to install ScrumWorks Pro server on all Windows platforms (except Windows XP).

  • Select a "Destination Folder" Screen. You must install ScrumWorks Pro Server in a path without spaces.
  • Click "Install" Screen. ScrumWorks Pro is installed onto the server during this step. A list of files and operations will be displayed in the installer window.
    • If the installation did not complete successfully, the final screen shows what went wrong and how to find the log file that contains error information.
    • If the installation completed successfully, the ScrumWorks Pro Server Service will start automatically.

After Server Installation

Your installation can be accessed via a web browser once the ScrumWorks Pro starts. It may take a few minutes for the service to start, so please be patient. Once the server is up, open a web browser on the local machine and point to:

http://localhost:8080/scrumworks/

If a web page loads with login options, your installation is successful, congratulations!

Server Log

The server log may be analyzed in case of problems or to further verify the installation and start-up:

INSTALLDIR\server\scrumworks\log\server.log

Log files are rotated once daily.

Continue on to the documentation on using the ScrumWorks Pro Desktop Client.

Please see our Support Resources with any questions or issues.

» 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.
  • Note: It is strongly recommended that you shutdown using this documented process periodically. Doing so deletes large temporary files that otherwise take up disk space.

» top

Changing the default ports and configuring HTTPS

The ports ScrumWorks Pro server listens to by default should be fine for most users. If you have pre-existing software installed on your machine, such as IIS or another copy of JBoss, you may need to change the ports ScrumWorks uses. Also, you may wish to add SSL security to your installation. Please refer to the port and SSL configuration guide.

» 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

Using MySQL Database with ScrumWorks Pro

The MySQL distribution of ScrumWorks Pro allows use of the MySQL database. Before installing the MySQL distribution of ScrumWorks Pro, please read the MySQL requirements and configuration guide.

MySQL is recommended for large production ScrumWorks Pro instances, but requires systems administration knowledge to set up. The Hypersonic distribution is intended for quick and easy set up. 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.

» top

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