2014-10-29 20:03:53 +01:00
<?xml version="1.0" encoding="utf-8"?>
< !DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
< html xmlns = "http://www.w3.org/1999/xhtml" lang = "en" xml:lang = "en" >
< head >
2016-10-31 17:24:49 +01:00
<!-- 2016 - 10 - 31 Mon 16:23 -->
2016-02-27 23:14:11 +01:00
< meta http-equiv = "Content-Type" content = "text/html;charset=utf-8" / >
< meta name = "viewport" content = "width=device-width, initial-scale=1" / >
2016-02-15 10:23:10 +01:00
< title > < / title >
2016-10-31 17:24:49 +01:00
< meta name = "generator" content = "Org mode" / >
2016-02-27 23:14:11 +01:00
< meta name = "author" content = "Bob Mottram" / >
< meta name = "description" content = "Turn the Beaglebone Black into a personal communications server"
2014-10-29 20:03:53 +01:00
/>
2016-02-27 23:14:11 +01:00
< meta name = "keywords" content = "freedombox, debian, beaglebone, red matrix, email, web server, home server, internet, censorship, surveillance, social network, irc, jabber" / >
2014-10-29 20:03:53 +01:00
< style type = "text/css" >
<!-- /* --> <![CDATA[/*> <!-- */
2015-07-05 21:33:45 +02:00
.title { text-align: center;
margin-bottom: .2em; }
.subtitle { text-align: center;
font-size: medium;
font-weight: bold;
margin-top:0; }
2014-10-29 20:03:53 +01:00
.todo { font-family: monospace; color: red; }
2015-04-10 13:56:51 +02:00
.done { font-family: monospace; color: green; }
.priority { font-family: monospace; color: orange; }
2014-10-29 20:03:53 +01:00
.tag { background-color: #eee; font-family: monospace;
padding: 2px; font-size: 80%; font-weight: normal; }
.timestamp { color: #bebebe; }
.timestamp-kwd { color: #5f9ea0; }
2015-07-05 21:33:45 +02:00
.org-right { margin-left: auto; margin-right: 0px; text-align: right; }
.org-left { margin-left: 0px; margin-right: auto; text-align: left; }
.org-center { margin-left: auto; margin-right: auto; text-align: center; }
2014-10-29 20:03:53 +01:00
.underline { text-decoration: underline; }
#postamble p, #preamble p { font-size: 90%; margin: .2em; }
p.verse { margin-left: 3%; }
pre {
border: 1px solid #ccc;
box-shadow: 3px 3px 3px #eee;
padding: 8pt;
font-family: monospace;
overflow: auto;
margin: 1.2em;
}
pre.src {
position: relative;
overflow: visible;
padding-top: 1.2em;
}
pre.src:before {
display: none;
position: absolute;
background-color: white;
top: -10px;
right: 10px;
padding: 3px;
border: 1px solid black;
}
pre.src:hover:before { display: inline;}
2016-08-08 18:21:03 +02:00
/* Languages per Org manual */
pre.src-asymptote:before { content: 'Asymptote'; }
pre.src-awk:before { content: 'Awk'; }
pre.src-C:before { content: 'C'; }
/* pre.src-C++ doesn't work in CSS */
pre.src-clojure:before { content: 'Clojure'; }
pre.src-css:before { content: 'CSS'; }
pre.src-D:before { content: 'D'; }
pre.src-ditaa:before { content: 'ditaa'; }
pre.src-dot:before { content: 'Graphviz'; }
pre.src-calc:before { content: 'Emacs Calc'; }
2014-10-29 20:03:53 +01:00
pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
2016-08-08 18:21:03 +02:00
pre.src-fortran:before { content: 'Fortran'; }
pre.src-gnuplot:before { content: 'gnuplot'; }
pre.src-haskell:before { content: 'Haskell'; }
pre.src-java:before { content: 'Java'; }
pre.src-js:before { content: 'Javascript'; }
pre.src-latex:before { content: 'LaTeX'; }
pre.src-ledger:before { content: 'Ledger'; }
pre.src-lisp:before { content: 'Lisp'; }
pre.src-lilypond:before { content: 'Lilypond'; }
2016-10-31 17:24:49 +01:00
pre.src-lua:before { content: 'Lua'; }
2016-08-08 18:21:03 +02:00
pre.src-matlab:before { content: 'MATLAB'; }
pre.src-mscgen:before { content: 'Mscgen'; }
pre.src-ocaml:before { content: 'Objective Caml'; }
pre.src-octave:before { content: 'Octave'; }
pre.src-org:before { content: 'Org mode'; }
pre.src-oz:before { content: 'OZ'; }
pre.src-plantuml:before { content: 'Plantuml'; }
pre.src-processing:before { content: 'Processing.js'; }
pre.src-python:before { content: 'Python'; }
pre.src-R:before { content: 'R'; }
pre.src-ruby:before { content: 'Ruby'; }
pre.src-sass:before { content: 'Sass'; }
pre.src-scheme:before { content: 'Scheme'; }
pre.src-screen:before { content: 'Gnu Screen'; }
pre.src-sed:before { content: 'Sed'; }
pre.src-sh:before { content: 'shell'; }
pre.src-sql:before { content: 'SQL'; }
pre.src-sqlite:before { content: 'SQLite'; }
/* additional languages in org.el's org-babel-load-languages alist */
pre.src-forth:before { content: 'Forth'; }
pre.src-io:before { content: 'IO'; }
pre.src-J:before { content: 'J'; }
pre.src-makefile:before { content: 'Makefile'; }
pre.src-maxima:before { content: 'Maxima'; }
pre.src-perl:before { content: 'Perl'; }
pre.src-picolisp:before { content: 'Pico Lisp'; }
pre.src-scala:before { content: 'Scala'; }
pre.src-shell:before { content: 'Shell Script'; }
pre.src-ebnf2ps:before { content: 'ebfn2ps'; }
/* additional language identifiers per "defun org-babel-execute"
in ob-*.el */
pre.src-cpp:before { content: 'C++'; }
pre.src-abc:before { content: 'ABC'; }
pre.src-coq:before { content: 'Coq'; }
pre.src-groovy:before { content: 'Groovy'; }
/* additional language identifiers from org-babel-shell-names in
ob-shell.el: ob-shell is the only babel language using a lambda to put
the execution function name together. */
pre.src-bash:before { content: 'bash'; }
pre.src-csh:before { content: 'csh'; }
pre.src-ash:before { content: 'ash'; }
pre.src-dash:before { content: 'dash'; }
pre.src-ksh:before { content: 'ksh'; }
pre.src-mksh:before { content: 'mksh'; }
pre.src-posh:before { content: 'posh'; }
/* Additional Emacs modes also supported by the LaTeX listings package */
pre.src-ada:before { content: 'Ada'; }
pre.src-asm:before { content: 'Assembler'; }
pre.src-caml:before { content: 'Caml'; }
pre.src-delphi:before { content: 'Delphi'; }
pre.src-html:before { content: 'HTML'; }
pre.src-idl:before { content: 'IDL'; }
pre.src-mercury:before { content: 'Mercury'; }
pre.src-metapost:before { content: 'MetaPost'; }
pre.src-modula-2:before { content: 'Modula-2'; }
pre.src-pascal:before { content: 'Pascal'; }
pre.src-ps:before { content: 'PostScript'; }
pre.src-prolog:before { content: 'Prolog'; }
pre.src-simula:before { content: 'Simula'; }
pre.src-tcl:before { content: 'tcl'; }
pre.src-tex:before { content: 'TeX'; }
pre.src-plain-tex:before { content: 'Plain TeX'; }
pre.src-verilog:before { content: 'Verilog'; }
pre.src-vhdl:before { content: 'VHDL'; }
pre.src-xml:before { content: 'XML'; }
pre.src-nxml:before { content: 'XML'; }
/* add a generic configuration mode; LaTeX export needs an additional
(add-to-list 'org-latex-listings-langs '(conf " ")) in .emacs */
pre.src-conf:before { content: 'Configuration File'; }
2014-10-29 20:03:53 +01:00
table { border-collapse:collapse; }
caption.t-above { caption-side: top; }
caption.t-bottom { caption-side: bottom; }
td, th { vertical-align:top; }
2015-07-05 21:33:45 +02:00
th.org-right { text-align: center; }
th.org-left { text-align: center; }
th.org-center { text-align: center; }
td.org-right { text-align: right; }
td.org-left { text-align: left; }
td.org-center { text-align: center; }
2014-10-29 20:03:53 +01:00
dt { font-weight: bold; }
2016-02-27 23:14:11 +01:00
.footpara { display: inline; }
2014-10-29 20:03:53 +01:00
.footdef { margin-bottom: 1em; }
.figure { padding: 1em; }
.figure p { text-align: center; }
.inlinetask {
padding: 10px;
border: 2px solid gray;
margin: 10px;
background: #ffffcc;
}
#org-div-home-and-up
{ text-align: right; font-size: 70%; white-space: nowrap; }
textarea { overflow-x: auto; }
.linenr { font-size: smaller }
.code-highlighted { background-color: #ffff00; }
.org-info-js_info-navigation { border-style: none; }
#org-info-js_console-label
{ font-size: 10px; font-weight: bold; white-space: nowrap; }
.org-info-js_search-highlight
{ background-color: #ffff00; color: #000000; font-weight: bold; }
2016-08-08 18:21:03 +02:00
.org-svg { width: 90%; }
2014-10-29 20:03:53 +01:00
/*]]>*/-->
< / style >
2016-08-08 18:42:34 +02:00
< link rel = "stylesheet" type = "text/css" href = "freedombone.css" / >
2014-10-29 20:03:53 +01:00
< script type = "text/javascript" >
/*
@licstart The following is the entire license notice for the
JavaScript code in this tag.
Copyright (C) 2012-2013 Free Software Foundation, Inc.
The JavaScript code in this tag is free software: you can
redistribute it and/or modify it under the terms of the GNU
General Public License (GNU GPL) as published by the Free Software
Foundation, either version 3 of the License, or (at your option)
any later version. The code is distributed WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU GPL for more details.
As additional permission under GNU GPL version 3 section 7, you
may distribute non-source (e.g., minimized or compacted) forms of
that code without the copy of the GNU GPL normally required by
section 4, provided you include this license notice and a URL
through which recipients can access the Corresponding Source.
@licend The above is the entire license notice
for the JavaScript code in this tag.
*/
<!-- /* --> <![CDATA[/*> <!-- */
function CodeHighlightOn(elem, id)
{
var target = document.getElementById(id);
if(null != target) {
elem.cacheClassElem = elem.className;
elem.cacheClassTarget = target.className;
target.className = "code-highlighted";
elem.className = "code-highlighted";
}
}
function CodeHighlightOff(elem, id)
{
var target = document.getElementById(id);
if(elem.cacheClassElem)
elem.className = elem.cacheClassElem;
if(elem.cacheClassTarget)
target.className = elem.cacheClassTarget;
}
/*]]>*///-->
< / script >
< / head >
< body >
< div id = "preamble" class = "status" >
< a name = "top" id = "top" > < / a >
< / div >
< div id = "content" >
2016-02-27 23:14:11 +01:00
< div class = "org-center" >
2016-01-07 15:51:37 +01:00
< div class = "figure" >
< p > < img src = "images/logo.png" alt = "logo.png" / >
< / p >
< / div >
< / div >
2015-12-15 22:45:46 +01:00
< center >
2016-01-07 16:00:30 +01:00
< h1 > Backups< / h1 >
2015-12-15 22:45:46 +01:00
< / center >
2014-10-29 20:03:53 +01:00
2016-02-27 23:14:11 +01:00
< div class = "org-center" >
2014-10-29 20:03:53 +01:00
< table border = "-1" cellspacing = "0" cellpadding = "6" rules = "groups" frame = "hsides" >
< colgroup >
2015-07-05 21:33:45 +02:00
< col class = "org-left" / >
2014-10-29 20:03:53 +01:00
< / colgroup >
< tbody >
< tr >
2016-10-31 17:24:49 +01:00
< td class = "org-left" > < a href = "#org5101793" > Backup keys< / a > < / td >
2014-10-29 20:03:53 +01:00
< / tr >
< tr >
2016-10-31 17:24:49 +01:00
< td class = "org-left" > < a href = "#orgbd04f75" > Backup to USB< / a > < / td >
2014-10-29 20:03:53 +01:00
< / tr >
< tr >
2016-10-31 17:24:49 +01:00
< td class = "org-left" > < a href = "#org3944959" > Restore from USB< / a > < / td >
2014-10-29 20:03:53 +01:00
< / tr >
< tr >
2016-10-31 17:24:49 +01:00
< td class = "org-left" > < a href = "#org4ffab21" > Distributed/remote backups< / a > < / td >
2015-09-29 11:21:55 +02:00
< / tr >
< tr >
2016-10-31 17:24:49 +01:00
< td class = "org-left" > < a href = "#org52a7ed8" > Restore from a friend< / a > < / td >
2014-10-29 20:03:53 +01:00
< / tr >
< / tbody >
< / table >
< / div >
2016-10-31 17:24:49 +01:00
< div id = "outline-container-org5101793" class = "outline-2" >
< h2 id = "org5101793" > Backup keys< / h2 >
< div class = "outline-text-2" id = "text-org5101793" >
2015-07-05 21:33:45 +02:00
< p >
2015-09-29 13:44:01 +02:00
As part of the Freedombone installation the GPG key used to encrypt backups will have been added to the < i > .gnupg< / i > keyring in your home directory. Ensure that you have a copy of all your keys by plugging in a LUKS encrypted USB drive and then running the commands:
2014-10-29 20:03:53 +01:00
< / p >
< div class = "org-src-container" >
2015-03-02 14:50:36 +01:00
< pre class = "src src-bash" > ssh username@domainname -p 2222
2014-10-29 20:03:53 +01:00
< / pre >
< / div >
2015-11-03 20:50:15 +01:00
< p >
2016-04-06 20:00:27 +02:00
Select < i > Administrator controls< / i > then < i > Backup and Restore< / i > then < i > Backup GPG key to USB drive (master keydrive)< / i > .
2015-11-03 20:50:15 +01:00
< / p >
2014-10-29 20:03:53 +01:00
< p >
2015-09-29 11:21:55 +02:00
Keep this USB drive in some safe place, since it will enable you to restore from previous backups.
2014-10-29 20:03:53 +01:00
< / p >
< p >
2015-11-03 20:50:15 +01:00
A pro-tip for the best possible security is to create multiple USB drives containing key fragments (fragment keydrive), and then to distribute them amongst your friends. In the worst case just ask for the drives back and you'll be able to reconstruct the backup key. You can do this by selecting < i > fragment keydrive< / i > and then repeating the process with a number of different USB drives (typically 4 or more).
2014-10-29 20:03:53 +01:00
< / p >
< / div >
< / div >
2016-10-31 17:24:49 +01:00
< div id = "outline-container-orgbd04f75" class = "outline-2" >
< h2 id = "orgbd04f75" > Backup to USB< / h2 >
< div class = "outline-text-2" id = "text-orgbd04f75" >
2014-10-29 20:03:53 +01:00
< p >
2015-09-29 11:21:55 +02:00
First and foremost - < b > encrypt your USB drives< / b > ! Even if you think you have "< i > nothing to hide< / i > " if you accidentally lose a USB thumb drive (it's easy to lose small objects) and it's not encrypted then potentially someone might be able to obtain enough information about you to commit identity fraud, take out loans, open bank accounts, etc. Use LUKS encryption. In Ubuntu you can do this using the < i > Disk Utility< / i > application. Some instructions < a href = "https://help.ubuntu.com/community/EncryptedFilesystemsOnRemovableStorage" > can be found here< / a > .
2014-10-29 20:03:53 +01:00
< / p >
< p >
2015-09-29 11:21:55 +02:00
Insert a USB thumb drive into the front socket of the Beaglebone Black.
< / p >
< p >
Log into the system and become the root user, then run the < i > backup< / i > command.
2014-10-29 20:03:53 +01:00
< / p >
< div class = "org-src-container" >
2015-03-02 14:50:36 +01:00
< pre class = "src src-bash" > ssh username@domainname -p 2222
2014-10-29 20:03:53 +01:00
< / pre >
< / div >
< p >
2016-04-06 20:00:27 +02:00
Select < i > Administrator controls< / i > then < i > Backup and Restore< / i > and then < i > Backup data to USB drive< / i > .
2015-11-03 20:50:15 +01:00
< / p >
< p >
Type in the LUKS password for the USB drive, then the backup will begin.
2015-09-29 11:21:55 +02:00
< / p >
< p >
When the backup ends remove the USB drive and keep it somewhere safe. Even if it gets lost or falls into the wrong hands the content is encrypted and so is unlikely to become a source of leaks.
2014-10-29 20:03:53 +01:00
< / p >
< / div >
< / div >
2016-10-31 17:24:49 +01:00
< div id = "outline-container-org3944959" class = "outline-2" >
< h2 id = "org3944959" > Restore from USB< / h2 >
< div class = "outline-text-2" id = "text-org3944959" >
2014-10-29 20:03:53 +01:00
< p >
2015-09-29 11:21:55 +02:00
Log into the system and become the root user:
2014-10-29 20:03:53 +01:00
< / p >
2015-09-29 11:21:55 +02:00
< div class = "org-src-container" >
< pre class = "src src-bash" > ssh username@domainname -p 2222
< / pre >
< / div >
2014-10-29 20:03:53 +01:00
< p >
2016-04-06 20:00:27 +02:00
Select < i > Administrator controls< / i > then if this is a new Freedombone installation then you will first need to restore your backup keys. That can be done by selecting < i > Backup and Restore< / i > then < i > Restore GPG key from USB keydrive< / i > . When that's done remove the keydrive and plug in the backup drive.
2014-10-29 20:03:53 +01:00
< / p >
2015-04-10 14:43:45 +02:00
< p >
2015-11-03 20:50:15 +01:00
Select < i > Backup and Restore< / i > then < i > Restore data from USB drive< / i > .
2015-04-10 14:43:45 +02:00
< / p >
2015-04-10 14:51:33 +02:00
< p >
2015-11-03 20:50:15 +01:00
Enter the LUKS password for the USB drive. When the restore is complete you can remove the USB drive.
2015-09-29 11:21:55 +02:00
< / p >
< / div >
< / div >
2016-10-31 17:24:49 +01:00
< div id = "outline-container-org4ffab21" class = "outline-2" >
< h2 id = "org4ffab21" > Distributed/remote backups< / h2 >
< div class = "outline-text-2" id = "text-org4ffab21" >
2015-09-29 11:21:55 +02:00
< p >
Distributed backups are a better way of ensuring the persistence of your data, such that even if your system gets stolen or destroyed then the data will still be recoverable from your friends. Since the backups are encrypted your friends (or anyone else with access to their systems) won't be able to read your backed up content even if their systems are subsequently compromised.
< / p >
< p >
2015-11-03 20:50:15 +01:00
Firstly you will need to have a user account on one or more of your friends servers. They don't necessarily need to be using Freedombone, just some version of GNU/Linux with ssh access. They can create a user account for you with the control panel on a Freedombone system or with the < b > adduser < username> < / b > command on any other system when logged in as root and then give you the username and password via a secure method, such as on paper, via an encrypted email, Tox or via an XMPP chat using OTR. Make sure that the password used is a strong one - preferably a long random string stored in a password manager - so that dictionary attacks will not be easy. Also for maximum resilience put your password manager file onto a USB thumb drive and carry it with you.
2015-04-10 14:51:33 +02:00
< / p >
< div class = "org-src-container" >
2015-09-29 11:21:55 +02:00
< pre class = "src src-bash" > ssh username@domainname -p 2222
2015-04-10 14:51:33 +02:00
< / pre >
< / div >
2015-11-03 20:50:15 +01:00
< p >
2016-04-06 20:00:27 +02:00
Select < i > Administrator controls< / i > then < i > Backup and Restore< / i > then < i > Configure remote backups< / i > .
2015-11-03 20:50:15 +01:00
< / p >
2015-04-10 14:43:45 +02:00
< p >
2015-09-29 11:21:55 +02:00
You can then enter the usernames, domains and ssh logins for one or more remote servers. The system will try to backup to these remote locations once per day.
2015-04-10 14:43:45 +02:00
< / p >
2014-10-29 20:03:53 +01:00
< / div >
< / div >
2016-10-31 17:24:49 +01:00
< div id = "outline-container-org52a7ed8" class = "outline-2" >
< h2 id = "org52a7ed8" > Restore from a friend< / h2 >
< div class = "outline-text-2" id = "text-org52a7ed8" >
< / div > < div id = "outline-container-org9783b56" class = "outline-3" >
< h3 id = "org9783b56" > With a completely new Freedombone installation< / h3 >
< div class = "outline-text-3" id = "text-org9783b56" >
2014-10-29 20:03:53 +01:00
< p >
2015-09-29 14:06:36 +02:00
This is the ultimate disaster recovery scenario in which you are beginning completely from scratch with new hardware and a new Freedombone installation (configured with the same username and domain names). It is assumed that the old hardware was destroyed, but that you have the backup key stored on a USB thumb drive.
2014-10-29 20:03:53 +01:00
< / p >
< p >
2015-04-10 14:43:45 +02:00
First log in and if you don't already have one then create a new friends list:
2014-10-29 20:03:53 +01:00
< / p >
< div class = "org-src-container" >
< pre class = "src src-bash" > ssh username@domainname -p 2222
< / pre >
< / div >
< p >
2016-04-06 20:00:27 +02:00
Select < i > Administrator controls< / i > then < i > Backup and Restore< / i > then < i > Restore GPG key from USB (master keydrive)< / i > . Select the username then plug in your keydrive and restore the key.
2015-09-29 13:21:47 +02:00
< / p >
< p >
2015-11-03 20:50:15 +01:00
Now select < i > Configure remote backups< / i > and configure the locations and logins for the remote server.
2014-10-29 20:03:53 +01:00
< / p >
< p >
2015-11-03 20:50:15 +01:00
Finally select < i > Restore from remote backup< / i > and enter the domain name of the remote server that you wish to restore from.
2014-10-29 20:03:53 +01:00
< / p >
< / div >
< / div >
2016-10-31 17:24:49 +01:00
< div id = "outline-container-orgf7adedb" class = "outline-3" >
< h3 id = "orgf7adedb" > On an existing Freedombone installation< / h3 >
< div class = "outline-text-3" id = "text-orgf7adedb" >
2014-10-29 20:03:53 +01:00
< p >
This is for more common situations in which maybe some data became corrupted and you want to restore it.
< / p >
< p >
Log in as root:
< / p >
< div class = "org-src-container" >
< pre class = "src src-bash" > ssh username@domainname -p 2222
< / pre >
< / div >
< p >
2016-04-06 20:00:27 +02:00
Select < i > Administrator controls< / i > then < i > Backup and Restore< / i > then < i > Restore from remote backup< / i > and enter the domain name of the remote server that you wish to restore from.
2014-10-29 20:03:53 +01:00
< / p >
2016-01-07 20:26:08 +01:00
< center >
Return to the < a href = "index.html" > home page< / a >
< / center >
2014-10-29 20:03:53 +01:00
< / div >
< / div >
< / div >
< / div >
< div id = "postamble" class = "status" >
< style type = "text/css" >
.back-to-top {
position: fixed;
bottom: 2em;
right: 0px;
text-decoration: none;
color: #000000;
background-color: rgba(235, 235, 235, 0.80);
font-size: 12px;
padding: 1em;
display: none;
}
.back-to-top:hover {
background-color: rgba(135, 135, 135, 0.50);
}
< / style >
< div class = "back-to-top" >
2016-10-31 17:24:49 +01:00
< a href = "#top" > Back to top< / a > | < a href = "mailto:bob@freedombone.net" > E-mail me< / a >
2014-10-29 20:03:53 +01:00
< / div >
< / div >
< / body >
< / html >
