Merge pull request #300 from jcabrerizo/feature/session-doc
Session expiring configuration
diff --git a/guide/ops/configuration/brooklyn_cfg.md b/guide/ops/configuration/brooklyn_cfg.md
index 8edb91f..9346d4a 100644
--- a/guide/ops/configuration/brooklyn_cfg.md
+++ b/guide/ops/configuration/brooklyn_cfg.md
@@ -185,9 +185,34 @@
[EntitlementManager]({{book.url.brooklyn_javadoc}}/org/apache/brooklyn/api/mgmt/entitlement/EntitlementManager.html).
-
## HTTPS Configuration
See [HTTPS Configuration]({{book.path.docs}}/ops/configuration/https.md) for general information on configuring HTTPS.
+## Session configuration
+
+Apache Brooklyn uses a util class, `org.apache.brooklyn.rest.util.MultiSessionAttributeAdapter` for ensuring requests
+in different bundles can get a consistent shared view of the data stored in the session.
+
+To choose the preferred session for a given request you should call one of the static methods `of` in the class.
+It will look on the server for a previously marked _preferred session handler_ and return the _preferred session_.
+If there is no _preferred session handler_, a new one will be created on the CXF bundle. If there is not a
+_preferred session_ on the _preferred session handler_, a new one will be created. The new elements will be marked as
+preferred.
+
+Any processing that wants to set, get or remove an attribute from the session should use the methods in this class,
+as opposed to calling request.getSession().
+
+This class marks as used the session on the other modules by resetting the max inactive interval for avoiding the server
+housekeeper service scavenging it due to inactivity. It also allows you to set up a max age time for the sessions,
+otherwise, the default configuration of the Jetty the server will be applied.
+
+The default value for the max inactive interval is 3600s but both values can be modified by adding the time in
+seconds as properties on `brooklyn.cfg`:
+
+```properties
+org.apache.brooklyn.server.maxSessionAge = 3600
+org.apache.brooklyn.server.maxInactiveInterval = 3600
+```
+
\ No newline at end of file
