Table of Contents Previous Next Index

Table of Contents

Product Installation
System Requirements
Supported Platforms
Solaris
Windows
Linux
Running GemFire in Pure Java Mode
Java Runtime Requirements
Other Software Requirements
Runtime Requirements
Installing and Uninstalling GemFire Enterprise
GemFire License Files
GemFire License Types
Obtaining Production and Development Licenses
Replacing An Invalid GemFire License
License Configuration and Deployment
GemFire Product Tree
GemFire Product Documentation
Overview of GemFire System Administration
Architecture of a GemFire Distributed System
Functional Overview
Operational Overview
GemFire Configuration and Deployment Files
GemFire Output Files
Startup and Shutdown
Management Tools
Tools for Monitoring and Analyzing System Operation
Log Files
GemFire Statistics
System Tuning
System Configuration
GemFire Configuration Files
Specifying the Configuration File Locations
Jar File Deployment
Configuring GemFire System Properties
Setting Attributes Inside the gemfire.properties Configuration File
Setting Attributes Outside the gemfire.properties File
System Properties in the gemfire.properties File
Configuring Member Discovery and Communication
Member Discovery
Peer Discovery
Client/Server Discovery
Using Locators For Peer and Client/Server Discovery
Using Multicast for Peer Discovery
Peer-to-Peer Messaging and Distribution
Choosing the Protocols to Use
Configuring Your Protocols
Client/Server Communication
Multi-Site Communication
Selecting a Network Adapter Through a Bind Address
Locators
Peer-to-Peer
Client/Server and Multi-site
Security
Starting a Distributed System for Authentication
Configuring Locators and Non-member Locators
Configuring Authentication
Starting the Cache Server
Authenticating Cache Server Credentials
Handling Server Authentication Errors
Client Authentication
Obtaining Client Credentials
Verifying the Client
Encrypting Credentials Using Diffie-Hellman
Handling Client Authentication Errors
Multi-Site Authentication
Obtaining Multi-Site Credentials
Verifying Multi-Site Credentials
JMX Agent Authentication
Authentication Using the LDAP and PKCS Samples
Using an LDAP Server for Client and Peer Authentication
Using PKCS for Encrypted Authentication
Configuring Authorization
The Authorization Callback
Pre-Operation Authorization
Post-Operation Authorization
Performance Considerations for Authorization Callbacks
Authorization Using the XmlAuthorization Sample
Configuring the XML Contents
The Authentication API
The Authorization API
Security Logging
Security Event Logging Levels
System Properties
Configuring SSL with GemFire
Security Components
Configuration Specifications
Application-Specific Configuration
Example Configuration and Startup
Using SSL With a JMX Agent
Run-time Operations
Starting and Stopping the Distributed System
Designing Your Startup and Shutdown Procedures
Startup and Shutdown Options
Distributed System Startup and Shutdown Sequence
Options for System Member Startup and Shutdown Behavior
Configuring and Running the GemFire Cache Server
Cache Server Configuration and Log Files
The cacheserver Command-Line Utility
Handling Network Outages
Creating Data Backup and Data Overflow Files
Region Data Backup and Overflow
Server Subscription Queue Overflow
Managing Memory
Memory Overhead Introduced by the Cache API
Calculating the Size of Your Data
Overhead of Application Objects
Managing Resources for Partitioned Regions
Adding an Extra Partition at Run Time
Removing a Partition From a Partitioned Region
Monitoring and Tuning the Distributed System
Monitoring Tools
System Member Performance
Distributed System Member
JVM Memory Settings
Garbage Collection
Connection Thread Settings
Slow Receivers with TCP/IP
Preventing Problems That Can Cause Slow Receivers
Managing Slow Receivers
Tuning to Reduce Slow distributed-ack Messages
Tuning Socket Communication
Setting Socket Buffer Sizes
Ephemeral TCP Port Limits
Making Sure You Have Enough Sockets
TCP/IP Peer-to-Peer Handshake Timeouts
Tuning UDP Communication
UDP Datagram Size
UDP Flow Control
UDP Retransmission Statistics
Tuning Multicast Communication
Provisioning Bandwidth for Multicast
Testing Multicast Speed Limits
Configuring Multicast Speed Limits
Run-time Considerations for Multicast
Troubleshooting the Multicast Tuning Process
Using JMX to Administer GemFire
Example Configuration
Starting the GemFire JMX Agent
Command-line Arguments
Admin Distributed System Properties
Distribution Locator Properties
E-Mail Notification Properties
Enabling, Disabling, and Configuring Connectors
HttpAdaptor
RMIConnectorServer
AdventNetSNMPAdaptor
SSL Communication
Properties and Log Files
The Agent Properties File
The Agent Log File
MBeans
Programming Example
Stopping the GemFire JMX Agent
GemFire System Logging
Overview of Logging
Logging Categories
The Log Message
Searching the Log Files
Logging Options
Log Level
Log File Name
Merging Log Files
Maximum Size of a Single Log File
Maximum Size of All Log Files
Troubleshooting and System Recovery
Producing Data Files for Troubleshooting
Diagnosing System Problems
Application or cache server process does not start
Application or cache server cannot join the distributed system
Can’t find a valid license file
Wrong license version
Wrong license type
License needs to be replaced
Member process seems to hang
Member process does not read settings from the gemfire.properties file
Cache isn’t configured properly
Can’t find the log file
OutOfMemoryError
PartitionedRegionStorageException
PartitionedRegionDistributionException
Application crashes without producing an exception
Timeout alert
Member produces SocketTimeoutException
Member logs ForcedDisconnectException, Cache and DistributedSystem forcibly closed
Members cannot see each other
Some new members are not seen by existing members
One part of the distributed system cannot see another part
Data distribution has stopped, though member processes are running
Distributed-ack operations take a very long time to complete
Slow system performance
Can’t get Windows performance data
System Failure and Recovery
Network Partitioning, Slow Response, and Member Removal Alerts
Recovering From Application or Cache Server Crashes
Recovery in a Peer-to-Peer Configuration
Recovery in a Client/Server Configuration
Recovering From Machine Crashes
Data Recovery for Partitioned Regions
Data Recovery for Distributed Regions
Data Recovery in a Client/Server Configuration
Recovering From Network Outages
Effect of Network Failure on Partitioned Regions
Effect of Network Failure on Distributed Regions
Effect of Network Failure on Client/Server Installations
Recovery
The gemfire Command-line Utility
Usage
Commands
System Statistics
Configuring Statistics
Examining Archived Statistics
Controlling the Size of Archive Files
GemFire Enterprise System Statistics
System Performance Statistics
Cache Performance Statistics Related to Transactions
Event Queue Statistics From Server-to-Client Communication
Partitioned Region Statistics