Dateien bei Super Renders Farm hochladen und herunterladen

Einleitung

Das Verschieben von Projektdateien zu und von einer render farm ist der Teil des Workflows, der am häufigsten schiefläuft. Ein Rendering scheitert nicht, weil die Engine sich falsch verhält, sondern weil ein Texturpfad auf dem entfernten Node nicht aufgelöst wurde, ein Projekt als ZIP hochgeladen wurde, das die Farm nie entpackt, oder eine langsame Heimverbindung nach zwanzig Minuten mitten im Upload stecken blieb.

Super Renders Farm unterstützt drei Möglichkeiten, Projektdateien zu verschieben (die Web-Oberfläche, die SuperRenders Client App und den S3-Zugriff mit Cyberduck oder der AWS CLI) und drei Möglichkeiten, gerenderte Ausgaben abzurufen. Keine davon ist an sich „die richtige"; jede hat ihre Stärken, abhängig von Dateigröße, Netzwerkgeschwindigkeit und wie oft Sie dasselbe Projekt erneut einreichen.

Dieser Leitfaden gibt Ihnen einen Entscheidungsbaum zur Auswahl der für Ihren Job passenden Methode, Schritt-für-Schritt-Anleitungen für jede Methode und eine Referenz für die Upload-Fehler, die wir im Support am häufigsten sehen.

Entscheidungsbaum: Welche Upload-Methode soll ich verwenden?

Die drei Methoden sind nicht austauschbar. Verwenden Sie diesen kurzen Entscheidungsbaum beim ersten Einreichen eines Projekts, und wechseln Sie dann, wenn sich Ihr Workflow stabilisiert.

Verwenden Sie die Web-UI wenn:

• Die Gesamtprojektgröße unter ~2 GB liegt
• Sie Jobs gelegentlich einreichen (ein paar Mal im Monat) statt kontinuierlich
• Sie keine Installation möchten — nur einen Browser

Verwenden Sie die Client App wenn:

• Sie mindestens wöchentlich Jobs einreichen und weniger manuelle Schritte möchten
• Ihr Projekt größer als ~2 GB ist
• Sie möchten, dass der Upload automatisch bei Verbindungsabbrüchen wiederholt wird
• Sie möchten, dass abgeschlossene Frames automatisch in einen lokalen Ordner heruntergeladen werden, sobald sie fertig sind

Verwenden Sie den S3-Zugriff (Cyberduck oder die AWS CLI), wenn:

• Sie bereits mit einem S3-Client arbeiten und ihn einem Browser oder der Client App vorziehen
• Sie Uploads zu Ihrem SRF Space oder Downloads davon skripten möchten; die AWS CLI läuft über ein Terminal oder ein geplantes Skript
• Sie es sich zutrauen, einen Access Key zu handhaben (behandeln Sie ihn wie ein Passwort)

Für jeden Weg gilt ein kleiner Vorbehalt: Die Farm entpackt keine Archive (.zip, .rar, .7z, .tar, .tar.gz). Die Farm benötigt einen unkomprimierten Projektordner (die Szenendatei plus alle referenzierten Assets in der korrekten Verzeichnisstruktur), damit der Render-Manager Asset-Pfade auflösen kann. Mehr dazu im Abschnitt Häufige Upload-Fehler weiter unten.

Methode 1: Web-UI-Upload

Der Web-Upload ist der einfachste Weg und der, den wir für Ersteinreichungen und kleine Projekte empfehlen.

Schritt-für-Schritt:

1. Melden Sie sich bei Ihrem Konto auf superrendersfarm.com an und öffnen Sie das Render-Dashboard.
2. Klicken Sie auf Neuer Job (oder Projekt einreichen, je nachdem, von welcher Engine-Landing-Page Sie kamen).
3. Ziehen Sie den Projektordner auf den Upload-Bereich, oder klicken Sie auf Ordner auswählen und wählen Sie ihn aus.
4. Warten Sie, bis der Upload-Fortschrittsbalken abgeschlossen ist. Der Browser zeigt den einzelnen Datei-Fortschritt für Projekte mit vielen Assets an.
5. Sobald der Upload abgeschlossen ist, konfigurieren Sie die Render-Einstellungen (Frame-Bereich, Ausgabeformat, Priorität) und reichen Sie den Job ein.

