When upgrading an existing version of Assets Server (server and client) to a newer version of Assets Server, the server and client application is upgraded while your data, server configuration and log files are left in place.
The process of upgrading is as follows:
- Creating a backup of the existing installation
- Stopping your current server
- Installing Assets Server
- Configuring Assets Server
- Reviewing optional steps (after upgrading)
- Starting Assets Server
- Testing Assets Server
Before you start
Before you start the upgrading process, please do the following:
- Read this article in full so that you are fully aware of the steps that need to be followed and the order in which they need to be performed.
- Familiarize yourself with the changes that were made in the various releases by reading through the Release Notes for Assets Server and the Release Notes for Assets.
1. Creating a backup of the existing installation
Make sure you have a recent backup of your current environment.
Because all data is stored on the file system, all data in the following Assets Server folder locations should be backed up:
- Elvis Hot Data
- Elvis Shared Data
2. Stopping your current server
Stop your current Assets Server from running.
3. Installing Assets Server
Download the installer from the software download page, run it and follow this instructions on screen. It will automatically detect the existing version and will replace all application files. Your data, configuration and log files will not be touched.
4. Configuring Assets Server
During the Server installation, a folder named clean-example-config-x.x.x is created in the main Config folder. It contains a clean copy of the latest configuration files.
Use it as a reference for any new configuration options that are available which you might want to make use of.
5. Reviewing optional steps (after upgrading)
Depending on the version of Assets Server that you are upgrading from or to, some additional steps may have to be manually performed after Assets Server has been installed.
Review the below information and implement where applicable.
Upgrading to Assets Server 6.57 or higher
- Integration with Studio Server / Enterprise Server. The metadata selector field group 'Enterprise' has been renamed to 'Studio'. When the 'Enterprise' group is used in the custom-assetinfo.xml file, manually change this to 'Studio'.
6. Starting Assets Server
At this point, Assets Server is ready to be started.
Important: As part of the upgrade process, Assets Server will automatically update the index. Depending on the size of the index, this can either take a few moments or it can take some time. Do not restart Assets Server until this process is finished. Use the Paramedic page of Assets Server (access Assets Server > Support Tools > Elasticsearch > Paramedic or use URL localhost:9200/_plugin/paramedic/) to monitor the progress.
7. Testing Assets Server
Verify that Assets Server is working properly by using Assets. Perform tasks such as uploading some files, searching for them, downloading or sharing them, or any other tasks that are part of your daily workflow.
- 24 November 2020: Added section '5. Reviewing optional steps (after upgrading)'.