Index

Symbols

2N redundancy

loss of, 1, 2, 3
synchronization flag, 1

A

address space, locking, 1

administrative attributes, 1, 2, 3

CMM_ELIGIBLE_MEMBER, 1, 2
CMM_EXCLUDED_MEMBER, 1
CMM_FLAG_DISQUALIFIED, 1
CMM_FLAG_SYNCHRO_NEEDED, 1
CMM_FROZEN_MEMBER, 1

amnesia, 1

APIs

development environment, 1

for managing peer nodes, 1

examples of use, 1, 1

applications

connecting tonhcmmd daemon, 1
debugging, 1
development environment for, 1
disconnecting fromnhcmmd daemon, 1
registering for notifications, 1
starting automatically, 1
testing, 1, 2

attributes

administrativeSee administrative attributes

B

binary files, location for cluster, 1
broken pipes, 1

C

callback functions

cluster membership change, 1, 2, 3
unregistering failure, 1

cancelled operations, failures due to, 1

CFLAGS entry, 1

cgha_cmm library, 1

change notifications, 1, 2, 3, 4

cluster, 1

identifying usingdomainid, 1
invalid, 1, 2
location of binary files, 1
stale, 1, 2, 3
state, 1, 2

Cluster Management Service, programming interface, 1

cluster node table, 1

entries, removing, 1
errors, 1
reloading, 1

CMM API

changing the state of nodes, 1
connection failure, 1
examples of use, 1
function calls, 1
header files, accessing, 1
introduction to, 1
libraries, accessing, 1
multithreading characteristics, 1
notifications, 1
return values, 1
usage, 1

cmm_cmc_filter function, 1, 2, 3, 4

cmm_cmc_register function, 1, 2, 3

cmm_cmc_unregister function, 1, 2

cmm_cmchanges_t structure, 1

cmm_config_reload function, 1

cmm_connect function, 1

cmm_disconnect function, 1

CMM_DISQUALIFIED_MEMBER level, 1, 2

CMM_EAGAIN error, 1

CMM_EBADF error, 1

CMM_EBUSY error, 1

CMM_ECANCELED error, 1

CMM_ECONN error, 1

CMM_EEXIST error, 1

CMM_EINVAL error, 1

CMM_ELIGIBLE_MEMBER

attribute, 1

CMM_ELIGIBLE_MEMBER attribute, 1

CMM_ENOCLUSTER error, 1

CMM_ENOENT error, 1

CMM_ENOMSG error, 1

CMM_ENOTSUP error, 1

CMM_EPERM error, 1

CMM_ERANGE error, 1

CMM_ESRCH error, 1

CMM_ETIMEDOUT error, 1

CMM_EXCLUDED_MEMBER attribute, 1

CMM_FLAG_DISQUALIFIED

attribute, 1

CMM_FLAG_SYNCHRO_NEEDED

attribute, 1

CMM_FROZEN_MEMBER attribute, 1

CMM_INVALID_CLUSTER notification, 1, 2

CMM_MASTER role, 1, 2

CMM_MASTER_DEMOTED notification, 1, 2, 3, 4

CMM_MASTER_ELECTED notification, 1, 2

cmm_master_getinfo function, 1

cmm_mastership_release function, 1, 2

cmm_member_getall function, 1

cmm_member_getcount function, 1

cmm_member_getinfo function, 1, 2

cmm_member_is* functions

code example, 1

cmm_member_isdesynchronized function, 1, 2

cmm_member_isdiesqualified function, 1

cmm_member_isdisqualified function, 1

cmm_member_iseligible function, 1, 2

cmm_member_isexcluded function, 1

cmm_member_isfrozen function, 1

cmm_member_ismaster function, 1, 2

cmm_member_isoutofcluster function, 1, 2

cmm_member_isqualified function, 1, 2

cmm_member_isvicemaster function, 1, 2

CMM_MEMBER_JOINED notification, 1, 2

CMM_MEMBER_LEFT notification, 1, 2

cmm_member_seizequalif function, 1

cmm_member_setqualif function, 1, 2, 3

cmm_member_t structure

fields, 1
returned by functions, 1
sflag field, 1
usage, 1

cmm_membership_release function, 1, 2

cmm_membership_remove function, 1, 2, 3, 4

cmm_node_getid function, 1

