h1. Upgrade Procedures
* [from 3.1.x|Upgrade Data and Agent]
* [from 3.0.x|Upgrade Data and Agent]
* [from 2.1.x|Upgrade Data and Agent]
* [from 2.0.x|Upgrade 2.0.x]
* [from 1.x|Upgrade QuickBuild 1.x]
* [from Luntbuild|Upgrade Luntbuild]
h1. Important Changes Affecting 1.x, 2.x and 3.x Users
* Changes for builds generated by QuickBuild 2.x will not be displayed, as we changed the storage mechanism in 4.x to disclose more commit information, and this mechanism is not compatible with the one used in 2.x. Changes information for builds generated by QuickBuild 3.x can still be displayed.
* Existing test history of TestNG will be dropped. The reason is that previously we used method name as key, which is not accurate due to method overloads. In 4.0.x, we use method signature instead to avoid this issue and unfortunately this is not compatible with test history generated by previous versions.
* Changes detection is now happens on the node running master step in order to reduce server load. So please make sure that relevant SCM tools are installed on the master node if necessary.
* The step pre/post action _Cancel sibling steps if current is failed_ has been removed. To fail other steps if one step fails, please edit the parallel composition step, and check the _Cancel On Error_ option.
* The notation to reference latest build with a configuration id has been changed from _<configuration id>:latest_ to _<configuration id>.latest_, and the same applies for latest successful/finished/failed builds. Refer to [build name|Build] for details.
* [from 3.1.x|Upgrade Data and Agent]
* [from 3.0.x|Upgrade Data and Agent]
* [from 2.1.x|Upgrade Data and Agent]
* [from 2.0.x|Upgrade 2.0.x]
* [from 1.x|Upgrade QuickBuild 1.x]
* [from Luntbuild|Upgrade Luntbuild]
h1. Important Changes Affecting 1.x, 2.x and 3.x Users
* Changes for builds generated by QuickBuild 2.x will not be displayed, as we changed the storage mechanism in 4.x to disclose more commit information, and this mechanism is not compatible with the one used in 2.x. Changes information for builds generated by QuickBuild 3.x can still be displayed.
* Existing test history of TestNG will be dropped. The reason is that previously we used method name as key, which is not accurate due to method overloads. In 4.0.x, we use method signature instead to avoid this issue and unfortunately this is not compatible with test history generated by previous versions.
* Changes detection is now happens on the node running master step in order to reduce server load. So please make sure that relevant SCM tools are installed on the master node if necessary.
* The step pre/post action _Cancel sibling steps if current is failed_ has been removed. To fail other steps if one step fails, please edit the parallel composition step, and check the _Cancel On Error_ option.
* The notation to reference latest build with a configuration id has been changed from _<configuration id>:latest_ to _<configuration id>.latest_, and the same applies for latest successful/finished/failed builds. Refer to [build name|Build] for details.