changes.
| | # Stop QuickBuild server of previous version. |
| # Extract installation package of new version to a new directory. |
| # Open a command line window, and switch to the _bin_ sub directory under the *new version*'s installation directory. Run the migrate command to migrate from previous QuickBuild version. On Windows platform, the command is _migrate.bat <install directory of previous QuickBuild version>_, and on unix platforms, it will be _migrate.sh <install directory of previous QuickBuild version>_. |
| # Start QuickBuild server in new installation directory. |
| | 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 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. If there is not any errors, you may safely delete installation directory of previous version of QuickBuild server. |
| | # Verify the server and agent installation by running some builds. |