Praktische Grenzen. Browser drosseln einzelne Upload-Sitzungen, sodass der Web-Weg oberhalb von ~2 GB langsam und oberhalb von ~5 GB bei Heimverbindungen unzuverlässig wird. Wenn Ihr Browser-Tab mitten im Upload geschlossen wird, bricht die Übertragung ab — es gibt keine Wiederaufnahme auf der Browser-Seite. Für Projekte in diesem Bereich wechseln Sie zur Client App.

Was hochgeladen wird. Drag-and-Drop bewahrt Ihre Ordnerstruktur exakt. Wenn Ihre Szene Texturen in \textures\ und \proxies\ referenziert, müssen diese Unterordner innerhalb des gezogenen Top-Level-Projektordners mit denselben Namen vorhanden sein. Fehlende Referenzen auf der Farm lassen sich fast immer auf einen dieser Unterordner außerhalb des Upload-Stamms zurückführen.

Methode 2: SuperRenders Client App

Die Client App ist der Weg, auf den sich die meisten Produktionsstudios schließlich einigen. Sie verwaltet die Wiederaufnahme bei Verbindungsunterbrechungen, Integritätsprüfungen und den automatischen Download abgeschlossener Frames — keines davon unterstützt der Browser-Weg.

Schritt-für-Schritt:

1. Laden Sie die Client App von der Download-Seite herunter und installieren Sie sie auf Ihrer Workstation.
2. Melden Sie sich mit Ihren Super-Renders-Farm-Anmeldedaten an.
3. Klicken Sie auf Neues Projekt und wählen Sie Ihren Projektordner aus. Die App scannt nach der Szenendatei und referenzierten Assets.
4. Überprüfen Sie die Dateiliste — die App zeigt fehlende Referenzen vor dem Start des Uploads an, damit Sie sie lokal beheben können statt nach einem fehlgeschlagenen Rendering.
5. Klicken Sie auf Hochladen. Der Fortschritt wird pro Datei angezeigt, und der Upload wird automatisch fortgesetzt, wenn Ihre Verbindung abbricht.
6. Nachdem der Upload abgeschlossen ist, konfigurieren Sie die Render-Einstellungen innerhalb der App und reichen Sie ein.

Automatischer Download. Die Client App verwaltet auch den Rückweg. Sobald Sie einen lokalen Ausgabeordner aktivieren, streamen abgeschlossene Frames auf Ihre Workstation, sobald jeder Frame fertig ist — Sie müssen nicht auf den Abschluss des gesamten Jobs warten, bevor Sie etwas abrufen.

Plugin-v1-vs-v2-Hinweis. Studios, die ältere Versionen der Client App verwenden, sollten die Tools und Client-App-Referenz für aktuelle Installationspfade, Plugin-Versionskompatibilität und den Migrationsplan prüfen, wenn Spaces (unsere Übertragungs-Schicht der nächsten Generation) die Client App ablöst. Dieses Dokument behandelt die DCC-Plugin-Integration, End-to-End-Einreichung und Fehlerbehebungsschritte im Detail — diese Seite behandelt nur die Upload-und-Download-Oberfläche.

Methode 3: S3-Zugriff (Cyberduck oder die AWS CLI)

Der S3-Zugriff lässt Sie Dateien zwischen Ihrer Workstation und Ihrem SRF Space mit einem Standard-S3-Client verschieben, ohne den Browser oder die Client App. Dateien, die Sie auf diesem Weg hochladen, erscheinen in Ihrem SRF Space und können für einen Job wie jeder andere Upload verwendet werden. Der S3-Zugriff verschiebt nur Dateien: Sie reichen den Job weiterhin über das Web-Dashboard, die Client App oder ein DCC-Plugin ein.

