はじめに

このマニュアルでは、RMAPI (Resource Management (リソース管理) API) を使用して、SPARC® と x86 ベースシステムの両方で Sun^TMCluster データサービスを開発する方法について説明します。

このマニュアルで使われる用語「x86」は、Intel 32 ビットファミリのマイクロプロセッサチップと AMD 社の互換マイクロプロセッサチップを指しています。

Sun Cluster ソフトウェアは、SPARC と x86 の 2 つのプラットフォーム上で稼動します。このマニュアル内の情報は、章、節、注、箇条書き項目、図、表、または例などで特に明記されていない限り両方に適用されます。

対象読者

このマニュアルは、Sun のソフトウェアとハードウェアについて豊富な知識を持っている経験のある開発者を対象にしています。 このマニュアルの情報は、Solaris^TM オペレーティングシステムの知識があることを前提としています。

内容の紹介

このマニュアルは、次の章と付録で構成されています。

• 第 1 章「リソース管理の概要」では、データサービスを開発するのに必要な概念について説明します。

• 第 2 章「データサービスの開発」では、データサービスの開発に関する詳細な情報を説明します。

• 第 3 章「リソースタイプの更新」では、リソースタイプの開発者がリソースタイプの更新や移行を行うために必要な情報を提供します。

• 第 4 章「Resource Management API リファレンス」では、Resource Management API (RMAPI) を構成するアクセス関数とコールバックメソッドに関する情報を説明します。

• 第 5 章「サンプルデータサービス」では、in.named() アプリケーション用の Sun Cluster データサービスの例を示します。

• 第 6 章「データサービス開発ライブラリ (DSDL)」では、Data Services Development Library (DSDL) を構成するアプリケーションプログラミングインタフェースの概要について説明します。

• 第 7 章「リソースタイプの設計」では、リソースタイプの設計と実装における DSDL の代表的な使用例について説明します。

• 第 8 章「サンプル DSDL リソースタイプの実装」では、DSDL により実装されるリソースタイプの例を説明します。

• 第 9 章「SunPlex Agent Builder」では、SunPlex ^TMAgent Builder について説明します。

• 第 10 章「汎用データサービス」では、一般的なデータサービスの作成方法について説明します。

• 第 11 章「データサービス開発ライブラリのリファレンス」では、DSDL API 関数について説明します。

• 第 12 章「CRNP」では、Cluster Reconfiguration Notification Protocol (CRNP) について説明します。 CNP を使用することで、フェイルオーバー用のアプリケーションや拡張性のあるアプリケーションを「クラスタ対応」として設定できます。

• 付録 A 「標準プロパティ」 では、標準リソースタイプ、リソースグループ、リソースプロパティについて説明します。

• 付録 B 「データサービスのコード例」 では、データサービスの例について、それぞれのメソッドの完全なコードを示します。

• 付録 C 「サンプル DSDL リソースタイプのコー ド例 」 では、SUNW.xfnts() リソースタイプにおける各メソッドの完全なコードを示します。

• 付録 D 「RGM の有効な名前と値」 では、Resource Group Manager (RGM) の名前と値についての文字の要件を説明します。

• 付録 E 「非クラスタ対応のアプリケーションの要件」 では、クラスタに対応していない、通常のアプリケーションを高可用性に適用させる要件を説明します。

• 付録 F 「CRNP のドキュメントタイプ定義」 では、CRNP のドキュメントタイプ定義を説明します。

• 付録 G 「CrnpClient.java アプリケーション」 では、第 12 章「CRNP」で説明されている CrnpClient.java の完全なアプリケーションを示します。

関連マニュアル

Sun Cluster の関連トピックについての情報は、次の表に示すマニュアルを参照してください。 すべての Sun Cluster マニュアルは、http://docs.sun.com で参照できます。

Sun Cluster マニュアルの完全なリストについては、ご使用の Sun Cluster リリースのリリースノートを参照してください。リリースノートは、 http://docs.sun.com にあります。

問い合わせについて

Sun Cluster のインストールまたは使用で問題が発生した場合は、ご購入先に連絡し、次の情報をお伝えください。

• 名前と電子メールアドレス (利用している場合)

• 会社名、住所、および電話番号

• システムのモデルとシリアル番号

• オペレーティングシステムのバージョン番号 (例: Solaris 10)

• Sun Cluster のバージョン番号 (例: Sun Cluster 3.1)

ご購入先に知らせる、システム上の各ノードについての情報を収集するには、次のコマンドを使用します。

上記の情報にあわせて、/var/adm/messages ファイルの内容もご購入先にお知らせください。

Sun のオンラインマニュアル

docs.sun.com では、Sun が提供しているオンラインマニュアルを参照することができます。マニュアルのタイトルや特定の主題などをキーワードとして、検索を行うこともできます。URL は、http://docs.sun.com です。

表記上の規則

このマニュアルでは、次のような字体や記号を特別な意味を持つものとして使用します。

sun% grep `^#define \
  XV_VERSION_STRING'

コード例は次のように表示されます。

• C シェル

  machine_name% command y|n [filename]

• C シェルのスーパーユーザー

  machine_name# command y|n [filename]

• Bourne シェルおよび Korn シェル

  $ command y|n [filename]

• Bourne シェルおよび Korn シェルのスーパーユーザー

  # command y|n [filename]

[ ] は省略可能な項目を示します。上記の例は、filename は省略してもよいことを示しています。

| は区切り文字 (セパレータ) です。この文字で分割されている引数のうち 1 つだけを指定します。

キーボードのキー名は英文で、頭文字を大文字で示します (例: Shift キーを押します)。ただし、キーボードによっては Enter キーが Return キーの動作をします。

ダッシュ (-) は 2 つのキーを同時に押すことを示します。たとえば、Ctrl-D は Control キーを押したまま D キーを押すことを意味します。