iii
Table of Contents
1. Introduction ........................................................................................................................................... 1
1.1. Getting Started (Tutorial) .............................................................................................................. 1
2. Distributed Data Structures ...................................................................................................................... 4
2.1. Distributed Queue ........................................................................................................................ 4
2.2. Distributed Topic ......................................................................................................................... 6
2.3. Distributed Map ........................................................................................................................... 6
2.3.1. Backups ........................................................................................................................... 7
2.3.2. Eviction ........................................................................................................................... 8
2.3.3. Persistence ...................................................................................................................... 10
2.3.4. Query ............................................................................................................................ 11
2.3.5. Near Cache ..................................................................................................................... 14
2.3.6. Entry Statistics ................................................................................................................ 15
2.3.7. Indexing ......................................................................................................................... 16
2.4. Distributed MultiMap .................................................................................................................. 16
2.5. Distributed Set ........................................................................................................................... 17
2.6. Distributed List .......................................................................................................................... 17
2.7. Distributed Lock ........................................................................................................................ 18
2.8. Distributed Events ...................................................................................................................... 18
3. Elastic Memory
(Enterprise Edition Only)
......................................................................................................... 20
4. Security
(Enterprise Edition Only)
.................................................................................................................... 21
4.1. Credentials ................................................................................................................................ 21
4.2. ClusterLoginModule ................................................................................................................... 22
4.3. Cluster Member Security ............................................................................................................. 23
4.4. Native Client Security ................................................................................................................. 24
4.4.1. Authentication ................................................................................................................. 24
4.4.2. Authorization .................................................................................................................. 24
4.4.3. Permissions ..................................................................................................................... 26
5. Data Affinity ....................................................................................................................................... 30
6. Monitoring with JMX ............................................................................................................................ 33
7. Cluster Utilities .................................................................................................................................... 35
7.1. Cluster Interface ......................................................................................................................... 35
7.2. Cluster-wide Id Generator ............................................................................................................ 35
7.3. LiteMember .............................................................................................................................. 35
8. Transactions ......................................................................................................................................... 36
8.1. Transaction Interface .................................................................................................................. 36
8.2. J2EE Integration ........................................................................................................................ 36
8.2.1. Resource Adapter Configuration ......................................................................................... 37
8.2.2. Sample Glassfish v3 Web Application Configuration .............................................................. 38
8.2.3. Sample JBoss Web Application Configuration ...................................................................... 38
9. Distributed Executor Service .................................................................................................................. 39
9.1. Distributed Execution .................................................................................................................. 39
9.2. Execution Cancellation ................................................................................................................ 40
9.3. Execution Callback ..................................................................................................................... 41
10. Http Session Clustering with HazelcastWM ............................................................................................. 43
11. WAN Replication ................................................................................................................................ 46
12. Configuration ..................................................................................................................................... 48
12.1. Creating Separate Clusters ......................................................................................................... 49
12.2. Network Configuration .............................................................................................................. 50
12.2.1. Configuring TCP/IP Cluster ............................................................................................. 50
12.2.2. Specifying Network Interfaces .......................................................................................... 50
12.2.3. EC2 Auto Discovery ....................................................................................................... 51
12.2.4. Network Partitioning (Split-Brain Syndrome) ...................................................................... 51
12.2.5. SSL ............................................................................................................................. 53
12.2.6. Encryption .................................................................................................................... 54
12.2.7. Socket Interceptor .......................................................................................................... 55