Documentation Home
> Sun Cluster 3.0 Data Services Developers' Guide
Sun Cluster 3.0 Data Services Developers' Guide
Book Information
Preface
Chapter 1 Resource Management API Overview
What Is Sun Cluster?
Resource Management Object Model
Resource Types
Resources
Resource Groups
Resource Group Manager
Resource Group Manager Administrative Interface
Callback Methods
Access Methods
Chapter 2 Using the Resource Management API
Setting Resource and Resource Type Properties
Using Callback Methods
Accessing Resource and Resource Group Property Information
Idempotency for Methods
Controlling an Application
Starting and Stopping a Resource
Initializing and Terminating a Resource
Monitoring a Resource
Resource Group Failover and Restart Control
Resource Properties to Support Monitors
Setting Status and Status_msg
Resource Group Properties to Support Monitors
Resource Type Properties to Support Monitors
Adding Message Logging to a Resource
Providing Process Management
Providing Administrative Support for a Resource
Implementing a Failover Resource
Implementing a Scalable Resource
Validation Checks For Scalable Services
Writing and Testing Data Services
Setting Up the Development Environment for Writing a Data Service
How to Set Up the Development Environment
How to Transfer a Data Service to a Cluster
Deciding on the START and STOP Methods to Use
Using Keep-Alives
Testing HA Data Services
Coordinating Dependencies Between Resources
Chapter 3 Data Service Requirements
Client-Server Environment
Crash Tolerance
Multihosted Data
Host Names
Multihomed Hosts
Binding to INADDR_ANY Versus Binding to Specific IP Addresses
Client Retry
Using Symbolic Links for Multihosted Data Placement
Chapter 4 Resource Management API Reference
RMAPI Access Methods
RMAPI Shell Commands
RMAPI Resource Commands
Resource Type Command
Resource Group Commands
Cluster Command
C Functions
Resource Functions
Resource Type Functions
Resource Group Functions
Cluster Functions
Utility Function
RMAPI Callback Methods
Method Arguments
Exit Codes
Control and Initialization Callback Methods
Administrative Support Methods
Net-Relative Callback Methods
Monitor Control Callback Methods
Chapter 5 Sample Application
Overview of the Sample Application
Defining the Resource Type Registration File
RTR File Overview
Resource Type Properties in the Sample RTR File
Resource Properties in the Sample RTR File
System-Defined Properties in the RTR File
Extension Properties in the RTR File
Providing Common Functionality to All Methods
Identifying the Command Interpreter and Exporting the Path
Declaring the PMF_TAG and SYSLOG_TAG Variables
Parsing the Function Arguments
Generating Error Messages
Obtaining Property Information
Controlling the Data Service
START Method
START Overview
Verifying the Configuration
Starting the Application
START Exit Status
STOP Method
STOP Overview
Stopping the Application
STOP Exit Status
Defining a Fault Monitor
Probe Program
Probe Overview
Obtaining Property Values
Checking the Reliability of the Service
Evaluating Restart Versus Failover
Restarting the Data Service
Probe Exit Status
MONITOR_START Method
MONITOR_START Overview
Starting the Probe
MONITOR_STOP Method
MONITOR_STOP Overview
Stopping the Monitor
MONITOR_STOP Exit Status
MONITOR_CHECK Method
Handling Property Updates
VALIDATE Method
VALIDATE Overview
VALIDATE Method Parsing Function
Validating Confdir
VALIDATE Exit Status
UPDATE Method
UPDATE Overview
Stopping the Monitor With UPDATE
Restarting the Monitor
UPDATE Exit Status
Appendix A Standard Properties
Resource Type Properties
Resource Properties
Resource Group Properties
Resource Property Attributes
Appendix B Sample Data Service Code Listings
Resource Type Registration File Listing
START Method Code Listing
STOP Method Code Listing
gettime Utility Code Listing
PROBE Program Code Listing
MONITOR_START Method Code Listing
MONITOR_STOP Method Code Listing
MONITOR_CHECK Method Code Listing
VALIDATE Method Code Listing
UPDATE Method Code Listing
Appendix C Legal RGM Names and Values
RGM Legal Names
RGM Values
© 2010, Oracle Corporation and/or its affiliates