Hey guys Matt here from MKSmartHouse.com and in this video I am going to show you the complete
way to backup your openhab server using windows.
[Intro]
Imagine that one day you open up your openHAB app on your phone and there is nothing there,
you then quickly go to your computer and try to ssh into the server but it just keeps saying
“Connection refused”.
At this point all is lost, all your hard work, all the time you put in, simply gone.
But, lucky for you that was just an imagination and it can all be simply avoided by following
this guide.
In this complete guide I will cover exactly how to backup your openhab server.
The way this backup will work is there will be an external flash drive plugged into the
raspberry pi and every day the raspberry pi will backup the openhab configuration and
user data files to the flash drive.
Now, this does solve a majority of the backup problem but what about the rest of the pi
or other non openhab related items.
Well, since we don't change much non openhab items on the raspberry pi after it is initially
set up, we will do a manually backup of the SD card onto the flash drive through the computer.
More on that later, let's just get started!
The items needed to complete this guide are the following: Number one, is a fully setup
any model of raspberry pi running openhab, I am using a raspberry pi 3 in a clear enclosure
that has a fan which generates a lot of air flow to the raspberry pi, I also installed
heatsinks on the pi for even more cooling.
I did this much cooling because I never want to run the risk of the pi overheating and
failing.
If you want a kit to protect your pi you can find it at mksmarthouse.com/shop.
If your pi is not setup check out my home automation server setup guide.
Number two is a computer running windows, if you have a mac computer then check out
my guide where I do this same guide except using a mac.
Number three, is an SD card reader of some kind that can read the type of SD card you
have in your pi, I only need a micro SD card reader but this one reads both sizes of sd
cards.
Lastly, number four you need a flash drive that is the same size as the sd card in your
pi my sd card is 32gb so I bought a 32gb flash drive.
The links to all the parts and guides mentioned are in the video description.
Speaking of links in the description, follow @mksmarthouse on twitter, instagram and snapchat
because those are the place where I give sneak peaks on when videos are releasing and also
where I ask for your input on topics and future videos.
1.
The first thing we have to do is plug the flash drive into the computer.
2.
Next open up file explorer and click on this PC.
The next part we are about to do will erase everything on the flash drive so make sure
you do not have anything important on it.
3.
Right click on your flash drive and press format
4.
In the volume label box type in OHBACKUP and in the filesystem select exFAT.
Click start.
5.
Next we need to head over to the written version of this guide on my website, link is in the
description.
6.
Here we need to download the OHBackup_script.
This is the script that we setup to automatically backup openhab every day at 12am and it will
also delete backups that over 30 days old in order to not fill up the flash drive completely.
7.
So go over to your downloads folder, double click on the zip file and then drag the script
to the flash drive we will use for backing up.
Once that is copied over eject the flash drive from your computer.
8.
Grab the flash drive from your computer and plug it into the raspberry pi.
9.
Before we get any further I just wanted to show you the basic ui of this server to demonstrate
that this pi is fully configured and has a sitemap with items in it in other words it
has a data on it.
I have already done this process to my main openhab server which is why I will be using
this pi.
10.
Now open up putty to ssh into the pi.
I recommend having the written version of this guide open so that way you can just copy
and paste the commands I am about to show you.
11.
The first thing we have to do is install support for exfat so type in sudo apt-get install
exfat-fuse and press enter.
You may need to type in your password and press enter.
11.1.
It will then ask if you want to confirm type y and press enter.
11.2.
Next enter super user so type in sudo su and press enter.
12.
Next we have to make a directory to mount the flash drive to, so type in mkdir /mnt/OHBackupDrive
and press enter.
13.
Now we have to find out what the UUID or id number of our flash drive is in order to mount
it to the directory so type in lsblk -o UUID,NAME,FSTYPE,SIZE,MOUNTPOINT,LABEL,MODEL and press enter.
14.
As you can see this is the 32gb flash drive I inserted into the pi and here is its UUID,
this is important so write it down somewhere.
15.
In order to mount the flash drive to the directory we need to modify the fstab so type in nano
/etc/fstab and press enter.
16.
Now at the bottom of the file type in UUID=C73C-F2E6 /mnt/OHBackupDrive auto defaults,auto,umask=000,users,rw
0 0 and press enter.
17.
Replace the UUID with the UUID of your flash drive.
18.
Once you changed the UUID press control x then y and enter to save.
19.
Now to execute the mounting procedure instead of rebooting type in mount -a and press enter.
20.
To confirm that it mounted to the directory type in df -k /mnt/OHBackupDrive and press
enter, you should see how much of the folder is used and some other information.
21.
Ok, now we are done with super user so type in exit and press enter.
22.
Next up is to copy the script from the flash drive to the bin folder do this by typing
in sudo cp /mnt/OHBackupDrive/OHBackup_script /bin and press enter.
23.
Next we need to give the script permission to execute, so type in sudo chmod u+x /bin/OHBackup_script
and press enter.
24.
To execute the script type in sudo /bin/OHBackup_script and press enter.
25.
You should see it say Openhab backup script and Success!
Backup made.
26.
Now, let's confirm that it did save so type in cd /mnt/OHBackupDrive and press enter then
type in ls and press enter.
You should see a zip file.
Great!
OpenHAB was successfully backed up.
27.
Now let’s make this backup process happen automatically everyday at 12 am.
28.
Type in sudo crontab -e and press enter.
It might ask you which editor to use, type in 2 to use nano and press enter.
29.
In the bottom of the file type in 0 0 * * * /bin/OHBackup_script what this does is execute the backup script
everyday at 12 am.
30.
Now press control x then y and enter to save.
31.
Like I mentioned in the beginning the script only backs up openhab stuff like your items,
things, sitemaps, configuration files etc, so stuff like the the mqtt server settings
will not be backed up, those things we need to backup manually.
I recommend backing up manually before/after every time you make a change to the raspberry
pi that is not directly integrated with openhab or when you make an openhab software update.
32.
In order to backup manually we need to first shut down the pi so type in sudo halt and
press enter.
33.
Once the pi is fully shut down and the lights are not blinking, unplug the power cable,
sd card and flash drive.
34.
Then plug the sd card and flash drive into the computer.
35.
Next open up win32diskimager and press yes in the pop up, if you don't know what win32diskimager
is then go check out my automation server setup guide windows version.
36.
Anyway click on the little folder icon, we are now going to choose where to save the
img, so choose your desktop and name the backup whatever you want, before you click save take
a look at what letter your sd card is and then click save.
37.
Now choose the letter of your sd card in the drop down
38.
Finally click read 39.
Once it finished open up file explorer and select your flash drive.
Right click, create a new folder, and name it SDCardBackups.
40.
Now, right click on the img file and hover over to send to and click compressed.
41.
Once it finished compressing drag the zip file from your desktop to the SDCardBackups
folder.
42.
Once it copies over you are completely done backing up your automation server.
43.You can now eject the flash drive as well as the sd card and plug them back into the
pi. 44.
Once they are plugged in you can connect power again.
45.
Congratulations, you are now safe from potential failures and part of the small percentage
of people that actually backup their OpenHAB server.
Help spread awareness of backing up openhab by sharing this video everywhere you possibly
can and save people from the headache of a failed server with no backup.
To demonstrate a change made after a manual backup I am going to make a modification to
the sitemap file.
As you can see the sitemap is changed.
Now for demonstration purposes I am going to issue a OpenHAB Runtime backup with the
command sudo /bin/OHBackup_script normally your backup would occur automatically at 12am
but for the purposes of this video I am going to back it up now.
You can also use this command if you are about to do any modifications to the configuration
files and want something to fall back on just in case you mess up.
For demonstration purposes I am going to simulate a raspberry pi failure that can happen to
anyone and results in a complete data loss.
[Hits raspberry pi with the hammer]
Now lets go over how to restore your openhab server if it did go through a failure.
1.
You would first plug both a new sd card either the same size or bigger than the original
and the OHBackup flash drive into the computer.
2.
Then open file explorer to your SDCardBackups folder and drag the backup you want to use
to your desktop.
3.
Once it finishes copying right click on the zip, click extract all and then extract.
4.
Then open up win32diskimager, and click yes in the pop up.
5.
Now select your sd card letter in the drop down and then click on the folder icon.
It will bring up the file explorer, navigate to your desktop, unzipped image folder and
click on the img file.
6.
Then click write backup.
Once it is formatted eject the flash drive and sd card and unplug both the sd card and
flash drive.
Plug both items items into the pi and plug in the power cable.
7.
Once the pi boots up ssh into it through terminal.
8.
The first thing we have to do is get into the backup drive and see which zip file we
want to restore to so type in cd /mnt/OHBackupDrive and press enter.
9.
To see what's inside type in ls and enter.
I am going to backup to the latest zip file which is this one.
10.
Next we need to stop openhab so type in sudo systemctl stop openhab2.service and press
enter.
11.
Now we are going to restore openhab so type in
sudo $OPENHAB_RUNTIME/bin/restore /mnt/OHBackupDrive/INSERTBACKUPNAME.zip before you hit enter replace INSERTBACKUPNAME
with the name of your backup and press enter.
12.
It will ask you to confirm, press y and enter.
13.
Finally, start up openhab again by typing in sudo systemctl start openhab2.service and
press enter.
14.
Your openhab server should be fully restored.
If I open up the basic UI you can see all the data is still there including the recently
made modification to the sitemap.
Finally, that concludes this complete guide to backing up and restoring your openhab server.
In the description you will find links to all the parts and devices used in the video
as well as a link to mksmarthouse.com/shop where I have a wide range of smart home kits
that you can put together such as blinds, led strips, sprinkler system and door sensors.
Alright thank you for watching and If you have any questions leave them in the comments
section below or head over to mksmarthouse.com/forum.
Good Bye!