Version 4.14¶

The release notes will tell you what’s new in each version, and any changes that you must be aware of when upgrading. For reference, Vidispine ticket numbers are printed as (#1234).

4.14

4.14 ¶

2018-07-18

User rename¶

The username of users can now be changed (#3232). It is also possible to assign multiple usernames, or aliases to users. Aliases can be used to for example allow a user to log in using either the username or the users e-mail address (#3260).

PUT /user/stephen@example.com
Content-Type: application/xml

<UserDocument xmlns="http://xml.vidispine.com/schema/vidispine">
  <userName>stephen</userName>
  <alias>stephen@example.com</alias>
  <realName>Stephen</realName>
</UserDocument>

User access keys and tokens¶

Support for user access keys has been added. Access keys are long-lived tokens that can be used to authenticate a user, that can be used instead of username/password credentials.

POST /user/stephen/key/

<AccessKeyDocument xmlns="http://xml.vidispine.com/schema/vidispine">
  <id>VSID2C56CQTA7DWW7DLF</id>
  <secret>PiFHewzGN3tZ/3lSeAkBVX+5YOw3wwpHTO2iqIaa</secret>
  <status>ACTIVE</status>
  <created>2018-06-01T10:36:13.891+02:00</created>
</AccessKeyDocument>

To make it easy to create authentication tokens when using aliases or access keys, a new create token resource has been added that does not require a username.

Group files by prefix¶

Files in file listings with the same prefix, in the same directory, can now be grouped together (#3230). This is supported for all types of storages, regardless if they have the notion of directories or not.

For example, given a file hierarchy of $YEAR/$MONTH/, we might have:

GET /storage/VX-1/file?prefix=true

<FileDocument xmlns="http://xml.vidispine.com/schema/vidispine">
  <file>
  ...
  </file>
  <prefixes>
    <prefix>2017/04/</prefix>
    <prefix>2017/05/</prefix>
    <prefix>2017/11/</prefix>
    <prefix>2018/02/</prefix>
  </prefixes>
</FileDocument>

Checksum validation on transfer¶

Copy and move jobs have been updated to support checksum validation (#3229). If enabled, the checksum of the written file will be computed and verified against that of the source file, and if different, will cause the job to fail.

Elasticsearch 6¶

Elasticsearch 6.x is now supported (#3081). Due to the removal of mapping types, older Elasticsearch versions (<= 5.5.x) are not supported anymore.

The support of two-way SSL (client authentication) with Elasticsearch (#3231) is added as well. It can be used in setting up PKI user authentication.

Multiple audio codecs in presets¶

Creation of videos with audio tracks/streams with different audio codecs is now possible. Use the audioTrack element in the transcode preset (#2932). For example, to transcode audio to both AC-3 and AAC:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TranscodePresetDocument xmlns="http://xml.vidispine.com/schema/vidispine">
    <format>mov</format>
    <audioTrack>
        <codec>ac3</codec>
        <bitrate>384000</bitrate>
    </audioTrack>
    <audioTrack>
        <codec>aac</codec>
        <bitrate>96000</bitrate>
    </audioTrack>
</TranscodePresetDocument>

Thumbnail reindexing¶

The thumbnail index can now be rebuilt using a re-index thumbnail request (#3224). This indexed used to be rebuilt when rebuilding the item index, but must now be rebuild separately. This can improve the item reindex performance, especially if thumbnails are stored on an object storage such as S3 or Azure.

AWS temporary credentials¶

The AWS credentials been sent to VSA can be configured using s3CredentialType (#2931).

EIDR metadata import¶

EIDR Integration (#2893).

You can now import metadata from the EIDR database. There is a new resource type for accessing EIDR. Synchronization is enabled by setting the EIDR id as metadata on an item. Later on a single item or a library of items can be synchronized.

Vidinet improvements¶

Analyze shapes using Vidinet transcoder (#3219).
Conform using Vidinet transcoder (#3220).
Support placeholder raw import using Vidinet (#2962).

Agent improvements¶

Execute AAF export jobs directly on agents (#3143).

Role changes¶

Change role requirement for GET API/vxa (#3246).

Improvements¶

Add binary as a component type for placeholder imports (#3122).
Support automatic creation of users authenticated by custom Shiro realms (#3293).
Add a metadatahelper object in the common JavaScript context (#3286).
Make it possible to configure S3 transfers to be HTTPS (#3227).
Spread transfer load over available VSAs (#3126).
Allow archive beans to clean up in case of a failed job (#3109).
Allow archive storages to be used as destinations in storage rules (#3108).
Add configuration to stop archived files from being used as storage rule transfer sources (#3107).
Allow archive beans to select source storage for archive jobs (#3106).
Include item and shape ids in job metadata for transfers started from storage rules (#3127).

Transcoder improvements¶

Support for Closed Captions (608 & 708) (#3052).
Automatic creation of thumbnails at scene changes (#3217).

Bug fixes¶

Transcoder self test reports failed transcoders as OK (#3291).
Transcode with destinationItem specified fails against Vidinet (#3279).
Export jobs fail on systems with only Vidinet transcoders (#3276).
Auto import jobs fail on systems with only Vidinet transcoders (#3274).
Transcoder self test fails on systems with only Vidinet transcoders (#3004).
Shape/essence import goes into WAITING if no Vidispine transcoder exists (#3269).
Delete Jobs Finishing But Files Not Removed (#3284).
Media check failing if apiNoauthUri contains amazonaws.com (#3255).
Not possible to abort Atempo archive jobs (#3121).
Item delete request with keepShapeTagStorage fails with NPE (#3210).
Transcode failing when transcode preset contains multiple audio outputs specifying more channels then found in source file (#3178).
Indexing error if multiple timespans have the same boolean field with different values (#3093).
Scheduled requests without a body cannot be viewed (#2904).
Parameter ‘state’ not optional when getting scheduled requests (#2903).
JMS notifications fail with NameNotFoundException. (#3214).

Agent fixes¶

VSA reports shares state incorrectly (#2980).

Upgrading from 4.13¶

Solr: No changes to the documents. Re-indexing is not required.
Elasticsearch: Supported versions have been changed to 5.6.x, 6.0.x, 6.1.x, or 6.2.x.
The item re-index process will no longer also rebuild the thumbnail index that is maintained internally by VS. The thumbnail index can now instead be rebuilt separately using a re-index thumbnail request. To restore the old behaviour, set disableThumbnailReindexing to false.
A number of new job steps have been added to support checksum validation on transfer.
- COPY_FILE/MOVE_FILE, step 90 - Waiting for source file hash.
- COPY_FILE/MOVE_FILE, step 92 - Retrieving source file hash.
- COPY_FILE/MOVE_FILE, step 140 - Waiting for destination file hash.
- COPY_FILE/MOVE_FILE, step 150 - Verifying file hashes.
Previous versions had a bug where collections containing libraries did not always have recursive ACL’s properly applied items in those libraries. This is fixed for newly created ACL’s, but any old ones with this problem will need to be re-indexed with:
```
PUT /reindex/acl
```
A role have been added for reading Vidispine Agents: _vxa_read. To make sure admin users receives the role properly, please run APIinit:
```
POST /APIinit
```