Filecatalyst Integration

FileCatalyst is a transfer accelerator which enables you to quickly upload batches of large files to Ooyala Flex.

The key difference between the Ooyala Flex Web Uploader and the FileCatalyst Transfer Agent is as follows:

  • Ooyala Flex Web Uploader: uses HyperText Transfer Protocol (HTTP) and Transmission Control Protocol (TCP).
  • FileCatalyst Transfer Agent: uses User Datagram Protocol (UDP).

Prerequisites

Please take into account the following prerequisites:

  • You must have a FileCatalyst license.
  • You must have the FileCatalyst Transfer Agent installed locally on your machine.
  • You must have both an Ooyala Flex user and a FileCatalyst user.
  • The storage location of the FileCatalyst Server needs to be shared with Ooyala Flex. In other words, each user of FileCatalyst must have a storage location linked to their username. The storage location must then be shared with Ooyala Flex, in order for the files to be ingested by Ooyala Flex.

For further information on FileCatalyst, please see the official FileCatalyst documentation.

Setting Up FileCatalyst

Creating a Storage Resource

Firstly you must create a storage resource.

To create a storage resource:

  1. On the toolbar, click New and select Resource from the drop down menu.

  2. In the Create new Resource… screen, complete the following fields:

    • Name: enter a name for your storage resource
    • Description: enter and optional description
    • Visibility: select a visibility. These are accounts, sub-accounts, workspaces, and groups that can see this storage resource.
    • Plugin: select Storage Resource from the drop down menu.
    • Polling Interval: select a polling interval from the drop down menu.
  3. Click Save.

  4. Click the Configuration tab.

  5. Click Edit.

  6. From the Protocol drop down, select either SFTP or FILE. Currently SFTP and FILE are the only supported protocols.

    • If you select the SFTP option, you must add a private key file in the Private Key File field.
  7. The Hostname field is optional. This field accesses the location (mandatory except for FILE, S3, Google, or Dropbox protocols).

  8. In the Path field, enter the path to the storage resource. This path must point to the physical storage location.

  9. Click Save.

  10. Click Enable.

  11. Click Start.

Creating an Inbox

Next you must create an Inbox.

To create an inbox:

  1. On the toolbar, click New and select Resource from the drop down menu.

  2. In the Create new Resource… screen, complete the following fields:

    • Name: enter a name for your storage resource
    • Description: enter and optional description
    • Visibility: select a visibility. These are accounts, sub-accounts, workspaces, and groups that can see this storage resource.
    • Plugin: select Storage Resource from the drop down menu.
    • Polling Interval: select a polling interval from the drop down menu.
  3. Click Save.

  4. Click the Configuration tab.

  5. Click Edit.

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

  7. In the Transfer Accelerator field, enter a name for the transfer accelerator. Example: FileCatalyst.

  8. Click Save.

  9. Click Enable.

  10. Click Start.

Creating a HTTP Transfer Resource

Regardless of whether you wish to use FileCatalyst or use the ordinary Ooyala Flex Web Uploader application, you must create and configure a HTTP transfer resource. The HTTP transfer resource is required for every type of transfer related scenario.

To create a HTTP transfer resource, 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 Resources

  3. On the Resources screen, click New.

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

    • Name: enter a name for your transfer resource
    • Description: enter and optional description
    • Visibility: select a visibility. These are accounts, sub-accounts, workspaces, and groups that can see this storage resource.
    • Plugin: select HTTP Transfer Resource from the drop down menu.
    • Polling Interval: select a polling interval from the drop down menu.
  5. Click Save.

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

  7. Click .

  8. In the Public End Point field, enter the URL of the Web Uploader instance associated with this resource.

  9. In the Internal End Point field, enter the URL used by Enterprise to communicate the Web Uploader instance associated with this resource (For example: when starting / stopping the resource).

  10. Click Save.

  11. Click Enable.

  12. Click Start.

Logging In

  1. On the toolbar, click Upload.

  2. In the Web Uploader window, click the FileCatalyst tile.

  3. In the User Name field, enter your FileCatalyst username.

  4. In the Password field, enter your FileCatalyst password.

  5. In the Transfer Agent Port field, enter the FileCatalyst TransferAgent port. This is the port on which the FileCatalyst Transfer Agent runs.

  6. Click Confirm.

Uploading Files Using FileCatalyst

  1. On the Add Files page you can see the local storage on your machine, such as the Desktop, Documents, and Downloads folders. Double-click on a directory to open it.

  2. Select one or more files you wish to upload.  When a file is selected, a tick appears in the check box next to it.

  3. Click Confirm.

  4. From the Inbox drop down, select an existing inbox.

  1. From the Workspace drop down, select an existing workspace.

  2. Click Select.

  3. On the Upload page, you may be required to enter metadata for the assets you have chosen. If the metadata contains mandatory fields, you must fill them in before the files can be uploaded.

  4. Click Upload and the files upload to Ooyala Flex.