VOD uploads¶

Assets are uploaded straight from the browser to a streamer: the console asks central for a grant — permission to write a file to a particular node — and pushes the file there. This page covers the Uploads, Storages and Upload tokens tabs; the catalog itself is described in VOD catalog.

New assets go to the storage with the most free space — there is no storage to pick by hand.

For uploading to be possible at all, the streamer needs two things from its settings:

• at least one VOD root — without it there is no storage and nowhere to put the file;
• a public payload address — central builds the node's upload URL from it, and the browser pushes the bytes there, past central.

Until the second one is set, issuing a grant is refused with a plain message: "no available storage: need an online node with a public upload URL".

Pick the files¶

The Upload files and Upload folder buttons on the catalog tab, or drag and drop: Drop files or folders anywhere on the list to upload into this folder.

Before the start, an Upload preview opens — a table of what goes where:

• Dropped — what you handed over.
• Asset key (tail) — how it will land in the catalog, editable right here.
• File name on the node — names are normalized automatically.
• Goes into — either new asset or → with {key}: the file joins an existing asset instead of creating its own.

The Folder node row is edited separately: renaming it rewrites the prefixes of every key underneath. If some names do not fit the key grammar, the start button is blocked and the fields are highlighted: Some names do not fit the grammar — fix the highlighted fields. At the bottom is a summary of the form N files → N assets.

The Add files button on an existing asset opens the same preview in Add files to mode: everything goes into that asset.

The upload dock¶

A started upload lands in the dock — a panel that lives on every page of the console. This is deliberate: navigating to another section does not interrupt the upload. The dock collapses and expands, and the uploads page opens from it.

Per-file statuses: pending, uploading, paused, error, done. The controls are Pause, Resume, Retry, Stop, and the same for the whole batch: Pause batch, Resume batch, Stop batch.

Stopping asks for confirmation and is honest about the consequence: the partial session on the node will be deleted — a half-uploaded file is not left as garbage on the streamer.

The active queue and the server history¶

The Uploads tab shows two tables:

• Active upload queue — what this browser tab is pushing: upload, destination, progress, bytes.
• Server history — issued grants (including portal traffic) — every grant central issued, including those issued outside the console: asset key, what it was issued through, node, creation time.

Grant states: issued, completed, expired, orphaned. "Orphaned" is a grant whose write was started and never finished.

Storages¶

The Storages tab lists the VOD storages the nodes reported: Storage, Capacity, Last report, Assets, state.

The states are available, unavailable, journal unreadable and needs reconcile. If the nodes reported no VOD root at all, the tab is empty: No storages: nodes reported no VOD root.

An unavailable storage can be deleted, and the dialog spells out the consequences: all its placements and tombstones will be deleted, assets with no other placement disappear from the catalog, and files on the disk (if it comes back) are left untouched. This is an operation on the catalog, not on the data.

Upload tokens for portals¶

The Upload tokens tab is what you need when files are uploaded not by an operator from the console but by your portal. The token is scoped: the holder can only request grants within its key prefix, and end users never see it.

The fields on creation are Name, Scope prefix (grants only under this key prefix), TTL, days and Max file size, GiB.

The secret is shown once: Copy the secret now — it will not be shown again.

A token can be Revoked. Revocation acts forward: New grant requests will be rejected; grants already issued live out their TTL.

What next¶

• VOD catalog — what to do with the uploaded assets.