Upgrade servers

You can upgrade your Deployment Automation server to the latest version on Windows and UNIX/Linux.

Before you upgrade

Before running an upgrade, back up your current server. For details, see Back up Deployment Automation.

The following table describes how to upgrade from earlier versions to ensure a smooth update of Common Tools (Tomcat and JRE). This is especially important for servers on UNIX/Linux.

From version To version 6.4
6.3.0 to 6.3.6 Upgrade directly to 6.4.
6.2.0 to 6.2.3 Upgrade to 6.3.0 and then to 6.4.
6.1 to 6.1.5

Upgrade in this sequence:

6.1.0 > 6.1.1 > 6.1.2 > 6.1.3 > 6.1.4 > 6.1.5 > 6.2.0 > 6.3.0 > 6.4


Upgrade in this sequence:

6.2.0 > 6.3.0 > 6.4

5.1 to 5.1.6

Upgrade in this sequence:

6.0 > 6.2.0 > 6.3.0 > 6.4

5.0.1 and earlier

First, upgrade to 5.1, as documented in the Release Automation User's Guide 5.1. Then upgrade in this sequence:

6.0 > 6.2.0 > 6.3.0 > 6.4

Make sure to upgrade agent relays to the corresponding server version. You can upgrade them directly to the version you need. For details, see Upgrade agent relays.

For assistance with any other upgrade scenarios, contact Support.

Note: If you are a Community Edition user, post any questions on the Community forum.

Back to top

Back up Deployment Automation

Before upgrading, back up your Deployment Automation server.

To back up your current server:

  1. Stop Common Tomcat.
  2. Run the following backups in any order. To ensure that the data stays in sync, run backups in a single session while Common Tomcat is stopped:

    1. Back up your database. If you are using Derby, you can omit this step.
    2. Back up your Deployment Automation profile directory and its subdirectories.

      Default locations of the DA profile directory:

      Windows C:\Users\<username>\.microfocus\da
      UNIX/Linux /opt/MicroFocus/da/<username>/.microfocus/da

      Replace <username> with the name of the system user under which the server was installed.  

      To find the location of your profile, open the web application's installed.properties file in the Common Tomcat conf directory, and find the installLocation property.

      Default locations of the installed.properties file:

      Windows C:\Program Files\Micro Focus\common\tomcat\<tomcat-version>\webapps\da\conf
      UNIX/Linux /opt/MicroFocus/da/common/tomcat/<tomcat-version>/webapps/da/conf
    3. If the DA profile contains any subdirectories that are virtual links pointing to external storage such as relocated CodeStation directories, back up those external storage locations.
    4. Back up your DA web application. We recommend to back up the entire webapps directory, but make sure to back up at least the web application directory and its subdirectories.

      Default locations of the DA web application:

      Windows C:\Program Files\Micro Focus\common\tomcat\<tomcat-version>\webapps\da
      UNIX/Linux /opt/MicroFocus/da/common/tomcat/<tomcat-version>/webapps/da

Back to top

Upgrade Deployment Automation server

Upgrade your Deployment Automation server to get access to the latest features and enhancements.

Ensure that you backed up your server before the upgrade. For details, see Back up Deployment Automation.

To upgrade a Deployment Automation server:

  1. Download the latest server installer for your platform from the Software Licensing and Downloads portal (requires login).

  2. Extract and run the server installer:

    1. Unpack the server installer zip bundle.

      The bundle includes the self-extracting executable file MicrofocusDA-Server64-bundle.exe containing the server and the Common Tools installers.

    2. Run the executable to extract the following installers:

      • Server installer MicroFocusDA-Server64-installer.exe

      • Common Tools installer setupOpenTextCommonTools_win64.exe, extracted into the common directory.

    3. As a Windows local system user, run the server installer:


    1. As a user with root privileges, extract and run the server installer:

      Micro FocusDA-Server.bin

    2. As part of the upgrade, specify the owner of the Deployment Automation installation.

      Ensure that the specified user is the owner of the Common Tomcat instance, especially when Common Tomcat hosts other applications in addition to Deployment Automation.

      The owner is the username that runs the Common Tomcat process. During the upgrade, directories inside the Common Tomcat instance are configured as owned by the specified owner. If the username and owner do not match, the Common Tomcat process may not be able to read or write to them.

      The ownership of the entire Common Tomcat installation is set to the specified username.

  3. In your web browser, open Deployment Automation using this URL format:



    <serverName> Specifies the server with Common Tomcat that hosts Deployment Automation.
    <port> Specifies the Common Tomcat port.

    Use http for non-SSL and https for SSL (recommended) installations.

