This procedure describes how to use the scrgadm command to register and configure the Sun Cluster HA for Netscape Directory Server data service.
Other options also enable you to register and configure the data service. See "Tools for Data-Service Resource Administration" for details about these options.
To perform this procedure, you need the following information about your configuration.
The name of the resource type for the Sun Cluster HA for Netscape Directory Server data service. This name is SUNW.nsldap.
The names of the cluster nodes that can master the data service.
The logical hostname that clients use to access the Sun Cluster HA for Netscape Directory Server data service. Normally, you set up this logical hostname when you install the cluster. See the section on how to set up logical hostnames in the Sun Cluster 3.0 U1 Installation Guide for details.
The path to the Netscape Directory Server application binaries that are the resources for the Sun Cluster HA for Netscape Directory Server data service. You can install the binaries on the local disks or the cluster file system. See Chapter 1, Planning for Sun Cluster Data Services for a discussion of the advantages and disadvantages of each location.
The port where Netscape Directory Server listens. For non-secure instances, the Port_list standard resource property for the Netscape Directory Server resource defaults to 389/tcp, and the value for the secure port is 636/tcp. If you set the port to a number other than 389, you must specify that value when you configure the Port_list property. See Chapter 11, Administering Data-Service Resources for instructions on how to set resource properties.
Perform this procedure on any cluster member.
Perform the following steps to complete your configuration.
Become superuser on a cluster member.
Register the resource type for the data service.
# scrgadm -a -t SUNW.nsldap |
Adds the data-service resource type.
Specifies the predefined resource-type name.
Add the Netscape Directory Server application resource t the failover resource group that you created for your network resources.
The resource group that contains the application resources is the same resource group that you created for your network resources in "How to Configure and Activate Network Resources".
# scrgadm -a -j resource -g resource-group \ -t resource-type [-y Network_resources_used=network-resource, ...] \ -y Port_list=port-number/protocol -x Confdir_list=pathname |
Specifies the LDAP application resource name.
Specifies a comma-separated list of network resources (logical hostnames or shared addresses) in resource-group, which the LDAP application resource must use.
Specifies the resource type to which the resource belongs, for example, SUNW.iws.
Specifies a port number and the protocol to be used, for example, 389/tcp. The Port_list property must have exactly one entry.
Specifies a path for your LDAP configuration directory. The Confdir_list extension property is required. The Confdir_list property must have exactly one entry.
Enable the resource and its monitor.
# scswitch -e -j resource |
Enables the resource and its monitor.
Specifies the name of the application resource being enabled.
This example shows how to register the Sun Cluster HA for Netscape Directory Server data service.
Cluster Information Node names: phys-schost-1, phys-schost-2 Logical hostname: schost-1 Resource group: resource-group-1 (for all resources) Resources: schost-1 (logical hostname), nsldap-1 (LDAP application resource) (Create a failover resource group.) # scrgadm -a -g resource-group-1 -h phys-schost-1,phys-schost-2 (Add a logical hostname resource to the resource group.) # scrgadm -a -L -g resource-group-1 -l schost-1 (Bring the resource group online.) # scswitch -Z -g resource-group-1 (Install and configure Netscape Directory Server.) (Stop the LDAP server.) (Register the SUNW.nsldap resource type.) # scrgadm -a -t SUNW.nsldap (Create an LDAP resource and add it to the resource group.) # scrgadm -a -j nsldap-1 -g resource-group-1 \ -t SUNW.nsldap -y Network_resources_used=schost-1 \ -y Port_list=389/tcp \ -x Confdir_list=/global/nsldap/slapd-schost-1 (Enable the application resources.) # scswitch -e -j nsldap-1 |
The SUNW.HAStorage resource type synchronizes actions between HA storage and the data service. The Sun Cluster HA for Netscape Directory Server data service is not disk-intensive and not scalable, and therefore configuring the SUNW.HAStorage resource type is optional.
See the SUNW.HAStorage(5) man page and "Relationship Between Resource Groups and Disk Device Groups" for background details. See "How to Set Up SUNW.HAStorage Resource Type for New Resources" for information about the procedure.