Sun Cluster 3.1 10/03 Data Services Developer's Guide

Preface

The Sun Cluster 3.1 10/03 Data Services Developer's Guide contains information about using the Resource Management API to develop Sun Cluster data services.

Who Should Use This Book

This document is intended for experienced developers with extensive knowledge of Sun software and hardware. The information in this book assumes knowledge of the Solaris^TM Operating Environment.

How This Book Is Organized

The Sun Cluster 3.1 10/03 Data Services Developer's Guide contains the following chapters and appendixes:

Chapter 1, Resource Management Overview provides an overview of the concepts needed to develop a data service.
Chapter 2, Developing a Data Service provides detailed information on developing a data service.
Chapter 4, Resource Management API Reference provides a reference to the access functions and callback methods that make up the Resource Management API (RMAPI).
Chapter 5, Sample Data Service provides a sample Sun Cluster data service for the in.named() application.
Chapter 6, Data Service Development Library (DSDL) provides an overview of the application programming interfaces constituting the Data Services Development Library (DSDL)
Chapter 7, Designing Resource Types explains the typical usage of the DSDL in designing and implementing resource types.
Chapter 8, Sample DSDL Resource Type Implementation describes a sample resource type implemented with DSDL.
Chapter 9, SunPlex Agent Builder describes SunPlex Agent Builder.
Chapter 10, Generic Data Services describes how to create a generic data service.
Chapter 11, Data Service Development Library Reference describes the DSDL API functions.
Appendix A, Standard Properties describes the standard resource type, resource group, and resource properties.
Appendix B, Sample Data Service Code Listings provides the complete code for each method in the sample data service.
Appendix C, Data Service Development Library Sample Resource Type Code Listing lists the complete code for each method in the SUNW.xfnts() resource type.
Appendix D, Legal RGM Names and Values lists the requirements for legal characters for Resource Group Manager (RGM) names and values.
Appendix E, Requirements for Non-Cluster Aware Applications list the requirements for ordinary non-cluster aware applications to be candidates for high availability.

Application	Title	Part Number
Concepts	Sun Cluster 3.1 10/03 Concepts Guide	817-0519
Software Installation	Sun Cluster 3.1 10/03 Software Installation Guide	817-0518
Administration	Sun Cluster 3.1 10/03 System Administration Guide	817-0516
API Development	Sun Cluster 3.1 10/03 Data Services Developer's Guide	817-0520
Error Messages	Sun Cluster 3.1 10/03 Error Messages Guide	817-0521
Hardware	Sun Cluster 3.x Hardware Administration Manual	817-0168
Sun Cluster 3.x Hardware Administration Collection at `http://docs.sun.com/db/coll/1024.1`
Data Services	Sun Cluster 3.1 Data Service Planning and Administration Guide	817-3305
Sun Cluster 3.1 Data Services 10/03 Collection at `http://docs.sun.com/db/coll/573.10`
Man Pages	Sun Cluster 3.1 10/03 Reference Manual	817–0522
Release Notes	Sun Cluster 3.1 10/03 Release Notes	817–0638
Sun Cluster 3.x Release Notes Supplement	816-3381

Getting Help

If you have problems installing or using Sun Cluster, contact your service provider and provide the following information.

Your name and email address (if available)
Your company name, address, and phone number
The model number and serial number of your systems
The release number of the operating environment (for example, Solaris 10)
The release number of Sun Cluster (for example, Sun Cluster 3.1)

Use the following commands to gather information on your system for your service provider.

Command	Function
`prtconf` `-v`	Displays the size of the system memory and reports information about peripheral devices
`psrinfo` `-v`	Displays information about processors
`showrev` `-p`	Reports which patches are installed
`prtdiag` `-v`	Displays system diagnostic information
`/usr/cluster/bin/scinstall` `-pv`	Displays Sun Cluster release and package version information

Also have available the contents of the /var/adm/messages file.

Accessing Sun Documentation Online

The docs.sun.com^SM Web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. The URL is http://docs.sun.com.

Typographic Conventions

The following table describes the typographic changes used in this book.

Table P–1 Typographic Conventions


Typeface or Symbol	Meaning	Example
`AaBbCc123`	The names of commands, files, and directories; on-screen computer output	Edit your `.login` file. Use `ls -a` to list all files. `machine_name% you have mail.`
`AaBbCc123`	What you type, contrasted with on-screen computer output	`machine_name%` `su` `Password:`
`AaBbCc123`	Command-line placeholder: replace with a real name or value	The command to remove a file is `rm filename`.
AaBbCc123	Book titles, new words or terms, or words to be emphasized	Read Chapter 6 in the User's Guide. These are called class options. Do not save the file.

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P–2 Shell Prompts


Shell	Prompt
C shell prompt	`machine_name%`
C shell superuser prompt	`machine_name#`
Bourne shell and Korn shell prompt	`$`
Bourne shell and Korn shell superuser prompt	`#`