Skip to content

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.

feature overview

Installation

Setup intro

Linux and OS X

Windows

FreeBSD


Configuration

Automation*

User Interfaces

Persistence


Community

(link to openHAB forum)

Development


Bindings


Application Integration

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.

Binding configurations

Use case examples

Item definition examples

Sitemap definition examples

Collections of Rules on a single page

Single Rules

Scripts

Syntax highlighting for external editors


Release Notes

Clone this wiki locally
You can’t perform that action at this time.