Lähdekoodi sivulle Duplicity

{{Ohjelma
| nimi=Duplicity
| kuva=
| kuvateksti=
| lisenssi=[[GPLv2+]]
| käyttöliittymä=teksti
| kotisivu=[http://duplicity.nongnu.org/ duplicity.nongnu.org]
}}

'''Duplicity''' on [[rsync]]-protokollaa käyttävä [[Python]]illa kirjoitettu [[varmuuskopiointi]]ohjelma, jolla tehdään salatut varmuuskopiot tiedostoista. Duplicity käyttää [[GnuPG]]-salausohjelmaa varmuuskopioiden salaukseen, joten symmetrisen salauksen lisäksi myös avainparisalaus on mahdollinen. Duplicity on erityisen kätevä varmuuskopioitaessa [[SSH]]:n yli etäpalvelimelle. Duplicity tukee versiointia ja osaa myös tallentaa [[tiedostojen oikeudet]]. Linkeistä Duplicity tukee [[symbolinen linkki|symbolisia linkkejä]], mutta ei [[kova linkki|kovia linkkejä]].

==Asennus==
{{Asenna|Duplicity|duplicity}}

==Käyttötapaus: <tt>/home</tt> -hakemiston varmuuskopiointi palvelimelle==
Duplicityn käyttöön tulee luoda PGP- ja SSH-avainparit. Lisätietoa löytyy artikkeleista [[Gpg#Avainparin_luominen|PGP-avainparin luominen]] ja [[SSH#Tunnistaminen_avainparilla|SSH-avainparin luominen]]. PGP-avainta ei tarvita jos käytetään symmetristä salausta, mutta avainparisalaus on vahvempi, joten tässä ohjeessa käsitellään Duplicityn käyttö avainparilla.

{{Oikeudet}}

===Valmistelu===
Luodaan ensin uusi avainpari duplicityn käyttöön [[root]]-tunnukselle. Salasana jätetään tyhjäksi.
 # ssh-keygen -t rsa -b 4096

Kopioidaan julkinen avain palvelimelle.
 # ssh-copy-id käyttäjä@esimerkki.fi

Kirjaudutaan palvelimelle ja luodaan hakemisto varmuuskopioille.
 # ssh käyttäjä@esimerkki.fi
 $ mkdir ~/varmuuskopio
 $ exit

Luodaan PGP-avainpari GnuPG-ohjelmalla rootille <tt>/root/.gnupg/</tt> -hakemistoon. GPG:lle tulisi antaa vahva salasana.
 # gpg --gen-key

Oman avaimen tunnusta tarvitaan myöhemmin. Sen saa näkyviin komennolla:
 # gpg --list-keys

===Varmuuskopiointi===
<tt>/home</tt> voitaisiin varmuuskopioida palvelimelle nyt näin:
 # duplicity --encrypt-key '''avaimen_tunnus''' /home <nowiki>sftp://käyttäjä@esimerkki.fi/varmuuskopio</nowiki>

Koska varmuuskopiota ei ole tehty aiemmin, duplicity tekee täyden varmuuskopion. Kun varmuuskopio tehdään uudestaan, ei kopioida kaikkea uudestaan, vaan kopioidaan vain muutokset, eli tehdään inkrementaalinen varmuuskopio. Uuden täyden varmuuskopion voi tehdä kuitenkin <tt>full</tt> -parametrilla.
 # duplicity full --encrypt-key '''avaimen_tunnus''' /home <nowiki>sftp://käyttäjä@esimerkki.fi/varmuuskopio</nowiki>

Jos ei haluta että Duplicity kysyy PGP-avaimen salasanaa, voidaan se antaa esimerkiksi näin:
 # PASSPHRASE="'''avaimen_salasana'''" duplicity --encrypt-key '''avaimen_tunnus''' /home <nowiki>sftp://käyttäjä@esimerkki.fi/varmuuskopio</nowiki>
Tämä on erityisen hyödyllinen esimerkiksi skripteissä.

Jos halutaan poistaa palvelimelta esimerkiksi kaikki paitsi kolme uusinta täyttä varmuuskopiota muutoksineen, voitaisiin ne poistaa näin:
 # duplicity remove-all-but-n-full 3 --force <nowiki>sftp://käyttäjä@esimerkki.fi/varmuuskopio</nowiki>

Varmuuskopiointi voitaisiin automatisoida esimerkiksi [[cron]]illa, jolloin inkrementaaliset varmuuskopiot voitaisiin tehdä päivittäin ja täydet varmuuskopiot esimerkiksi kerran viikossa tai kuukaudessa.

===Tiedostojen palauttaminen varmuuskopiosta===
Koko <tt>/home/</tt> -hakemisto voitaisiin palauttaa varmuuskopiosta seuraavasti:
 # PASSPHRASE="'''avaimen_salasana'''" duplicity <nowiki>sftp://käyttäjä@esimerkki.fi/varmuuskopio</nowiki> /home

Tietty tiedosto voidaan palauttaa <tt>--file-to-restore /tiedoston/polku</tt> parametrilla.
 # PASSPHRASE="'''avaimen_salasana'''" duplicity --file-to-restore '''/home/user/kuvat/lomakuva.png''' <nowiki>sftp://käyttäjä@esimerkki.fi/varmuuskopio</nowiki> '''/home/user/kuvat/lomakuva.png'''

{{Varmuuskopiointi}}
[[Luokka:Komentorivin erikoisohjelmat]]