Ingesting with Aspera

You can use Aspera file transfer software 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 Aspera Ingest

About Aspera

Aspera provides a high-performance file transfer client for uploading videos to Backlot. Aspera uses encryption while transferring data.

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 Aspera.

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.
Ooyala must know that you plan to use Aspera and must provide you with credentials before you can begin uploading videos. To use Aspera, contact your Ooyala support representative.

Downloading the Aspera Client

Aspera is available as a free browser plug-in or as a licensed desktop client. The Aspera browser plugin will be offered for download the first time a user connects to the ingest endpoint and logs in successfully. You can also download the software separately.

Ingesting with the Aspera Client

You can upload a video via the Aspera client 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 the Aspera Client (OIS v2.5)

  1. Prepare the file(s) you want to upload.
  2. Launch your Aspera 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 the Aspera Client (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. Add a new host, specifying aspera.upload.ooyala.com as the host and the username and password that were provided by Ooyala.
  2. Begin uploading videos, thumbnails, and metadata files. If you are using Aspera with XML or CSV metadata, upload metadata when the video is fully transferred to Aspera. With a basic Aspera account, Backlot immediately begins processing any uploaded videos. With a CSV or XML Aspera account, Backlot will not begin processing the video(s) until after the metadata file is uploaded.
  3. Continue uploading videos until you are finished.
  4. Upload the manifest file.
  5. To check whether the videos processed successfully, see Ingestion Log.
Files are deleted after all of the videos are processed. If a video specified in the metadata file cannot be found, the video is ignored.

Was this article helpful?