Deze handleiding beschrijft hoe u handmatig gegevens kunt opslaan via de opdrachtregel (CLI) met behulp van het S3 Compatible-protocol op Swiss Backup, de cloudoplossing voor gegevensopslag in een onafhankelijke Zwitserse cloud.

Een S3-locatie gebruiken via de CLI

Vereisten

• U moet een Swiss Backup-account van Infomaniak hebben met een beschikbare apparaatquota (minimaal 1) voor een cloudback-up.
• Voeg 1 apparaat van het type Cloud toe om de S3-compatibele instellingen te verkrijgen.
• Gebruik een applicatie van het type Terminal (opdrachtregelinterface, CLI / Command Line Interface) op uw apparaat.

Met een Terminal-applicatie (commandoregelinterface, CLI) op uw apparaat:

1. Installeer s3cmd, bijvoorbeeld op Debian/Ubuntu:

   sudo apt install s3cmd

   of op macOS (met Homebrew):

   brew install s3cmd

   en voor Windows wordt het aanbevolen om S3Express te gebruiken, een open-source commandoregeltool (hulp nodig?).

2. Voer het volgende commando in om de verbinding te configureren:

   s3cmd --configure

3. Vul de velden in met de gegevens die specifiek zijn voor uw apparaat (raadpleeg deze andere handleiding):
   
   • Weergavenaam = kies een naam voor de opslag.
   • Toegangssleutel en Geheime sleutel = de toegangssleutels die zijn gegenereerd in de e-mail die u van Infomaniak heeft ontvangen na het aanmaken van de opslagruimte.
   • Servicepunt = bijvoorbeeld https://s3.swiss-backup02.infomaniak.com (1)
   • Bucketnaam = standaard
   • Standaardregio
   • S3-eindpunt: gebruik de URL die door Infomaniak wordt verstrekt
   • Gebruik HTTPS: ja
   • HTTP-proxyserver: laat leeg, tenzij er een specifieke configuratie is
   • Handtekeningversie: forceer het gebruik van v4
   • Padstijl: kies Ja indien gevraagd
   • Toegang testen: u kunt de test uitvoeren om de configuratie te valideren

Na afloop wordt een configuratiebestand opgeslagen (standaard in ~/.s3cfg).

Een back-up naar Swiss Backup starten

Hieronder vindt u enkele basisopdrachten om met Swiss Backup te werken:

• Buckets weergeven: s3cmd ls
• De inhoud van een bucket weergeven: s3cmd ls s3://bucket-name
• Een bestand verzenden: s3cmd put example.txt s3://bucket-name/
• Een bestand downloaden: s3cmd get s3://bucket-name/example.txt
• Een lokale map synchroniseren met een bucket: s3cmd sync /path/local/ s3://bucket-name/

Bij problemen

Na een update van het hulpprogramma AWS CLI (Amazon Web Services Command Line Interface) kunt u een foutmelding krijgen wanneer u probeert verbinding te maken of gegevens over te zetten naar een S3-locatie van Swiss Backup:

Het overzetten van gegevens in meerdere delen met behulp van aws-chunked wordt niet ondersteund

Deze fout is gerelateerd aan een overdrachtsmethode die door AWS CLI (aws-chunked) wordt gebruikt en die niet compatibel is met de Swiss Backup-service.

Om Swiss Backup effectief te blijven gebruiken via de opdrachtregel, raadt Infomaniak aan om het open-source-hulpprogramma s3cmd te gebruiken, zoals hierboven in deze handleiding beschreven. Dit is volledig compatibel met S3-locaties.