Schritt-für-Schritt:

1. Öffnen Sie in Ihrem Konto Cloud Direct Connect und generieren Sie Ihren Access Key (das Portal nennt dies Ihr FTP-Konto). Kopieren Sie die Access Key ID, den Secret Access Key und das Remote Directory.
2. Cyberduck: Wählen Sie Open Connection, wählen Sie das Protokoll Amazon S3, und geben Sie die Access Key ID und den Secret Access Key ein. Erweitern Sie More Options und geben Sie Ihr Remote Directory bei Path ein, dann stellen Sie die Verbindung her.
3. AWS CLI: Führen Sie aws configure aus, geben Sie die Access Key ID und den Secret Access Key ein, setzen Sie die Region auf ap-southeast-1, und lassen Sie das Ausgabeformat leer. Kopieren Sie dann den unverpackten Projektordner in Ihr Remote Directory, zum Beispiel aws s3 cp ./my-project s3://<Remote Directory>/my-project --recursive.
4. Reichen Sie den Job über das Web-Dashboard, die Client App oder ein DCC-Plugin ein und wählen Sie die hochgeladenen Dateien aus.

Ausgabe über S3 zurückholen. Fertige Frames werden in den Ordner SuperRendersOutput/<job ID>/ innerhalb Ihres SRF Space geschrieben, sodass Sie sie mit demselben Client abrufen können, zum Beispiel aws s3 sync s3://<Remote Directory>/SuperRendersOutput/<job ID>/ ./frames/.

Gut zu wissen. Ihr Konto hat einen einzigen Access Key, und er läuft nicht ab. Behandeln Sie ihn wie ein Passwort: Halten Sie ihn aus gemeinsam genutzten Skripten und Repositories heraus. Wenn Sie ihn ändern lassen möchten, wenden Sie sich an den Support. Temporäre und Systemdateien (*.tmp, *.temp, *.partial, *.swap, *.lnk, *.ini, *.db) sowie jeder rendertemp/-Ordner werden nicht an die Render-Nodes weitergegeben, halten Sie Szenendaten also aus Dateien mit diesen Namen heraus.

Verwenden Sie Cyberduck mit dem Amazon S3-Protokoll oder die AWS CLI; FileZilla- und FTP/SFTP-Clients verbinden sich nicht.

Vergleich: Methoden auf einen Blick

Passen Sie die Methode an die Projektform an. Ein 200-MB-Still ist im Browser problemlos; eine 60-GB-Animation mit gecachten Fluiden sollte über die Client App laufen, oder über den S3-Zugriff, wenn Ihre Pipeline ihre Übertragungen bereits skriptet.

Häufige Upload-Fehler

Dies sind die Fehler, die wir am häufigsten im Support sehen, und was zuerst zu prüfen ist.

„Eine .zip, .rar oder .7z hochgeladen, und der Job findet die Szene nicht."

Sie können .zip-, .rar- oder .7z-Dateien hochladen, aber die Farm entpackt sie nicht, sodass nichts innerhalb eines Archivs gerendert wird (der Web-Uploader warnt, dass die Datei nicht automatisch entpackt wird). Dasselbe gilt für .tar und .tar.gz. Entpacken Sie Ihren Szenenordner und laden Sie die Dateien unverpackt hoch. Wenn Sie mit einer ZIP-Lieferung eines Kollegen arbeiten, entpacken Sie sie zuerst lokal und laden Sie dann den entstandenen Ordner hoch.

„Fehlende Textur: D:\projects\..."

