Tutorial - ftrack Integration

Rev 1.003, 2020.04.09

How to read this tutorial

  • The tutorial does not cover all features of accsyn, just a selected set.

  • Entries in Bold are highlighted important input data.

  • Entries in Bold Italic are made up data for this tutorial only, here you provide your own data as appropriate.

  • Labels in Italic correspond to the name of an input were you enter data.

  • Text in [ BRACKETS ] denotes a button within user interface, were LINK points out a link - for example a navigation link.

Summary

This tutorial is targeted companies that:

  • Utilises ftrack (ftrack.com) as their project management tool.

  • Stores paths to file assets @ ftrack version components, or are planning to do so, on a central storage location.


Wishing to:

  • Easily transfer files between locations, freelancers, subcontractors and employees working from home, from within ftrack without needing to go over FTP or other service.

  • Have transfers go at maximum speed, with high security - no account passwords communicated in emails or similar channels.

  • Monitor and debug transfers, submit complimentary transfers.

  • Further use a Python API to enable file delivery automatisations.


This tutorial is a complete walkthrough covering:

  • Setting up accsyn on-prem.

  • Setting up accsyn at a remote site/location.

  • Configuring the ftrack integration, with an existing central storage scenario or a studio location.

  • Configuring and test an employee workstation with Connect and the ftrack accsyn accessor.

  • Run the action to transfer the published version to the remote site.

  • Configure a remote standard restricted user/vendor within accsyn and ftrack, for project or specific parts of a project.

  • Publish a starter version and send it to the remote user/vendor.

  • Have remote user publish back result to ftrack and synchronise files.


Note: In this tutorial we are only covering sending a set of files already registered within the ftrack database (location system). Beyond that, accsyn can act as a full replacement of your current FTP server or other similar file transfer infrastructure, please visit accsyn.com for full feature specifications.

Schematics

Installing and configuring accsyn


The following guide is a short summary of the installation process described in detail here: accsyn Admin Manual

  • Register your domain @ https://customer.accsyn.com, we recommend using the same accsyn domain name as you have with ftrack. In this tutorial we will use company(.accsyn.com).

  • Follow the guide to initialise domain. Hint: Read through the admin tour when offered, it gives insight into the architecture of accsyn and the terms used/names of entities.

  • Install server; when the guide instructs you to install the accsyn daemon, download and install it on your current file transfer on-prem server ("alpha"). Pick a server that has access to your storage, or a the part of your storage that you want to expose to accsyn.

  • Network; the guide will ask you to configure your firewall, add NAT port forwards 45190-45210 (tcp) to file transfer server "alpha". Note that accsyn daemon DOES NOT listen to any ports 24/7, it will only start a listening process during file transfer init, software firewalled to accept incoming connections from remote client WAN IP only. For more information, please refer to accsyn Security Whitepaper.

  • Root share; Browse to your storage, were files referenced in ftrack are stored . In this tutorial, we assume server is running Linux and have project data accessible/mounted at /storage (Windows workstation path S: , \\192.168.1.240\storage).

  • Finish installation.

  • Finally, we want to learn accsyn about the Windows paths, in case files are stored in ftrack from mixed platforms. Go to Admin>Shares>Root shares and edit the root share (storage). Enter drive letter S: as Windows path and \\192.168.1.240\storage as the UNC path (helps accsyn identify files accessed over VPN).

Note: it's perfectly fine to skip Windows drive letters, and go 100% on UNC paths. Drive letters simplifies remote workflows, enabling sites and employees to have a local drive letter keeping project file paths consistent across locations.


Installing accsyn on a remote site/location

Next, we are going to setup a remote office. In this tutorial we are going to name it "LA" and we assume you have prepared a local Linux server with proxy storage mounted at same path as main server (/storage):

  1. Logon to accsyn as an administrator.

  2. Go to Admin>Sites and choose [Create site].

  3. Enter the name (code) of site (LA) and click [Create].

  4. Go to Admin>Servers and choose [Install server].

  5. Choose "Serving root share(s) on a remote site." option, choose the site (LA) and the root share (storage).

  6. Click Next.

  7. Conclude the server installation by installing the Daemon, authenticating and finish server installation.


You now have a fully working setup were you can push files, using an encrypted accelerated rsync protocol, between your sites and users.

Configuring the ftrack action


Configure ftrack


As first step, we need the locations in ftrack to align with sites in accsyn:

  1. Logon to ftrack as an administrator and head over to System Settings>Locations.

  2. Create the locations "hq" that will correspond to the main site in accsyn, and the site "la". If you already have sites in ftrack you can rename the sites in accsyn to align, note that it is important hey have exactly the same name for integration to work properly.


Getting boilerplate action script


We provide a boilerplate Python 3 action script at our GitHub: https://github.com/accsyn/ftrack-send

Note: The script is for Python 3, simply change the line "except Exception as e:" to "except Exception, e:" to make it Python 2 compliant.


Setup action


  1. Copy the action script to your Linux server.

  2. (Optional) Create a virtual env.

  3. Install ftrack API and accsyn API: pip install ftrack-python-api and pip install accsyn-python-api.

  4. Set ftrack environment variables for your shell: FTRACK_SERVER=https://company.ftrack.com, FTRACK_API_USER=<your ftrack username> and FTRACK_API_KEY=<API key for selected user account>.

  5. Set accsyn environment variables, we recommend inviting activating a separate Employee account in accsyn for this purpose: ACCSYN_DOMAIN=company, ACCSYN_API_USER=<accsyn account E-mail> and ACCSYN_API_KEY=<API key for selected accsyn account>.

  6. Modify the action script to suite your needs, depending on your storage setup you will need to configure the part of the script that identifies shares and paths before submitting transfers to accsyn.

  7. Run the action: . /path/to/venv/bin/activate && python action.py.


