REQUIREMENTS

Compatibility

  • Relativity 9.5.196.102 - Present
  • RelativityOne

Network Configuration Requirements

Transcode (Veritone setting), Transcription, Translation, and Object Detection features transmit data over Port 443 from Relativity Web and Agent Servers to Veritone cloud, if cloud processing is desired. The following steps are not required if Veritone Edge processing is enabled.

Veritone static endpoints and IP addresses are available for whitelisting:

Files larger than 100mb require access to Amazon S3. All Amazon IP ranges can be found here

  • Required AWS Certificates installed into Trusted Root Cert Store on the Web and Agent Servers: CA1, CA2, CA3, CA4, Starfield Root Cert. AWS Certificates available here
  • Consistent FIPS configuration across Web and Agent servers
  • Write permissions to file repository for agent servers where Veritone Transcoder Agents are installed

The following PowerShell command will test your connection:

*Proprietary Codecs Not Supported

INSTALLATION

Application

Download the “Veritone aiWARE for Relativity” application here:
https://unlock.veritone.com/aiware-relativity-rap-current

  1. Upload the Veritone aiWARE .rap file to your Relativity Application Library
  2. Once uploaded, choose to install it from the Workspaces Installed section and select all workspaces.
    Note: All workspaces must be running the same version of the application at all times. 
  3. When upgrading to the latest .rap file, follow the same steps, selecting Yes to the Possible Broken Applications prompt. 

Agents

Instance Settings

Two Instance Settings are available to specify the CPU percentage utilization during business hours and off hours which reference the hours specified in the AgentOffHourStartTime and AgentOffHourEndTime instance settings.

  • CPUUsageInTranscodingBusinessHours
  • CPUUsageInTranscodingOffHours

ADMINISTRATION

Navigate to Veritone AiWARE -> Veritone Admin tab in workspace to manage the configurations below

Workspace Configuration

Veritone aiWARE for Relativity supports two types of processing: Cloud and Edge. With Cloud processing, your files are sent to an instance of Veritone's cloud-based servers for processing. With Edge processing, your files are processed on-prem or in your private cloud of choice. In either case, contact your Veritone Legal representative for provisioning details.

API Endpoint

  • For Cloud processing, enter the appropriate endpoint (as indicated above) and click Save
  • For Edge processing, enter the appropriate endpoint of your local instance of Edge, port 9000, and click Save. For example: https://yourdomain.com:9000

API Key

  • To acquire an API key for either Cloud or Edge processing, contact your Veritone Legal representative
  • Enter the provided API key and click Validate and Save
  • If you receive the message “Key Validation Failed”, refer to the network configuration requirements section


Data Deletion

Data deletion settings are only applicable when Cloud processing is enabled.

  • Delete: Files and results are automatically deleted from Veritone after jobs complete.
  • Preserve: Files and results are preserved in Veritone after jobs complete 
  • Delete All from Veritone Environment: Deletes all previously preserved files from the Veritone environment.
  • The Veritone Recording Deletion Agent is required to support this feature

Processing Environment

  • Veritone Cloud: Select this option if you'd like processing to occur in Veritone's cloud.
  • Edge: Select this option if you'd like processing to occur in on an Edge (on-prem or private cloud).

Transcoding Environment

  • Local: Runs transcoding process on the local Relativity agent server. Local transcoding is optional for Cloud processing, but is required for Edge processing.
  • Veritone: Transcoding process runs in Veritone environment (Veritone Key required)

Additional Steps Required for Edge Processing

The Edge server must be able to access the Relativity API in order to upload files for processing. The URL that Edge uses to access the Relativity API is specified in the "VeritoneServicesURL" value in "Instance Settings" section of your Relativity environment.

For example:

Group Management

Transcode (Veritone setting), Transcription, Translation, and Object Detection are billable actions. Each feature can be restricted at the group level per workspace.

  • Check the box Assign Transcription/Translations/Object Detection Permissions.
    - To grant permissions, move each group into the Groups Permitted list
       (right-side)
    - To restrict permissions, keep each group in the Groups Not Permitted list
       (left-side)
  • When Assign Transcription/Translations/Object Detection Permissions is unchecked, all users in the workspace are permitted.

MEDIA PLAYER

