Migrate a project to the latest version of Twist

As newer Twist versions are released, some of the settings of existing Twist projects may need to be migrated such that they work seamlessly with updated versions of Twist.

How to migrate a Twist Project?

Twist automatically detects and prompts you to migrate a project if necessary, when the you open a Scenario in the Twist IDE. A project, can also be manually migrated by using the option available on the context menu on a project in the Scenario View.

Prerequisites for migration:

During Migration, you will see a dialog that lists outs the operations performed during migration. If the project cannot be migrated for some reason, then a dialog box would pop up with an explanation. Please fix the problem encountered and try re-running Migration again.

Migration can also be invoked in verbose mode such that it lists out more details of the activities performed. Please create a log4j.properties file with the logger entry shown below and add it to the classpath. (Refer to the Appendix below for more information)

log4j.logger.com.thoughtworks.twist.migration = DEBUG

The following describes the changes that would be performed as a part of automated migration in Twist.

Migrating to 2.0

  • The Twist version number will be updated
  • Twist now also supports the groovy language. The migration process will add a Java Language Support library to classpath for existing Twist projects.

Migrating to 1.1 GA

Migrating to 1.0 GA