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. 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.

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 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 a Deployment Automation server

Ensure that you backed up your server before the upgrade. 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 installer.

  3. UNIX/Linux only: As part of the upgrade installation, specify the owner of the Deployment Automation installation.

    Ensure that the user specified is also 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.

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

    http(s)://<serverName>:<port>/da

    where:

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

    Use http for non-SSL and https for SSL installations.

After upgrading the server, continue with upgrading server configuration.

Deployment Automation 6.3.4 and later: 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.3.4 or later

After the upgrade, the server uses JRE 11 which has TLS 1.0 and 1.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 TLS 1.0 and 1.1 protocols:

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

    Windows C:\Program Files\Micro Focus\common\jre\11.0\conf\security
    UNIX/Linux /opt/MicroFocus/common/jre/conf/security
  2. Remove TLS1 and TLS1.1 from the following string:

    jdk.tls.disabledAlgorithms=...

  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 to 6.3.3 or later

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 the timeframe for running background jobs.

Upgrade from 6.1.4 or earlier
  • 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: