Created this page because I found the "official" migration docs rather wanting. This guide assumes you have read those docs though, since they contain vital information to get it working. What follows is just a step by step procedure to fill in the blanks:

Setup:

One Tracker on a Windows 2003 Server running Roundup 0.7.11 with a few modifications (interfaces.py, detectors) as a Windows Service. Substitute TRACKER_HOME with absolute path to your tracker...

  1. Backup current TRACKER_HOME
  2. run 'net stop "Roundup Bug Tracker" at command line
  3. run roundup-server -c remove. This assumes you have roundup-server somehow executable. I will use this as an abreviation. In your case it might be C:\Python23\python.exe C:\Python23\Scripts\roundup-server -c remove or similar!
  4. uninstall Roundup 0.7.11 (Control Panel --> Add or Remove programs --> Python 2.3 roundup-0.7.11)
  5. install Roundup 0.8.1
  6. create a config file for your tracker: roundup-admin genconfig TRACKER_HOME\config.ini and read official migration doc on how to configure it.
  7. create TRACKER_HOME\schema.py according to migration docs
  8. edit TRACKER_HOME\schema.py for new permissions according to migration docs ("Create" permission!)
  9. create directory TRACKER_HOME\extensions and populate it according to migration docs (i.e. copy stuff out of TRACKER_HOME\interfaces.py)
  10. create file TRACKER_HOME\db\backend_name in db directory and insert the appropriate backend name with a text editor
  11. delete everything in TRACKER_HOME except config.ini and schema.py
  12. generate config file for roundup-server: roundup-server -S -C "TRACKER_HOME\roundup-server.ini" and edit it according to migration docs
  13. test server with 'roundup-server -C "TRACKER_HOME\roundup-server.ini", browse, click etc. When finnished, use [CTRL]?-[BREAK]? to stop server.
  14. install server with roundup-server -C "TRACKER_HOME\roundup-server.ini" -c install this will register Roundup as a Service. You can change the path of roundup-server.ini in the registry: HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\roundup, check the ImagePath Variable.
  15. configure the service (set its startup type to "Automatic") with the windows services program

enjoy.

Daren Thomas