cmm_notify_dispatch function, 1, 2

cmm_notify_getfd function, 1, 2

cmm_notify_t structure, 1, 2

CMM_OK return value, 1

CMM_OUT_OF_CLUSTER role, 1, 2, 3

cmm_potential_getinfo function, 1, 2

CMM_QUALIFIED_MEMBER level, 1, 2

CMM_STALE_CLUSTER notification, 1, 2, 3

CMM_VALID_STATE notification, 1

CMM_VICEMASTER role, 1, 2

CMM_VICEMASTER_DEMOTED notification, 1, 2

CMM_VICEMASTER_ELECTED notification, 1, 2, 3

cmm_vicemaster_getinfo function, 1

commands,nhcmmrole, 1

common.h library file, code example, 1

compiling

programs, 1

D

Daemon Monitor, monitoring thenhcmmd daemon, 1

daemons

issues when debugging, 1

nhcmmd, 1, 2

sending notifications, 1

nhprobed, 1

data transfer, 1

debugging applications

overview, 1

development environment, 1, 2

development host

disk space, 1
requirements, 1
software requirements, 1
transferring data, 1

diskless nodes, excluding from cluster, 1

disks, space on development host, 1

display messages, formatting, 1

E

elections

notifications of, 1, 2
participation in, 1, 2

eligibility, retrieving information, 1

environment variables, LD_BIND_NOW, 1

errors

checking, 1
CMM_EAGAIN, 1
CMM_EBADF, 1
CMM_EBUSY, 1
CMM_ECANCELED, 1
CMM_ECONN, 1
CMM_EEXIST, 1
CMM_EINVAL, 1
CMM_ENOCLUSTER, 1
CMM_ENOENT, 1
CMM_ENOMSG, 1
CMM_ENOTSUP, 1
CMM_EPERM, 1
CMM_ERANGE, 1
CMM_ESRCH, 1
CMM_ETIMEDOUT, 1
displaying, 1
from function calls, 1
log files, 1
logging, 1
reporting by the NMA, 1
return values, 1, 2

event, nonexistent, 1

example source code, 1, 2

examples

location in source code, 1
using the CMM API, 1

F

failover, 1, 2, 3

caution about triggering, 1
provision for critical applications, 1
qualification levels, 1

failures

amnesia, 1
callback functions, 1
due to cancelled operations, 1
node, 1
of the active node, 1
provision of a standby node, 1
return values, 1
split brain, 1
unregistering callbacks, 1

file descriptors

invalid, 1
shortage of, 1

file systems, mounting, 1

files

copying, 1
transferring, 1

flags, compilerSee Makefiles

frozen nodes, identifying, 1

ftp command, 1

function calls

return values, 1
successful, 1

H

hardware requirements, 1

header files

inSUNWnhcmdpackage, 1
locating, 1

I

in nodes, defined, 1
installation server, transferring data, 1
invalid cluster, 1, 2
invalid file descriptors, 1

L

LD_BIND_NOW environment variable, 1

LDFLAGS entry, 1

libcgha_cmm.so library, 1

linking to your application, 1
location, 1

libraries

cgha_cmm, 1

common.h library file

code example, 1

installing, overview, 1

libcgha_cmm.so, 1

linking to your application, 1

locating, 1

required for development host, 1

linking programs, 1

locking address space, 1

M

Makefiles

CFLAGS entry, 1
LDFLAGS entry, 1

master node

definition, 1
demotion, 1, 2, 3, 4
exclusion from cluster, 1
identifying, 1, 2
notification of election, 1, 2
qualification level, 1
reloading cluster node table, 1
retrieving information, 1
state information, 1

master-eligible nodes

See also master node

See also qualification levels

See also vice-master node

, 1, 2

See also master node
See also qualification levels
See also vice-master node

identifying, 1

membership roles, 1, 2

change notifications, 1, 2, 3, 4
CMM_MASTER, 1, 2
CMM_OUT_OF_CLUSTER, 1, 2, 3
CMM_VICE-MASTER, 1
CMM_VICEMASTER, 1
displaying, 1
identifying at command line, 1
managing, 1
retrieving information about, 1, 2

memory, locking shared objects in, 1

messages, formatting, 1

mlockall function, 1

mount command, 1

multithreading characteristics of CMM API, 1

N

nhcmmd daemon