The Media Player feature allows users to playback audio and video within Relativity’s Document Viewer

Media Player Requirements

Local Transcoding

  • Compatible Media File
  • Veritone Transcoding Agent 

Veritone Transcoding

  • Compatible Media File
  • Veritone Key
  • Veritone Transcoder Job Manager Agent
  • Veritone Transcoder Job Analyzer Agent 

How to enable the Media Player

  1. Navigate to Veritone AiWARE / Veritone Admin tab in the workspace
  2. Transcoding Environment
    a. Local: Runs transcoding process on the local Relativity agent server
    b. Veritone: Transcoding process runs in Veritone environment (Veritone Key required)
  3. From the document list, choose mass operation “Transcode” and submit files to enable the media player.

Media Player Status

The Media Player is enabled when the following conditions are met:

  • Veritone Transcoding Complete = Yes
  • Veritone Transcoder Warning = No

Transcode Logs

The Transcode Logs tab lists every job submitted to Veritone for transcoding and includes the following information:

  • Document: DocID / Control Number
  • Date Submitted: The date the transcode job was submitted
  • Date Completed: The date the transcode job completed
  • Submitted by: The user who submitted the transcode job
  • Media Duration: The duration of the media file 
  • Status: Current job status (Submitted, In Progress, Completed/Failed)
  • Veritone Recording ID: Unique job identifier in Veritone environment

The Transcode Logs tab also includes three processing features:

  • Delete all pending jobs: Will cancel all jobs that have not yet been submitted to Veritone. Jobs cannot be canceled once they are in progress.
  • Check All Failed: Will retry all failed jobs by rerunning the engines.
  • Sync Job Status: Will fetch the latest job status on failed jobs without rerunning. This option should be executed first when job failures are encountered. 

Transcode History

The Transcode History tab displays a chart of the total hours of media transcoded per month. Date range filters are available to update the chart as desired.

TRANSCRIPTION

The Transcription feature allows users to leverage Veritone’s Speech-to-Text engines to generate text from audio and video files that can be integrated with Relativity dtSearch and Analytics.

Transcription Requirements

  • Veritone Key
  • Media Player is Enabled (Transcoding Completed)
  • Veritone Transcription Job Manager Agent
  • Veritone Transcription Job Analyzer Agent

Bulk Transcription

  1. Select media files from document list and choose Transcribe Media
  2. In the Transcribe Media dialog box, choose the desired Language and click Submit

Single File Transcription

  1. In the Document Viewer, select the Transcribe button directly beneath the media player
  2. In the Transcribe Media dialog box, choose the desired Language and click Submit

Transcription Status

The current status will be displayed in the Veritone Machine Transcription Status field and in the Transcription Logs tab.

Transcript Viewer

When the job completes, the transcription will display directly below the media player in the document viewer. To navigate the transcript, the user can click on any word in the transcript viewer - the audio and/or video playback will synchronize to the selected text. The playback progress is highlighted by bolding in the transcript display. 

Transcription Logs

The Transcription Logs tab lists every transcription job submission and includes the following information:

  • Document: DocID / Control Number
  • Date Submitted: The date the transcription job was submitted
  • Date Completed: The date the transcription job completed
  • Submitted by: The user who submitted the transcription job
  • Language: Language option selected
  • Media Duration: The duration of the media file 
  • Status: Current job status (Submitted, In Progress, Completed or Failed)
  • Veritone Recording ID: Unique job identifier in Veritone environment
  • The Transcription Logs tab also includes three functional features:
  • Delete all pending jobs: Will cancel all jobs that have not yet been submitted to Veritone. Jobs cannot be canceled once they are in progress.
  • Check All Failed: Will retry all failed jobs by rerunning the engines.
  • Sync Job Status: Will fetch the latest job status on failed jobs without rerunning. This option should be executed first when job failures
    are encountered. 

Transcription History

The Transcription History tab displays a chart of the total hours of media transcribed per month. Date range filters are available to update the chart as desired.

AUDIO / VIDEO REDACTION

The Audio / Video Redaction feature allows users to identify and redact sensitive material from Audio & Video files. Redacted segments will be replaced with blacked out video frames and white noise over the audio channel. Redacted native copies can be utilized for production or export purposes.