Testing action


We are going to test the action by sending the components of a version in ftrack to the other location.

In this tutorial, we assume the company have a pipeline that stores file paths at version components upon publish. The script will look for these paths at "ftrack.unmanaged" and custom locations:

Example of Ftrack version with stored paths.

  1. Logon to ftrack and open the version to send.

  2. Run action on version and choose "accsyn Send".

  3. Choose "hq" as source location and "la" as destination.

  4. Run the action, a job should appear in ftrack. Hover the job to get feedback on how transfer progress.



Setup an employee

An employee working away from office is another example of when you want to send project assets forth and back through ftrack. In accsyn, a user having the "employee" rule means they have full access to all root shares / storage.


  1. In accsyn, goto Admin>Users and choose [Invite user]. Enter the employee's Email and choose [Next].

  2. For clearance, choose Employee and finish by clicking [Invite].

  3. Have the employee activate their account, download and logon to the accsyn desktop app. We assume they are on Windows.

  4. Have Employee mount a work harddrive at drive letter S:.

  5. Open accsyn app prefs and, beneath Shares, enable "storage" and tick Read and Write checkboxes.


You can now start push and pull files as long as the employee has the desktop app running. Next we need to setup ftrack:

  1. Logon to ftrack as an Admin and head over to System Settings>Locations.

  2. Create a location with the exact same E-mail address as you used in accsyn when inviting the employee.

  3. Restart your running action script.


At last, we test the setup by sending a task plus an additional file to the employee:

  1. Run accsyn Send action on the task you wish to send in ftrack.

  2. The new employee location should now appear in ftrack among destinations.

  3. Beneath Additional Files, paste the full path to the additional files, for example: "S:\theproject\seq010\refs" and run the action.


All components beneath task plus the extra folder should now appear remotely @ employee workstations. If any errors, run accsyn desktop app or view transfers within Accsyn webapp to troubleshoot.


Hint: To automise task send, you can extend the ftrack event listener to react upon task assignments and send tasks as they occur.


Publishing back

Assuming you have plug-in that employee uses to create a ftrack version, with component paths pointing the local assets that needs to be sent back to server, your ftrack user's can easily run the accsyn Send action again to send the version back to main premises/site.


Hint: Of course you can also use the accsyn Python API within your plug-ins to automise file transfers on publish.




Setup a vendor


By "vendor" we mean a restricted freelancer or subcontractor that only should work on a subset of project data, with limited access to project data. The typical flow is to have an "outsource" user or similar in ftrack and assign tasks based on production schedule.



Invite vendor


  1. Repeat the same steps as for an employee except that you instead of inviting them with "employee" clearance in accsyn, you use default "restricted" clearance.

  2. Instruct the vendor to activate their account, download and install the accsyn desktop app.



Setting up share in accsyn


To make it easy for vendor to do complementary asset downloads and upload the result back, we setup a share in accsyn for the purpose.

  1. Logon as admin and go to Admin>Shares within accsyn.

  2. Click [Create share].

  3. In this tutorial, we assume vendor will have read access to entire project folder. Browse to the project folder and click [Next].

  4. Pick a suitable name for share, for example "theproject-outsource" and create it by clicking [Create]. Note: You can reuse this share for all vendors, as actual file access is defined separately.

  5. Upon creation, you will be directed to the accsyn ACL create wizard. Click [Next]

  6. Choose the vendor E-mail and make sure only Read is checked. Finish up by clicking [Grant access].

  7. Vendor can now freely download from your project folder, next we want to give write access. Click [Share directory] and browse to a folder were they can upload their finished task result. Click [Next].

  8. Tick Write checkbox and then [Grant access]. Vendor can now upload the folder you chose, notifying admins with an E-mail each time an upload finishes.

Note: This step is optional. Without the share vendors can't do complementary download and when they upload, it will go to into their Accsyn home share.


Configure vendor


We want the vendor to work as smoothly as possible, without needing to keep track of saving files and your folder structure:

  1. Instruct vendor to add the following environment variable: ACCSYN_STORAGE_PATH=C:\Users\vendor\documents\company\storage.

  2. Have them properly save the settings and then restart and logon to the accsyn desktop app.

From now on, when a package is sent to vendor, with source paths beneath storage, they will start download directly mirroring the folder structure at on-prem storage.


Configure ftrack and send a shot


  1. As for an employee, create a location in ftrack with a name exactly matching the accsyn E-mail username of vendor.

  2. Select the shot in ftrack and run accsyn Send action.

  3. Choose "hq" as source and the vendor E-mail as destination.

  4. accsyn will collect all components beneath shot and send to vendor, if you want to be more specific on what to send - select the particular tasks containing required file components to complete the task remotely.

  5. If vendor has mapped a share that covers the paths, download will start immediately. Otherwise, instruct vendor to save package to get download going.


Publish back

When vendor is done with their work, the basic way to send back the result is to drag-n-drop the folder onto accsyn and upload to the company. If they have followed your naming convention, and have ACL write access to the involved folder on-prem, upload should start immediately and files should end up with mirrored paths.




Conclusion


With the accsyn ftrack send action, file management suddenly becomes demystified enabling anyone with ftrack access to push file assets globally between sites and users. Fully encrypted and using an accelerated protocol, minimising waste of valuable production time.


For more information/tutorials, please head over to support.accsyn.com.