communicating withlibcgha_cmm.so library, 1
connecting to applications, 1
disconnecting from applications, 1
notification pipes, 1
sending notifications, 1
setting timeout for calls, 1
state changes, 1

nhcmmrole command, 1

nhcmmstat tool, 1

nhprobed daemon, 1

nodes

adding, 1

addr field, 1

administrative attributes, 1, 2, 3

availability in cluster, 1

CGTP address, 1

changing state, 1

diskless

exclusion from cluster, 1
improving performance, 1

domainid field, 1

eligibility, 1

eligibility to become master, 1

exclusion from cluster, 1, 2, 3, 4

failover, 1, 2

failure, 1

failures, 1, 2

frozen nodes

identifying, 1

gathering information, 1

identifying, 1, 2

identifying properties, 1

identifying roles, 1

in nodes, 1

incarnation_number field, 1

information about, 1, 2, 3

joining the cluster, 1, 2, 3

last reboot, 1

leaving the cluster, 1, 2, 3

master, 1, 2

master-eligible

identifying, 1

membership of cluster, 1

membership roles, 1, 2, 3

name field, 1

nodeid field, 1, 2

out nodes, 1

identifying, 1, 1

qualification levels, 1, 2, 3, 4

removing, 1

removing role, 1

retrieving information, 1, 2, 3, 4

roles, 1

sflag field, 1, 2

software_load_id field, 1

standby, 1

state change notifications, 1

state information, 1

switchover, 1, 2

synchronization, 1, 2, 3

vice-master, 1, 2

nonexistent items, 1

notifications

accessing, 1, 2
broken pipes, 1
callback functions, 1, 2, 3
change, 1, 2, 3, 4
CMM_INVALID_CLUSTER, 1, 2
CMM_MASTER_DEMOTED, 1, 2, 3, 4
CMM_MASTER_ELECTED, 1, 2
CMM_MEMBER_JOINED, 1, 2
CMM_MEMBER_LEFT, 1, 2
CMM_STALE_CLUSTER, 1, 2, 3
CMM_VALID_STATE, 1
CMM_VICEMASTER_DEMOTED, 1, 2
CMM_VICEMASTER_ELECTED, 1, 2, 3
code example, 1
dispatching, 1
filtering, 1
messages, 1
of state changes, 1
receiving, 1
registering for, 1, 2, 3
sent bynhcmmd daemon, 1
unregistering for, 1, 2

O

out nodes, defined, 1

P

packages

prerequisites for CMM API, 1
SUNWnhcmd, 1

parameters, invalid, 1

peer nodes, retrieving information, 1

performance, enhancing, 1

pipes, broken, 1

poll function, 1

programs

compiling, 1, 2
enhancing performance, 1
linking, 1

Q

qualification levels, 1, 2, 3

CMM_DISQUALIFIED_MEMBER, 1, 2
CMM_QUALIFIED_MEMBER, 1, 2
failover, 1
location stored, 1

R

rcp command, 1

Reliable NFS, synchronization flag, 1

return values, 1, 2

CMM_EAGAIN, 1
CMM_EBADF, 1
CMM_EBUSY, 1
CMM_ECANCELED, 1
CMM_ECONN, 1
CMM_EEXIST, 1
CMM_EINVAL, 1
CMM_ENOCLUSTER, 1
CMM_ENOENT, 1
CMM_ENOMSG, 1
CMM_ENOTSUP, 1
CMM_EPERM, 1
CMM_ERANGE, 1
CMM_ESRCH, 1
CMM_ETIMEDOUT, 1
CMM_OK, 1

S

server out of resources, 1

shared objects, locking in memory, 1

software requirements, development host, 1

source code, examples, 1, 2

space requirements, of development host, 1

split brain, 1

stale cluster, 1, 2, 3

startup scripts, 1

state changes

notifications, 1
overview, 1

Sun WorkShop TeamWare, 1

SUNWnhcmd package, 1

contents, 1, 2

SUNWnhcmdpackage, 1

SUNWnhhad package, 1

switchover, 1, 2

synchronization, 1, 2, 3

T

timeouts

responding to, 1
setting fornhcmmd daemon, 1

transfer of data, 1

V

vice-master node

definition, 1
demotion, 1, 2
election, 1, 2, 3
exclusion from cluster, 1
identifying, 1, 2