Ingesting with FTP / FTPS

You can use FTPS (recommended) or FTP (deprecated) to upload videos, thumbnails, closed captions, and manifest files to Backlot.

Note: This topic applies to both OIS v2.5 and OIS v1. Certain sections, where indicated, apply to just one version. OIS v1 has been deprecated and is scheduled to be disabled. Customers using OIS v1 should switch to OIS v2.5.

Overview of FTP Ingest

About FTP / FTPS

FTP is a standard network protocol for transferring files from one computer to another. For OIS v2.5, FTPS (FTP over SSL) is required. FTP is used for OIS v1, which is deprecated.
Most operating systems support FTP natively, and you can choose from many FTP client applications. You can automate FTP uploads by writing scripts, have users bulk upload videos through a Windows, Mac, or Linux application, or have users bulk upload videos through a browser (e.g., FireFTP).
Note: You can use any FTP client to upload videos to Backlot.

Account Policy

Your account is limited to a maximum of 100GB on the ingestion server at any time. If you expect to upload more content, you can request a temporary increase from your Customer Success Manager or Technical Support.

Getting Ingest Credentials

You need to obtain ingest credentials in order to upload files to Ooyala via FTP.

Setting Up an Upload-only User in Backlot (OIS v2.5)

Note: If you want to use both basic and manifest-based ingestion, you need to create separate, uniquely-named, upload-only user accounts for each (for example, user1_basic@example.com and user1_manifest@example.com).
  1. In the Backlot GUI (Account > User Management), add a user with Upload Only permissions to your account (see Managing Users).
  2. Configure the password for this account.
  3. Use the email and password associated with this user to log into the ingestion endpoint (see Ooyala Ingest Server Endpoints).
Note: If you want to use manifest-based ingest, contact Ooyala to enable this functionality for your account.

Obtaining Ingest Credentials from Ooyala Support (OIS v1) (Deprecated)

Note: OIS v1 has been deprecated and is scheduled to be disabled. Customers using OIS v1 should switch to OIS v2.5.
Note: Ooyala must know that you plan to use FTP and must provide you with credentials before you can begin uploading content.

To use FTP, submit a ticket on the Customer Portal:

  • Indicate that you want to use FTP to upload content to Ooyala.
  • Indicate whether you want to use manifest-based ingestion and provide metadata through an XML Manifest File or CSV Manifest File.

After submitting a support request, Ooyala Support will provide you with a set of credentials, similar the following example.

ftp://d0b206YlR6etqD1HscU4iP3R223:2kg15iBvFOo3ffg@ftp.upload.ooyala.com
server: ftp.upload.ooyala.com
username: d0b206YlR6etqD1HscU4iP3R223
password: 2kg15iBvOo3fVfg

Ingesting with an FTP / FTPS Client

You can upload a video via FTP / FTPS either with or without a manifest.
Note: All upload files must comply with the ingest requirements described in Supported Ingest Formats

Uploading Your File(s) via FTPS (OIS v2.5)

Note: OIS v2.5 requires an FTPS client.
  1. Prepare the file(s) you want to upload.
  2. Launch your FTPS client program.
  3. Log into the ingest endpoint (see Ooyala Ingest Server Endpoints) using the credentials (email and password) of your Backlot upload-only user account.
  4. Upload the file(s) you want to ingest (videos, thumbnails, closed caption files, and so on). If you are using a manifest file, be sure to upload all of the files that are referenced in the manifest file.
  5. Ooyala suggests that you upload the manifest file last.
Files are deleted right after they are all processed. Submitted files that do not go through the entire ingestion workflow (for example, awaiting the upload of the manifest file) are deleted from the server after 7 days.

Uploading Your File(s) via FTP (OIS v1) (Deprecated)

Note: OIS v1 has been deprecated and is scheduled to be disabled. Customers using OIS v1 should switch to OIS v2.5.
Note: If your uploads include a manifest file, upload the manifest file last. Any content files referenced in the manifest file must be uploaded before the manifest file itself.
  1. Prepare videos to upload.
  2. Locate your credentials provided by Ooyala. For example:
    username: 11amo6qGw2oucN78R-BYbDpCESk
    password: 2kg15iBvOo3fVfg
  3. Select one of the following FTP endpoints: uk.ftp.upload.ooyala.com (UK/EMEA), jp.ftp.upload.ooyala.com (Asia/Pacific), or ftp.upload.ooyala.com (All others).
  4. Launch your FTP client program.
  5. Begin uploading to the root directory of the selected FTP endpoint. Videos uploaded to any subdirectories will be ignored.
    Note: If you are using a UI-based tool, you specify your credentials in the UI. If you are using a command-line tool, your request looks similar to: ftp://username:password@endpoint (for example: ftp://d0b206YlR6etqD1HscU4iP3R223:2kg15iBvFOo3ffg@ftp.upload.ooyala.com). For more information, refer to the FTP client's documentation.
    Note: With a basic FTP account, Backlot immediately begins processing any uploaded videos. With a CSV or XML FTP account, Backlot will not begin processing the video(s) until after the metadata file is uploaded.
  6. Continue uploading videos until you are finished.
  7. Upload the manifest file, if applicable.
  8. To check whether the videos processed successfully, see Ingestion Log.
If a video specified in the manifest file cannot be found, the video is ignored.

Was this article helpful?