Cyberduck is desktop software voor Microsoft Windows 10 en Apple OSX die gebruikt kan worden om bestanden over te zetten tussen je computer en Yoda. In deze handleiding leggen we uit hoe je Cyberduck installeert, hoe je een nieuwe verbinding (bladwijzer) met Yoda maakt en we eindigen met een aantal veelgestelde vragen en tips over het gebruik van Cyberduck.
Cyberduck verkrijgen
Voor gebruikers die op hun eigen computer werken, is Cyberduck beschikbaar om te downloaden vanaf de website: https://cyberduck.io/download/. Dit programma is gratis en vereist geen registratie.
Let op: Voor gebruikers die een EUR-laptop gebruiken, raden we aan om WinSCP te gebruiken, dat beschikbaar is via het EUR Software Center.
Voer het gedownloade installatieprogramma uit door te dubbelklikken op "Cyberduck-installer.exe" die je in de Windows Verkenner in je Download-map vindt. Installeer Cyberduck met de standaardopties en start Cyberduck vanuit het startmenu.
Cyberduck configureren
Maak een nieuwe beveiligde WebDAV (HTTPS) verbinding met Yoda (bladwijzer)
Maak eerst een nieuwe bladwijzer door op de + knop linksonder in het scherm te drukken.
Je ziet nu een nieuwe verbindingspagina:
Klik op de vervolgkeuzelijst "FTP (File Transfer Protocol)" en selecteer een WebDAV-verbinding (HTTPS)
Vul de volgende informatie in de juiste velden in
Maak eerst een Data Access Password aan:
- Server: erasmus-data.irods.surfsara.nl
- Username: je e-mailadres
- Password: plak (CTRL-v) het Data Access Password dat je in de portal hebt aangemaakt.
Cyberduck gebruikt je thuismap als standaardmap om bestanden te downloaden. Dit kan worden gewijzigd door te klikken op " More Options" (Meer opties) en een nieuwe map te kiezen.
Je hebt met succes een bladwijzer gemaakt, sluit het bewerkingsvenster door op de X-knop rechtsboven in het bewerkingsvenster te klikken om terug te keren naar het hoofdscherm van Cyberduck.
Verbinding maken met Yoda
Het hoofdscherm toont alle verbindingen (bladwijzers) die je hebt gedefinieerd. Om verbinding te maken dubbelklik je op de bladwijzer (in dit geval "erasmus-data.irods.surfsara.nl - WebDAV (HTTPS)") en je wordt verbonden.
Als het inloggen onverwacht niet lukt, controleer dan of je data access password nog steeds geldig is.
Je zou nu je projectmap moeten zien in een Windows verkenner-achtig venster:
Werken met YODA-mappen en het uploaden/downloaden van bestanden
Klik op een > om een map te openen,
Gebruik de pijlen naar links, rechts en boven om door de mapstructuur te navigeren en klik met de rechtermuisknop in het hoofdvenster om een nieuwe map aan te maken:
Je kunt ook mappen en bestanden slepen van Windows Verkenner naar je Yoda projectmappen:
In beide gevallen zou je, zodra het kopiëren is gestart, het overdrachtvenster moeten zien. Houd dit open tot de overdracht is voltooid.
Daarnaast heeft het contextmenu (te activeren door met de rechtermuisknop te klikken op een Yoda projectbestand/map) een aantal opties voor het uploaden, downloaden en synchroniseren van bestanden en mappen:
Enkele dingen om te overwegen bij het gebruik van Cyberduck/ WebDAV
Totale pad- en bestandslengte
Als je Cyberduck gebruikt, moet je ervoor zorgen dat je padlengtes (mappen + bestandsnaam) minder dan 255 tekens lang zijn. Bij gebruik van WebDAV geldt dit ook aan de serverkant (Yoda), inclusief servernaam, projectnaam en projectmappen. Wees voorzichtig bij het kopiëren van diepe mappenstructuren en zeer lange bestandsnamen naar Yoda met behulp van Cyberduck en WebDAV. Gelukkig geeft Cyberduck een foutmelding en kopieert het bestand niet als het een bestand met een te lang bron- of doelpad probeert te kopiëren. Deze fout is meestal een "access denied" (403 of 500) fout en als je op "continue" klikt, slaat Cyberduck dat bestand gewoon over en wordt het niet naar Yoda gekopieerd.
Aanbeveling. Als je "access denied errors" krijgt bij het overbrengen van bestanden met Cyberduck:
- Noteer welke bestanden niet worden gekopieerd.
- Maak de mapstructuur plat of verkort de bestandsnaam.
- Comprimeer de tak(ken) van de "hoofdmap" die de lange padnamen bevatten in afzonderlijke ZIP-archieven.
Veelgestelde vragen
Vraag 1) Als ik een bestand probeer te verwijderen, krijg ik de Cyberduck-foutmelding "cannot delete <filename>" (Kan <bestandsnaam> niet verwijderen).
Deze foutmelding kan verschijnen wanneer het bestand/de map alleen-lezen is. Alleen-lezen toegang kan het gevolg zijn van:
- De map is vergrendeld.
- Je hebt alleen-lezen toegang gekregen tot de projectmap.
Antwoord: ontgrendel de map in het onderzoeksportaal of krijg lees-/schrijftoegang voor het project.
Vraag 2) Ik kopieer een bestand met Cyberduck, de overdracht slaagt maar ik zie het bestand niet in de portal.
De map waarnaar je kopieert is gemarkeerd als alleen-lezen. Alleen-lezen toegang kan het gevolg zijn van:
- De map is vergrendeld in de YODA-portal
- Je hebt alleen-lezen toegang gekregen tot de projectmap
Antwoord: ontgrendel de map in het onderzoeksportaal of krijg lees-/schrijftoegang voor het project.
Vraag 3) Ik heb geprobeerd een bestand te verwijderen, maar ik krijg een foutmelding "Access denied".
Een mogelijkheid is dat het bestand corrupt is geraakt tijdens het uploaden en verkeerd geregistreerd staat in de iRODS-database.
Antwoord: Neem contact op met je datamanager of iRODS beheerder om het probleem op te lossen. Stel Cyberduck in om WebDAV kopiëren met één verbinding te gebruiken
Deze pagina is het laatst bijgewerkt in april 2024. Heb je niet-werkende links gevonden of (schijnbaar) niet correcte informatie? Stuur dan een mail met het onderwerp 'Website content' naar datasteward@eur.nl.