1.2. Upgrading From Old Versions

Upgrading to the newer version

In order to perform an upgrade to the latest version or a newer version, please follow the steps described in Installing MetaDefender Vault Using the Install Wizard in order to upgrade the product.

Note: Uninstalling MetaDefender Vault will not cause any data or settings loss including files, configuration, and license. If you want to do a clean uninstall and install, follow Clean uninstall of MetaDefender Vault.

Upgrading from Vault 1.3.6 or lower to the latest version

From version 1.3.7 and onward, Vault will be using NGINX as the underlying web server.

Although the way users interact with the system remains largely unchanged, there are a couple of differences to be aware of.

  1. The REST API and User Interface ports can no longer physically share the same value (REST API will be auto re-assigned to the first free port starting from 8000 upward).

  2. All REST calls will now be made to the web client's port and NGINX will reroute them to the appropriate destination.

  3. It is no longer valid to provide a certificate hash, in case of TLS/SSL settings.

  4. The paths to the actual certificate and private key have to be provided. In the case of password-protected certificates, the path to the file containing the passwords is also necessary.

The migration to NGINX will be handled by the installer.
During the upgrade process, if TLS/SSL settings are detected, a pop-up window will appear, asking for the user to provide the paths to the:

  1. SSL certificate

  2. SSL certificate private key

  3. (Optional) The path to a text file containing the password for the protected certificate

images/download/attachments/1948603/RequestSslCertificate.PNG

The user can opt to reset to factory defaults by clicking Proceed with default (in which case all TLS/SSL settings will be lost).

When pressing the Accept button, a check will be made to validate the contents before continuing with the installation. Data is considered valid if it fulfills the following criteria:

  1. SSL certificate must be provided in the .pem or .crt formats.

  2. SSL certificate private key must be provided in the .pem or .key formats.

  3. The private key must be applicable to the given certificate.

  4. In case the certificate is password protected, then a text file containing the password must also be provided.

In case the input data is invalid, a warning will be presented. Click OK and try again.

images/download/attachments/1948603/image2019-8-8_15-13-39.png

If everything is successful then the following screen will be presented:

images/download/attachments/1948603/image2019-8-8_14-35-16.png