ImageVault 5 manual upgrade

To upgrade to ImageVault 5, follow the instructions below

From an ImageVault 5 installation

The upgrade process for an ImageVault 5 site consists of a few steps

1. Backup current installation

Copy all current files in the current installation to a backup folder.

Note: You can exclude the App_Data folder since that will/can contain a great deal of files that is not affected by the upgrade. (Media stored on disc will be located here as per default settings).

2. Prepare the upgrade

Download and extract the installation zip to a new folder.

3. Copy current configuration

Copy the web.config file from the backup folder to the new folder (replace initial web.config).

4. Apply configuration changes

Run the upgrade/upgrade.ps1 script. This will modify the web.config file with configuration changes inlcuded in the upgrade.

5. Copy new files

Copy all files (except the upgrade folder) from the new folder to the existing site. Replace all existing files.

Clean upgrade

Since step 5 (Copy new files) replaces existing files but doesn't remove obsolete files you could remove all existing files before copying the new files. Observe that you need to leave files that you have added yourself. The following locations contains files that often are customized on ImageVault installations

  • App_Data - Contains uploaded files on windows platforms (as default). Logfiles can also be located here.
  • styles/override - Can be used to override existing stylesheets for custom theming of ImageVault.

From an ImageVault 4 installation

This documentation describes an update from ImageVault 4 to ImageVault 5.

1. Deactivate the ImageVault 4 installation

Since the upgrade will modify the ImageVault database we recommend disabling the current ImageVault 4 installation first by stopping the ImageVault Core Windows service and the ImageVault UI website.

2. Backup ImageVault database

Since starting the ImageVault 5 instance will upgrade the database, it's recommended to perform a backup if you would like to revert to the ImageVault 4 database.

3. Install a new ImageVault 5 instance

Follow the installation instructions to install a new ImageVault 5 on an IIS.

If your existing ImageVault 4 installation is a virtual application below your Episerver site, rename it and create a new imagevault virtual application and install the ImageVault 5 instance there.

4. Configure the ImageVault 5 instance

Follow the setup instructions to perform the configuration of the ImageVault 5 instance.

In this case, you already have a database and file folders. Be sure to enter these details in the dialog. You might need to manually modify the web.config file if the currently used authentication method is not supported by the setup. See the web.config for the ImageVault 4 instance for the current settings regarding membership and role providers.

5. Upgrade connectors

In some cases any current used connectors need to be upgraded. This depends if there exists any breaking changes between the currently installed connector and the new version. See the ImageVault change log and the individual connectors documentation for more information about breaking changes and how to upgrade them.

6. Remove old installation

When you have confirmed that the new installation works you can remove the old ImageVault 4 installation.

comments powered by Disqus