This documentation relates to QuickBuild 10.0.x
Select here if you are using a different version

Upgrade to 3.0.x

Version 1 by Robin Shen
on Jan 13, 2019 22:25.


 
compared with
Version 2 by Robin Shen
on Mar 01, 2020 07:04.


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.

 h3. Upgrade procedures
 * [from 3.0.x|Upgrade Data]
 * [from 2.1.x|Upgrade Data]
 * [from 2.0.x|Upgrade 2.0.x]
 * [from 1.x|Upgrade QuickBuild 1.x]
 * [from Luntbuild|Upgrade Luntbuild]
  
 h3. Incompatibilities with 2.x
 # If empty value is specified for a prompted variable, the variable will get value of _null_. In 2.x, the default value will be used when prompted value is left empty.
 # View log by step is not possible for migrated builds.
 # Executed steps should be referenced by [step path] instead of step name.
  # RESTful API is not compatible with 2.x. Existing programs needs to be changed to use the [new API|RESTful API] in order to interact with 3.x server.
  # RESTful API is not compatible with 2.x. Existing programs needs to be changed to use the [new API|XML RESTful API] in order to interact with 3.x server.
 # QuickBuild tray monitor needs to be reinstalled in order to interact with 3.x server.
 # The method _isScheduled()_ of configuration object is now removed. Call _request.scheduled_ instead to check for scheduled build.
 # The _current_ object used in next build version field needs to be replaced with _configuration_ as _current_ now points to the version manager object itself.
 # Builds can not be moved from one configuration to another; otherwise, change and issue comparison will not be accurate.
 # To build in a future time, define a variable prompting for date or time input, and specify pre-queue script as below:
 {code}
 request.setRequestDate(vars.get("name_of_the_date_var").asDate())
 {code}
 # The method _build.getSteps()_ is removed. If a custom email notification template is used (other than using _default_html_notification.vm_), please change error message rendering part of the template as below:
 {code}
 #if ($build.hasErrors())
 <h3>Error Messages</h3>
 <table class="error-messages">
  #if ($build.errorMessage)
  <tr>
  <td colspan="2" valign="top">$util.formatString($build.errorMessage)</td>
  <td valign="top"><a href="$build.logUrl">build log</a></td>
  </tr>
  #end
  #foreach ($stepPathName in $build.stepRuntimes.keySet())
  #set($step=$build.stepRuntimes.get($stepPathName))
  #if ($step.errorMessage)
  <tr>
  <td valign="top">$stepPathName</td>
  <td valign="top">$util.formatString($step.errorMessage)</td>
  <td valign="top"><a href="$build.getLogUrl($stepPathName)">step log</a></td>
  </tr>
  #end
  #end
 </table>
 #end
 {code}
 # Custom plugins for 2.x need to be re-compiled and re-exported. Below changes may affect your plugin:
 ## Class _com.pmease.quickbuild.web.component.editor_ is renamed to _com.pmease.quickbuild.web.component.editor.BeanEditor_.
 ## Read only mode of BeanEditor is removed, and a separate class _com.pmease.quickbuild.web.component.BeanViewer_ is added for display bean properties.