After upgrading the server, continue with upgrading server configuration.

Upgrade from 6.3.3 or earlier: The installer upgrades Apache Log4j to version 2 and creates a new default Log4j properties file, log4j2.properties, in the server profile. After the upgrade, your earlier Log4j settings are stored in the log4j.properties.old file. To use these settings, manually migrate them to the new Log4j file.

Back to top

Upgrade server configuration

When upgrading, take into account the following considerations:

Upgrade to 6.4

After the upgrade, Deployment Automation allows the use of TLSv1.2, TLSv1.1, and TLSv1 protocols by default. To improve your system's security, you can change the configuration to allow TLSv1.3 and TLSv1.2 only.

Edit the installed.properties files in your DA profile directory and replace the default protocol list with the following line:

TLSv1.3, TLSv1.2

Default locations:

Windows C:\Users\<username>\.microfocus\da\conf\server\installed.properties
UNIX/Linux /opt/MicroFocus/da/<username>/.microfocus/da/conf/server/installed.properties

Note: All your system components must use the same protocols. Make the same changes in the installed.properties files for agents, agent relays, and component integrators.

Upgrade from 6.3.3 or earlier

After the upgrade, the server uses JRE 11 which has TLSv1 and TLSv1.1 protocols disabled by default to avoid security breaches. You agents on JRE 6 or 7 may not connect to a JRE 11 server because of the disabled protocols.

To connect JRE 6 or 7 agents, temporarily enable the TLSv1 and TLSv1.1 protocols:

  1. Open the java.security file in the following location:


  2. Remove TLSv1 and TLSv1.1 from the following string:


  3. Save your changes.

  4. Restart Common Tomcat.

Note: Enabling the protocols makes the JRE 6 and 7 agents visible in the user interface. But to upgrade the agents to JRE 8, you need the 6.3.2 server. For details, see Upgrade agents.

Upgrade from 6.3.2 or earlier

After the upgrade, process requests submitted before the upgrade are recalculated by background jobs.

Background jobs recalculate the status of each request and store the status in your database for easy retrieval. This reduces the time required for Deployment Automation to open and process timelines and deployment history.

Because background jobs may slow the server while they are running, they are restricted to run during a specified timeframe. To change the default timeframe, see Set conditions for running background jobs.

Upgrade from 6.1.4 or earlier
  • Deployment Automation 6.4 supports Common Tomcat 9.0.

    Default locations:

    Windows C:\Program Files\Micro Focus\common\tomcat\<tomcat-version>
    UNIX/Linux /opt/MicroFocus/da/common/tomcat/<tomcat-version>
  • All connectors, such as port number, customization, and SSL configuration, are automatically identified and updated in the new Common Tomcat directories during the server upgrade.
  • You have to manually copy any additional applications running under Common Tomcat, such as Dimensions CM and ZMF Connector, to the new directory structure.

    For details, see Integrate with Dimensions CM and Reconfigure ChangeMan ZMF integration after server upgrade.

  • If you are using SSO, you must configure it again, including setting the parameters in the gatekeeper-core-config.xml file.

    To set these parameters, copy the corresponding strings from the earlier version of the gatekeeper-core-config.xml file. Copying and replacing the entire file from the earlier Common Tomcat installation does not work.

Back to top

See also: