JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Cluster Data Services Developer's Guide     Oracle Solaris Cluster 4.1
search filter icon
search icon

Document Information

Preface

1.  Overview of Resource Management

2.  Developing a Data Service

3.  Resource Management API Reference

4.  Modifying a Resource Type

5.  Sample Data Service

6.  Data Service Development Library

7.  Designing Resource Types

8.  Sample DSDL Resource Type Implementation

9.  Oracle Solaris Cluster Agent Builder

10.  Generic Data Service

Generic Data Service Concepts

Precompiled Resource Type

Advantages and Disadvantages of Using the GDS

Ways to Create a Service That Uses the GDS

GDS and Agent Builder

GDS and Oracle Solaris Cluster Administration Commands

Selecting the Method to Use to Create a GDS-Based Service

How the GDS Logs Events

GDS Log Files

Required GDS Properties

Port_list Property

Start_command Property

Optional GDS Properties

Child_mon_level Property

Failover_enabled Property

Log_level Property

Monitor_retry_count Property

Monitor_retry_interval Property

Network_aware Property

Network_resources_used Property

Probe_command Property

Probe_timeout Property

Start_timeout Property

Stop_command Property

Stop_signal Property

Stop_timeout Property

Validate_command Property

Validate_timeout Property

Using Agent Builder to Create a Service That Uses the GDS

Creating and Configuring GDS-Based Scripts

How to Start Agent Builder and Create the Scripts

How to Configure the Scripts

Output From Agent Builder

Using Oracle Solaris Cluster Administration Commands to Create a Service That Uses the GDS

How to Use Oracle Solaris Cluster Administration Commands to Create a Highly Available Service That Uses the GDS

How to Use Oracle Solaris Cluster Administration Commands to Create a Scalable Service That Uses the GDS

Command-Line Interface for Agent Builder

How to Use the Command-Line Version of Agent Builder to Create a Service That Uses GDS

11.  DSDL API Functions

12.  Cluster Reconfiguration Notification Protocol

13.  Security for Data Services

A.  Sample Data Service Code Listings

B.  DSDL Sample Resource Type Code Listings

C.  Requirements for Non-Cluster-Aware Applications

D.  Document Type Definitions for the CRNP

E.  CrnpClient.java Application

Index

Using Oracle Solaris Cluster Administration Commands to Create a Service That Uses the GDS

This section describes how to input arguments to the GDS. You use the existing Oracle Solaris Cluster administration commands, such as clresourcetype, clresourcegroup, and clresource to maintain and administer the GDS.

If the scripts provide adequate functionality, you do not need to use the lower-level administration commands that are shown in this section. However, you can use the lower-level administration commands if you need to have finer control over the GDS-based resource. These commands are executed by the scripts.

How to Use Oracle Solaris Cluster Administration Commands to Create a Highly Available Service That Uses the GDS

Before You Begin

Ensure that the /etc/netmasks file has IP-address subnet and netmask entries for all logical hostnames. If necessary, edit the /etc/netmasks file to add any missing entries.

  1. Assume the root role or a role that provides solaris.cluster.modify RBAC authorization.
  2. Register the resource type SUNW.gds.
    # clresourcetype register SUNW.gds
  3. Create the resource group that contains the LogicalHostname resource and the failover service itself.
    # clresourcegroup create haapp_rg
  4. Create the resource for the LogicalHostname resource.
    # clreslogicalhostname create -g haapp_rg hhead
  5. Create the resource for the failover service itself.
    # clresource create -g haapp_rg -t SUNW.gds
            -p Validate_command="/export/app/bin/configtest" \
            -p Scalable=false -p Start_timeout=120 \
            -p Stop_timeout=120 -p Probe_timeout=120 \
            -p Port_list="2222/tcp" \
            -p Start_command="/export/ha/appctl/start" \
            -p Stop_command="/export/ha/appctl/stop" \
            -p Probe_command="/export/app/bin/probe" \
            -p Child_mon_level=0 -p Network_resources_used=hhead \
            -p Failover_enabled=TRUE -p Stop_signal=9 haapp_rs
  6. Bring the resource group haapp_rg online in a managed state.
    # clresourcegroup online -M haapp_rg

How to Use Oracle Solaris Cluster Administration Commands to Create a Scalable Service That Uses the GDS

Before You Begin

Ensure that the /etc/netmasks file has IP-address subnet and netmask entries for all logical hostnames. If necessary, edit the /etc/netmasks file to add any missing entries.

  1. Assume the root role or a role that provides solaris.cluster.modify RBAC authorization.
  2. Register the resource type SUNW.gds.
    # clresourcetype register SUNW.gds
  3. Create the resource group for the SharedAddress resource.
    # clresourcegroup create sa_rg
  4. Create the SharedAddress resource hhead in resource group sa_rg.
    # clressharedaddress create -g sa_rg hhead
  5. Create the resource group for the scalable service.
    # clresourcegroup create -S -p RG_dependencies=sa_reg app_rg
  6. Create the resource for the scalable service.
    # clresource create -g app_rg -t SUNW.gds
            -p Validate_command="/export/app/bin/configtest" \
            -p Scalable=TRUE -p Start_timeout=120 \
            -p Stop_timeout=120 -p Probe_timeout=120 \
            -p Port_list="2222/tcp" \
            -p Start_command="/export/app/bin/start" \
            -p Stop_command="/export/app/bin/stop" \
            -p Probe_command="/export/app/bin/probe" \
            -p Child_mon_level=0 -p Network_resource_used=hhead \
            -p Failover_enabled=TRUE -p Stop_signal=9 app_rs
  7. Bring the resource group that contains the network resources online.
    # clresourcegroup online sa_reg
  8. Bring the resource group app_rg online in a managed state.
    # clresourcegroup online -M app_reg