The Sun Cluster Data Services Developer's Guide for Solaris OS contains information about using the Resource Management API to develop SunTM Cluster data serviceson both SPARC® and x86 based systems.
This Sun Cluster release supports systems that use the SPARC and x86 families of processor architectures: UltraSPARC, SPARC64, and AMD64. In this document, the label x86 refers to systems that use the AMD64 family of processor architectures.
This document is intended for experienced developers with extensive knowledge of Sun software and hardware. The information in this book assumes that you have knowledge of the Solaris Operating System.
The Sun Cluster Data Services Developer's Guide for Solaris OS contains the following chapters and appendixes:
Chapter 1, Overview of Resource Management provides an overview of the concepts that you need to develop a data service.
Chapter 2, Developing a Data Service provides detailed information about developing a data service.
Chapter 3, Resource Management API Reference provides a reference to the access functions and callback methods that make up the Resource Management API (RMAPI).
Chapter 4, Modifying a Resource Type discusses the issues that you need to understand to modify a resource type. Information about the means by which you enable a cluster administrator to upgrade a resource is also included.
Chapter 5, Sample Data Service provides a sample Sun Cluster data service for the in.named application.
Chapter 6, Data Service Development Library provides an overview of the application programming interfaces that make up the Data Services Development Library (DSDL).
Chapter 7, Designing Resource Types explains the typical use of the DSDL in designing and implementing resource types.
Chapter 8, Sample DSDL Resource Type Implementation describes a sample resource type that is implemented with the DSDL.
Chapter 9, Sun Cluster Agent Builder describes Sun Cluster Agent Builder.
Chapter 10, Generic Data Services describes how to create a generic data service.
Chapter 11, DSDL API Functions describes the DSDL API functions.
Chapter 12, Cluster Reconfiguration Notification Protocol provides information about the Cluster Reconfiguration Notification Protocol (CRNP). The CRNP enables failover and scalable applications to be “cluster aware.”
Appendix A, Standard Properties describes the standard resource type, resource, and resource group properties.
Appendix B, Sample Data Service Code Listings provides the complete code for each method in the sample data service.
Appendix C, DSDL Sample Resource Type Code Listings 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.
Appendix F, Document Type Definitions for the CRNP lists the document type definitions for the CRNP.
Appendix G, CrnpClient.java Application shows the complete CrnpClient.java application that is discussed in Chapter 12, Cluster Reconfiguration Notification Protocol.
Information about related Sun Cluster topics is available in the documentation that is listed in the following table. All Sun Cluster documentation is available at http://docs.sun.com.
Topic |
Documentation |
---|---|
Overview | |
Concepts | |
Hardware installation and administration |
Sun Cluster 3.1 - 3.2 Hardware Administration Manual for Solaris OS Individual hardware administration guides |
Software installation | |
Data service installation and administration |
Sun Cluster Data Services Planning and Administration Guide for Solaris OS Individual data service guides |
Data service development | |
System administration | |
Error messages | |
Command and function references |
For a complete list of Sun Cluster documentation, see the release notes for your release of Sun Cluster software at http://docs.sun.com.
If you have problems installing or using the Sun Cluster software, contact your service provider and provide the following information:
Your name and email address
Your company name, address, and phone number
The model number and serial number of your systems
The release number of the operating system (for example, the Solaris 10 OS)
The release number of Sun Cluster software (for example, 3.2)
Use the following commands to gather information about your systems 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 |
SPARC: prtdiag -v |
Displays system diagnostic information |
/usr/cluster/bin/clnode show-rev |
Displays Sun Cluster release and package version information |
Also have available the contents of the /var/adm/messages file.
The Sun web site provides information about the following additional resources:
The following table describes the typographic conventions that are used in this book.
Table P–1 Typographic Conventions
Typeface |
Meaning |
Example |
---|---|---|
AaBbCc123 |
The names of commands, files, and directories, and onscreen computer output |
Edit your .login file. Use ls -a to list all files. machine_name% you have mail. |
AaBbCc123 |
What you type, contrasted with onscreen computer output |
machine_name% su Password: |
aabbcc123 |
Placeholder: replace with a real name or value |
The command to remove a file is rm filename. |
AaBbCc123 |
Book titles, new terms, and terms to be emphasized |
Read Chapter 6 in the User's Guide. A cache is a copy that is stored locally. Do not save the file. Note: Some emphasized items appear bold online. |
The following table shows the default UNIX® system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.
Table P–2 Shell Prompts
Shell |
Prompt |
---|---|
C shell |
machine_name% |
C shell for superuser |
machine_name# |
Bourne shell and Korn shell |
$ |
Bourne shell and Korn shell for superuser |
# |