h1. Upgrade from QuickBuild 1.x
h2. Migration procedure
# Login to QuickBuild 1.x as administrator, switch to page _Administration/Backup Database_, and backup the database as _backup.xml_ under QuickBuild 1.x's installation directory.
# Install QuickBuild2 following the [installation guide|Installation Guide]. Assume installation directory for QuickBuild2 server is _/opt/quickbuild2_.
# Open a command prompt window, switch to directory _/opt/quickbuild2/bin_, and run command _migrate.sh <QuickBuild 1.x installation directory>_ (or _migrate.bat_ on Windows). The param _<QuickBuild 1.x installation directory>_ should be replaced by the actual installation directory of
QuickBuild 1.x.
# After migration, please check the file _/opt/quickbuild2/migrate/migrate-log.html_ for all settings that can not be migrated and needs to be re-configured.
h2. Important changes that affect 1.x users
# Configuration settings such as build necessary condition, variables definitions, promote settings, build clean up strategies are placed into advanced settings tab.
# Expressions have been changed a lot. Due to complexity of expressions, we can only migrate default expressions that have not been changed by users. For customized expressions, please rewrite them based on the scripting help, which can be accessed by poining mouse to the help icon when edit related properties.
# By default only one promote destination can be defined now. However multiple promote destinations can be enabled by using variables and scripts as explained in help of property _configuration_ when defined the promotion setting.
# Promotion mechanism is simplified and a QuickBuild repository is no longer necessary in order to fetch files from promotion source. Instead, promotion files are specified when define the promotion settings of related configurations.
# The step type _Send Notification_ is now removed. To specify receivers and conditions of build notifications, please edit advanced settings of related configurations, and enable proper notifications.
h2. Migration procedure
# Login to QuickBuild 1.x as administrator, switch to page _Administration/Backup Database_, and backup the database as _backup.xml_ under QuickBuild 1.x's installation directory.
# Install QuickBuild2 following the [installation guide|Installation Guide]. Assume installation directory for QuickBuild2 server is _/opt/quickbuild2_.
# Open a command prompt window, switch to directory _/opt/quickbuild2/bin_, and run command _migrate.sh <QuickBuild 1.x installation directory>_ (or _migrate.bat_ on Windows). The param _<QuickBuild 1.x installation directory>_ should be replaced by the actual installation directory of
QuickBuild 1.x.
# After migration, please check the file _/opt/quickbuild2/migrate/migrate-log.html_ for all settings that can not be migrated and needs to be re-configured.
h2. Important changes that affect 1.x users
# Configuration settings such as build necessary condition, variables definitions, promote settings, build clean up strategies are placed into advanced settings tab.
# Expressions have been changed a lot. Due to complexity of expressions, we can only migrate default expressions that have not been changed by users. For customized expressions, please rewrite them based on the scripting help, which can be accessed by poining mouse to the help icon when edit related properties.
# By default only one promote destination can be defined now. However multiple promote destinations can be enabled by using variables and scripts as explained in help of property _configuration_ when defined the promotion setting.
# Promotion mechanism is simplified and a QuickBuild repository is no longer necessary in order to fetch files from promotion source. Instead, promotion files are specified when define the promotion settings of related configurations.
# The step type _Send Notification_ is now removed. To specify receivers and conditions of build notifications, please edit advanced settings of related configurations, and enable proper notifications.