JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Cluster Data Services Developer's Guide     Oracle Solaris Cluster
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.  Solaris Cluster Agent Builder

Agent Builder Overview

Before You Use Agent Builder

Using Agent Builder

Analyzing the Application

Installing and Configuring Agent Builder

Agent Builder Screens

Starting Agent Builder

Navigating Agent Builder

Browse Command

Agent Builder Menus

Agent Builder File Menu

Agent Builder Edit Menu

Using the Create Screen

Using the Configure Screen

Using the Agent Builder Korn Shell-Based $hostnames Variable

Using Property Variables

List of Property Variables

Resource Property Variables

Resource Type Property Variables

Resource Group Property Variables

Syntax of Property Variables

How Agent Builder Substitutes Property Variables

Reusing Code That You Create With Agent Builder

How to Clone an Existing Resource Type

Editing the Generated Source Code

How to Use the Command-Line Version of Agent Builder

Directory Structure That Agent Builder Creates

Agent Builder Output

Source and Binary Files

Utility Scripts and Man Pages That Agent Builder Creates

Support Files That Agent Builder Creates

Package Directory That Agent Builder Creates

rtconfig File

Cluster Agent Module for Agent Builder

How to Install and Set Up the Cluster Agent Module

How to Start the Cluster Agent Module

Using the Cluster Agent Module

Differences Between the Cluster Agent Module and Agent Builder

10.  Generic Data Service

11.  DSDL API Functions

12.  Cluster Reconfiguration Notification Protocol

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

Cluster Agent Module for Agent Builder

The Cluster Agent module for Agent Builder is a NetBeans module. This module enables you to create resource types for the Solaris Cluster software through the Java Studio Enterprise product.


Note - The Java Studio Enterprise documentation contains information about how to set up, install, and use the Java Studio Enterprise product. You can find this documentation at the http://developers.sun.com/jsenterprise/ web site.


How to Install and Set Up the Cluster Agent Module

The Cluster Agent module is installed when you install the Solaris Cluster software. The Solaris Cluster installation tool places the Cluster Agent module file scdsbuilder.jar in /usr/cluster/lib/scdsbuilder. To use the Cluster Agent module with the Java Studio Enterprise software, you need to create a symbolic link to this file.


Note - The Solaris Cluster and Java Studio Enterprise products and Java 1.4 must be installed and available to the system on which you intend to run the Cluster Agent module.


  1. Enable all users or only yourself to use the Cluster Agent module.
    • To enable all users, become superuser or assume a role that provides solaris.cluster.modify RBAC authorization, and create the symbolic link in the global module directory.

      # cd /opt/s1studio/ee/modules
      # ln -s /usr/cluster/lib/scdsbuilder/scdsbuilder.jar

      Note - If you installed the Java Studio Enterprise software in a directory other than /opt/s1studio/ee, substitute this directory path with the path that you used.


    • To enable only yourself, create the symbolic link in your modules subdirectory.

      % cd ~your-home-dir/ffjuser40ee/modules
      % ln -s /usr/cluster/lib/scdsbuilder/scdsbuilder.jar
  2. Stop and restart the Java Studio Enterprise software.

How to Start the Cluster Agent Module

The following steps describe how to start the Cluster Agent module from the Java Studio Enterprise software.


Note - The Java Studio Enterprise documentation contains information about how to set up, install, and use the Java Studio Enterprise product. You can find this documentation at the http://developers.sun.com/jsenterprise/ web site.


  1. From the Java Studio Enterprise File menu, choose New, or click this icon on the toolbar:
    image:Graphic that shows the New icon on the toolbar in the Java Studio Enterprise software

    The New Wizard screen appears.


    image:Dialog box that shows the New Wizard screen
  2. In the Select a Template pane, scroll down (if necessary) and click the key next to the Other folder.
    image:Inline graphic that shows the key for the Other folder

    The Other folder opens.


    image:Figure that shows the expanded Other folder menu
  3. From the Other folder, select Solaris Cluster Agent Builder and click Next.

    The Cluster Agent module for Java Studio Enterprise starts. The first New Wizard - Solaris Cluster Agent Builder screen appears.


    image:Dialog box that shows New Wizard Solaris Cluster Agent Builder screen when it first appears

Using the Cluster Agent Module

Use the Cluster Agent module as you would the Agent Builder software. The interfaces are identical. For example, the following figures show that the Create screen in the Agent Builder software and the first New Wizard - Solaris Cluster Agent Builder screen in the Cluster Agent module contain the same fields and selections.

Figure 9-4 Create Screen in the Agent Builder Software

image:Dialog box that shows the create screen after information has been entered

Figure 9-5 New Wizard - Solaris Cluster Agent Builder Screen in the Cluster Agent Module

image:Dialog box that shows the New Wizard Solaris Cluster Agent Builder screen after information has been entered

Differences Between the Cluster Agent Module and Agent Builder

Despite the similarities between the Cluster Agent module and Agent Builder, minor differences exist: