From 3e4a8495bd221a55655ecd11c8c48d040d78b78a Mon Sep 17 00:00:00 2001
From: Oliver Bertuch <o.bertuch@fz-juelich.de>
Date: Wed, 5 Dec 2018 16:36:12 +0100
Subject: [PATCH] Describe EJB timer usage for developers.

---
 .../source/developers/big-data-support.rst    |  4 ++++
 doc/sphinx-guides/source/developers/index.rst |  1 +
 .../source/developers/timers.rst              | 19 +++++++++++++++++++
 3 files changed, 24 insertions(+)
 create mode 100644 doc/sphinx-guides/source/developers/timers.rst

diff --git a/doc/sphinx-guides/source/developers/big-data-support.rst b/doc/sphinx-guides/source/developers/big-data-support.rst
index 567fb99ec7a..095f3a533fe 100644
--- a/doc/sphinx-guides/source/developers/big-data-support.rst
+++ b/doc/sphinx-guides/source/developers/big-data-support.rst
@@ -282,3 +282,7 @@ Available variables are:
 * ``minorVersion``
 * ``majorVersion``
 * ``releaseStatus``
+
+----
+
+Previous: :doc:`selinux` | Next: :doc:`timers`
\ No newline at end of file
diff --git a/doc/sphinx-guides/source/developers/index.rst b/doc/sphinx-guides/source/developers/index.rst
index 52bde9ee184..b5d44777815 100755
--- a/doc/sphinx-guides/source/developers/index.rst
+++ b/doc/sphinx-guides/source/developers/index.rst
@@ -31,3 +31,4 @@ Developer Guide
    geospatial
    selinux
    big-data-support
+   timers
diff --git a/doc/sphinx-guides/source/developers/timers.rst b/doc/sphinx-guides/source/developers/timers.rst
new file mode 100644
index 00000000000..b057a10496e
--- /dev/null
+++ b/doc/sphinx-guides/source/developers/timers.rst
@@ -0,0 +1,19 @@
+==========
+EJB Timers
+==========
+
+As described in :doc:`../admin/timers`, Dataverse uses EJB timers for scheduled jobs. This section is about the
+techniques used for scheduling.
+
+* :doc:`../admin/metadataexport` is done via ``@Schedule`` annotation on ``OAISetServiceBean.exportAllSets()`` and
+  ``DatasetServiceBean.exportAll()``. Fixed to 2AM local time every day, non persistent.
+* Harvesting is a bit more complicated. The timer is attached to ``HarvesterServiceBean.harvestEnabled()`` via
+  ``@Schedule`` annotation every hour at minute 50, non-persistent.
+  That method collects all enabled ``HarvestingClient`` and runs them.
+
+.. contents:: |toctitle|
+	:local:
+
+----
+
+Previous: :doc:`big-data-support`
\ No newline at end of file