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