Audio/Video Redaction Requirements

  • Machine Transcription Completed
  • Media Player is Enabled (Transcoding Completed)
  • Veritone Redaction Agent

How to Redact Audio / Video

While in the Document Viewer, select the Redact button (top-right) and a new tab named Redacted Copy will open. Media redactions can be applied on the video playback bar or by highlighting text in the transcript.

Video Redaction

  1. In the Redacted Copy tab, select the Video option from the toggle (top-left)
  2. Select the redaction selection button and a yellow 10-second block appear on the playback bar.
  3. Click and drag the yellow block over segments of the media file to be redacted.
  4. Provide a redaction name in the text box next to the Redact button. This name will be inserted into the Veritone Redacted Text field replacing the transcribed text.
  5. Click Redact to apply redaction. Create as many video redactions as necessary.

Transcription Redaction

  1. In the Redacted Copy tab, select the Text option from the toggle (top-left)
  2. Highlight text in the transcript to select segments to be redacted
  3. Provide a redaction name in the text box next to the Redact button. This name will be inserted into the Veritone Redacted Text field replacing the transcribed text.
  4. Click Redact to apply redaction. Create as many redactions as necessary.

Redactions applied in the Video and Text tabs are synchronized. When all redactions have been applied, select Save Redactions at the top-right of the document viewer. The Veritone Redaction Agent will generate a new MP3/MP4 file and populate the Veritone Redacted Text field.

Edit Saved Redactions

To edit redactions, choose Edit Redactions at the top-right of the Document Viewer and select the pencil icon in the redaction table to edit existing redactions, or, create new ones using the methods above. Click Save Redactions to generate a new MP3/MP4 and repopulate the Veritone Redacted Text field.

Redaction Status

Refer to the Veritone Media Redaction Status field for the current status. When the redaction is complete the status will read Media Redaction Completed and is available for Production and/or export.

How to Produce Redacted Audio / Video

From the document list, select all redacted media files, run the mass operation Produce Redacted Copy, select Yes, and click Save.

Result: The Produce Redacted Copy function sets the redacted media copy as the primary file, instead of the original native file allowing it to be picked up by Relativity’s Production Sets and Relativity Desktop Client

Important: Do not manually Edit the document object field “Veritone Produce Redacted Copy”. This field is ONLY a reference field for the value chosen when the mass operation function is executed. 

Requirements

  • Veritone Media Redaction Status = Media Redaction Completed
  • Produce Redacted Copy = Yes

Redaction Logs

The Redaction Logs tab lists every Save Redaction request and includes the following information:

  • Document: DocID / Control Number
  • Date Submitted: Date the user executes Save Redaction
  • Submitted By: User that executes Save Redaction
  • Status: Status of redaction being saved
  • Output: Message related to the current status

TRANSLATION

The Translation feature allows users to leverage Veritone’s machine translation engines to translate the Extracted Text of any file type into numerous target languages that can be integrated with Relativity dtSearch and Analytics.

Translation Requirements

  • Veritone Key
  • Veritone Translation Job Manager Agent
  • Veritone Translation Job Analyzer Agent
  • Machine Transcription Completed (media files only)
  • Extracted Text field populated

Bulk Translation

  1. Select any file type from document list and choose Translate
  2. Choose desired Language option and click Submit

Single File Translation

  1. Select Translate from at the top-right of the Document Viewer
  2. Choose the desired Language pair and click Submit

Translation Status

The current status will be populated in the Veritone Machine Translation Status field and in the Translation Logs tab.

Edit Translated Text

User may edit translated text for Audio / Video files in the Document Viewer in the Translation tab beneath the media player. Select the pencil icon to unlock for editing, and choose the check box to save the changes.

Translation logs

The Translation Logs tab lists every translation job submission and includes the following information:

  • Document: DocID / Control Number
  • Submitted by: The user who submitted the translation job
  • Date Submitted: The date the translation job was submitted
  • Date Completed: The date the translation job completed
  • Language: Language option selected
  • Status: Current job status (Submitted, In Progress, Completed or Failed)
  • Veritone Recording ID: Unique job identifier in Veritone environment

The Translation Logs tab also includes three functional features:

  • Delete all pending jobs: Will cancel all jobs that have not yet been submitted to Veritone. Jobs cannot be canceled once they are in progress.
  • Check All Failed: Will retry all failed jobs by rerunning the engines.
  • Sync Job Status: Will fetch the latest job status on failed jobs without rerunning. This option should be executed first when job failures are encountered. 

