FileCatalyst Integration

FileCatalyst is a transfer accelerator which utilizes a UDP based approach. This FileCatalyst integration makes it much quicker to upload batches of large files to Ooyala Flex.

The key difference between the ordinary Ooyala Flex Uploader and the FileCatalyst Uploader, is as follows:

  • Ooyala Flex Uploader: uses HTTP and TCP.
  • FileCatalyst Uploader: uses reliable UDP.

Prerequisites

There are a number of prerequisites that you must take into account, if you intend to use the FileCatalyst Uploader. These are as follows:

  • Each user must have a FileCatalyst license.
  • Each user must have the FileCatalyst Transfer Agent installed locally on their machine.
  • Each user must have both an Ooyala Flex user, and a FileCatalyst user.
  • You must have the storage location of the FileCatalyst Server shared with Ooyala Flex. So in other words, each user of FileCatalyst must have a storage location linked to their username. That storage location must then be shared with Ooyala Flex, in order for the files to be ingested by Ooyala Flex.
Note: For further information on FileCatalyst, please follow this link to the FileCatalyst documentation.

 

Using FileCatalyst

Creating a Storage Resource

To begin, you must create a storage resource. To create a storage resource, follow these steps:

 

1) From the toolbar, on the right-hand side of the Ooyala Flex console, click the New option.

 

2) From the drop down menu, select Resource.

 

3) In the Create new Resource... screen, enter a name and an optional description.

 

4) From the Visibility field, select a visibility. For example: which accounts, workspaces, and groups will be able to see this storage resource.

 

5) From the Plugin drop down, select Storage Resource.

 

6) From the Polling Interval drop down select a polling interval.

 

7) Click Save.

 

8) Next, click the Configuration tab.

 

9) Click the Edit option.

 

 

10) From the Protocol drop down, you must select either SFTP or FILE. SFTP and FILE are currently the only two supported protocols.

Note: If you have selected the SFTP option, you must specify a private key file in the Private Key File field.

Note: The Hostname field is optional. This field accesses the location (mandatory except for FILE, S3, Google, or Dropbox protocols).

11) In the Path field, enter a path for your storage resource. This path must point to the physical storage location.

12) Click Save

 

13) Click the Enable option, to enable your storage resource.

 

14) Click the Start option, in order to start your storage resource.

 

Creating an Inbox

Next you must create an Inbox. To do this, follow these steps:

1) From the toolbar on the right-hand side of the console, click the New option.

2) From the drop down menu, select Resource.

3) In the Create new Resource... screen, enter a name and an optional description.

4) From the Visibility field, select a visibility for your Inbox. For example: which accounts, workspaces, and groups that will be able to see this inbox resource.

5) From the Plugin drop down, select Inbox.

6) From the Polling Interval drop down, select a polling interval.

7) Click Save.

8) Next, click the Configuration tab.

9) Click the Edit option.

10)  From the Storage Resource drop down, select the storage resource you have created for use with FileCatalyst.

11) In the Transfer Accelerator field, enter a name for your transfer accelerator, for example FileCatalyst.

12) Click Save.

13) Click the Enable option, to enable your Inbox.

14) Click the Start option, in order to start your Inbox.

 

Creating a HTTP Transfer Resource

Regardless of whether you wish to use FileCatalyst or use the ordinary Web Uploader, you must ensure that you have setup a HTTP transfer resource. The HTTP Transfer resource is required for any type of transfer related scenario.

If you have not created a HTTP transfer resource, then follow these steps:

1) In the Ooyala Flex console, on the right-hand side of the screen, click the Settings tab.

2) From the toolbar, click the Resources option.

3) On the Resources screen, click the New option.

4) In the Create a New Resource... screen, enter the details for your HTTP transfer resource.

5) In the Name field, enter a name.

6) In the Description field, enter an optional description.

7) In the Visibility field, enter a visibility for your Resource. For example: which accounts, sub-accounts, and groups that the resource can be viewed by.

8) From the Plugin drop down, select the HTTP Transfer Resource option.

9) From the Polling Interval drop down, select a polling interval.

10) Click Save.

11) On the Transfer Resource screen, click the Configuration sub-tab.

12) Click the Editoption.

13) In the Public End Point field, enter the URL of the web transfer instance associated to this resource.

14) In the Internal End Point field, enter the URL used by enterprise to communicate the web transfer instance associated with this resource (For example: when starting / stopping the resource).

15) Click Save.

16) Click the Enable option.

17) Click the Start option.

Logging In

When you first start using FileCatalyst to upload files to Ooyala Flex, you will need to fill in your FileCatalyst credentials.

 

To do this, follow these steps:

1) In the Ooyala Flex console, from the toolbar, click the Upload option.

 

2) In the Web Uploader window, click the Upload option.

 

3) Select your FileCatalyst options. This is your FileCatalyst inbox, and your FileCatalyst storage resource.

 

 

4) Click the Add File(s) option, to select a file you wish to upload.

5) A pop up will then appear, in which you will need to provide your FileCatalyst credentials.

 

 

6) In the Username field, enter your file Catalyst username.

 

 

7) In the Password box, enter your FileCatalyst password.

 

 

8) In the Transfer Agent port field, enter your port.

 

Note: The port is automatically defined in this field, and is the default port for the FileCatalyst Transfer Agent. Because this is local from user to user, it can be changed.

 

9) Select the Remember my login credentials check box, if you want Ooyala Flex to remember these details.

Uploading files using FileCatalyst

To upload a file using FileCatalyst, follow these steps:

1) In the Ooyala Flex console, from the toolbar, click the Upload option.

2) From the Inbox drop down, select the inbox that you have associated with FileCatalyst. When creating and configuring this inbox, It might be a good idea to name the inbox "file-catalyst-inbox" or something similar, so that it is distinguishable.

3) From the Transfer Accelerator field, select the FileCatalyst option.

Note: You can also select the regular HTTP upload type from the Transfer Accelerator drop down, in order to perform regular uploads using your FileCatalyst Inbox.

4) Select the files you wish to upload, and then click Add Files.

Notes:

  • If you have selected multiple files, and there are metadata fields associated with them, you will need to click the Edit button located next to each file, and then input the metadata. You will be unable to upload the files until the metadata has been inputted.
  • If you have only selected a single file, and there are metadata fields associated with it, then the metadata pop-up will appear, and you will be required to input the metadata. You will be unable to upload the files until the metadata has been inputted.

5) The files will upload.

Was this article helpful?