Documentation Home
> Sun Cluster 3.0 U1 Data Services Developer's Guide
Sun Cluster 3.0 U1 Data Services Developer's Guide
Book Information
Preface
Chapter 1 Resource Management Overview
Sun Cluster Application Environment
RGM Model
Resource Types
Resources
Resource Groups
Resource Group Manager
Callback Methods
Programming Interfaces
Resource Management API
Data Service Development Library (DSDL)
SunPlex Agent Builder
Resource Group Manager Administrative Interface
SunPlex Manager
Administrative Commands
Chapter 2 Developing a Data Service
Analyzing the Application for Suitability
Determining the Interface to Use
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
Setting Resource and Resource Type Properties
Declaring Resource Type Properties
Declaring Resource Properties
Declaring Extension Properties
Implementing Callback Methods
Accessing Resource and Resource Group Property Information
Idempotency for Methods
Controlling an Application
Starting and Stopping a Resource
Deciding on the START and STOP Methods to Use
Initializing and Terminating a Resource
Monitoring a Resource
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
Using Keep-Alives
Testing HA Data Services
Coordinating Dependencies Between Resources
Chapter 3 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 4 Sample Data Service
Overview of the Sample Data Service
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
Chapter 5 Data Service Development Library (DSDL)
DSDL Overview
Managing Configuration Properties
Starting and Stopping a Data Service
Implementing a Fault Monitor
Accessing Network Address Information
Debugging the Resource Type Implementation
Chapter 6 Sample DSDL Resource Type Implementation
About the X Font Server
The Configuration File
The TCP Port Number
Naming Conventions
The SUNW.xfnts RTR File
The scds_initialize Call
The xfnts_start Method
Validating the Service Before Starting
Starting the Service
Returning From svc_start
The xfnts_stop Method
The xfnts_monitor_start Method
The xfnts_monitor_stop Method
The xfnts_monitor_check Method
The SUNW.xfnts Fault Monitor
The xfonts_probe Main Loop
The svc_probe Function
Determining the Fault Monitor Action
The xfnts_validate Method
The xfnts_update Method
Chapter 7 SunPlex Agent Builder
Using Agent Builder
Analyzing The Application
Installing and Configuring Agent Builder
Launching Agent Builder
Using the Command Line Version of Agent Builder
Using the Create Screen
Using the Configure Screen
Using the Agent Builder $hostnames Variable
Creating Resource Types With Multiple Independent Process Trees
Reusing Completed Work
Cloning an Existing Resource Type
Editing the Generated Source Code
Directory Structure
Outputs
Source and Binary Files
Utility Scripts and Man Pages
Support Files
Packaging Directory
The rtconfig File
Navigation
Browse Button
Menus
File Menu
Edit Menu
Chapter 8 DSDL Reference
DSDL Functions
General Purpose Functions
Property Functions
Network Resource-Access Functions
Fault Monitoring Using TCP Connections
PMF Functions
Fault Monitor Functions
Utility Functions
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 DSDL Sample Resource Type Code Listing
xfnts.c
xfnts_monitor_check Method
xfnts_monitor_start Method
xfnts_monitor_stop Method
xfnts_probe Method
xfnts_start Method
The xfnts_stop Method Code Listing
The xfnts_update Method Code Listing
The xfnts_validate Method Code Listing
Appendix D Legal RGM Names and Values
RGM Legal Names
RGM Values
Appendix E Requirements for Non-Cluster Aware Applications
Multihosted Data
Using Symbolic Links for Multihosted Data Placement
Host Names
Multihomed Hosts
Binding to INADDR_ANY Versus Binding to Specific IP Addresses
Client Retry
© 2010, Oracle Corporation and/or its affiliates