Translation history

The Translation History tab displays a chart of the total document count translated per month. Date range filters are available to update the chart as desired.

OBJECT DETECTION

The Object Detection feature allows users to leverage Veritone’s AI engines to extract objects from video frames that can be integrated with Relativity dtSearch and Analytics.

Object Detection Requirements

  • Veritone Key
  • Compatible Video File Format
  • Veritone Object Detection Job Manager Agent
  • Veritone Object Detection Job Analyzer Agent

Bulk Object Detection

  1. Select media files from document list and choose Object Detection
  2. In the Object Detection dialog box, click Submit

Single File Object Detection

  1. In the Document Viewer, select the Object Detection button (top-right)
  2. In the Object Detection dialog box, click Submit

Object Detection Status

The current status will be displayed in the Veritone Object Detection Status field and in the Object Detection Logs tab.

Object Detection Logs

The Object Detection Logs tab lists every job submission and includes the following information:

  • Document: DocID / Control Number
  • Submitted by: The user who submitted the job
  • Date Submitted: The date the job was submitted
  • Date Completed: The date the job completed
  • Media Duration: The duration of the video file 
  • Status: Current job status (Submitted, In Progress, Completed or Failed)
  • Veritone Recording ID: Unique job identifier in Veritone environment

The Object Detection Logs tab also includes three functional features:

  • Delete all pending jobs: Will cancel all jobs that have not yet been submitted to Veritone. Jobs cannot be canceled once they are in progress.
  • Check All Failed: Will retry all failed jobs by rerunning the engines.
  • Sync Job Status: Will fetch the latest job status on failed jobs without rerunning. This option should be executed first when job failures are encountered. 

Object Detection History

The Object Detection History tab displays a chart of the total hours of media processed per month. Date range filters are available to update the chart as desired.

VERITONE SUMMARY REPORT

Execute the SQL script below to generate transcription, translation and object detection totals for all workspaces where the Veritone AiWARE for Relativity application is installed. The output will include the workspace name, case artifact ID, total transcription jobs, total transcription duration (hours), total translation jobs, total object detection jobs, total object detection duration (hours). User must enter the range in the first DECLARE statement on row four.

  • SQL file can be downloaded here.

SECURITY & DATA FLOW

Audio, video, and text files that are uploaded and stored in a customer’s Relativity instance are transmitted to the Veritone Platform for processing, and the resulting metadata is transmitted back to Relativity, through the Veritone Relativity Application (Veritone RAP) interface. The data transmission channel is encrypted with a TLS 1.2 implementation with a 256 bit AES connection.

The Veritone Platform resides in the Amazon Web Services (AWS) commercial cloud infrastructure.  AWS’ cloud security documentation is available at http://aws.amazon.com/security/.  AWS’ ISO 27017 certification is available at https://aws.amazon.com/compliance/iso-27017-faqs/.

Veritone’s cloud architecture is a multi-tenant architecture that is securely partitioned logically for each customer’s data.  For processing conducted through the Veritone RAP, a unique API key is generated by Veritone for each Relativity Workspace, which corresponds to a unique media container in the Veritone Platform.  API calls are made through the Veritone RAP to submit, retrieve and delete processing jobs. 

By default, the Veritone RAP is configured to automatically delete media and metadata from the Veritone Platform upon job completion.  Immediately after job results are retrieved by the Veritone RAP, the Veritone RAP automatically executes an API delete call to remove all media files and metadata related to that job from the Veritone Platform. *An enabled Veritone Recording Deletion Agent is required.

Secure deletion of data from the cloud environment is conducted in accordance with AWS commercial cloud deletion processes.  No original media files or metadata is stored in the Veritone Platform after completion of a processing job, unless the customer elects to retain such data in the Platform.  If a customer elects to retain copies of its media files and metadata in the Veritone Platform, Veritone has the ability to encrypt such data utilizing 256 bit AES encryption.

__________________________________________________________________

Veritone Support

Email: [email protected]

+1 888 507 1737 

Monday – Friday, 6AM – 6PM Pacific Standard Time

Did this answer your question?