C - Upgrade « Squash TA server »

Migrate from 1.6.1 to 1.7.0

• Server migration

  1. Download the version of Squash TA server you want to install here.

  2. Install the new TA server in a separate location as a classical new installation.

  3. Stop both old and new Squash TA execution server.

  4. Copy the content of JENKINS_HOME/jobs of your previous install into the JENKINS_HOME/jobs of your new install

  5. Copy JENKINS_HOME/mvnsettings.xml and JENKINS_HOME/conf.properties of your previous install into the JENKINS_HOME of your new install.

  6. Start your new Squash TA execution server.

  7. Verify in Jenkins log that restore went well.

  8. If you has installed additional plugin you should installed (and eventually configure) them in this new installation

  9. In your new jenkins go to "Manage Jenkins/ Managed files"

     1. Set the same configuration in TAGloablSettings than in the mvnsettings.xml you copied above.

     2. Set the same configuration in conf.properties than in the conf.properties you copied above. You could take the opportunity to use the new syntax to define the tmcallback credentials.

  10. Verify that all your jobs which previously working are still working on your new installation to check that the upgrade went well.

• Job migration

The job template embedded in Squash-TA Server 1.7.0 is based on a maven job whereas the job embedded in Squash-TA Server is based on a free style job. The main advantage of the new job is to be OS free. As we have prepared the new Squash TA Server for being able to use jenkins in a master slave mode (particulary when used with TM) we needed a job which could be executed by a slave on linux or on windows.

It's possible to modify the old template to support the new feature but we encourage our users to migrate to the new job template. The reason is that the old template won't be take into account for futur evolution. The migration consist to create a new job based on the new template ("templateSquashTAExecutionJob") using the classic creation job procedure.

Note, for those using the TM-ta link, at this stage a TM server version < 1.9.0 (1.9.0 included) is unabble to run the new jobs. You need a TM server 1.10

Migrate between two versions older than 1.6.1 (1.6.1 included)

• 1. Download the version of Squash TA server you want to install here.

  2. Install the new TA server in a separate location as a classical new installation.

  3. Stop both old and new Squash TA execution server.

  4. Archive the content of the JENKINS_HOME of your previous install.

  5. In the JENKINS_HOME/jobs copy/duplicate the directory "templateSquashTAExecutionJob" in a safe place outside JENKINS_HOME dir.

1. Now replace the content of the JENKINS_HOME directory of your new installation by the content of the JENKINS_HOME archive you've done in the foruth step.

   1. After the replacement, remove the directory "templateSquashTAExecutionJob" Iocated in the jenkins JENKINS_HOME/jobs of your new installation and replace it by the one you have duplicated in the fifth step.

   2. Start your new Squash TA execution server.

   3. Verify in Jenkins log that restore went well.

   4. Verify that all your jobs which previously working are still working on your new installation to check that the upgrade went well.

Note:

• • By default, in Squash TA execution server, JENKINS_HOME is: INSTALL_DIRECTORY/execution_home

• It also exists a Jenkins plugin to create and import backup : https://wiki.jenkins-ci.org/display/JENKINS/thinBackup