5.3. Special Instructions for Upgrading from 17.x

To set up a new EKM server as part of an upgrade from a previous version, you must follow the same procedure for Installing a New EKM Server while observing these special instructions during the installation process:


Important:  Failure to adhere to these special instructions during server setup will result in an upgrade failure during execution of the EKM upgrade wizard.


  1. When specifying the Shared path for the EKM data directory, recall that this path must be located on a file share on the cluster file server.

    If the EKM data directory for EKM 17.x already meets this requirement, specify the same directory for EKM 18.2.

    If the EKM data directory for EKM 17.x does not meet this requirement, for example if it is a local filesystem path, you must specify a new location for the EKM data directory for EKM 18.2. After installation, you must manually copy or move the data from the EKM 17.x data directory to the new EKM 18.2 data directory before running the EKM Upgrade wizard.

  2. When specifying the EKM job data directory (jobSourceRootPath), set the value in EKM 18.2 to the same value set in EKM 17.x.

    Doing this will allow seamless access to job data for jobs run in 17.x. If you need to use a new path for the EKM job data directory and cannot follow these instructions, then you will need to manually copy or move your 17.x job data files into the new directory structure. This could be done before or after the upgrade, but should be done before you start the newly upgraded EKM 18.2 server for the first time.

    For information about setting up the job data directory, see the jobSourceRootPath and clusterVisibleDirectories settings in Specifying Remote Process Policies (<remoteProcess>) in the Administration Guide.

  3. If the existing EKM 17.x server uses an external database, or the new EKM 18.2 server uses an external database, then the values you will enter on the Database Server Settings screen will depend on the approach you choose for preparing your database for upgrade. See Prepare the EKM Database for an Upgrade – Part 1 for more information.


    Important:  After installing EKM 18.2 as part of an upgrade, do not start the EKM 18.2 server until instructed to do so.


There are also post-setup steps that are specific to upgrades. See Special Post-Setup Instructions for Upgrade for details.


Release 18.2 - © ANSYS, Inc. All rights reserved.