Re-indexing metadata

The text index can be fully reindexed without disturbing production. The reindexing process also handles application server restarts, and can be monitored. Normally, reindexing is only needed if the metadata field definition are changed, but it can be a good idea to reindex if the database is moved or if upgrading to a newer version of Vidispine.

Note

The number of indexes returned in the GET command is only an estimate.

Requesting a reindex

PUT /reindex/(index)

Starts a reindex. If a reindex of the same type (item/collection/ACL/file) is already in progress, it is restarted.

Note

Only files that do not belong to an item will be indexed when reindexing files. To reindex all files both a file and item reindex must be started.

Parameters:
  • index – One of item, collection, acl or file.
Query Parameters:
 
  • priority – The priority of this reindex request compare to other request. Requests with a larger/higher priority will be processed first. Default is 500.
Produces:
Role:

_administrator

Example:

PUT /reindex/item
<ReindexRequestDocument xmlns="http://xml.vidispine.com/schema/vidispine">
    <index>item</index>
    <priority>500</priority>
    <status>IN QUEUE</status>
    <start>2016-03-23T22:41:04.133+01:00</start>
</ReindexRequestDocument>

Retrieving reindex information

GET /reindex/(index)

Gets information about a reindex process, i.e., progress and whether it is finished.

Produces:
Role:

_administrator

Example:

GET /reindex/item
<ReindexRequestDocument xmlns="http://xml.vidispine.com/schema/vidispine">
    <index>item</index>
    <priority>500</priority>
    <status>FINISHED</status>
    <start>2016-03-23T22:41:04.133+01:00</start>
    <finish>2016-03-23T22:41:04.774+01:00</finish>
    <indexesDone>48</indexesDone>
    <indexesTotal>48</indexesTotal>
</ReindexRequestDocument>

Controlling index of items/collections

If the metadata field solr-index of an item/collection is set to false, it won’t be indexed.

Example:

<MetadataDocument xmlns="http://xml.vidispine.com/schema/vidispine">
   <timespan end="+INF" start="-INF">
      <field>
         <name>solr-index</name>
         <value>false</value>
      </field>
   </timespan>
</MetadataDocument>