Dalet Flex has integrated with Oracle, via the creation of three DIVArchive action plugins. This is the first integration of an archive system with Dalet Flex. Below is a list of DIVArchive related plugins. These plugins revolve around the archiving of media assets. These plugins will enable you to archive, delete, restore, and purge your assets respectively.
The asset types that are currently supported for use with DIVArchive, are as follows:
- Media assets
- Text assets
- Image assets
Group assets are not currently supported.
In order to make use of the DIVArchive functionality, there are a number of prerequisites that you must take into consideration. These are as follows:
- You must have DIVA credentials i.e you must have credentials that enable you to access the DIVA Configuration Utility.
- You must define the source and destination in Configuration Utility: The source and destination are essentially locations that the DIVArchive system has access to. When adding the source, you will need to specify a source type from the Source Type field in DIVArchive Configuration Utility. The source types that are currently supported by Dalet Flex are as follows:
- CIFS (Common Internet File System)
- DISK
- FTP Standard
- MediaGrid
- Local
- You must set up and configure DIVArchive in Dalet Flex. This involves configuring the DIVArchive resource. When specifying locations, you must map these locations in the Resource plugin’s Folder Mapping field.
- You must define a media name in Configuration Utility, and then reference the Media Name field in the DIVArchive action plugin. Media name can refer to media or storage plan.
In the diagram below, you can see how each of the DIVArchive plugins relate to each other, and in what order they can be used:
DIVArchive Action
This plugin archives an asset as a new object in DIVArchive.
Only individual assets are currently supported. So you can only archive one asset at a time.
Despite the fact that the DIVArchive plugin falls under the "Archive" category the DIVArchive action is distinctly different and separate from the standard Dalet Flex Archive action.
When you are setting up the DIVArchive plugin, you must first ensure that you have specified a source and a destination in the DIVArchive UI.
Properties
| Field | Value | Explanation |
| Icon | Plugin icon | |
| Sub-type | Archive | Sub-type of this plugin |
| Classification | Capacity | Classification of this plugin |
| Deployment | Internal | Whether the plugin is deployed inside Dalet Flex or within another product |
| Supports Configuration | YES | Whether this plugin supports configuration |
| Supports Scripting | YES | Whether configuration supports scripting |
| Scripting Context | [job](../actions/), asset, event * | What Dalet Flex objects can be referenced from within the scripting context. * Note the event object is only visible in the context of an action running in an event handler. |
| Undo Action</td> | The action required to undo this action | |
| Redo Action | The action required to redo this action | |
| Timeout | Whether or not to select a timeout | |
| Auto retry | Whether or not to select an automatic retry | |
| Compatibility | 5.3 | What versions of Dalet Flex this plugin works for |
| Lifecycle | Stable | Maturity of this plugin (experimental, unstable or stable) |
Configuration
| Field | Field Type | Mandatory | Multiplicity | Description |
| External Resource | Single option | YES | The External Resource which will process specified assets. | |
| Asset Context | String | YES | The asset context hierarchy expression referencing the assets to be archived. | |
| Archive Params | complex | NO | Archive Params details of archive service | |
| Object Name | string | YES | Name of the Object to be archived. | |
| Object Category | string | YES | Category of the Object. | |
| Source | string | YES | Name of the Source (e.g. video server, browsing server). This name must be known to the DIVArchive Configuration Description. | |
| Media Name | string | YES | The Tape Group or Disk Array on which the object is to be saved. | |
| Delete On Source | Boolean | NO | The delete on source variable is used as archived params. | |
| Comment | string | NO | The comment is used as archived params. |
DIVA Delete Action
This plugin deletes an asset from DIVArchive.
This plugin falls under the Delete Archive category.
Properties
| Field | Value | Explanation |
| Icon | Plugin icon | |
| Sub-type | Delete Archive | Sub-type of this plugin |
| Classification | Capacity | Classification of this plugin |
| Deployment | Internal | Whether the plugin is deployed inside Dalet Flex or within another product |
| Supports Configuration | YES | Whether this plugin supports configuration |
| Supports Scripting | YES | Whether configuration supports scripting |
| Scripting Context | [job](../actions/), asset, event * | What Dalet Flex objects can be referenced from within the scripting context. * Note: the event object is only visible in the context of an action running in an event handler. |
| Undo Action | The action required to undo this action | |
| Redo Action | The action required to redo th | |
| Auto retry | Whether or not to select an automatic retry | |
| Compatibility | 5.3 | What versions of Dalet Flex this plugin works for |
| Lifecycle | Stable | Maturity of this plugin (Experimental, Unstable or Stable) |
Configuration
| Field | Field Type | Mandatory | Multiplicity | Description |
| External Resource | Single option | YES | The external resource which will process specified assets. | |
| Media Name | string | NO | The tape group or disk array from which the object will be deleted. | |
| Instance ID | string | NO | Disk or tape instance number to be deleted. This is assigned in DIVArchive and can be verified in Dalet Flex using DIVArchive tab in asset. (#) | |
| Priority Level | string | NO | A value between 0...100 (not included). This will be used in DIVArchive system to manage the job priority. (#) |
DIVA Restore Action
This plugin restores an archived asset from DIVArchive.
This plugin falls under the Restore Archive category.
Properties
| Field | Value | Explanation |
| Icon | Plugin icon | |
| Sub-type | Restore Archive | Sub-type of this plugin |
| Classification | Capacity | Classification of this plugin |
| Deployment | Internal | Whether the plugin is deployed inside Dalet Flex or within another product |
| Supports Configuration | YES | Whether this plugin supports configuration |
| Supports Scripting | YES | Whether configuration supports scripting |
| Scripting Context | [job](../actions/), asset, event * | What Dalet Flex objects can be referenced from within the scripting context. * Note: the event object is only visible in the context of an action running in an event handler. |
| Undo Action | The action required to undo this action | |
| Redo Action | The action required to redo this action | |
| Timeout | Whether or not to select a timeout | |
| Auto retry | Whether or not to select an automatic retry | |
| Compatibility | 5.3 | What versions of Dalet Flex this plugin works for |
| Lifecycle | Stable | Maturity of this plugin (Experimental, Unstable or Stable) |
Configuration
| Field | Field Type | Mandatory | Multiplicity | Description |
| External Resource | single option | YES | The external resource which will process specified assets. | |
| Destinations | complex | YES | 0..* | Name of the destination(s) configured in DIVArchive. |
| Destination | string | YES | Name of the destination(s) configured in DIVArchive. | |
| Destination Path | NO | Path on the destination(s). | ||
| Priority Level | string | NO | A value between 0...100 (not included). This will be used in DIVArchive system to manage the job priority. (#) | |
| Restore Options | string | NO | Command line style parameters that can be added to the request. These options supersede any options specified in the DIVArchive Database | |
| Additional Services | single option | NO | Restore overwrite option. |
The options for the additional services are as follows:
- Default: Operate using the default setting in the DIVA Manager Configuration.
- Do not overwrite: Do not overwrite existing files on the destination server. The Action will fail if the file already exists.
- Do not check existence: Do not check existence of the file on the server.
- Delete and write: Force delete and rewrite if the file exists on the server.
DIVArchive Resource
This resource provides access to an archive resource. Configuration options are governed by the specific vendor solution being used, so in this case, the configuration options are related to DIVArchive.
Properties
| Field | Value | Explanation |
| Icon | Plugin icon | |
| Sub-type | External | Sub-type of this plugin |
| Classification | Process | Classification of this plugin |
| Deployment | Internal | Whether the plugin is deployed inside Dalet Flex or within another product |
| Supports Configuration | YES | Whether this plugin supports configuration |
| Supports Scripting | NO | Whether configuration supports scripting |
| Scripting Context | What Dalet Flex objects can be referenced from within the scripting context | |
| Undo Action | The action required to undo this action | |
| Redo Action | The action required to redo this action | |
| Compatability | 5.x | What versions of Dalet Flex this plugin works for |
| Lifecycle | Stable | Maturity of this plugin (Experimental, Unstable or Stable) |
Configuration
| Field | Field Type | Mandatory | Multiplicity | Description |
| Integration Service | complex | NO | DIVA Archive Integration service details | |
| Hostname | string | YES | Hostname for accessing the location | |
| Port | string | YES | Port for accessing the location (#) | |
| Username | string | YES | Username for authentication | |
| Password | string | YES | Password for authentication | |
| Site Name | string | YES | The site name configured in DIVArchive | |
| Response Timeout | string | YES | Response timeout | |
| Userinfo | string | YES | User Information | |
| Folder Mapping | complex | NO | 0..* | Base VFS locations for the location of files once a destination is defined it will be used as restore location. |
| Flex Base VFS Location | NO | Details for a base vfs location | ||
| Protocol | single option | YES | Protocol for accessing the location | |
| Hostname | string | NO | Hostname for accessing the location (mandatory except for file, s3, google or dropbox protocols) | |
| Port | string | NO | Port for accessing the location (mandatory except for file, s3, google or dropbox protocols) (#) | |
| Path | string | NO | Path for accessing the location (absolute path starting with / except for ftp, sftp, ftps which are relative to the user's home directory) | |
| Username | string | NO | Username for authentication (not required for file protocol) | |
| Password | string | NO | Password for authentication (not required for file, s3, google or dropbox protocols) | |
| Key | string | NO | Key for authentication (only applicable to s3, google and dropbox protocols) | |
| Secret | string | NO | Secret for authentication (only applicable to s3, google and dropbox protocols) | |
| Token | string | NO | Token for authentication (only applicable to google and dropbox protocols) | |
| Bucket | string | NO | Only applicable to S3 protocol | |
| Private Key File | file | NO | Only applicable for SFTP certificate authentication | |
| DIVA Archive Base VFS Location | complex | NO | Details for a diva archive base vfs location |
DIVArchive Video Restore
The DIVArchive Video Restore plugin gives you the ability to either restore a whole video, or perform a partial restore on a video that is currently in archive. You can only restore a single asset at a time.
Important points:
When performing a partial restore, you must specify an in timecode and an out timecode in the configuration for the plugin. Timecode In and Timecode Out, values should be in HH:MM:SS:FF Format.
This is a distinctly different plugin to the Restore Archive plugin. The Restore plugin is a file restore.
This plugin falls under the Restore Archive sub-type.
Video Partial Restore on a DIVA object with multiple assets and for an asset group is not supported.
Properties
| Field | Value | Explanation |
| Icon | Plugin icon | |
| Sub-type | Restore Archive | Sub-type of this plugin |
| Classification | Capacity | Classification of this plugin |
| Deployment | Internal | Whether the plugin is deployed inside Dalet Flex or within another product |
| Supports Configuration | YES | Whether this plugin supports configuration |
| Supports Scripting | YES | Whether configuration supports scripting |
| Scripting Context | [job](../actions/), asset, event * | What Dalet Flex objects can be referenced from within the scripting context. * Note: the event object is only visible in the context of an action running in an event handler. |
| Undo Action | The action required to undo this action | |
| Redo Action | The action required to redo this action | |
| Timeout | Whether or not to select a timeout | |
| Auto retry | Whether or not to select an automatic retry | |
| Compatibility | 5.5 | What versions of Dalet Flex this plugin works for |
| Lifecycle | Stable | Maturity of this plugin (Experimental, Unstable or Stable) |
Configuration
| Field | Field Type | Mandatory | Multiplicity | Description |
| External Resource | Single Option | YES | The External Resource which will process specified assets. | |
| Asset Context | string | YES | The asset context hierarchy expression referencing the assets to be restored. e.g.: To restore all assets from an Asset Group enter *. | |
| DIVA Object Name Category | string | NO | 0..1 | On Archive Flex has created DIVA object name using 'Object Name'+'Object Category' fields from Archive config. If an Asset is archived in multiple DIVAObjects, use this expression to select specific DIVAObject, e.g. myassetid+mycategory. |
| Video File Details | complex | YES | 0..1 | Configuration used to create video file from source file. |
| Timecode In (HH:MM:SS:FF) | string | NO | Start time-code of the file. If not defined then DIVA Service will consider default value "00:00:00:00". | |
| Timecode Out (HH:MM:SS:FF) | string | NO | End time-code of the file. If not defined then DIVA service will consider default value "99:99:99:99". | |
| Destination File Name | string | NO | File Name of restored video file at destination. Default will be in format asset-name_TC-IN_TC-OUT. | |
| Destinations | complex | YES | 0..1 | Restore destinations. If empty the file will be restored to the current asset location. |
| Destination | string | YES | Asset(s) will be restored to the configured path in DIVA Destination config. If asset was archived with subfolder (e.g. copy/file1.mp4), it will be appended to Destination path. | |
| Destination Path | string | NO | Use this path to append additional subfolder to the configured path in DIVA Destination config. If asset was archived with subfolder (e.g. copy/file1.mp4), this will be appended after the Destination Path. | |
| Move Restored Assets to Current Location | Check box | NO | DIVA will restore always to the asset original location when it was archived. If Flex asset has been moved (or in Delete resource) since it was archived, this option will move back to current asset location from the restored original location. | |
| DIVA Video Partial Restore to create a clip from Restored File? | Check box | NO | This option will import video partial restore asset as new Flex media asset with RENDER_CLIP relation to original archived asset. This option will be ignored if Destination param is configured (use another explicit Import action in this case). | |
| Priority Level | string | NO | A value between 0...100 (not included). This will be used in DIVArchive system to manage the job priority. (#) | |
| Restore Options | string | NO | Command line style parameters that can be added to the request. These options supersede any options specified in the DIVArchive Database | |
| Additional Services | Single option | NO | Restore overwrite option. |
Comments
0 comments
Please sign in to leave a comment.