Ihre Szene referenziert einen absoluten Pfad auf Ihrem lokalen Rechner, der auf den Worker-Nodes der Farm nicht existiert. Dies ist die häufigste Ursache für fehlgeschlagene Jobs, und sie tritt auf, egal ob Sie über die Web-UI oder die Client App hochgeladen haben. Beheben Sie es lokal mit relativen Pfaden (die meisten DCCs haben einen Befehl „Pfade relativ machen" oder „Assets konsolidieren" — File → Reference Editor → Make Relative in Maya, File → Archive in 3ds Max, File → Pack External Data in Blender). Die Client App scannt vorab auf absolute Pfade und markiert sie vor Uploadbeginn, was eine Rückfrage-Runde erspart.

„Upload-Zeitüberschreitung."

Häufig bei Heimverbindungen, besonders über WLAN bei Dateien über 1 GB. Der Browser-Weg nimmt keine Übertragung wieder auf — wechseln Sie zur Client App, die sich von vorübergehenden Verbindungsabbrüchen erholt. Prüfen Sie außerdem Ihre lokale Upload-Geschwindigkeit (die meisten ISPs begrenzen den privaten Upload auf 10–50 Mbit/s); ein 20-GB-Projekt auf einer 10-Mbit/s-Leitung dauert bei durchgehender Übertragung etwa fünf Stunden.

„Ungültige Projektstruktur."

Der hochgeladene Ordner enthält keine Szenendatei, die die Farm erkennt (.max, .ma/.mb, .c4d, .blend, .hip/.hiplc, .aep). Häufige Ursache: Nur den Textur-Ordner statt des vollständigen Projektstamms gezogen. Laden Sie eine Ebene höher erneut hoch, damit die Szenendatei enthalten ist.

„Asset-Pfade zeigen außerhalb des Projektordners."

