Skip to content
This repository has been archived by the owner on May 17, 2021. It is now read-only.

mapdb Persistence

Frank Lazzarini edited this page Sep 13, 2016 · 7 revisions

Documentation of the mapdb Persistence Service

Introduction

The mapdb Persistence Service is based on simple key-value store http://www.mapdb.org/

Since

1.7.0

Features

The mapdb Persistence Service is a simple persistence provider that only saves the last value. The intention is to use this for "restoreOnStartup" items because all other persistence options have their drawbacks if values are only needed for reload.

They: a) grow in time b) require complex installs (mysql, influxdb, ...) c) rrd4j can't store all item types (only numeric types)

Querying the mapdb persistence service for historic values other than the last value make no sense since the persistence service can only store one value per item.

Installation

For installation of this persistence package please follow the same steps as if you would install a binding.

On Debian/Raspbian, you can use the following:

sudo apt-get update
sudo apt-get install openhab-addon-persistence-mapdb

Configuration

Place a persistence file called mapdb.persist in the ${openhab_home}/configurations/persistence folder.

See Persistence for details on configuring this file.

This persistence service can be configured in the "MapDB Persistence Service" section in openhab.cfg. You can set the commit interval.

If you would like MapDB to be the default persistence service, update persistence:default in openhab.cfg to the following:

persistence:default=mapdb

Troubleshooting

Restore of items after startup is taking some time. Rules are already started in parallel. Especially in rules that are started via "System started" trigger, it may happen that the restore is not completed resulting in undefined items. In these cases the use of restored items has to be delayed by a couple of seconds. This delay has to be determined experimentally.

Installation


User Interfaces


Community

(link to openHAB forum)

Development



Misc


Samples

A good source of inspiration and tips from users gathered over the years. Be aware that things may have changed since they were written and some examples might not work correctly.

Please update the wiki if you do come across any out of date information.

Use case examples

Collections of Rules on a single page

Single Rules

Scripts


Release Notes

Clone this wiki locally