Merge branch '3.x'

Author: nebhale

docs/container-tomcat.md

@@ -91,6 +91,21 @@ By default, the Tomcat instance is configured to store all Sessions and their da
 ### Redis
 To enable Redis-based session replication, simply bind a Redis service containing a name, label, or tag that has `session-replication` as a substring.
 
+### Pivotal Cloud Cache
+To enable session state caching on 'Pivotal Cloud Cache', bind to a 'Pivotal Cloud Cache' service instance who's name either ends in `-session-replication` or is tagged with `session-replication`.
+
+Service instances can be created with a tag:
+
+```sh
+$ cf create-service p-cloudcache my-service-instance -t session-replication
+```
+
+or existing service instances can be given a tag:
+
+```sh
+$ cf update-service new-service-instance -t session-replication
+```
+
 ## Managing Entropy
 Entropy from `/dev/random` is used heavily to create session ids, and on startup for initializing `SecureRandom`, which can then cause instances to fail to start in time (see the [Tomcat wiki]). Also, the entropy is shared so it's possible for a single app to starve the DEA of entropy and cause apps in other containers that make use of entropy to be blocked.
 If this is an issue then configuring `/dev/urandom` as an alternative source of entropy may help. It is unlikely, but possible, that this may cause some security issues which should be taken in to account.