Jump To Close Expand all Collapse all Table of contents Administration and Configuration Guide I. Introduction Expand section "I. Introduction" Collapse section "I. Introduction" 1. Setting up Red Hat JBoss Data Grid Expand section "1. Setting up Red Hat JBoss Data Grid" Collapse section "1. Setting up Red Hat JBoss Data Grid" 1.1. Prerequisites 1.2. Steps to Set up Red Hat JBoss Data Grid II. Set Up JVM Memory Management Expand section "II. Set Up JVM Memory Management" Collapse section "II. Set Up JVM Memory Management" 2. Set Up Eviction Expand section "2. Set Up Eviction" Collapse section "2. Set Up Eviction" 2.1. About Eviction 2.2. Eviction Strategies Expand section "2.2. Eviction Strategies" Collapse section "2.2. Eviction Strategies" 2.2.1. Eviction Strategies 2.2.2. LRU Eviction Algorithm Limitations 2.3. Using Eviction Expand section "2.3. Using Eviction" Collapse section "2.3. Using Eviction" 2.3.1. Using Eviction 2.3.2. Initialize Eviction 2.3.3. Eviction Configuration Examples 2.3.4. Utilizing Memory Based Eviction 2.3.5. Eviction and Passivation 3. Set Up Expiration Expand section "3. Set Up Expiration" Collapse section "3. Set Up Expiration" 3.1. About Expiration 3.2. Expiration Operations 3.3. Eviction and Expiration Comparison 3.4. Cache Entry Expiration Behavior 3.5. Configure Expiration 3.6. Troubleshooting Expiration III. Monitor Your Cache Expand section "III. Monitor Your Cache" Collapse section "III. Monitor Your Cache" 4. Set Up Logging Expand section "4. Set Up Logging" Collapse section "4. Set Up Logging" 4.1. About Logging 4.2. Supported Application Logging Frameworks Expand section "4.2. Supported Application Logging Frameworks" Collapse section "4.2. Supported Application Logging Frameworks" 4.2.1. Supported Application Logging Frameworks 4.2.2. About JBoss Logging 4.2.3. JBoss Logging Features 4.3. Boot Logging Expand section "4.3. Boot Logging" Collapse section "4.3. Boot Logging" 4.3.1. Boot Logging 4.3.2. Configure Boot Logging 4.3.3. Default Log File Locations 4.4. Logging Attributes Expand section "4.4. Logging Attributes" Collapse section "4.4. Logging Attributes" 4.4.1. About Log Levels 4.4.2. Supported Log Levels 4.4.3. About Log Categories 4.4.4. About the Root Logger 4.4.5. About Log Handlers 4.4.6. Log Handler Types 4.4.7. Selecting Log Handlers 4.4.8. About Log Formatters 4.5. Logging Sample Configurations Expand section "4.5. Logging Sample Configurations" Collapse section "4.5. Logging Sample Configurations" 4.5.1. Logging Sample Configuration Location 4.5.2. Sample XML Configuration for the Root Logger 4.5.3. Sample XML Configuration for a Log Category 4.5.4. Sample XML Configuration for a Console Log Handler 4.5.5. Sample XML Configuration for a File Log Handler 4.5.6. Sample XML Configuration for a Periodic Log Handler 4.5.7. Sample XML Configuration for a Size Log Handler 4.5.8. Sample XML Configuration for a Async Log Handler IV. Set Up Cache Modes Expand section "IV. Set Up Cache Modes" Collapse section "IV. Set Up Cache Modes" 5. Cache Modes Expand section "5. Cache Modes" Collapse section "5. Cache Modes" 5.1. Cache Modes 5.2. About Cache Containers 5.3. Local Mode Expand section "5.3. Local Mode" Collapse section "5.3. Local Mode" 5.3.1. Local Mode 5.3.2. Configure Local Mode 5.4. Clustered Modes Expand section "5.4. Clustered Modes" Collapse section "5.4. Clustered Modes" 5.4.1. Clustered Modes 5.4.2. Asynchronous and Synchronous Operations 5.4.3. About Asynchronous Communications 5.4.4. Cache Mode Troubleshooting Expand section "5.4.4. Cache Mode Troubleshooting" Collapse section "5.4.4. Cache Mode Troubleshooting" 5.4.4.1. Invalid Data in ReadExternal 5.4.4.2. Cluster Physical Address Retrieval 6. Set Up Distribution Mode Expand section "6. Set Up Distribution Mode" Collapse section "6. Set Up Distribution Mode" 6.1. About Distribution Mode 6.2. Distribution Mode’s Consistent Hash Algorithm 6.3. Locating Entries in Distribution Mode 6.4. Return Values in Distribution Mode 6.5. Configure Distribution Mode 6.6. Synchronous and Asynchronous Distribution 7. Set Up Replication Mode Expand section "7. Set Up Replication Mode" Collapse section "7. Set Up Replication Mode" 7.1. About Replication Mode 7.2. Optimized Replication Mode Usage 7.3. Configure Replication Mode 7.4. Synchronous and Asynchronous Replication Expand section "7.4. Synchronous and Asynchronous Replication" Collapse section "7.4. Synchronous and Asynchronous Replication" 7.4.1. Synchronous and Asynchronous Replication 7.4.2. Troubleshooting Asynchronous Replication Behavior 7.5. The Replication Queue Expand section "7.5. The Replication Queue" Collapse section "7.5. The Replication Queue" 7.5.1. The Replication Queue 7.5.2. Replication Queue Usage 7.6. About Replication Guarantees 7.7. Replication Traffic on Internal Networks 8. Set Up Invalidation Mode Expand section "8. Set Up Invalidation Mode" Collapse section "8. Set Up Invalidation Mode" 8.1. About Invalidation Mode 8.2. Configure Invalidation Mode 8.3. Synchronous/Asynchronous Invalidation 8.4. The L1 Cache and Invalidation 9. State Transfer Expand section "9. State Transfer" Collapse section "9. State Transfer" 9.1. State Transfer 9.2. Non-Blocking State Transfer 9.3. Suppress State Transfer via JMX 9.4. The rebalancingEnabled Attribute V. Enabling APIs Expand section "V. Enabling APIs" Collapse section "V. Enabling APIs" 10. Enabling APIs Declaratively Expand section "10. Enabling APIs Declaratively" Collapse section "10. Enabling APIs Declaratively" 10.1. Enabling APIs Declaratively 10.2. Batching API 10.3. Grouping API 10.4. Externalizable API Expand section "10.4. Externalizable API" Collapse section "10.4. Externalizable API" 10.4.1. The Externalizable API 10.4.2. Register the Advanced Externalizer (Declaratively) 10.4.3. Custom Externalizer ID Values Expand section "10.4.3. Custom Externalizer ID Values" Collapse section "10.4.3. Custom Externalizer ID Values" 10.4.3.1. Custom Externalizer ID Values 10.4.3.2. Customize the Externalizer ID (Declaratively) 11. Set Up and Configure the Infinispan Query API Expand section "11. Set Up and Configure the Infinispan Query API" Collapse section "11. Set Up and Configure the Infinispan Query API" 11.1. Set Up Infinispan Query Expand section "11.1. Set Up Infinispan Query" Collapse section "11.1. Set Up Infinispan Query" 11.1.1. Infinispan Query Dependencies in Library Mode 11.2. Indexing Modes Expand section "11.2. Indexing Modes" Collapse section "11.2. Indexing Modes" 11.2.1. Managing Indexes 11.2.2. Managing the Index in Local Mode 11.2.3. Managing the Index in Replicated Mode 11.2.4. Managing the Index in Distribution Mode 11.2.5. Managing the Index in Invalidation Mode 11.3. Directory Providers Expand section "11.3. Directory Providers" Collapse section "11.3. Directory Providers" 11.3.1. Directory Providers 11.3.2. RAM Directory Provider 11.3.3. Filesystem Directory Provider 11.3.4. Infinispan Directory Provider 11.4. Configure Indexing Expand section "11.4. Configure Indexing" Collapse section "11.4. Configure Indexing" 11.4.1. Configure the Index in Remote Client-Server Mode 11.4.2. Rebuilding the Index 11.5. Tuning the Index Expand section "11.5. Tuning the Index" Collapse section "11.5. Tuning the Index" 11.5.1. Near-Realtime Index Manager 11.5.2. Tuning Infinispan Directory 11.5.3. Per-Index Configuration 12. The Health Check API Expand section "12. The Health Check API" Collapse section "12. The Health Check API" 12.1. The Health Check API 12.2. Accessing the Health API using JMX 12.3. Accessing the Health Check API using the CLI 12.4. Accessing the Health Check API using the Management REST Interface VI. Remote Client-Server Mode Interfaces Expand section "VI. Remote Client-Server Mode Interfaces" Collapse section "VI. Remote Client-Server Mode Interfaces" 13. Remote Client-Server Mode Interfaces 14. The Hot Rod Interface Expand section "14. The Hot Rod Interface" Collapse section "14. The Hot Rod Interface" 14.1. About Hot Rod 14.2. The Benefits of Using Hot Rod over Memcached 14.3. Hot Rod Hash Functions 14.4. The Hot Rod Interface Connector Expand section "14.4. The Hot Rod Interface Connector" Collapse section "14.4. The Hot Rod Interface Connector" 14.4.1. The Hot Rod Interface Connector 14.4.2. Configure Hot Rod Connectors 15. The REST Interface Expand section "15. The REST Interface" Collapse section "15. The REST Interface" 15.1. The REST Interface 15.2. The REST Interface Connector Expand section "15.2. The REST Interface Connector" Collapse section "15.2. The REST Interface Connector" 15.2.1. The REST Interface Connector 15.2.2. Configure REST Connectors 16. The Memcached Interface Expand section "16. The Memcached Interface" Collapse section "16. The Memcached Interface" 16.1. The Memcached Interface 16.2. About Memcached Servers 16.3. Memcached Statistics 16.4. The Memcached Interface Connector Expand section "16.4. The Memcached Interface Connector" Collapse section "16.4. The Memcached Interface Connector" 16.4.1. The Memcached Interface Connector 16.4.2. Configure Memcached Connectors VII. Set Up Locking for the Cache Expand section "VII. Set Up Locking for the Cache" Collapse section "VII. Set Up Locking for the Cache" 17. Locking Expand section "17. Locking" Collapse section "17. Locking" 17.1. Locking 17.2. Configure Locking (Remote Client-Server Mode) 17.3. Configure Locking (Library Mode) 17.4. Locking Types Expand section "17.4. Locking Types" Collapse section "17.4. Locking Types" 17.4.1. About Optimistic Locking 17.4.2. About Pessimistic Locking 17.4.3. Pessimistic Locking Types 17.4.4. Explicit Pessimistic Locking Example 17.4.5. Implicit Pessimistic Locking Example 17.4.6. Configure Locking Mode (Remote Client-Server Mode) 17.4.7. Configure Locking Mode (Library Mode) 17.5. Locking Operations Expand section "17.5. Locking Operations" Collapse section "17.5. Locking Operations" 17.5.1. About the LockManager 17.5.2. About Lock Acquisition 17.5.3. About Concurrency Levels 18. Set Up Lock Striping Expand section "18. Set Up Lock Striping" Collapse section "18. Set Up Lock Striping" 18.1. About Lock Striping 18.2. Configure Lock Striping (Remote Client-Server Mode) 18.3. Configure Lock Striping (Library Mode) 19. Set Up Isolation Levels Expand section "19. Set Up Isolation Levels" Collapse section "19. Set Up Isolation Levels" 19.1. About Isolation Levels 19.2. About READ_COMMITTED 19.3. About REPEATABLE_READ VIII. Set Up and Configure a Cache Store Expand section "VIII. Set Up and Configure a Cache Store" Collapse section "VIII. Set Up and Configure a Cache Store" 20. Cache Stores Expand section "20. Cache Stores" Collapse section "20. Cache Stores" 20.1. Cache Stores 20.2. Cache Loaders and Cache Writers 20.3. Cache Store Configuration Expand section "20.3. Cache Store Configuration" Collapse section "20.3. Cache Store Configuration" 20.3.1. Configuring the Cache Store 20.3.2. Configure the Cache Store using XML (Library Mode) 20.3.3. About SKIP_CACHE_LOAD Flag 20.3.4. About the SKIP_CACHE_STORE Flag 20.3.5. About the SKIP_SHARED_CACHE_STORE Flag 20.4. Shared Cache Stores Expand section "20.4. Shared Cache Stores" Collapse section "20.4. Shared Cache Stores" 20.4.1. Shared Cache Stores 20.4.2. Invalidation Mode and Shared Cache Stores 20.4.3. The Cache Store and Cache Passivation 20.4.4. Application Cachestore Registration 20.5. Connection Factories Expand section "20.5. Connection Factories" Collapse section "20.5. Connection Factories" 20.5.1. Connection Factories 20.5.2. About ManagedConnectionFactory 20.5.3. About SimpleConnectionFactory 20.5.4. About PooledConnectionFactory 21. Cache Store Implementations Expand section "21. Cache Store Implementations" Collapse section "21. Cache Store Implementations" 21.1. Cache Stores 21.2. Cache Store Comparison 21.3. Cache Store Configuration Details (Library Mode) 21.4. Cache Store Configuration Details (Remote Client-Server Mode) 21.5. Single File Cache Store Expand section "21.5. Single File Cache Store" Collapse section "21.5. Single File Cache Store" 21.5.1. Single File Cache Store 21.5.2. Single File Store Configuration (Remote Client-Server Mode) 21.5.3. Single File Store Configuration (Library Mode) 21.5.4. Upgrade JBoss Data Grid Cache Stores 21.6. LevelDB Cache Store Expand section "21.6. LevelDB Cache Store" Collapse section "21.6. LevelDB Cache Store" 21.6.1. LevelDB Cache Store 21.6.2. Configuring LevelDB Cache Store (Remote Client-Server Mode) 21.6.3. LevelDB Cache Store Sample XML Configuration (Library Mode) 21.6.4. Configure a LevelDB Cache Store Using JBoss Operations Network 21.7. JDBC Based Cache Stores Expand section "21.7. JDBC Based Cache Stores" Collapse section "21.7. JDBC Based Cache Stores" 21.7.1. JDBC Based Cache Stores 21.7.2. JdbcBinaryStores Expand section "21.7.2. JdbcBinaryStores" Collapse section "21.7.2. JdbcBinaryStores" 21.7.2.1. JdbcBinaryStores 21.7.2.2. JdbcBinaryStore Configuration (Remote Client-Server Mode) 21.7.2.3. JdbcBinaryStore Configuration (Library Mode) 21.7.3. JdbcStringBasedStores Expand section "21.7.3. JdbcStringBasedStores" Collapse section "21.7.3. JdbcStringBasedStores" 21.7.3.1. JdbcStringBasedStores 21.7.3.2. JdbcStringBasedStore Configuration (Remote Client-Server Mode) 21.7.3.3. JdbcStringBasedStore Configuration (Library Mode) 21.7.3.4. JdbcStringBasedStore Multiple Node Configuration (Remote Client-Server Mode) 21.7.4. JdbcMixedStores Expand section "21.7.4. JdbcMixedStores" Collapse section "21.7.4. JdbcMixedStores" 21.7.4.1. JdbcMixedStores 21.7.4.2. JdbcMixedStore Configuration (Remote Client-Server Mode) 21.7.4.3. JdbcMixedStore Configuration (Library Mode) 21.7.5. Cache Store Troubleshooting Expand section "21.7.5. Cache Store Troubleshooting" Collapse section "21.7.5. Cache Store Troubleshooting" 21.7.5.1. IOExceptions with JdbcStringBasedStore 21.8. The Remote Cache Store Expand section "21.8. The Remote Cache Store" Collapse section "21.8. The Remote Cache Store" 21.8.1. Remote Cache Stores 21.8.2. Remote Cache Store Configuration (Remote Client-Server Mode) 21.8.3. Remote Cache Store Configuration (Library Mode) 21.8.4. Define the Outbound Socket for the Remote Cache Store 21.9. JPA Cache Store Expand section "21.9. JPA Cache Store" Collapse section "21.9. JPA Cache Store" 21.9.1. JPA Cache Stores 21.9.2. JPA Cache Store Sample XML Configuration (Library Mode) 21.9.3. Storing Metadata in the Database 21.9.4. Deploying JPA Cache Stores in Various Containers 21.10. Cassandra Cache Store Expand section "21.10. Cassandra Cache Store" Collapse section "21.10. Cassandra Cache Store" 21.10.1. Cassandra Cache Store 21.10.2. Enabling the Cassandra Cache Store 21.10.3. Cassandra Cache Store Sample XML Configuration (Remote Client-Server Mode) 21.10.4. Cassandra Cache Store Sample XML Configuration (Library Mode) 21.10.5. Cassandra Configuration Parameters 21.11. Custom Cache Stores Expand section "21.11. Custom Cache Stores" Collapse section "21.11. Custom Cache Stores" 21.11.1. Custom Cache Stores 21.11.2. Custom Cache Store Maven Archetype 21.11.3. Custom Cache Store Configuration (Remote Client-Server Mode) Expand section "21.11.3. Custom Cache Store Configuration (Remote Client-Server Mode)" Collapse section "21.11.3. Custom Cache Store Configuration (Remote Client-Server Mode)" 21.11.3.1. Custom Cache Store Configuration (Remote Client-Server Mode) 21.11.3.2. Option 1: Add Custom Cache Store using deployments (Remote Client-Server Mode) 21.11.3.3. Option 2: Add Custom Cache Store using the CLI (Remote Client-Server Mode) 21.11.3.4. Option 3: Add Custom Cache Store using JON (Remote Client-Server Mode) 21.11.4. Custom Cache Store Configuration (Library Mode) IX. Set Up Passivation Expand section "IX. Set Up Passivation" Collapse section "IX. Set Up Passivation" 22. Activation and Passivation Modes Expand section "22. Activation and Passivation Modes" Collapse section "22. Activation and Passivation Modes" 22.1. Activation and Passivation Modes 22.2. Passivation Mode Benefits 22.3. Configure Passivation 22.4. Evication and Passivation Expand section "22.4. Evication and Passivation" Collapse section "22.4. Evication and Passivation" 22.4.1. Eviction and Passivation 22.4.2. Eviction and Passivation Usage 22.4.3. Eviction Example when Passivation is Disabled 22.4.4. Eviction Example when Passivation is Enabled X. Set Up Cache Writing Expand section "X. Set Up Cache Writing" Collapse section "X. Set Up Cache Writing" 23. Cache Writing Modes Expand section "23. Cache Writing Modes" Collapse section "23. Cache Writing Modes" 23.1. Cache Writing Modes 23.2. Write-Through Caching Expand section "23.2. Write-Through Caching" Collapse section "23.2. Write-Through Caching" 23.2.1. Write-Through Caching 23.2.2. Write-Through Caching Benefits and Disadvantages 23.2.3. Write-Through Caching Configuration (Library Mode) 23.3. Write-Behind Caching Expand section "23.3. Write-Behind Caching" Collapse section "23.3. Write-Behind Caching" 23.3.1. Write-Behind Caching 23.3.2. About Unscheduled Write-Behind Strategy 23.3.3. Unscheduled Write-Behind Strategy Configuration (Remote Client-Server Mode) 23.3.4. Unscheduled Write-Behind Strategy Configuration (Library Mode) XI. Monitor Caches and Cache Managers Expand section "XI. Monitor Caches and Cache Managers" Collapse section "XI. Monitor Caches and Cache Managers" 24. Set Up Java Management Extensions (JMX) Expand section "24. Set Up Java Management Extensions (JMX)" Collapse section "24. Set Up Java Management Extensions (JMX)" 24.1. About Java Management Extensions (JMX) 24.2. Using JMX with Red Hat JBoss Data Grid 24.3. JMX Statistic Levels 24.4. Enable JMX for Cache Instances 24.5. Enable JMX for CacheManagers 24.6. Disabling the CacheStore via JMX When Using Rolling Upgrades 24.7. Multiple JMX Domains 24.8. MBeans Expand section "24.8. MBeans" Collapse section "24.8. MBeans" 24.8.1. MBeans 24.8.2. Understanding MBeans 24.8.3. Registering MBeans in Non-Default MBean Servers 25. Set Up JBoss Operations Network (JON) Expand section "25. Set Up JBoss Operations Network (JON)" Collapse section "25. Set Up JBoss Operations Network (JON)" 25.1. About JBoss Operations Network (JON) 25.2. Download JBoss Operations Network (JON) Expand section "25.2. Download JBoss Operations Network (JON)" Collapse section "25.2. Download JBoss Operations Network (JON)" 25.2.1. Prerequisites for Installing JBoss Operations Network (JON) 25.2.2. Download JBoss Operations Network 25.2.3. Remote JMX Port Values 25.2.4. Download JBoss Operations Network (JON) Plugin 25.3. JBoss Operations Network Server Installation 25.4. JBoss Operations Network Agent 25.5. JBoss Operations Network for Remote Client-Server Mode Expand section "25.5. JBoss Operations Network for Remote Client-Server Mode" Collapse section "25.5. JBoss Operations Network for Remote Client-Server Mode" 25.5.1. JBoss Operations Network for Remote Client-Server Mode 25.5.2. Installing the JBoss Operations Network Plug-in (Remote Client-Server Mode) 25.6. JBoss Operations Network Remote-Client Server Plugin Expand section "25.6. JBoss Operations Network Remote-Client Server Plugin" Collapse section "25.6. JBoss Operations Network Remote-Client Server Plugin" 25.6.1. JBoss Operations Network Plugin Metrics 25.6.2. JBoss Operations Network Plugin Operations 25.6.3. JBoss Operations Network Plugin Attributes 25.6.4. Create a New Cache Using JBoss Operations Network (JON) 25.7. JBoss Operations Network for Library Mode Expand section "25.7. JBoss Operations Network for Library Mode" Collapse section "25.7. JBoss Operations Network for Library Mode" 25.7.1. JBoss Operations Network for Library Mode 25.7.2. Installing the JBoss Operations Network Plug-in (Library Mode) 25.7.3. Monitoring of JBoss Data Grid Instances in Library Mode Expand section "25.7.3. Monitoring of JBoss Data Grid Instances in Library Mode" Collapse section "25.7.3. Monitoring of JBoss Data Grid Instances in Library Mode" 25.7.3.1. Prerequisites 25.7.3.2. Manually Adding JBoss Data Grid Instances in Library Mode 25.7.3.3. Monitor Custom Applications Using Library Mode Deployed On JBoss Enterprise Application Platform Expand section "25.7.3.3. Monitor Custom Applications Using Library Mode Deployed On JBoss Enterprise Application Platform" Collapse section "25.7.3.3. Monitor Custom Applications Using Library Mode Deployed On JBoss Enterprise Application Platform" 25.7.3.3.1. Monitor an Application Deployed in Standalone Mode 25.7.3.3.2. Monitor an Application Deployed in Domain Mode 25.8. JBoss Operations Network Plug-in Quickstart 25.9. Other Management Tools and Operations Expand section "25.9. Other Management Tools and Operations" Collapse section "25.9. Other Management Tools and Operations" 25.9.1. Other Management Tools and Operations 25.9.2. Accessing Data via URLs 25.9.3. Limitations of Map Methods XII. Red Hat JBoss Data Grid Web Administration Expand section "XII. Red Hat JBoss Data Grid Web Administration" Collapse section "XII. Red Hat JBoss Data Grid Web Administration" 26. Red Hat JBoss Data Grid Administration Console Expand section "26. Red Hat JBoss Data Grid Administration Console" Collapse section "26. Red Hat JBoss Data Grid Administration Console" 26.1. About JBoss Data Grid Administration Console 26.2. Red Hat JBoss Data Grid Administration Console Prerequisites 26.3. Red Hat JBoss Data Grid Administation Console Getting Started Expand section "26.3. Red Hat JBoss Data Grid Administation Console Getting Started" Collapse section "26.3. Red Hat JBoss Data Grid Administation Console Getting Started" 26.3.1. Red Hat JBoss Data Grid Administration Console Getting Started 26.3.2. Adding Management User 26.3.3. Logging in the JBoss Data Grid Administration Console 26.4. Dashboard View Expand section "26.4. Dashboard View" Collapse section "26.4. Dashboard View" 26.4.1. Dashboard View 26.4.2. Cache Containers View 26.4.3. Clusters View 26.4.4. Status Events View 26.5. Cache Administration Expand section "26.5. Cache Administration" Collapse section "26.5. Cache Administration" 26.5.1. Adding a New Cache 26.5.2. Editing Cache Configuration 26.5.3. Cache Statistics and Properties View 26.5.4. Enable and Disable Caches 26.5.5. Cache Flush and Clear 26.5.6. Server Tasks Execution 26.5.7. Server Tasks Expand section "26.5.7. Server Tasks" Collapse section "26.5.7. Server Tasks" 26.5.7.1. New Server Task 26.5.7.2. Server Tasks View 26.6. Cache Container Configuration Expand section "26.6. Cache Container Configuration" Collapse section "26.6. Cache Container Configuration" 26.6.1. Cache Container Configuration 26.6.2. Defining Protocol Buffer Schema 26.6.3. Transport Setting 26.6.4. Defining Thread Pools 26.6.5. Adding New Security Role 26.6.6. Creating Cache Configuration Template 26.7. Cluster Administration Expand section "26.7. Cluster Administration" Collapse section "26.7. Cluster Administration" 26.7.1. Cluster Nodes View 26.7.2. Cluster Nodes Mismatch 26.7.3. Cluster Rebalancing 26.7.4. Cluster Partition Handling 26.7.5. Cluster Events 26.7.6. Adding Node 26.7.7. Node Statistics and Properties View 26.7.8. Node Performance Metrics View 26.7.9. Disabling a Node 26.7.10. Cluster Shutdown and Restart Expand section "26.7.10. Cluster Shutdown and Restart" Collapse section "26.7.10. Cluster Shutdown and Restart" 26.7.10.1. Cluster Shutdown 26.7.10.2. Cluster Start XIII. Securing Data in Red Hat JBoss Data Grid Expand section "XIII. Securing Data in Red Hat JBoss Data Grid" Collapse section "XIII. Securing Data in Red Hat JBoss Data Grid" 27. Introduction Expand section "27. Introduction" Collapse section "27. Introduction" 27.1. Securing Data in Red Hat JBoss Data Grid 28. Red Hat JBoss Data Grid Security: Authorization and Authentication Expand section "28. Red Hat JBoss Data Grid Security: Authorization and Authentication" Collapse section "28. Red Hat JBoss Data Grid Security: Authorization and Authentication" 28.1. Red Hat JBoss Data Grid Security: Authorization and Authentication 28.2. Permissions 28.3. Role Mapping 28.4. Configuring Authentication and Role Mapping using Login Modules 28.5. Configuring Red Hat JBoss Data Grid for Authorization 28.6. Authorization Using a SecurityManager 28.7. SecurityManager in Java Expand section "28.7. SecurityManager in Java" Collapse section "28.7. SecurityManager in Java" 28.7.1. About the Java Security Manager 28.7.2. About Java Security Manager Policies 28.7.3. Write a Java Security Manager Policy 28.7.4. Run Red Hat JBoss Data Grid Server Within the Java Security Manager 28.8. Data Security for Remote Client Server Mode Expand section "28.8. Data Security for Remote Client Server Mode" Collapse section "28.8. Data Security for Remote Client Server Mode" 28.8.1. About Security Realms 28.8.2. Add a New Security Realm 28.8.3. Add a User to a Security Realm 28.8.4. Configuring Security Realms Declaratively 28.8.5. Loading Roles from LDAP for Authorization (Remote Client-Server Mode) 28.9. Securing Interfaces Expand section "28.9. Securing Interfaces" Collapse section "28.9. Securing Interfaces" 28.9.1. Hot Rod Interface Security Expand section "28.9.1. Hot Rod Interface Security" Collapse section "28.9.1. Hot Rod Interface Security" 28.9.1.1. Publish Hot Rod Endpoints as a Public Interface 28.9.1.2. Encryption of communication between Hot Rod Server and Hot Rod client 28.9.1.3. Securing Hot Rod to LDAP Server using SSL 28.9.1.4. User Authentication over Hot Rod Using SASL Expand section "28.9.1.4. User Authentication over Hot Rod Using SASL" Collapse section "28.9.1.4. User Authentication over Hot Rod Using SASL" 28.9.1.4.1. User Authentication over Hot Rod Using SASL 28.9.1.4.2. Configure Hot Rod Authentication (GSSAPI/Kerberos) 28.9.1.4.3. Configure Hot Rod Authentication (MD5) 28.9.1.4.4. Configure Hot Rod Using LDAP/Active Directory 28.9.1.4.5. Configure Hot Rod Authentication (X.509) 28.9.2. REST Interface Security Expand section "28.9.2. REST Interface Security" Collapse section "28.9.2. REST Interface Security" 28.9.2.1. Publish REST Endpoints as a Public Interface 28.9.2.2. Enable Security for the REST Endpoint 28.9.3. Memcached Interface Security Expand section "28.9.3. Memcached Interface Security" Collapse section "28.9.3. Memcached Interface Security" 28.9.3.1. Publish Memcached Endpoints as a Public Interface 28.10. Active Directory Authentication (Non-Kerberos) 28.11. Active Directory Authentication Using Kerberos (GSSAPI) 28.12. The Security Audit Logger Expand section "28.12. The Security Audit Logger" Collapse section "28.12. The Security Audit Logger" 28.12.1. The Security Audit Logger 28.12.2. Configure the Security Audit Logger (Library Mode) 28.12.3. Configure the Security Audit Logger (Remote Client-Server Mode) 28.12.4. Custom Audit Loggers 29. Security for Cluster Traffic Expand section "29. Security for Cluster Traffic" Collapse section "29. Security for Cluster Traffic" 29.1. Node Authentication and Authorization (Remote Client-Server Mode) Expand section "29.1. Node Authentication and Authorization (Remote Client-Server Mode)" Collapse section "29.1. Node Authentication and Authorization (Remote Client-Server Mode)" 29.1.1. Node Authentication and Authorization (Remote Client-Server Mode) 29.1.2. Configure Node Authentication for Cluster Security (DIGEST-MD5) 29.1.3. Configure Node Authentication for Cluster Security (GSSAPI/Kerberos) 29.2. Configure Node Security in Library Mode Expand section "29.2. Configure Node Security in Library Mode" Collapse section "29.2. Configure Node Security in Library Mode" 29.2.1. Configure Node Security in Library Mode 29.2.2. Simple Authorizing Callback Handler 29.2.3. Configure Node Authentication for Library Mode (DIGEST-MD5) 29.2.4. Configure Node Authentication for Library Mode (GSSAPI) 29.3. JGroups Encryption Expand section "29.3. JGroups Encryption" Collapse section "29.3. JGroups Encryption" 29.3.1. JGroups Encryption 29.3.2. Configuring JGroups Encryption Protocols 29.3.3. SYM_ENCRYPT: Using a Key Store 29.3.4. ASYM_ENCRYPT: Configured with Algorithms and Key Sizes 29.3.5. JGroups Encryption Configuration Parameters XIV. Command Line Tools Expand section "XIV. Command Line Tools" Collapse section "XIV. Command Line Tools" 30. Introduction Expand section "30. Introduction" Collapse section "30. Introduction" 30.1. Command Line Tools 31. Red Hat JBoss Data Grid CLIs Expand section "31. Red Hat JBoss Data Grid CLIs" Collapse section "31. Red Hat JBoss Data Grid CLIs" 31.1. JBoss Data Grid CLIs 31.2. Red Hat JBoss Data Grid Library Mode CLI Expand section "31.2. Red Hat JBoss Data Grid Library Mode CLI" Collapse section "31.2. Red Hat JBoss Data Grid Library Mode CLI" 31.2.1. Red Hat JBoss Data Grid Library Mode CLI 31.2.2. Start the Library Mode CLI (Server) 31.2.3. Start the Library Mode CLI (Client) 31.2.4. CLI Client Switches for the Command Line 31.2.5. Connect to the Application 31.3. Red Hat JBoss Data Grid Server CLI Expand section "31.3. Red Hat JBoss Data Grid Server CLI" Collapse section "31.3. Red Hat JBoss Data Grid Server CLI" 31.3.1. Red Hat Data Grid Server Mode CLI 31.3.2. Start the Server Mode CLI 31.4. CLI Commands Expand section "31.4. CLI Commands" Collapse section "31.4. CLI Commands" 31.4.1. CLI Commands 31.4.2. The abort Command 31.4.3. The begin Command 31.4.4. The cache Command 31.4.5. The clearcache Command 31.4.6. The commit Command 31.4.7. The container Command 31.4.8. The create Command 31.4.9. The deny Command 31.4.10. The disconnect Command 31.4.11. The encoding Command 31.4.12. The end Command 31.4.13. The evict Command 31.4.14. The get Command 31.4.15. The grant Command 31.4.16. The info Command 31.4.17. The locate Command 31.4.18. The put Command 31.4.19. The replace Command 31.4.20. The roles command 31.4.21. The rollback Command 31.4.22. The site Command 31.4.23. The start Command 31.4.24. The stats Command 31.4.25. The upgrade Command 31.4.26. The version Command XV. Other Red Hat JBoss Data Grid Functions Expand section "XV. Other Red Hat JBoss Data Grid Functions" Collapse section "XV. Other Red Hat JBoss Data Grid Functions" 32. Set Up the L1 Cache Expand section "32. Set Up the L1 Cache" Collapse section "32. Set Up the L1 Cache" 32.1. About the L1 Cache 32.2. L1 Cache Configuration Expand section "32.2. L1 Cache Configuration" Collapse section "32.2. L1 Cache Configuration" 32.2.1. L1 Cache Configuration (Library Mode) 32.2.2. L1 Cache Configuration (Remote Client-Server Mode) 33. Set Up Transactions Expand section "33. Set Up Transactions" Collapse section "33. Set Up Transactions" 33.1. About Transactions Expand section "33.1. About Transactions" Collapse section "33.1. About Transactions" 33.1.1. About Transactions 33.1.2. About the Transaction Manager 33.1.3. XA Resources and Synchronizations 33.1.4. Optimistic and Pessimistic Transactions 33.1.5. Write Skew Checks 33.1.6. Transactions Spanning Multiple Cache Instances 33.2. Configure Transactions Expand section "33.2. Configure Transactions" Collapse section "33.2. Configure Transactions" 33.2.1. Configure Transactions (Library Mode) 33.2.2. Configure Transactions (Remote Client-Server Mode) 33.3. Transaction Recovery Expand section "33.3. Transaction Recovery" Collapse section "33.3. Transaction Recovery" 33.3.1. Transaction Recovery 33.3.2. Transaction Recovery Process 33.3.3. Transaction Recovery Example 33.4. Deadlock Detection Expand section "33.4. Deadlock Detection" Collapse section "33.4. Deadlock Detection" 33.4.1. Deadlock Detection 33.4.2. Enable Deadlock Detection 34. Configure JGroups Expand section "34. Configure JGroups" Collapse section "34. Configure JGroups" 34.1. About JGroups 34.2. Configure Red Hat JBoss Data Grid Interface Binding (Remote Client-Server Mode) Expand section "34.2. Configure Red Hat JBoss Data Grid Interface Binding (Remote Client-Server Mode)" Collapse section "34.2. Configure Red Hat JBoss Data Grid Interface Binding (Remote Client-Server Mode)" 34.2.1. Interfaces 34.2.2. Binding Sockets Expand section "34.2.2. Binding Sockets" Collapse section "34.2.2. Binding Sockets" 34.2.2.1. Binding Sockets 34.2.2.2. Binding a Single Socket Example 34.2.2.3. Binding a Group of Sockets Example 34.2.3. Configure JGroups Socket Binding 34.3. Configure JGroups (Library Mode) Expand section "34.3. Configure JGroups (Library Mode)" Collapse section "34.3. Configure JGroups (Library Mode)" 34.3.1. Configure JGroups for Clustered Modes 34.3.2. JGroups Transport Protocols Expand section "34.3.2. JGroups Transport Protocols" Collapse section "34.3.2. JGroups Transport Protocols" 34.3.2.1. JGroups Transport Protocols 34.3.2.2. The UDP Transport Protocol 34.3.2.3. The TCP Transport Protocol 34.3.2.4. Using the TCPPing Protocol 34.3.3. Pre-Configured JGroups Files Expand section "34.3.3. Pre-Configured JGroups Files" Collapse section "34.3.3. Pre-Configured JGroups Files" 34.3.3.1. Pre-Configured JGroups Files 34.3.3.2. default-jgroups-udp.xml 34.3.3.3. default-jgroups-tcp.xml 34.3.3.4. default-jgroups-ec2.xml 34.3.3.5. default-jgroups-google.xml 34.4. Test Multicast Using JGroups Expand section "34.4. Test Multicast Using JGroups" Collapse section "34.4. Test Multicast Using JGroups" 34.4.1. Test Multicast Using JGroups 34.4.2. Testing With Different Red Hat JBoss Data Grid Versions 34.4.3. Testing Multicast Using JGroups 35. Use Red Hat JBoss Data Grid with Amazon Web Services Expand section "35. Use Red Hat JBoss Data Grid with Amazon Web Services" Collapse section "35. Use Red Hat JBoss Data Grid with Amazon Web Services" 35.1. The S3_PING JGroups Discovery Protocol 35.2. S3_PING Configuration Options Expand section "35.2. S3_PING Configuration Options" Collapse section "35.2. S3_PING Configuration Options" 35.2.1. S3_PING Configuration Options 35.2.2. Using Private S3 Buckets 35.2.3. Using Pre-Signed URLs Expand section "35.2.3. Using Pre-Signed URLs" Collapse section "35.2.3. Using Pre-Signed URLs" 35.2.3.1. Using Pre-Signed URLs 35.2.3.2. Generating Pre-Signed URLs 35.2.3.3. Set Pre-Signed URLs Using the Command Line 35.2.4. Using Public S3 Buckets 35.3. Utilizing an Elastic IP Address 36. Use Red Hat JBoss Data Grid with Google Compute Engine Expand section "36. Use Red Hat JBoss Data Grid with Google Compute Engine" Collapse section "36. Use Red Hat JBoss Data Grid with Google Compute Engine" 36.1. The GOOGLE_PING Protocol 36.2. GOOGLE_PING Configuration Expand section "36.2. GOOGLE_PING Configuration" Collapse section "36.2. GOOGLE_PING Configuration" 36.2.1. GOOGLE_PING Configuration 36.2.2. Starting the Server in Google Compute Engine 36.3. Utilizing a Static IP Address 37. Integration with the Spring Framework Expand section "37. Integration with the Spring Framework" Collapse section "37. Integration with the Spring Framework" 37.1. Integration with the Spring Framework 37.2. Enabling Spring Cache Support Declaratively (Library Mode) 37.3. Enabling Spring Cache Support Declaratively (Remote Client-Server Mode) 38. High Availability Using Server Hinting Expand section "38. High Availability Using Server Hinting" Collapse section "38. High Availability Using Server Hinting" 38.1. High Availability Using Server Hinting 38.2. Establishing Server Hinting with JGroups 38.3. Configure Server Hinting (Remote Client-Server Mode) 38.4. Configure Server Hinting (Library Mode) 39. Set Up Cross-Datacenter Replication Expand section "39. Set Up Cross-Datacenter Replication" Collapse section "39. Set Up Cross-Datacenter Replication" 39.1. Cross-Datacenter Replication 39.2. Cross-Datacenter Replication Operations 39.3. Configure Cross-Datacenter Replication Expand section "39.3. Configure Cross-Datacenter Replication" Collapse section "39.3. Configure Cross-Datacenter Replication" 39.3.1. Configure Cross-Datacenter Replication (Remote Client-Server Mode) 39.3.2. Configure Cross-Datacenter Replication (Library Mode) Expand section "39.3.2. Configure Cross-Datacenter Replication (Library Mode)" Collapse section "39.3.2. Configure Cross-Datacenter Replication (Library Mode)" 39.3.2.1. Configure Cross-Datacenter Replication Declaratively 39.4. Taking a Site Offline Expand section "39.4. Taking a Site Offline" Collapse section "39.4. Taking a Site Offline" 39.4.1. Taking a Site Offline 39.4.2. Taking a Site Offline 39.4.3. Taking a Site Offline via JBoss Operations Network (JON) 39.4.4. Taking a Site Offline via the CLI 39.4.5. Bring a Site Back Online 39.5. State Transfer Between Sites Expand section "39.5. State Transfer Between Sites" Collapse section "39.5. State Transfer Between Sites" 39.5.1. State Transfer Between Sites 39.5.2. Active-Passive State Transfer 39.5.3. Active-Active State Transfer 39.5.4. State Transfer Configuration 39.6. Configure Multiple Site Masters Expand section "39.6. Configure Multiple Site Masters" Collapse section "39.6. Configure Multiple Site Masters" 39.6.1. Configure Multiple Site Masters 39.6.2. Multiple Site Master Operations 39.6.3. Configure Multiple Site Masters (Remote Client-Server Mode) 39.6.4. Configure Multiple Site Masters (Library Mode) 39.7. Cross-Datacenter Replication Concerns 40. Rolling Upgrades Expand section "40. Rolling Upgrades" Collapse section "40. Rolling Upgrades" 40.1. Rolling Upgrades 40.2. Rolling Upgrades Using Hot Rod 40.3. Rolling Upgrades Using REST 40.4. RollingUpgradeManager Operations 40.5. RemoteCacheStore Parameters for Rolling Upgrades Expand section "40.5. RemoteCacheStore Parameters for Rolling Upgrades" Collapse section "40.5. RemoteCacheStore Parameters for Rolling Upgrades" 40.5.1. rawValues and RemoteCacheStore 40.5.2. hotRodWrapping 41. Externalize Sessions Expand section "41. Externalize Sessions" Collapse section "41. Externalize Sessions" 41.1. Externalize Sessions 41.2. Externalize HTTP Session from JBoss EAP to JBoss Data Grid 41.3. Externalize HTTP Sessions from JBoss Web Server (JWS) to JBoss Data Grid Expand section "41.3. Externalize HTTP Sessions from JBoss Web Server (JWS) to JBoss Data Grid" Collapse section "41.3. Externalize HTTP Sessions from JBoss Web Server (JWS) to JBoss Data Grid" 41.3.1. Externalize HTTP Session from JBoss Web Server (JWS) to JBoss Data Grid 41.3.2. Prerequisites 41.3.3. Installation 41.3.4. Session Management Details 41.3.5. Configure the JBoss Web Server Session Manager 42. Data Interoperability Expand section "42. Data Interoperability" Collapse section "42. Data Interoperability" 42.1. Protocol Interoperability Expand section "42.1. Protocol Interoperability" Collapse section "42.1. Protocol Interoperability" 42.1.1. Enabling Compatibility Mode 43. Handling Network Partitions (Split Brain) Expand section "43. Handling Network Partitions (Split Brain)" Collapse section "43. Handling Network Partitions (Split Brain)" 43.1. Network Partition Recovery 43.2. Detecting and Recovering from a Split-Brain Problem 43.3. Split Brain Timing: Detecting a Split 43.4. Split Brain Timing: Recovering From a Split 43.5. Detecting and Recovering from Successive Crashed Nodes 43.6. Network Partition Recovery Examples Expand section "43.6. Network Partition Recovery Examples" Collapse section "43.6. Network Partition Recovery Examples" 43.6.1. Network Partition Recovery Examples 43.6.2. Distributed 4-Node Cache Example With 3 Owners 43.6.3. Distributed 4-Node Cache Example With 2 Owners 43.6.4. Distributed 5-Node Cache Example With 3 Owners 43.6.5. Replicated 4-Node Cache Example With 4 Owners 43.6.6. Replicated 5-Node Cache Example With 5 Owners 43.6.7. Replicated 8-Node Cache Example With 8 Owners 43.7. Configure Partition Handling A. Recommended JGroups Values for JBoss Data Grid Expand section "A. Recommended JGroups Values for JBoss Data Grid" Collapse section "A. Recommended JGroups Values for JBoss Data Grid" A.1. Supported JGroups Protocols A.2. TCP Default and Recommended Values A.3. UDP Default and Recommended Values A.4. The TCPGOSSIP JGroups Protocol A.5. TCPGOSSIP Configuration Options A.6. JBoss Data Grid JGroups Configuration Files B. Hotrod.Properties Expand section "B. Hotrod.Properties" Collapse section "B. Hotrod.Properties" B.1. Hotrod.Properties C. Connecting with JConsole Expand section "C. Connecting with JConsole" Collapse section "C. Connecting with JConsole" C.1. Connect to JDG via JConsole D. JMX MBeans in Red Hat JBoss Data Grid Expand section "D. JMX MBeans in Red Hat JBoss Data Grid" Collapse section "D. JMX MBeans in Red Hat JBoss Data Grid" D.1. Activation D.2. Cache D.3. CacheContainerStats D.4. CacheLoader D.5. CacheManager D.6. CacheStore D.7. ClusterCacheStats D.8. DeadlockDetectingLockManager D.9. DistributionManager D.10. Interpreter D.11. Invalidation D.12. LockManager D.13. LocalTopologyManager D.14. MassIndexer D.15. Passivation D.16. RecoveryAdmin D.17. RollingUpgradeManager D.18. RpcManager D.19. StateTransferManager D.20. Statistics D.21. Transactions D.22. Transport D.23. XSiteAdmin E. Configuration Recommendations Expand section "E. Configuration Recommendations" Collapse section "E. Configuration Recommendations" E.1. Timeout Values F. Performance Recommendations Expand section "F. Performance Recommendations" Collapse section "F. Performance Recommendations" F.1. Concurrent Startup for Large Clusters G. References Expand section "G. References" Collapse section "G. References" G.1. About Consistency G.2. About Consistency Guarantee G.3. About JBoss Cache G.4. About RELAY2 G.5. About Return Values G.6. About Runnable Interfaces G.7. About Two Phase Commit (2PC) G.8. About Key-Value Pairs G.9. Requesting a Full Byte Array Legal Notice Settings Close Language: English Format: Multi-page Single-page PDF Format: Multi-page Single-page PDF Language and Page Formatting Options Language: English Format: Multi-page Single-page PDF Format: Multi-page Single-page PDF Part VI. Remote Client-Server Mode Interfaces Previous Next