XL Release - Upgrade Manual

The upgrade process

The upgrade process consists of the following steps:

1. Obtain a new version of the XL Release software from XebiaLabs.
2. Read the new version's release notes so you are aware of the new functionality and possible upgrade considerations.
3. Read the new version's upgrade manual (this document) so you are aware of possible upgrade considerations.
4. If the current version of XL Release is running, stop it and ensure that there are no running tasks active.
5. Create a new installation directory for the new version of XL Release (so the existing version is still available in case of problems).
6. Extract the new XL Release software release into the new installation directory.
7. Copy the data from the previous XL Release installation directory into the new installation directory.
8. Start the new version of XL Release.

Upgrade notes

• It is possible to skip XL Release versions when upgrading. XL Release will sequentially apply any upgrades for the intermediate (skipped) versions. Please read the specific upgrade instructions for each of the versions carefully.
• If a repository upgrade is required, XL Release will detect that it is running against an old repository and will automatically execute an upgrade when it is first started. The server log will contain extensive logging of the repository upgrade process.

Upgrading the server

To upgrade an existing XL Release server installation:

1. Create a directory for the new XL Release server installation, including the new XL Release server version number in the directory name.
2. Extract the server archive in this directory.
3. Copy the contents of the conf directory from the previous installation into the new installation directory.
4. Copy the entire repository directory from the previous installation into the new installation directory.
5. Do not copy the contents of the hotfix directory unless you are instructed to do so, because hotfixes are version-specific.
6. If you have made any changes to the XL Release server startup scripts (server.sh or server.cmd), manually re-do these changes in the new installation directory.

This completes the upgrade of the XL Release server.

Specific upgrade notes

This section describes specific considerations for migrating from or to a particular XL Release version:

• Upgrading to XL Release 4.0.13
• Upgrading to XL Release 4.0.11
• Upgrading to XL Release 4.0.10

Upgrading to XL Release 4.0.13

LDAP security upgrade

• If you are using LDAP authentication, you must update xl-release-security.xml:
  • Change org.springframework.security.ldap.authentication.LdapAuthenticationProvider to com.xebialabs.xlrelease.security.authentication.LdapAuthenticationProvider

Upgrading to XL Release 4.0.11

Security upgrade

• Spring and Spring Security were upgraded to version 3.2, so if you use xl-release-security.xml, you must update it by removing the version specification of XSD files:
  • Change .../spring-beans-3.1.xsd to .../spring-beans.xsd
  • Change .../spring-security-3.1.xsd to .../spring-security.xsd

Upgrading to XL Release 4.0.10

Updating calls to XLRequest

In order to benefit new features from HttpRequest/HttpResponse, the plugin scripts have to be updated :

• In the existing script replace the CredentialsFallback, XLRequest() and send() calls:

  credentials = CredentialsFallback(jiraServer, username, password).getCredentials()
  response = XLRequest(jiraURL + '/contextUrl', 'POST', content, credentials['username'], credentials['password'], 'application/json').send()
  

• By calls to the HttpRequest constructor and to the get(), post(), put(), delete() methods:

  request = HttpRequest(jiraServer, username, password)
  response = request.post('/rest/api/2/issue',
      content,
      contentType = 'application/json')
  

• Replace calls to read():

  data = json.loads(response.read())
  

• By an access to the reponse property:

  data = json.loads(response.response)