Upgrade 2.0.x

Version 5 by Robin Shen
on Dec 24, 2009 06:50.

<< Changes from 4 to 5
compared with
Current by Robin Shen
on Dec 24, 2009 06:52.

 
Key
These lines were removed. This word was removed.
These lines were added. This word was added.

View page history


There are 1 changes. View first change.

 In this procedure, we assume that installation directory of 2.0.x server is _/quickbuild-old_, and new version of QuickBuild is extracted to directory _/quickbuild-new_.
 # Login to 2.0.x as administrator, switch to menu _Administration/Database Backup_, and backup the database to file _backup.zip_. After the backup, you should be able to find the file _/quickbuild-old/backup.zip_.
 # Stop QuickBuild 2.0.x server process. On Windows platform, please also run _/quickbuild-old/bin/service-uninstall.bat_ to unregister the QuickBuild NT service if it is installed previously.
 # Copy below files from _/quickbuild-old_ into the same place under _/quickbuild-new_:
 ## all files under the _conf_ directory *except* _wrapper.conf_ and _wrapper_license.conf_.
 ## all files under the _lib_ directory.
 ## all files under the _resource_ directory *except* _default_html_notification.vm_, and _default_plain_notification.vm_.
 # If you've adjusted memory setting (property _wrapper.java.maxmemory_), and java command (property _wrapper.java.command_) in _/quickbuild-old/conf/wrapper.conf_, make the same adjustment in _/quickbuild-new/conf/wrapper.conf_.
 # If you are connecting to external database in old QuickBuild (please check file _quickbuild-old/conf/hibernate.properties_ for sure), manually delete the database using your database tool, and create a new one with the same name.
 # Open a command line window, switch to directory _/quickbuild-new/bin_, and run command _restore.(bat|sh)_ /quickbuild-old/backup.zip_ to migrate and restore data of old QuickBuild.
 # Run command _/quickbuild-new/bin/server.bat install_ to install QuickBuild NT service if necessary.
  # Startup new QuickBuild server and check if data has been restored successfully.
  # Startup new QuickBuild server by running _/quickbuild-new/bin/server.bat console_ and check if data has been restored successfully.
 # If you've configured build agents, *re-install build agents* following below steps:
 ## Backup the file _conf/attributes.properties_ under build agent's installation directory.
 ## Delete build agent's installation directory.
 ## Install build agents following [this guide|build agent installation guide].
 ## Overwrite file _conf/attributes.properties_ under build agent's installation directory with the file backed up previously.
 # If user agents are used in your team, tell your developer to *re-install user agents* following below steps:
 ## Backup the file _conf/attributes.properties_ under user agent's installation directory.
 ## Delete user agent's installation directory.
 ## Install user agents following [this guide|user agent installation guide].
 ## Overwrite file _conf/attributes.properties_ under user agent's installation directory with the file backed up previously.
 # Verify the server and agent installation by running some builds.