Kommandolinje værktøj til Jottacloud

Et kommandolinjeprogram til Jottacloud som kan køre på forskellige operativsystemer
Dette kommandoværktøj, eller kommandolinjeprogram, er et kommandolinje værktøj til vores brugere. Kommandolinjeprogrammet (engelsk: commando-line client) (CLI) er muligt at køre på de fleste enheder med Windows, OS X og Linux styresystemer. Herunder stationære computere, servere, NAS enheder, og endda Raspberry Pi.
Note: Kommandolinjeprogrammet er et specielt stykke software designet til at køre på servere og hovedløse systemer. Det er ikke meningen, at det skal kontrollere Jottaclouds skrivebordsprogram.

Funktioner

  • Automatisk backup af mapper
  • Arkivering af filer
  • Brugerdefinerbare scanningsintervaller
  • Mulighed for at ignorere filer og mapper med simple ’gitignore’ mønstre
  • Simple webhooks
  • Mulighed for at administrere eksterne værter

Komponenter

Kommandolinjeprogrammet har to komponenter:

  • Jottad - Jottaclouds daemon
  • jotta-cli - Jottaclouds kommandolinje interface

Installation

Jottaclouds kommandolinjeprogram understøtter mange operativsystemer og cpu arkitekturer.

Download allerede kompilerede binære filer til MacOS, Windows og Linux fra siden med udgivelser.

Installations instruktioner kan findes her.

Man er nødt til selv at opdatere Jottaclouds kommandolinjeprogram, da det ikke kan gøres automatisk. Tjek installationsdokumentationen for hver platform, for at finde hjælp til at opdatere softwaren.

Problemer og bug rapportering

For at rapportere bugs- og problemer bedes du følge Jottaclouds CLI problem tracker på GitHub

Notér dig: Jottaclouds kommandolinjeprogram er en software i betastadiet, benyt det derfor med forsigtighed.

Jottacloud CLI til Linux - Debian pakker

Hvordan man installerer Jottacloud CLI på Debian/Ubuntu systemer

Debian/Ubuntu og derivater

Banebrydende ændringer: Når version 0.4.x går i luften, vil jottad blive kørt som brugeren jottad. Hvis du opgraderer fra 0.3.x eller ældre versioner vil dette medføre, at jottad ikke kan læse den gamle konfigurationsmappe placeret i /root/.jottad. For at afhjælpe dette problem; flyt de pågældende filer og mapper fra /root/.jottad til jottad brugernes hjem, som befinder sig i /var/lib/jottad og recursive chown til bruger jottad og gruppe jottad:

