Index (Sun Cluster Data Services Developer's Guide for Solaris OS)

Sun Cluster Data Services Developer's Guide for Solaris OS


Numbers and Symbols

	`#$upgrade_from` directive ( ) ( )
		`Anytime` ( )
		`At_creation` ( )
		tunability values ( )
		`When_disabled` ( )
		`When_offline` ( )
		`When_unmanaged` ( )
		`When_unmonitored` ( )

	`$hostnames` variable, Agent Builder ( )


A

	accessing network address, with DSDL ( )

	Agent Builder
		`$hostnames` variable ( )
		analyzing the application ( )
		binary files ( )
		cloning existing resource type ( )
		Cluster Agent module ( )
			differences ( )
		command-line version ( )
		Configure screen ( )
		configuring ( )
		Create screen ( )
		creating a service using GDS ( )
		creating a service using GDS with the command-line version of ( )
		creating resource types ( )
		description ( ) ( )
		directory structure ( )
		editing generated source code ( )
		GDS output ( )
		installing ( )
		launching ( )
		man pages ( )
		navigating in ( )
			Browse button ( )
			Edit menu ( )
			File menu ( )
			menus ( )
		package directory ( )
		reusing completed work ( )
		`rtconfig` file ( )
		scripts ( )
		source files ( )
		starting ( )
		support files ( )
		using ( )
		using to create GDS ( ) ( )

	`Anytime`, `#$upgrade_from` directive ( )

	API, Resource Management
		See RMAPI

	arguments, RMAPI method ( )

	`arraymax`, resource type migration ( )

	`arraymin`, resource type migration ( )

	`At_creation`, `#$upgrade_from` directive ( )

	attributes, resource property ( )


B

	binary files, Agent Builder ( )

	`Boot` method, using ( ) ( )

	Browse button, Agent Builder ( )


C

	C program functions, RMAPI ( )

	callback method, overview ( )

	callback methods
		control ( )
		description ( )
		initialization ( )
		`Monitor_check` ( )
		`Monitor_start` ( )
		`Monitor_stop` ( )
		`Postnet_start` ( )
		`Prenet_start` ( )
		RMAPI ( )
		`Update` ( )
		using ( )
		`Validate` ( )

	CCR (cluster configuration repository) ( )

	checks, validating for scalable services ( )

	client, CRNP ( )

	cloning existing resource type, Agent Builder ( )

	Cluster Agent module
		Agent Builder differences ( )
		description ( )
		installing ( )
		setting up ( )
		starting ( )
		using ( )

	cluster commands, RMAPI ( )

	cluster configuration repository ( )

	cluster functions, RMAPI ( )

	Cluster Reconfiguration Notification Protocol
		See CRNP

	code
		changing method ( )
		changing monitor ( )

	codes, RMAPI exit ( )

	command line
		Agent Builder ( )
		commands on ( )

	commands
		`halockrun` ( )
		`hatimerun` ( )
		RMAPI resource type ( )
		Sun Cluster ( )
		using to create GDS ( ) ( )

	components, RMAPI ( )

	Configure screen, Agent Builder ( )

	configuring, Agent Builder ( )

	Create screen, Agent Builder ( )

	creating resource types, Agent Builder ( )

	CRNP
		authentication ( )
		client ( )
		client identification process ( )
		communciation ( )
		description ( )
		error conditions ( )
		example Java application ( )
		function of ( )
		message types ( )
		protocol ( )
		registration of client and server ( )
		`SC_CALLBACK_REG` messages ( )
		semantics of protocol ( )
		server ( )
		server event delivery ( )
		server reply ( )


D

	daemon, designing the fault monitor ( )

	data service
		creating
			analyzing suitability ( )
			determining the interface ( )
		sample ( )
			common functionality ( )
			controlling the data service ( )
			defining a fault monitor ( )
			extension properties in RTR file ( )
			generating error messages ( )
			handling property updates ( )
			`Monitor_check` method ( )
			`Monitor_start` method ( )
			`Monitor_stop` method ( )
			obtaining property information ( )
			probe program ( )
			resource properties in RTR file ( )
			RTR file ( )
			`Start` method ( )
			`Stop` method ( )
			`Update` method ( )
			`Validate` method ( )
		setting up development environment ( )
		transferring to cluster for testing ( )

	Data Service Development Library
		See DSDL

	data services
		testing ( )
		testing HA ( )
		writing ( )

	debugging resource types with DSDL ( )

	default property values
		cluster configuration repository ( )
		new value for upgrade ( )
		Sun Cluster 3.0 ( )
		upgrades ( )
		when inherited ( )

	dependencies, coordinating between resources ( )

	directive
		`#$upgrade_from` ( ) ( )
		default tunability ( )
		placement in RTR file ( )
		tunability constraints ( )

	directories, Agent Builder ( )

	directory structure, Agent Builder ( )

	distinguishing between multiple registered versions, `RT_version` ( )

	distinguishing between vendors, `Vendor_id` ( )

	documentation requirements
		for upgrade ( )
		tunability constraints ( )

	DSDL
		accessing network address ( )
		components ( )
		debugging resource types ( )
		description ( ) ( )
		enabling HA local file systems ( )
		fault monitor functions ( )
		fault monitoring ( )
		functions ( )
		general purpose functions ( )
		implementing a fault monitor ( )
		`libdsdev.so` ( )
		network resource-access functions ( )
		overview ( )
		PMF (Process Monitor Facility) functions ( )
		property functions ( )
		sample resource type implementation
			determining the fault monitor action ( )
			returning from `svc_start()` ( )
			`scds_initialize()` function ( )
			starting the service ( )
			`SUNW.xfnts` fault monitor ( )
			`SUNW.xfnts` RTR file ( )
			`svc_probe()` function ( )
			TCP port number ( )
			validating the service ( )
			X font server ( )
			X font server configuration file ( )
			`xfnts_monitor_check` method ( )
			`xfnts_monitor_start` method ( )
			`xfnts_monitor_stop` method ( )
			`xfnts_probe` main loop ( )
			`xfnts_start` method ( )
			`xfnts_stop` method ( )
			`xfnts_update` method ( )
			`xfnts_validate` method ( )
		starting a data service ( )
		stopping a data service ( )
		utility functions ( )
		where implemented ( )


E

	editing generated Agent Builder source code ( )

	enabling HA local file systems with DSDL ( )

	error conditions, CRNP ( )

	examples
		data service ( )
		Java application that uses CRNP ( )
		resource type upgrade ( )

	exit codes, RMAPI ( )

	extension properties, declaring ( )


F

	failover resource, implementing ( )

	fault monitor
		daemon
			designing the ( )
		functions, DSDL ( )
		`SUNW.xfnts` ( )

	files
		binary in Agent Builder ( )
		`rtconfig` ( )
		source in Agent Builder ( )
		support in Agent Builder ( )

	`Fini` method, using ( ) ( )

	fully qualified name, how obtained ( )

	functions
		DSDL ( )
		DSDL fault monitor ( )
		DSDL network resource-access ( )
		DSDL PMF (Process Monitor Facility) ( )
		DSDL property ( )
		DSDL utility ( )
		general purpose DSDL ( )
		RMAPI C program ( )
		RMAPI cluster ( )
		RMAPI resource ( )
		RMAPI resource group ( )
		RMAPI resource type ( )
		RMAPI utility ( )
		`scds_initialize()` ( )
		`svc_probe()` ( )


G

	GDS
		Agent Builder output ( )
		`Child_mon_level` property ( )
		creating a service with Agent Builder ( )
		creating a service with command-line version of Agent Builder ( )
		definition ( )
		description ( )
		`Failover_enabled` property ( )
		`Network_resources_used` property ( )
		`Port_list` property ( )
		`Probe_command` property ( )
		`Probe_timeout` property ( )
		required properties ( )
		`Start_command` extension property ( )
		`Start_timeout` property ( )
		`Stop_command` property ( )
		`Stop_signal` property ( )
		`Stop_timeout` property ( )
		`SUNW.gds` resource type ( )
		using with Agent Builder ( ) ( )
		using with Sun Cluster administration commands ( ) ( )
		ways to use ( )
		when to use ( )
		why use ( )

	generic data service
		See GDS


H

	HA data services, testing ( )

	`halockrun`, description ( )

	`hatimerun`, description ( )


I

	idempotency, methods ( )

	implementing
		fault monitor with DSDL ( )
		resource type monitor ( )
		resource type names ( )
		RMAPI ( )

	`Init` method, using ( ) ( )

	installation requirements, resource type packages ( )

	installing Agent Builder ( )

	interfaces, command-line ( )


J

	Java, sample application that uses CRNP ( )


K

	keep-alives, using ( )


L

	`libdsdev.so`, DSDL ( )

	`libscha.so`, RMAPI ( )

	logging, adding to a resource ( )


M

	man pages, Agent Builder ( )

	master, description ( )

	`max`, resource type migration ( )

	menus
		Agent Builder ( )
		Agent Builder Edit ( )
		Agent Builder File ( )

	message logging, adding to a resource ( )

	messages, `SC_CALLBACK_REG` CRNP ( )

	method arguments, RMAPI ( )

	method code, changing ( )

	methods
		`Boot` ( ) ( ) ( )
		callback ( )
			control ( )
			initialization ( )
		`Fini` ( ) ( ) ( )
		idempotency ( )
		`Init` ( ) ( ) ( )
		`Monitor_check` ( ) ( )
		`Monitor_check` callback ( )
		`Monitor_start` ( ) ( )
		`Monitor_start` callback ( )
		`Monitor_stop` ( ) ( )
		`Monitor_stop` callback ( )
		`Postnet_start` ( )
		`Postnet_start` callback ( )
		`Prenet_start` ( )
		`Prenet_start` callback ( )
		`Start` ( ) ( ) ( )
		`Stop` ( ) ( ) ( )
		`Update` ( ) ( ) ( )
		`Update` callback ( )
		`Validate` ( ) ( ) ( )
		`Validate` callback ( )
		`xfnts_monitor_check` ( )
		`xfnts_monitor_start` ( )
		`xfnts_monitor_stop` ( )
		`xfnts_start` ( )
		`xfnts_stop` ( )
		`xfnts_update` ( )
		`xfnts_validate` ( )

	migrating resource types ( )

	`min`, resource type migration ( )

	`Monitor_check` method
		compatibility ( )
		using ( )

	monitor code, changing ( )

	`Monitor_start` method, using ( )

	`Monitor_stop` method, using ( )


N

	navigating Agent Builder ( )

	network resource-access functions, DSDL ( )


O

	obtaining fully qualified name ( )

	options, tunability ( )


P

	package directory, Agent Builder ( )

	PMF
		functions, DSDL ( )
		purpose ( )

	`Postnet_start` method, using ( )

	`Postnet_stop`, compatibility ( )

	`Prenet_start` method, using ( )

	primaries ( )

	primary nodes ( )

	process management ( )

	process management facility, overview ( )

	process monitor facility
		See PMF

	process trees, creating resource types with multiple independent ( )

	programming architecture ( )

	properties
		changing resource ( )
		`Child_mon_level` ( )
		declaring extension ( )
		declaring resource ( )
		declaring resource type ( )
		`Failover_enabled` ( )
		GDS, required ( )
		`Network_resources_used` ( )
		`Port_list` ( )
		`Probe_command` ( )
		`Probe_timeout` ( )
		resource ( )
		resource group ( )
		resource type ( )
		setting resource ( ) ( )
		setting resource type ( )
		`Start_command` extension ( )
		`Start_timeout` ( )
		`Stop_command` ( )
		`Stop_signal` ( )
		`Stop_timeout` ( )

	property attributes, resource ( )

	property functions, DSDL ( )

	property values, default ( )

	protocol, CRNP ( )


R

	registering CRNP clients and servers ( )

	resource
		adding message logging to a ( )
		implementing a failover ( )
		implementing a scalable ( )
		migrating to a different version ( )
		monitoring ( )
		starting ( )
		stopping ( )

	resource commands, RMAPI ( )

	resource dependencies, coordinating ( )

	resource functions, RMAPI ( )

	resource group commands, RMAPI ( )

	resource group functions, RMAPI ( )

	Resource Group Manager
		See RGM

	resource group properties ( )
		accessing information about ( )

	resource groups
		description ( )
		failover ( )
		properties ( )
		scalable ( )

	Resource Management API
		See RMAPI

	resource properties ( )
		accessing information about ( )
		changing ( )
		declaring ( )
		setting ( ) ( )

	resource property attributes ( )

	`Resource_type`, migration ( )

	resource type
		migration requirements ( )
		multiple versions ( )
		upgrading ( )

	resource type commands, RMAPI ( )

	resource type functions, RMAPI ( )

	resource type monitor, implementing ( )

	resource type names
		implementing ( )
		restrictions ( )
		Sun Cluster 3.0 ( )
		version suffix ( )
		without version suffix ( )

	resource type packages, installation requirements ( )

	resource type properties ( )
		declaring ( )
		setting ( )

	resource type registration
		See RTR

	resource type upgrades, examples of ( )

	resource `Type_version` property ( )
		editing ( )
		tunability ( )

	resource types
		creating ( )
		debugging with DSDL ( )
		description ( )

	resources
		coordinating dependencies between ( )
		description ( )

	reusing completed work, Agent Builder ( )

	RGM
		description ( )
		handling of resource groups ( )
		handling of resource types ( )
		handling of resources ( )
		purpose ( )

	RMAPI ( )
		C program functions ( )
		callback methods ( )
		cluster commands ( )
		cluster functions ( )
		components ( )
		exit codes ( )
		`libscha.so` ( )
		method arguments ( )
		resource commands ( )
		resource functions ( )
		resource group commands ( )
		resource group functions ( )
		resource type commands ( )
		resource type functions ( )
		shell commands ( )
		utility functions ( )
		where implemented ( )

	`RT_version`, migration ( )

	`RT_Version`
		purpose ( )
		when not to change ( )
		when to change ( )

	`rtconfig` file ( )

	RTR
		description ( )
		file
			changing ( )
			description ( )
			migration ( )
			`SUNW.xfnts` ( )


S

	sample data service
		common functionality ( )
		controlling the data service ( )
		defining a fault monitor ( )
		extension properties in RTR file ( )
		generating error messages ( )
		handling property updates ( )
		`Monitor_check` method ( )
		`Monitor_start` method ( )
		`Monitor_stop` method ( )
		obtaining property information ( )
		probe program ( )
		RTR file ( )
		sample properties in RTR file ( )
		`Start` method ( )
		`Stop` method ( )
		`Update` method ( )
		`Validate` method ( )

	sample DSDL
		determining the fault monitor action ( )
		returning from `svc_start()` ( )
		`scds_initialize()` function ( )
		starting the service ( )
		`SUNW.xfnts` fault monitor ( )
		`SUNW.xfnts` RTR file ( )
		`svc_probe()` function ( )
		TCP port number ( )
		validating the service ( )
		X font server ( )
		X font server configuration file ( )
		`xfnts_monitor_check` method ( )
		`xfnts_monitor_start` method ( )
		`xfnts_monitor_stop` method ( )
		`xfnts_probe` main loop ( )
		`xfnts_start` method ( )
		`xfnts_stop` method ( )
		`xfnts_update` method ( )
		`xfnts_validate` method ( )

	scalable resource, implementing ( )

	scalable services, validating ( )

	`scds_initialize()` function ( )

	screens
		Configure ( )
		Create ( )

	scripts, Agent Builder ( )

	server
		CRNP ( )
		X font
			configuration file ( )
			definition ( )
		`xfs`
			port number ( )

	shell commands, RMAPI ( )

	source code, editing generated Agent Builder ( )

	source files, Agent Builder ( )

	`Start` method, using ( ) ( )

	starting a data service with DSDL ( )

	`Stop` method
		compatibility ( )
		using ( ) ( )

	stopping a data service with DSDL ( )

	Sun Cluster
		commands ( )
		using with GDS ( )

	SunPlex Agent Builder
		See Agent Builder

	SunPlex Manager, description ( )

	`SUNW.xfnts`
		fault monitor ( )
		RTR file ( )

	support files, Agent Builder ( )

	`svc_probe()` function ( )


T

	TCP connections, using DSDL fault monitoring ( )

	testing
		data services ( )
		HA data services ( )

	tunability constraints, documentation requirements ( )

	tunability options ( )
		`Anytime` ( )
		`At_creation` ( )
		`When_disabled` ( )
		`When_offline` ( )
		`When_unmanaged` ( )
		`When_unmonitored` ( )


U

	`Update` method
		compatibility ( )
		using ( ) ( )

	upgrade aware, defined ( )

	upgrades
		default property values ( )
		documentation requirements ( )
		examples of resource type ( )

	utility functions
		DSDL ( )
		RMAPI ( )


V

	`Validate` method
		checking property values for upgrade ( )
		upgrades ( )
		using ( ) ( )

	validation checks, scalable services ( )

	values, default property ( )

	`Vendor_id`
		distinguishing between ( )
		migration ( )


W

	`When_disabled`, `#$upgrade_from` directive ( )

	`When_offline`, `#$upgrade_from` directive ( )

	`When_unmanaged`, `#$upgrade_from` directive ( )

	`When_unmonitored`, `#$upgrade_from` directive ( )

	writing data services ( )


X

	X font server
		configuration file ( )
		definition ( )

	`xfnts_monitor_check` ( )

	`xfnts_monitor_start` ( )

	`xfnts_monitor_stop` ( )

	`xfnts_start` ( )

	`xfnts_stop` ( )

	`xfnts_update` ( )

	`xfnts_validate` ( )

	`xfs` server, port number ( )