Setting up iSNS Server HA Using Sun Cluster 3.2
	===============================================

The overall tasks are

 - Install Sun Cluster 3.2.
    For information about Sun Cluster see 
    http://docs.sun.com/app/docs/doc/819-2969(Sun Cluster Concepts Guide for Solaris OS).

 - Encapsulate iSNS SMF service into Failover Proxy Resource.

 - Specify iSNS data store location in a Cluster File System.

 - Online the associated cluster resource group.

Sun Cluster SMF	proxy resource type SUNW.Proxy_SMF_failover can be used to
encapsulate iSNS SMF service into a Failover Proxy Resource Configuration.
For information	on how you can encapsulate SMF services	with Sun Cluster 3.2,
see http://docs.sun.com/app/docs/doc/819-2974/6n57pdk2b?a=view(Enabling Solaris SMF
Services to Run With Sun Cluster) For information about failover configuration,
see http://docs.sun.com/app/docs/doc/819-2974/6n57pdjtp?a=view(Creating a Resource
Group)

It is assumed that Sun Cluster 3.2 is successfully installed prior to executing
the following steps.

1) On a	cluster	member,	become superuser or assume a role that provides
   Solaris.cluster.modify RBAC authorization.

2) Register the	proxy SMF failover resource type.

    # clresourcetype register SUNW.Proxy_SMF_failover


3)  Verify that	the proxy resource type	has been registered.

    # clresourcetype show


4) Create the SMF failover resource group for iSNS service.

     # clresourcegroup create isns_rg


5) Verify that the SMF resource	group has been created.

      #	clresourcegroup	status isns_rg


6) Add an iSNS SMF failover application resource to the resource group.

   When	you create an iSNS resource of SMF proxy resource type,
   you need to specify the extension property "Proxied_service_instances".
   The extension property's value is the path to a file	that contains
   proxied SMF service along service FMRI, path	of the corresponding service
   manifest file.

   An example property file "/var/tmp/isns_svc.txt" should contain the
   following line. You need to create this file	on all nodes of	the cluster
   node	list.  

    # cat /tmp/isns_svc.txt
    <svc:/system/isns_server:default>,</var/svc/manifest/system/isns_server_svc.xml>

    # clresource create -g isns_rg -t SUNW.Proxy_SMF_failover -x
	Proxied_service_instances=/tmp/isns_svc.txt isns_rs 

7) Verify that the SMF failover	application resource has been added and
   validated.

    # clresource show	isns_rs

8) Specify a data store file in a Cluster File System. 
    #svccfg -s isns_server setprop config/data_store_location="/global/fs/isnsdata.xml"
    where /global/fs is a mount point for a cluster file system among cluster
    nodes.   The server will create the file if it doesn't exist at the start time.
    You should specify the same data store file property on all nodes in 
    order to have all nodes to share the data store.

    For creating a Cluster File system, refer to 
    http://docs.sun.com/app/docs/doc/819-2970/6n57ljhns?a=view

9)  Bring the failover resource	group online.

    # clresourcegroup online -M isns_rg

Changing iSNS service properties after encapsulating with Failover SMF Proxy Resource
-------------------------------------------------------------------------------------

You should not use SMF svcadm for disabling, enabling or refreshing SMF services that
are encapsulated in a proxy resource. In order to change properties of the SMF services
(in the SMF repository) that are encapsulated in a proxy resource, you should follow
the following steps.
    
Example steps to follow for changing a property of the service.

1)  On a cluster member, become	superuser or assume a role that	provides
    solaris.cluster.modify RBAC	authorization.

2)  Bring the iSNS reourcegroup	offline
    # clresourcegroup offline isns_rg

3)  Disable iSNS resource

    # clresource disable isns_rs

4)  Change the required	properties using Solaris SMF service commands
    You	need to	change these properties	on all nodes of	the cluster
    node list.
    
    For example,
    # svccfg -s isns_server setprop config/ESI_retry_threshold_count=4

    You should change the property on all nodes.  Otherwise,  during a fail
    over situation, you	will not have expected service properties in place.

5)   Enable  iSNS resources
       # clresource enable isns_rs

     isns-resource
	    Specifies your iSNS	resource name.

6)  Bring the iSNS resourcegroup online	from one node

       # clresourcegroup online	isns_rg