Documentation Home
> Sun Cluster Data Services Developer's Guide for Solaris OS
Sun Cluster Data Services Developer's Guide for Solaris OS
Book Information
Index
Numbers and Symbols
A
B
C
D
E
F
G
H
I
J
K
L
M
N
O
P
R
S
T
U
V
W
X
Preface
Chapter 1 Overview of Resource Management
Sun Cluster Application Environment
RGM Model
Resource Types
Resources
Resource Groups
Resource Group Manager
Callback Methods
Programming Interfaces
RMAPI
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
Setting Up the Development Environment
Transferring 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
Generic Data Service
Controlling an Application
Starting and Stopping a Resource
Deciding Which Start and Stop Methods to Use
Init, Fini, and Boot Methods
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 Upgrading a Resource Type
Overview
Resource Type Registration File
Resource Type Name
Directives
Changing the RT_Version in an RTR file
Resource Type Names in Earlier Versions of Sun Cluster
Resource Type_version Property
Migrating a Resource to a Different Version
Upgrading and Downgrading a Resource Type
Default Property Values
Resource Type Developer Documentation
Resource Type Name and Resource Type Monitor Implementations
Application Upgrades
Resource Type Upgrade Examples
Installation Requirements for Resource Type Packages
Information That You Need to Know Before Changing the RTR File
Changing Monitor Code
Changing Method Code
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 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 6 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
Enabling Highly Available Local File Systems
Chapter 7 Designing Resource Types
The RTR File
The Validate Method
The Start Method
The Stop Method
The Monitor_start Method
The Monitor_stop Method
The Monitor_check Method
The Update Method
The Init, Fini, and Boot Methods
Designing the Fault Monitor Daemon
Chapter 8 Sample DSDL Resource Type Implementation
X Font Server
X Font Server Configuration File
TCP Port Number
Naming Conventions
SUNW.xfnts RTR File
scds_initialize() Function
xfnts_start Method
Validating the Service Before Starting
Starting the Service
Returning From svc_start()
xfnts_stop Method
xfnts_monitor_start Method
xfnts_monitor_stop Method
xfnts_monitor_check Method
SUNW.xfnts Fault Monitor
xfonts_probe Main Loop
svc_probe() Function
Determining the Fault Monitor Action
xfnts_validate Method
xfnts_update Method
Chapter 9 SunPlex Agent Builder
Agent Builder Overview
Before You Use Agent Builder
Creating Resource Types With Multiple Independent Process Trees
Using Agent Builder
Analyzing the Application
Installing and Configuring Agent Builder
Agent Builder Screens
Launching Agent Builder
Navigating Agent Builder
Browse
Menus
File Menu
Edit Menu
Using the Create Screen
Create Screen
Using the Configure Screen
Configure Screen
Using the Agent Builder Korn Shell-Based $hostnames Variable
Property Variables
List of Property Variables
Syntax of Property Variables
How Agent Builder Substitutes Property Variables
Reusing Completed Work
How to Clone an Existing Resource Type
Editing the Generated Source Code
How to Use the Command-Line Version of Agent Builder
Directory Structure
Agent Builder Output
Source and Binary Files
Utility Scripts and man Pages
Support Files
Package Directory
rtconfig File
Cluster Agent Module for Agent Builder
How to Install and Set Up the Cluster Agent Module
How to Start the Cluster Agent Module
Using the Cluster Agent Module
Differences Between the Cluster Agent Module and Agent Builder
Chapter 10 Generic Data Services
GDS Overview
Precompiled Resource Type
Advantages and Disadvantages of Using the GDS
Ways to Create a Service That Uses the GDS
GDS and the SunPlex Agent Builder
GDS and the Standard Sun Cluster Administration Commands
Selecting the Method to Use to Create a GDS-Based Service
How the GDS Logs Events
GDS Log Files
Required GDS Properties
Start_command Extension Property
Port_list Property
Optional GDS Properties
Network_resources_used Property
Stop_command Property
Probe_command Property
Start_timeout Property
Stop_timeout Property
Probe_timeout Property
Child_mon_level Property
Failover_enabled Property
Stop_signal Property
Log_level Property
Using SunPlex Agent Builder to Create a Service That Uses the GDS
Creating and Configuring the Scripts
Output From SunPlex Agent Builder
Using the Standard Sun Cluster Administration Commands to Create a Service That Uses the GDS
Command-Line Interface for the SunPlex Agent Builder
Chapter 11 Data Service Development Library Reference
DSDL Functions
General Purpose Functions
Property Functions
Network Resource-Access Functions
Fault Monitoring Using TCP Connections
PMF Functions
Fault Monitor Functions
Utility Functions
Chapter 12 CRNP
Overview of CRNP
Overview of the CRNP Protocol
Semantics of the CRNP Protocol
Message Types That the CRNP Uses
How a Client Registers With the Server
Assumptions About How Administrators Will Set Up the Server
How the Server Identifies a Client
How SC_CALLBACK_REG Messages Are Passed Between a Client and the Server
Contents of an SC_CALLBACK_REG Message
How the Server Replies to a Client
Contents of an SC_REPLY Message
How a Client Is to Handle Error Conditions
How the Server Delivers Events to a Client
How the Delivery of Events Is Guaranteed
Contents of an SC_EVENT Message
How the CRNP Authenticates Clients and the Server
Creating a Java Application That Uses CRNP
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
Stop Method
gettime Utility
PROBE Program
Monitor_start Method
Monitor_stop Method
Monitor_check Method
Validate Method
Update Method
Appendix C Data Service Development Library 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
The xfnts_update Method
The xfnts_validate Method Code Listing
Appendix D Legal RGM Names and Values
RGM Legal Names
Rules for Names Except Resource Type Names
Format of Resource Type 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
Appendix F Document Type Definitions for CRNP
SC_CALLBACK_REG XML DTD
NVPAIR XML DTD
SC_REPLY XML DTD
SC_EVENT XML DTD
Appendix G CrnpClient.java Application
Contents of CrnpClient.java
© 2010, Oracle Corporation and/or its affiliates