Ihre Szene referenziert Assets, die über dem Projektstamm liegen (z. B. ein gemeinsam genutzter \Studio Library\-Ordner eine Ebene über \Project_X\). Worker-Nodes können nur sehen, was sich im hochgeladenen Ordner befindet. Konsolidieren Sie diese Assets entweder lokal vor dem Upload in den Projektordner (die meisten DCCs haben einen Befehl „Alle Assets sammeln"), oder laden Sie den übergeordneten Ordner hoch, damit alle referenzierten Pfade aufgelöst werden.

Gerenderte Ausgabe herunterladen

Drei Wege existieren für den Abruf abgeschlossener Frames: manueller Download aus dem Dashboard, automatisches Streaming über die Client App oder ein S3-Abruf aus dem Ordner SuperRendersOutput/<job ID>/ in Ihrem SRF Space.

Manueller Download über Dashboard. Wenn ein Job abgeschlossen ist, listet das Dashboard jeden Ausgabe-Frame auf und bietet Download pro Frame und als vollständiger Job. Für Animations-Jobs zippt das Dashboard die Ausgabe (das ist ein Download-Komfort — kein Einreichungsformat), damit Sie die gesamte Sequenz in einer Übertragung abrufen können. Für Stills oder kurze Sequenzen hält der Download pro Frame die Dateianzahl beherrschbar.

Automatischer Download über Client App. Mit installierter Client App und einem konfigurierten lokalen Ausgabeordner streamen abgeschlossene Frames herunter, sobald jeder Frame fertig ist. Sie müssen nicht auf den vollständigen Abschluss des Jobs warten — Sie können Frame 1 überprüfen, während die Frames 240 bis 480 noch rendern. Dies ist besonders nützlich für lange Animations-Jobs, bei denen sich Review-Zyklen mit dem Rendering selbst überschneiden.

S3-Abruf über Cyberduck oder die AWS CLI. Wenn Sie den S3-Zugriff (Cloud Direct Connect) nutzen, werden fertige Frames in den Ordner SuperRendersOutput/<job ID>/ in Ihrem SRF Space geschrieben. Rufen Sie sie mit demselben Client ab, mit dem Sie hochladen, zum Beispiel mit aws s3 sync s3://<Remote Directory>/SuperRendersOutput/<job ID>/ ./frames/. Die Einrichtung wird oben unter Methode 3 behandelt.

Aufbewahrung. Ausgabedateien bleiben nach Abschluss des Jobs zum Download verfügbar; es gibt keinen festen automatischen Löschzeitraum, und wir löschen ein Projekt, wenn Sie uns darum bitten. Für die Langzeitarchivierung laden Sie zum Speicher Ihres Studios herunter, statt sich auf die Farm als Backup-Tier zu verlassen.

FAQ

Q: Warum entpackt Super Renders Farm keine ZIP-Dateien? A: Der Render-Manager muss Ihren Projektordner durchqueren, um Asset-Pfade aufzulösen: Szenendateien referenzieren Texturen, Proxies, Caches und Plugins über relative oder absolute Pfade. Die Farm entpackt keine Archive, gleich welchen Formats. Laden Sie das Projekt daher als unkomprimierten Ordner hoch; genau das erzeugt der „Alle Assets sammeln"-Befehl jeder DCC standardmäßig.

Q: Was ist das größte Projekt, das ich hochladen kann? A: Es gibt keine erzwungene Obergrenze. Wir haben Multi-Hundert-Gigabyte-Animationsprojekte mit gecachten Simulationen verwaltet. Verwenden Sie für große Projekte die Client App: Browser-Uploads bleiben bei langen Übertragungen stecken, während die Client App dort fortsetzt, wo sie aufgehört hat.

Q: Wie lade ich hoch, wenn meine Verbindung unzuverlässig ist? A: Verwenden Sie die SuperRenders Client App. Sie nimmt bei Verbindungsabbruch die Übertragung wieder auf, sodass eine abgebrochene WLAN-Verbindung Ihre Übertragung nicht von vorn beginnt. Der Browser-Upload-Weg nimmt nichts wieder auf: Schließt sich Ihr Tab mitten im Upload, bricht die Übertragung ab.

Q: Wie lange werden meine gerenderten Frames auf der Farm aufbewahrt? A: Ausgabedateien bleiben nach Abschluss des Jobs zum Download verfügbar; es gibt keinen festen automatischen Löschzeitraum, und wir löschen ein Projekt, wenn Sie uns darum bitten. Für die Archivierung laden Sie abgeschlossene Jobs zum Speicher Ihres Studios herunter, statt die Farm als Langzeit-Backup zu behandeln.

Q: Wie bekomme ich abgeschlossene Frames automatisch auf meine Workstation zurück? A: Verwenden Sie die SuperRenders Client App mit einem konfigurierten Ausgabeordner. Frames streamen herunter, sobald jeder fertig ist, sodass Sie frühe Frames überprüfen können, während spätere Frames noch rendern. Der manuelle Download-Weg des Dashboards ist für einmalige Jobs in Ordnung, aber für Animationsarbeit spart der automatische Download der Client App viel Wartezeit.

Q: Meine Szene referenziert Texturen auf einem Netzlaufwerk. Werden diese hochgeladen? A: Nur wenn die Netzlaufwerk-Pfade innerhalb Ihres hochgeladenen Projektordners sind. Worker-Nodes können die Netzwerkshares Ihres Studios nicht direkt erreichen. Führen Sie zuerst lokal den Befehl „Alle Assets sammeln" oder „Referenzen konsolidieren" Ihres DCC aus — das kopiert alle referenzierten Dateien in den Projektordner und schreibt die Pfade auf relative um — dann laden Sie den konsolidierten Ordner hoch. Die meisten fehlgeschlagenen Job-Tickets, die wir sehen, lassen sich darauf zurückführen, dass dieser Schritt übersprungen wurde.

Formate und Größenlimits im Detail: warum die Farm Ihr Projekt unverpackt benötigt und welchen Upload-Weg Sie ab ~2 GB verwenden sollten, werden im ausführlichen Leitfaden behandelt: Upload-Formate und Größenlimits.