BROWSE CATDV SUPPORT MANUALS

The CatDV Worker can be used to upload media to an Aspera Server  site.

In order to  do this Aspera Connect needs to be installed to provide the command interface to interact with the Aspera Server,  this can be downloaded from the Aspera Website here .

In this workflow we shall use the worker to publish media to an Aspera Server.

Set a Server Query to watch for Aspera upload instructions

On the trigger tab of a new worker action, set a Server Query to look for a user field being updated. In this example we are looking for a user field called “Aspera_Upload” being changed to “Upload_file”. This user field has been previously created as a Grouping field with “Upload_file” as a value.

Aspera upload eg

 

Tell the worker to publish the original media to the Aspera Server  site

Use execute command 2 on the Conversions tab to call  our Aspera Upload Batch file  command line:

c:\bats\Catdv_asperaUP.bat $i

Where c:\bats\Catdv_asperaUP.bat is the path to our Aspera Upload batch script ( or shell script on a Mac ) and $i is a worker variable for the  Full path of the input file (after preprocessing) (eg. “E:\Media\Original\file1.mov”)

Please see the bottom section of this document for a full version of the script

aspera_upload-TConversion

Update the Status of the Clip

The asset can now be updated to show that the upload has happened. On the Publish tab, update the “Aspera_Upload” field to say “Uploaded”.

aspera_upload-Watch-Action1

Example Aspera Upload Script

The following script is supplied to illustrate how it is possible to automate the Upload. The script is free to use and modify but are provided for use at your own risk. Please consult a systems administrator if you are in any doubt about shell /  batch scripts. Knowledge of scripting will be needed to adapt these scripts to suit a specific environment or business needs.

This tutorial is focused on Windows   environments but  the ASCP command syntax is standard across platforms so the scripts can  be repurposed as shell scripts for OSX.

There are comments in each script to help indicate what each section does and suggestions on where modifications can be made.

Windows Batch script

copy and  paste  the  text between the ####### sections into a text file and save it as Catdv_asperaUP.bat in a folder called c:\bats

alternatively  download the file here and rename the extension to .bat   Catdv_asperaUP.txt

##################################################################################

REM Example CatDV Aspera server Upload Script

REM Usage Call Catdv_asperaUP.bat in the Execute Command 1 Section of the Worker watch action Conversions TAB 

REM Triggered By a a server query on user field Aspera_upload = Upload_File

REM use Publish section to update user field Aspera_upload = Uploaded

REM syntax Path to batch file Variable_1 ( source file path ) 

REM eg c:\bats\Catdv_asperaUP.bat $i

REM set the Aspera password alternatively this could be supplied as a variable from a user field in CatDV 

set ASPERA_SCP_PASS=demoaspera


REM call ascp path to the executable -QT disables encryption and -l 100m sets max transfer rate to 100Mbps -P preservers file time stamp 33001 is the aspera control port %1 substitutes the first variable supplied by CatDV worker ( source file-path) 
REM aspera@demo.asperasoft.com:/Upload is the account to log in to and the upload directory 

"C:\Program Files (x86)\Aspera\Aspera Connect\bin\ascp.exe" -QT -l 100m -P 33001 %1 asperaweb@demo.asperasoft.com:/Upload/sbstest/



REM Scope for further development - supply the aspera login name and PWD from within CatDV as user fields so usage would become 

REM syntax Path to batch file Variable_1 ( source file path ) Variable_2 ( aspera user-name U16 ) Variable_3 ( aspera PWD U17 ) Variable_3 ( aspera PWD U18 )

REM eg c:\bats\Catdv_asperaUP.bat $i $U16 $U17
REM substituting %3 for demoaspera in the set ASPERA_SCP_PASS string above and %2 for aspera@demo.asperasoft.com to set the aspera user and :/%4 to set the upload path 


REM there are also many other options governing the behaviour of the Aspera transfer that could be managed through modification of the batch command syntax either directly or by supplying user Fields as variables through the worker 

REM syntax help for ascp http://download.asperasoft.com/download/docs/ascp/3.0/html/index.html
##################################################################################