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.
Note
The ps1 and dll file in the upgrade folder might be blocked when you unzip the files and this might result in errors when running the ps1 script. To unblock the files, run the following PowerShell command in the unpacked folder.
Unblock-file ./**/*.*
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.