Manually upgrade an Edge Encryption proxy server running on Windows

Update a proxy running on Windows.

Before you begin

If using AES 256-bit encryption with Java 8 update 141 (8u141) or lower, you must install the Java Cryptography Extension (JCE) jurisdiction policy files by copying them into the system Java home directory of each Edge Encryption proxy server host. Add these files to the <Java-home-directory>/jre/lib/security folder before performing a scheduled or manual upgrade. To install the AES 256-bit encryption policy files, see Enable AES 256-bit encryption for Java 8 update 141 (8u141) or lower.

Role required: security_admin or local administrator on the host machine.

Procedure

  1. Download the Edge Encryption proxy-update archive file to the installation directory.
  2. Start the Windows cmd terminal program with administrator privileges.
  3. Change to the installation directory.
  4. Run the following command:
    java -jar edgeencryption-dist-<version>-windows-x86-64.zip -m dist-upgrade -c <proxy directory>
    Option Description
    proxy directory The directory in the installation directory where the proxy was initially installed. This directory is created by the install.

    If you want to see the help screen, execute this command without arguments: java -jar edgeencryption-dist-<version>-windows-x86-64.zip

    A new proxy directory is created with a current timestamp and the old proxy directory is maintained as a backup. The old proxy shuts down and the new proxy starts up. Any open connections/transactions on the old proxy server are terminated.
  5. Check the proxy log in the new directory and the instance to verify that the proxy has been updated and is running.