When users search for an asset, Elvis uses an index to locate where the asset is stored. It is important therefore that the index is always up-to-date.
Available indexes and when to update them
Elvis contains multiple indexes but the only one that you will ever typically update is the 'asset' index.
Note: Updating the asset index is mainly necessary when:
1 In Elvis 5.26 and higher, the index is automatically updated after most changes. For details, see the linked article for details.
Other available indexes include:
Whenever an index needs to be manually updated, this will be mentioned in a Help Center article.
Updating the index
Note: Updating an index might take a while, depending on the size of your index.
To update an index, access the Update index page and click on the name of the index that needs to be updated.
Do one of the following:
- Enter the following URL:
- On the Elvis Server console, click Server admin page
When the indexing succeeds, the revision number will be incremented and your new configuration will have taken effect. If it fails, you will get an error message and no changes will have been made to the index.
1. Why is the config index always set to '1' after restarting the server?
At each server restart, the config index is regenerated and redistributed across all nodes and will therefore always be '1', even when initially incrementing it by updating the index.
2. Errors appear in the log files after updating the asset index
The following errors might appear in the log files:
ERROR com.ds.acm.ak - NEW CONFIGURATION IS INCORRECT: Compass settings of the field language were changed. It is incorrect to modify the field.
WARN com.ds.acm.warnings.Server - warning: Detected illegal changes in new asset info
com.ds.acm.al: New configuration is incorrect, see log for details. Please review asset info configuration.
These errors are generated by a safety feature that is in place during the Elvis service startup which compares the full-assetInfo.xml file (created during the last successful startup) with the new-assetInfo.xml file (constructed from the (internal)default-assetinfo file and the possible (custom) configured custom-assetinfo file).
If the compare results in a difference, the above errors are thrown in the Elvis Server log with a description where this difference is found.
This safety feature is in place to protect the system from starting with an incorrect assetinfo file.
A common scenario for this situation to occur is when changes have been made to the configuration of the assetInfo in the custom-assetinfo.xml file. It may also occur after upgrading Elvis to a newer version with an updated default assetinfo.
It is important to be aware if recent changes have been made to your custom-assetInfo.xml:
- Yes, I just updated the configuration of the custom-assetInfo file which resulted in this log message. Please read the log message carefully; it might describe where a possible configuration error occurred.
- No, I just upgraded my Elvis Server version (with a new/changed default assetinfo file) which resulted in this log message.
Update the asset index once more.
Do the following:
Step 1. Stop your Elvis Cluster nodes.
Step 2. On each node, access the Elvis Server/Elvis Hot Data/elvis-data/assetInfo/ folder and remove the following files:
Note: Make sure you do this on every node (including the nodes that act as the Processing Server and job runner).
Step 3. Start the Elvis Cluster.
New files will be created and the errors should not appear anymore.
3. Metadata changes or custom downloads not working after custom-assetinfo change
When changing custom-assetinfo it may be necessary to increase the index revisions after a restart.
Several indices make use of the metadata structure mapping and may need to be updated.
These indices are:
Make sure these revisions are upped when running into issues with updating specific metadata fields, or when downloading a custom preview with embedded metadata.
- 14 August 2018: Added troubleshooting item 'Metadata changes or custom downloads not working after custom-assetinfo change'.