mv /root/.jottad/* /var/lib/jottad
chown -R jottad.jottad /var/lib/jottad
systemctl restart jottad

Installation

Afhængigheder:
apt-get install wget apt-transport-https ca-certificates
Først hent opbevaringsnøglen:
wget -O - https://repo.jotta.us/public.gpg | sudo apt-key add -
Gem repo informationen til apt kilder:
echo "deb https://repo.jotta.us/debian debian main" | sudo tee /etc/apt/sources.list.d/jotta-cli.list

Kør sudo apt-get update 

Installer pakken jotta-cli :

sudo apt-get install jotta-cli

Pakken leverer init scripts til dig der kører flavour. (systemd, upstart eller sysvinit)

(Kun opgradering) genstart den opgraderede service, ved at bruge dit systems init flavour, som f.eks.:

sudo systemctl restart jottad
Hjælp til at starte:
jotta-cli help

Note: Ved at køre programmet som en ikke-root bruger som standard, formindskes sikkerhedssårbarhederne, men samtidig vil det medføre, at jottad ikke kan læse filer der ikke er tilgængelige for jottad brugeren eller gruppen.
For at afbøde dette skal gøres enten:

  • Skift brugeren af processen ved at redigere/etc/systemd/system/jottad.service , /etc/init/jottad.conf or /etc/init.d/jottad 
  • Gør filerne mulige at se, ved at tilføje den pågældende jottad bruger til en gruppe, der har adgang til filerne.
  • chmod  filerne for at gøre dem tilgængelige.

Jottacloud CLI til Linux - RPM pakker

Hvordan man installerer Jottacloud CLI på Redhat/CentOS systemer

Debian/Ubuntu og derivater

Banebrydende ændringer: Når version 0.4.x går i luften, vil jottad blive kørt som brugeren jottad. Hvis du opgraderer fra 0.3.x eller ældre versioner vil dette medføre, at jottad ikke kan læse den gamle konfigurationsmappe placeret i /root/.jottad. For at afhjælpe dette problem; flyt de pågældende filer og mapper fra /root/.jottad til jottad brugernes hjem, som befinder sig i /var/lib/jottad og recursive chown til bruger jottad og gruppe jottad:

mv /root/.jottad/* /var/lib/jottad
chown -R jottad.jottad /var/lib/jottad
systemctl restart jottad

Installation

Gem de følgende linjer til /etc/yum.repos.d/JottaCLI.repo:
[jotta-cli]name=Jottacloud CLI
baseurl=https://repo.jotta.us/redhat
gpgcheck=1
gpgkey=https://repo.jotta.us/RPM-GPG-KEY-jotta-cli

Installér pakken jotta-cli :

sudo yum install jotta-cli

Pakken leverer init scripts til dig der kører flavour. (systemd, upstart eller sysvinit)

Efter installation (og ved opgradering) kan du starte eller genstarte CLI-daemonen ved at bruge systemets init flavour, som for eksempel: 

sudo systemctl start jottad

For at være sikker på at det starter ved opstart af computeren:

sudo systemctl enable jottad

Hjælp til at starte:

jotta-cli help

Note: Ved at køre programmet som en ikke-root bruger som standard, formindskes sikkerhedssårbarhederne, men samtidig vil det medføre, at jottad ikke kan læse filer der ikke er tilgængelige for jottad brugeren eller gruppen.
For at afbøde dette skal gøres enten:

  • Skift brugeren af processen ved at redigere/etc/systemd/system/jottad.service , /etc/init/jottad.conf or /etc/init.d/jottad 
  • Gør filerne mulige at se, ved at tilføje den pågældende jottad bruger til en gruppe, der har adgang til filerne.
  • chmod  filerne for at gøre dem tilgængelige.

Jottacloud CLI til FreeBSD

Sådan installerer du Jottacloud CLI på FreeBSD og derivater

Binære filer til FreeBSD kan findes her.

Ved un-tar filer bliver de flyttet til /usr/bin eller  /usr/share/jottad,/etc/jottad 

For eksempel kan init-scripts, der arbejder på Linux, findes i /usr/share/jottad .
De fleste funktioner er ikke blevet testet grundigt på FreeBSD og der vil formentlig være en hel del bugs. Vær venlig at rapporter eventuelle bugs på vores  bug tracker, så de kan blive udbedret.

Jottacloud CLI til macOS

Sådan installerer du Jottacloud kommandolinjeprogram på MacOS ved brug af Homebrew

Homebrew

Du skal bruge Homebrew til at installere Jottacloud CLI på MacOS.

Lær hvordan man installerer Homebrew her.

Installering af Jottacloud CLI

Når Hombrew er blevet installeret på dit system, følg instruktionerne nedeunder:

Tap repoen:

brew tap jotta/cli
Installer de binære filer:
brew install jotta-cli

Start jottad som en service på login:

brew services start jotta-cli
Hjælp til at starte:
jotta-cli help

Opdatering af Jottacloud CLI

Kør opdateringen og opgrader (kunne også gøres uden jotta-cli da Homebrew opdaterer alle pakkerne):

brew update && brew upgrade jotta-cli

Note: Husk at genstarte jottad service efter opgraderingen

brew services restart jotta-cli

Jottacloud CLI til Windows

Hvordan man installerer Jottacloud kommandolinjeprogram på Windows systemer

For at installere Jottacloud CLI skal du hente den nyeste msi installer fra vores repo arkiv og køre den.

Download den nyeste msi installation fra vores repo arkiv.

https://repo.jotta.us/archives/windows/amd64/

Du opdaterer Jottacloud CLI til en nyere version på nøjagtig samme måde. Hent fra ovenstående link og installer.

Login og basal brug

De basale ting ved Jottacloud kommandolinje interface

Kommandolinje interfacet kan bruges ved at skrive den følgende kommando efter installation.

 jotta-cli [command]

For en liste med alle muligheder, skrives bare jotta-cli uden andre kommandoer eller lignende.

Usage:
  jotta-cli [command]
Available Commands:
  add          Adds a folder to continuous backup
  archive      Archive/upload a single file to jottacloud
  completion   Bash completion for jotta-cli
  config       Set or get a configuration setting
  download     Download a file or folder
  dump         Dump the local backupdatabase
  help         Help about any command
  ignores      Set or view ignore files
  list         List ongoing downloads and information about completed downloads
  logfile      prints the path of the logfile
  login        Login. Necessary for jottad to run
  logout       Logout. Resets credentials and stop backups
  ls           list a backed up folder
  pause        Pause jottad for an amount of time
  rem          Stop backing up a current backup folder
  resume       Resume jottad if paused
  scan         Trigger a scan of one or more backupfolders
  status       Shows you the state of the system right now
  tail         Watch the logfile stream
  version      Show version information
  web          Open jottacloud website
  webhook      Manage webhooks

Flags:
  -h, --help          help for jotta-cli
      --host string   the ip address of the host jottad is running on (default "127.0.0.1")
      --port string   the port jottad is listening on (default "14443")

Log in og opret enhed

Den første ting du skal gøre, er at logge ind med dine brugeroplysninger og lave en enhed på Jottacloud.

jotta-cli login 

1. Accepter betingelserne ved brug af Jottacloud

2. Indsæt din personlige login-token. Generer en login-token her: https://www.jottacloud.com/web/secure

3. Giv din enhed et navn

Du er nu klar til at tilføje mapper som der skal laves en backup af.

Tilføjelse og fjernelse af mapper fra backup med Jottacloud CLI

Sådan tilføjer og fjerner du mapper fra backup med Jottacloud CLI

Tilføj mapper til backup

Tilføj en folder til backup ved at skrive den følgende kommando.

jotta-cli add 'path/to/folder' 

kommandolinje-jottacloud

Brug denne statuskommando til at verificere at folderen er tilføjet, og til at se hvor langt den er med at uploade:

jotta-cli status 

Note: Backup fungerer på samme måde som skrivebordsprogrammet. Ændrede filer tilføjes som nye revisioner til filerne på Jottacloud. Slettede filer vil blive puttet i papirkurven på Jottacloud i 30 dage før de slettes.

Fjern mapper fra backup

Hvis du ikke længere vil have jotta-cli til at holde øje med, og lave backup af en mappe mere, så kan du fjerne den folder fra jotta-cli. Brug følgende kommando:

jotta-cli rem 'path/to/folder' 

Brug igen statuskommandoen for at verificere, at folderen er fjernet.

Note: Brug af ’jotta-cli -rem’ kommandoen vil IKKE slette mappen fra Jottacloud.

Jottacloud CLI og tilladelse på Linux

Denne artikel forsøger at løse situationen, hvor jotta-cli, ikke har adgang til de filer, du ønsker at sikkerhedskopiere.

Hvis du ønsker en introduktion til, hvordan tilladelser foregår på Linux generelt, så har Digital Ocean en fremragende artikel om dette.

Overblik

Jottacloud CLI består af to dele: en cli og en daemon. Her kaldes daemonen for jottad og jottad er den komponent, der skriver og læser dine uploads og downloads, og som kommunikerer med Jottacloud og udfører godkendelser.

Som standard, når du installerer jotta-cli på RPM- og DEB-baserede distributioner, bliver jottad daemonen kørt som både en bruger og gruppe med navnet jottad.

Fordi daemonen kører som denne oprettede bruger, har jottad ikke adgang til filer uden læse- eller skrivetilladelser.

En løsning på dette er at åbne tilladelserne til de filer og mappe, du gerne vil sikkerhedskopiere, så de kan læses og redigeres. Dette anbefales dog ikke ikke.

En bedre løsning er at sikre, at kun jottad har læse- og skriveadgang til disse filer.

Du kan opnå dette ved at bruge grupper i stedet for.

Brugen af grupper kan foregå på to forskellige måder

  1. Føj din bruger til en gruppe jottad og angiv gruppeejeren til at være jottad.

Fordel: jottad har kun adgang til det, du ønsker at sikkerhedskopiere.

Ulempe: du skal skifte gruppe hver gang, du ønsker at tage en sikkerhedskopi af noget nyt

  1. At køre jottad som din egen brugergruppe.

Fordel: jottad har adgang til alle dine filer

Ulempe: jottad har adgang til alle dine filer

Første løsning

  • Tilføj din bruger til din jottad gruppe: <code>usermod -a -G jottad <username> </code>
  • Skift gruppeejer til jottad for hver mappe, du ønsker at sikkerhedskopiere:<code>
    chgrp jottad /home/<username>/folder_to_backup </code>
  • Det kan også være nødvendigt at justere mappens tilladelser: <code>chmod g+w /home/<username>/folder_to_backup </code>
$ jotta-cli add /home/<username>/folder_to_backup
ERROR: stat /home/<username>/folder_to_backup: permission denied.
$ chgrp jottad /home/<username>/folder_to_backup
$ jotta-cli add /home/<username>/folder_to_backup
OK

Anden løsning

Hvad der skal gøres her, afhænger af, hvilken slags init-system dit operativsystem bruger.

  • upstart:
    Åben <code>/etc/init/jottad</code> og angiv <code>setgid</code> til dit gruppenavn. Skift herefter ’umask’ til 002. Hvis din fil ikke indeholder <code>setgid</code> , ret da linjen <code>chroot --userspec jottad:jottad</code>  i stedet for, hvilket redigerer den anden jottad i din gruppe: <code>chroot --userspec jottad:<group></code>
    Genstart jottad ved hjælp af kommandoen:<code>restart jottad</code>
  • sysvinit:
    Åben <code>/etc/init.d/jottad</code>  og rediger linjen <code>group="jottad"</code>  for din gruppe.
    Tilføj <code>umask=002</code> efter linjen <code>nice=""</code>.
    Genstart jottad ved hjælp af kommandoen <code>/etc/init.d/jottad restart</code>.
  • systemd:
    Tilføj en tilsidesættelse af systemd-tjenesten ved at anvende <code>systemctl edit jottad</code> og indtast følgende (husk at erstatte <code><group></code> med dit aktuelle gruppenavn):
[Service]
Group=<group>
UMask=0002

       Genindlæs enhedens systemd filer ved brug af kommandoen <code>systemctl daemon-reload</code>.
       Genstart jottad ved hjælp af kommandoen <code>systemctl restart jottad</code>.

Bemærk venligst, at ’inheritance’ for brugergrupper ikke nødvendigvis fungerer som med en skal med systemd. Sørg for at den gruppe, du kører tjenesten med, faktisk er den reelle gruppeejer for de mapper, du ønsker at foretage en sikkerhedskopiering af. Overvej alternativt at bruge SupplementaryGroups.

Sørg for at gruppen kan få adgang til mapper og filer

Brug af ovennævnte løsninger vil resultere i at jottad kan læse, skrive og køre filer, der ejes af den valgte gruppe, men filerne og mapperne i sig selv skal stadig angives til at kunne læses, skrives og køres.

Alle mapper har brug for læse- og udførelsestilladelse for at kunne indtaste og liste indhold, og alle filer skal som minimum have læsetilladelse. For at forstå mere omkring, hvordan tilladelser fungerer på Linux, henviser vi igen til den tidligere nævnte artikel fra Digital Ocean.

Eksempel: indstil anbefalede tilladelser til sikkerhedskopiering af en mappe 

$ # Find all folders in the folder to backup and make them executable by the group
$ find /home/<username>/folder_to_backup -type d -exec chmod g+x {}\;
$ # Set all files and folder to group readable
$ chmod -R g+r /home/<username>/folder_to_backup

Note: Alle overordnede mapper i den mappe, du tilføjer til sikkerhedskopien, behøver også læsetilladelse og eksekveringstilladelse. For eksemplet herover ville det se sådan her ud:  <code>/home</code> og <code>/home/username</code>.

Arkivering af filer med Jottacloud CLI

Lær hvordan man arkiverer filer med Jottacloud CLI

For at uploade en fil direkte til Jottacloubs Web Arkiv, brug da den simple kommando:  

jotta-cli archive

Eksempel:
jotta-cli archive 'path/to/file'

jotta-cli archive 'path/to/file' 

Jottacloud CLI vil derefter starte en kontrolsum og uploade filen. Dette kan ses visuelt i terminalens GUI.

kommandolinje-jottacloud

Note: Filer er gemt i en undermappe af Arkivet med det samme navn som enheden.

Du kan også specificere en sti under Arkiv til at gemme filen til.

Eksempel:

jotta-cli archive 'path/to/file' --remote folder/subfolder

Dette vil gemme filen til ”archive/folder/subfolder/file”

Hvis du ikke har brug for/ønsker UI-delen (hvis du f.eks. bruger et script af en art), så kan du specificere --nogui og terminalen vil ikke skifte til rå tilstand.

Eksempel:

jotta-cli archive 'path/to/file' --nogui

Sådan ser du Jottacloud CLIs status og logbog (logs)

Lær at forstå hvad Jottacloud CLI laver

Der er to metoder som kan hjælpe dig til at forstå hvad der foregår i kommandolinjeprogrammet i dette øjeblik.

  • Status
  • Logs

Status

For at se statussen for kommandolinjeprogrammet, brug følgende statuskommando:

jotta-cli status 

Dette vil vise dig følgende information:

$ jotta-cli status
---------------------------------------------------------
 Account   : test-account
 Usage     : 1.57TB / 2.0TB
 Backups   :
---------------------------------------------------------
   Path      : /Users/test/Desktop
   Files     : 8536 files / 8.48GB
   Status    : Up to date!
---------------------------------------------------------
OK

Log

Kommandolinjeprogrammet vil skrive logfiler til jotta-cils installationssti. Den befinder sig typisk i brugerens hjemmemappe under  .jottad  mappen.

~/.jottad/jottabackup.log 

Du kan følge logbogen for en igangværende proces ved at bruge tailf kommandoen:

jotta-cli tail 

Tryk på CTRL + C for at lukke kommandoen.

Ignorer filer og mapper fra backup med Jottacloud CLI

Lær hvordan man ignorerer filer og mapper med Jottacloud CLI

Beskrivelse

Jottacloud kommandolinjeprogram understøtter muligheden for at ignorere filer og mapper ved at placere specielle ignoreringsfiler i den mappestruktur, som du er ved at lave en backup af.

Der er to måder hvorpå man kan udelukke filer og mapper:

  • Globale udelukkelser
  • Mappe specifikke udelukkelser

Globale udelukkelser

Du kan bruge jotta-cli for at indlæse globale udelukkelsesfiler der anvendes på alle mapper. Lav en fil med det udelukkelsesmønster du ønsker, og indlæs det ved brug af ignores set  kommandoen.

jotta-cli ignores set 'path/to/ignorefile' 

For at se det globale udelukkelsesmønster på dit system, brug ignores get kommandoen:

jotta-cli ignores get 

Dette vil printe alle de globale udelukkelsesregler. Her er et eksempel fra Mac OS X:

---------------------------------------------
#
# ---- START OSX DEFAULTS ----
#
# The patterns listed in this file are the hardcoded
# and imutable ignore rules. These will always be respected
# by the client regardless of any other specified rules

### OSX ###
.DS_Store
.AppleDouble
.LSOverride
Icon\r

# Files that might appear in the root of a volume
.DocumentRevisions-V100
.fseventsd
.Spotlight-V100
.TemporaryItems
.Trashes
.VolumeIcon.icns
.com.apple.timemachine.donotpresent

# Directories potentially created on remote AFP share
.AppleDB
.AppleDesktop
Network Trash Folder
Temporary Items
.apdisk
#
# ---- END DEFAULTS ----
#

Mappe specifikke udelukkelser

Du kan tilføje mappe specifikke udelukkelsesfiler til individuelle mapper du vil lave backup af. Tilføj en speciel fil i en mappe af eget valg. Filen hedder: .jottaignore 

Det som .jottaignore filen gør, er at specificere hvilke ikke-overvågede filer, som Jottacloud CLI skal ignorere. .jottaignore  minder på mange måder om  .gitignore.

Der er dog én stor forskel mellem .jottaignore og  .gitignoreÆndringer du laver til  .jottaignore filer rammer også filer og mapper der allerede er lavet backup af. Det betyder, at hvis du tilføjer et udelukkelsesmønster, der udelukker filer eller mapper der allerede er lavet backup af, så bliver de slettet fra din backup på Jottacloud.

Hver linje i en .jottaignore  fil specificerer et mønster. 

Note: .jottaignore  filer er kun understøttet af Jottaclouds kommandolinjeprogram. Jottacloud skrivebordsprogrammet understøtter altså ikke  .jottaignore  filer.

Mønsterformat

Mønsterformatet ved .jottaignore er det samme som ved  .gitignore

Klik her for at se dokumentationen for .gitignore.

Eksempler

### WordPress ###
*.log
wp-config.php
wp-content/advanced-cache.php
wp-content/backup-db/
wp-content/backups/
wp-content/blogs.dir/
wp-content/cache/
wp-content/upgrade/
wp-content/uploads/
wp-content/wp-cache-config.php
wp-content/plugins/hello.php

/.htaccess
/license.txt
/readme.html
/sitemap.xml
/sitemap.xml.gz

Gitignore.io er et brugbart værktøj til at lave .gitignore  filer. Dette værktøj kan også benyttes til at lave  .jottaignore filer.

Håndtering af flere forekomster ved hjælp af kommandolinje interfacet

Sådan opretter du forbindelse til jottad på afstand.

Du kan administrere kommandolinjeprogrammet på eksterne maskiner med kommandolinje interfacet.

Kommandolinje interfacet (jotta-cli) muliggør for dig at forbinde til eksterne hosts der kører den samme jottad daemon. Brug  -host  kommandoen for at specificere navnet på hosten eller ip adressen på den maskine, som du vil administrere.

Eksempel: Display  status  from jottad  on 192.168.10.10:

jotta-cli -host 192.168.10.10 status 

Note: Brug jotta-cli uden -host kommandoen for at administrere en local host.

Hvad er en webhook

Fra version 0.6 lytter jottad til 127.0.0.1 og ikke 0.0.0.0. At lytte til 127.0.0.1 betyder, at jottad ikke kan modtage forbindelser fra andre værter. For at give jottad mulighed for at lytte til alle eller nogle grænseflader skal du specificere listenAddr, som giver mulighed for dette. Du kan både specificere  ip-adressen, der tilhører en bestemt netværksgrænseflade, eller blot anvende 0.0.0.0, hvilket betyder, at jottad lytter til alle tilgængelige grænseflader (mere information).

Du kan specificere den adresse, jottad lytter til i konfigurationsfilen. Konfigurationsfilen følger ini-formatet og kontrollerer nogle aspekter af, hvordan jottad kører. Et eksempel på en konfigurationsfil er vist nedenfor. Denne konfigurationsfil ændrer standarddatadir til /home/roland/.jottaddata, og adressen jottad lytter til ændres til 0.0.0.0.

[settings]
; this changes the datadir
Datadir=/home/roland/.jottaddata
; this allows jottad to listen on all interfaces
ListenAddr=0.0.0.0

Det kan ske, at konfigurationsfilen ikke findes i forvejen, og hvis dette er tilfældet, skal du først oprette den. De mulige placeringer for konfigurationsfilen afhænger af dit operativsystem og er vist nedenfor. Du kan bruge eksempelfilen ovenfor som en skabelon, så længe du husker at ændre eller fjerne Datadir-elementet.

jottad søger efter konfigurationsfilen på følgende placeringer:

linux & freebsd:
/etc/jottad/config.ini

macos:
~/.config/jottad.ini

windows:
installdir\config.ini
(install dir is the same dir as the jottad.exe executable)

Sådan konfigurerer du kommandolinjeprogrammet til at sende webhooks

Lav webhooks så man får beskeder om begivenheder

Du kan konfigurere kommandolinjeprogrammet til at sende simple webhooks.

Det jottad  mulighed for at beskeder, når der sker noget vigtigt. jottad sender lige nu de følgende beskeder:

  • Når  jottad  starter
  • Når  jottad  stopper
  • En status besked ved brugerdefinerede intervaller

Image

Vi har kun implementeret et par webhook beskeder til at starte med, men vi vil tilføje flere med tiden. Hvis I har nogle forslag til beskeder, som vi skal tilføje, hører vi gerne fra jer.

Hvad er en webhook

Webhooks er en simple måde at sende beskeder til eksterne kilder, som Slack, from jottad. De bruger normale HTTP anmodninger med en JSON payload der inkluderer beskedens tekst og nogle muligheder.

jottad sender beskeder med rig formatering i Slack format.

Tilføj en webhook URL

For at tilføje en URL til  jottad, brug den simple kommando  webhook add:

jotta-cli webhook add [your url]

En besked bliver sendt med det samme, som tjekker om alting er blevet modtaget i den anden ende.

Statusinformation fra jottad bliver sendt hver 6. time som standard. Det statusinterval kan ændres med følgende kommando:

jotta-cli config set webhookstatusinterval [value] 

[value] skal overholde tidsvarigheden som angivet nedenfor:

10m, 6h, 5h30m

Kig på følgende link for at se flere eksemplerhttps://golang.org/pkg/time/#ParseDuration  

Fjern en webhook URL

For at fjerne en webhook URL fra jottad brug kommandoen webhook rem:

jotta-cli webhook rem [your url]

jottad vil nu ikke længere sende beskeder til den pågældende URL.

Sådan pauser du Jottacloud CLI

Lær hvordan du pauser og genoptager Jottacloud CLI

Du kan pause jottad i en periode. Det kan være brugbart, hvis du pludselig skal bruge internettet eller cpu’en som jottad brugte til at lave backup. Det kan også være, at det er fordi du skal ændre en masse filer i et backupsæt, og du ikke vil have en masse halvfærdige versioner af filerne gemt. Eksempelvis kan en masse skift frem og tilbage mellem git branches gøre, at en masse filer ændre sig, som man måske ikke ønskede.

jotta-cli pause [duration]

Eksempler:

jotta-cli pause 5m 
jotta-cli pause 6h30m

Overstående vil få jottad til at pause i hhv. 5 minutter, eller 6 timer og 30 minutter. Flere eksempler kan findes her.

Varigheden udløber inden for +/- 1 minut, så det giver ikke megen mening at indstillet pausen med et nanosekund præcision.

Hvis du har tilføjet én eller flere webhooks, så vil jottad sende besked til de pågældende webhooks, at den går i pausemode. Der vil også blive sendt besked når pausen er forbi, enten ved pausens udløb, eller ved at du har stoppet den manuelt med nedenstående kommando:

jotta-cli resume

Hvis du genstarter jottad eller computeren imens den er sat på pause, så vil den ikke huske at den var på pause.

Ved at bruge denne funktion kan du nemt planlægge pauser på forskellige tidspunkter i løbet af dagen.

$ cat /etc/cron.d/jottad
# Pause jottad from 01:00 until 07:00 every day
0 1 * * * jottad /usr/bin/jotta-cli pause 6h

Jottacloud CLI Konfiguration

Lær hvordan du konfigurerer Jottacloud CLI, så det passer til dine behov
Jottacloud CLI kommer med flere indstillinger, du kan skifte eller finpudse efter ønske. Du kan se en komplet liste over disse indstillinger og deres værdier ved at køre denne kommando:
> jotta-cli config get
downloadrate          : unlimited
uploadrate            : unlimited
scaninterval          : 1h0m0s
webhookstatusinterval : 6h0m0s
logscanignores        : false
slowmomode            : 0
logtransfers          : false
screenshotscapture    : false
Standardindstillingerne er vist ovenfor her.

Hastighed for download og upload (downloadrate /uploadrate)

Dette ændrer båndbredden, som <code>jottad</code> må bruge, når der downloades eller uploades. Enhederne, der bruges til at beskrive dette, burde være ganske intuitive: 1 m betyder 1 megabyte per sekund. 512k betyder 512 kilobyte per sekund. 0 betyder ubegrænset, hvilket altså giver jottad mulighed for at bruge så meget af båndbredden, det skal.

Scanningsinterval (scaninterval)

<code>jottad</code> scanner hver mappe, der er tilføjet til sikkerhedskopiering hvert scanningsinterval.

Enhederne er sekunder, minutter og timer og skrives således:

h for hour 
m for minutes
s for seconds

De kan kombineres eller anvendes alene sådan her:

jotta-cli config set scaninterval 30m
jotta-cli config set scaninterval 2h
jotta-cli config set scaninterval 1h30m


Statusinterval for webhook (webhookstatusinterval)

Hvis du har nogen webhooks konfigureret, så vil <code>jottad</code> sende en statusopdatering til dine webhooks ved hvert webhook statusinterval. Enhederne for dette er de samme som for scanningsintervallet.

Ignorer logscanninger (Logscanignores)

<code>jottad</code> vil automatisk ignorere nogle filer, når der scannes. Dette forekommer enten fordi <code>jottad</code> ignorerer alle sådanne filer, eller fordi du muligvis har tilføjet dine egne ignoreringsregler. Du kan indstille din logscanignores til ’true’ (sand), hvis du ønsker, at <code>jottad</code> skal skrive årsagen til, at hver fil bliver ignoreret til logfilen. Du kan bruge dette til at finde ud af, hvorfor en bestemt fil eller mappe ikke bliver opdateret.

Slowmomode

<code>jottad</code> vil som standard anvende værdien ’slomomode’, som benytter alle tilgængelige cpu eller harddrive-ressourcer, når du scanner. Dette kan have en negativ påvirkning på andre processer, du kører samtidig. Ved at indstille ’slowmomode’ til en scanning med højere værdi, vil scanningen foregå langsommere, hvilket bruger mindre cpu og harddrive kraft. De gyldige værdier, du kan anvende i denne sammenhæng er fra 0-50.

Logoverførsler (logtransfers) 

<code>jottad</code> logger som standard kun overførselsfejl. Hvis du indstiller denne kommando til ’true’ (sandt), så vil jottad skrive resultatet af alle http-anmodninger relateret til uploads og downloads i logfilen.


Skærmbilleder (Screenshotcapture) på MacOS  

Hvis du indstiller denne kommando til ’true’ (sandt), så vil <code>jottad</code> holde øje med eventuelle skærmbilleder, der tages, uploade dem og generere en offentlig url, som så skrives i din udklipsholder. Denne funktion kan være meget nyttig, hvis du hurtigt skal dele skærmbilleder med andre mennesker.

Skærmbilleder (Screenshotcapture) på linux

Selvom det ikke er lige så nemt som på MacOS, er det også muligt at gøre dette på din linux.

Installer ’scrot’ og ’xclip’ med din pakkeadministrator sådan her:

apt install scrot xclip # apt/dpkg based
yum install scrot xclip # rpm based


Opret scrot.sh for at begynde at sende skærmbilleder Jottacloud:

#!/bin/bash
mkdir -p ~/Screenshots
sleep 0.2 ; scrot -s -e 'mv $f ~/Screenshots ; jotta-cli archive ~/Screenshots/$f --share --clipboard --nogui'

Marker det område, du vil tage et skærmbillede af, og URL'en til skærmbilledet vil automatisk blive lagt ud på din udklipsholder.

Download ved hjælp af Jottacloud CLI

Lær, hvordan du downloader filer eller mapper ved hjælp af Jottacloud CLI

I version 0.5 tilføjede vi muligheden for at downloade filer og mapper ved hjælp af jotta-cli.

jotta-cli download Archive/folder/subfolder ~/Downloads

Ovenfor står syntaksen, som skal bruges til at begynde en given download.  <code>Archive/folder/subfolder</code> er den fjernsti (<code>remote path</code>) til filen eller mappen på jottacloud. <code> ~/Downloads</code> er <code>download destination</code>, hvor filer og mapper bliver downloadet til.

Note: Hvis du kører <code>jottad</code> og <code>jotta-cli</code> på separate enheder, skal du angive en gyldig <code>downloaddestination</code> på den enhed, hvor <code>jottad</code> kører.


Overblik over kommandoer

jotta-cli download remote/path/to/file /local/download/destination
jotta-cli download --watch
jotta-cli download --abort=downloadid
jotta-cli list downloads
jotta-cli list downloadinformation --downloadid=downloadid [--json]


Start af en download

At forstå og finde den rigtige fjernsti (<code>remote path</code>) til downloads er måske det mest forvirrende, når du skal downloade ved hjælp af <code>jotta-cli</code>.


Ligesom på webstedet er dine filer grupperet i "Sync", "Backup" og "Archive". Se eksemplet her:

jotta-cli download Backup/MyImac/FolderWithStuff ~/Downloads
jotta-cli download Sync .

Den rigtige fjernsti (<code>remote path</code>) kan trækkes fra filen eller mappernes placering på websiden, men den tilsigtede metode er at bruge bash-completion på MacOS og linux og <code>jotta-cli</code> ls på windows. Se Bash-completion nedenfor her.

Når du har trykket på retur venter <code>jotta-cli</code>  på,  at <code>jottad</code> samler de nødvendige metadata for at udføre den pågældende download. I løbet af denne tid kan du afbryde din download ved at trykke CTRL-C. Når din download starter, udskriver jotta-cli nogle oplysninger om din download, inklusive en <code>download-ID</code>, og vender så tilbage.

Annullering af download

Når en download er startet, kan du annullere den ved anvende følgende kommando:
<code> jotta-cli download --abort=downloadid</code>

Du kan finde din download ved at skrive<code> jotta-cli list downloads</code> eller <code>jotta-cli download --watch</code> . Når du annullerer en download, efterlader det alle filer, der allerede er downloadet på filsystemet. Alle delvist downloadede filer slettes.

Hold øje med downloads

Du kan se udviklingen i en download ved at anvende <code>jotta-cli download --watch</code> .

Kun en download køres på ethvert tidspunkt. Hvis du har startet flere downloads, starter den anden ikke, før den første er afsluttet. Når en download er afsluttet, forsvinder den fra <code>jotta-cli list downloads</code> med mindre en eller flere filer ikke blev downloadet korrekt.

Fejl ved downloads

Hvis en fil ikke kunne downloades af en eller anden grund, vil overførslen blive afsluttet, men den forsvinder ikke fra <code>jotta-cli list downloads</code>.

If a file could not be downloaded for any reason the download will complete, but it will not dissappear from <code>jotta-cli list downloads</code>. For at se detaljerede oplysninger om downloadfejl skal du skrive <code>jotta-cli list downloadinfo --downloadid=downloadid</code>. Du kan også tilføje <code>--json</code> for at få informationer om downloadfejl i et json format.

For at rydde downloads fra listen skal du skrive <code>jotta-cli download --abort=downloadid</code>.

Bash-completion

På MacOS og linux kan du bruge bash-completion til at 'gennemse' fjernstierne på jottacloud. Prøv følgende kommando:

jotta-cli download [TABTAB]

her betyder [TABTAB], at du trykker TAB 2 gange.

Dette skulle gerne være en oplevelse, der minder om browsing i et lokalt filtype, selvom det dog kan være lidt langsommere afhængigt af latenstid for vores servere. Funktionen fungerer også med <code>jotta-cli ls [TABTAB]</code>, men ikke med en begyndende <code>-l</code> som i <code>jotta-cli ls -l [TABTAB]</code>.

Du kan finde mere information her: bash completion

Hvis du støder på problemer med stier, hvor der er problemer med bash-completion, så fortæl venligst om udfordringerne på https://github.com/jotta/jotta-cli-issues eller send en support forespørgsel til support@jottacloud.com  hvis du ikke ønsker at vise de aktuelle filstier offentligt.

 

Bash completion (MacOS og Linux)

Lær hvordan du anvender bash-completion med Jottacloud CLI

MacOS

På MacOs er du nødt til at installere Homebrew (et gratis og open-source administrationssystem til software pakker). Brug dette til at installere bash-completion og tilføj derefter bash-completion til din skal (shell).

Du bliver muligvis også nødt til at opgradere bash, da MacOS generelt er udstyret med en temmelig gammel version, hvilket har indflydelse på dine bash-completion scripts.

Til at begynde med skal du installere Homebrew fra https://brew.sh/. Du har formentlig allerede hentet det, hvis du har installeret Jotta-Cli på din MacOs.

Derefter skal du tjekke din bash version:

echo $BASH_VERSION


Hvis din bash major version er mindre end 4, er du nødt til at opgradere:

brew install bash

Nu skal du hvidliste den nye version af bash. Det gør du ved at tilføje den til listen over skaller, som findes i denne fil:
<code>/etc/shells</code>

Når du har foretaget din hvidliste af skallen, skal du sikre dig, at du kører den nye version. Det gør du ved at køre følgende kommando:

chsh -s /usr/local/bin/bash

Du kan finde mere information om opgradering af bash her:https://itnext.io/upgrading-bash-on-macos-7138bd1066ba?gi=a0e70050c3ff


For det tredje, installer bash-completion:

brew install bash-completion

Husk at følge instruktionerne om, hvordan du tilføjer bash-completion til din skal. Det vil typisk se nogenlunde sådan her ud:

Add the following line to your ~/.bash_profile:
  [[ -r "/usr/local/etc/profile.d/bash_completion.sh" ]] && . "/usr/local/etc/profile.d/bash_completion.sh"


Fjerde, tilføj følgende til din <code>~/.bash_profile</code>:

. <(jotta-cli completion)


Linux

De fleste linux-distributioner leveres med bash-completion, som altså allerede er indlæst. Hvis dette ikke er tilfældet, kan du køre denne kommando:

apt-get install bash-completion

Hvis din linux distrubution ikke er Devian, skal du køre en tilsvarende kommando, der passer hertil.

Tilføj herefter følgende til din <code>~/.bash_profile</code> eller <code>~/.bashrc</code>:

. <(jotta-cli completion)

Hvilke platforme og arkitekturer er understøttet af Jottacloud CLI?

Jottaclouds kommandolinjeprogram understøtter følgende operativsystemer og arkitekturer.

Note: Installations- og downloadinstruktioner kan findes her. Hvis dit system ikke understøtter vores installationspakker, så kan du downloade de binære filer direkte fra vores arkiv.

Linux

Kommandolinjeprogrammet er bygget til et antal arkitekturer inden for forskellige Linux distributioner der kører kernel version 2.6.23 eller senere. Vi tilbyder binære filer til følgende arkitekturer:

  • Amd64
  • i386
  • arm64
  • armhf

Vi tilbyder pakkede binære filer til de følgende distributioner:

  • deb-baserede systemer - herunder Debian, Ubuntu og deres derivater
  • rpm-baserede systemer - herunder Red Hat, Fedora og CentOS

Windows

Version 10, 8 og 7. 64-bit versioner som det eneste. Windows 10 og 8 er 64-bit som standard, men Windows 7 kan være både 32- og 64-bit. For at finde ud af hvilken version af Windows 7 version du kører, kan du læse denne Windows support artikel.

MacOS

10.8 Mountain Lion eller nyere.

Hvilke filsystemer er understøttet af Jottacloud CLI?

Som et nyt tiltag kan man fra version 0.4.x tilføje enhver og alle POSIX kompatible filsystemer som backupstier i jotta-cli.

Ved brug af fjernmountede filsystemer, overlay filsystemer eller utestede filsystemer vil jotta-cli vise en advarsel:

$ jotta-cli add /path
Warning: The path you attempt to add is located on a remote mounted filesystem, overlay filesystem or untested filesystem. If the file system becomes unmounted or unavailable, jotta-cli might interpret that as the files and folders have been deleted, and thus the backed up files will be moved to the trash can on Jottacloud.
Do you still want to add the path to backup? (yes/no):

Med dette i mente, skal du helst ikke tilføje nogle stier med mounts i dem, men hellere tilføje selve mountet. At gøre det sidste vil logge en fejl i jotta-cli status som siger, at filsystemerne pludselig er væk og at server side dataen ikke vil blive slettet.

Denne funktion er ikke blevet gennemtestet, så send venligst alle fundne bugs til vores bug tracker.