rpcsimp アプリケーションのインストール、構成、実行

以下のステップは、サンプル・アプリケーションのインストール、構成、実行を行う方法を示しています。

ステップ 1:アプリケーション・ディレクトリの作成

rpcsimp 用のディレクトリを作成し、そのディレクトリに移動します。

mkdir rpcsampdir
cd rpcsampdir

注記 この様にしておくと、作業開始時にあった rpcsimp 関連のファイルと、作業中に作成した新たなファイルを容易に把握できます。標準のシェル (/bin/sh) または Korn シェルを使用してください。C シェル (csh) は使わないでください。

ステップ 2:環境の設定

必要な環境変数を設定しエクスポートします。

TUXDIR=<BEA Tuxedo ルート・ディレクトリのパス名> 
TUXCONFIG=<ユーザが指定する作業ディレクトリのパス名>/tuxconfig
PATH=$PATH:$TUXDIR/bin
# SVR4, Unixware
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$TUXDIR/lib
# HPUX
SHLIB_PATH=$LD_LIBRARY_PATH:$TUXDIR/lib
# RS6000
LIBPATH=$LD_LIBRARY_PATH:$TUXDIR/lib
export TUXDIR TUXCONFIG PATH LD_LIBRARY_PATH SHLIB_PATH LIBPATH

BEA Tuxedo ATMI ディレクトリ内のファイルにアクセスできるように、さらに BEA Tuxedo ATMI のコマンドを実行できるように、TUXDIR と PATH を指定する必要があります。TUXCONFIG を設定し、コンフィギュレーション・ファイルがロードできるようにします。共有オブジェクトを使用する場合は、環境変数も設定する必要があります。(たとえば、LD_LIBRARY_PATH)。

ステップ 3:ファイルのコピー

rpcsimp 用のファイルをアプリケーション・ディレクトリにコピーします。

cp $TUXDIR/apps/rpcsimp/* .

ここでは一部のファイルを編集し、実行形式にするので、ソフトウェアに同梱されたオリジナルのファイルではなく、コピーしたファイルを使用して作業を開始することをお勧めします。

ステップ 4:ファイルの一覧表示

ファイルを一覧表示します。

$ ls
client.c
dcebind.c
dceepv.c
dcemgr.c
dceserver.c
rpcsimp.mk
simp.idl
simpdce.acf
ubbconfig
$

(このセクションで参照しない一部のファイルは省略しています。)

IDL ACF ファイル―simpdce.acf

simpdce.acf

[explicit_handle]interface changecase
{
}

「付録Α」の例で用いた simp.idl ファイルは、ゲートウェイと DCE サーバの構築に使用されます。しかし、simp.idl ファイルは DCE コンパイラと BEA Tuxedo の IDL コンパイラの両方でコンパイルされるために、2 つの simp.h ヘッダ・ファイルが同じ名前で作成されます。また、クライアントにではなく、サーバに明示的バインディングを指定できるように、この例では ACF ファイルを使用しています。バインディングを指定しない TxRPC 用のものと、明示的ハンドルをもつ DCE/RPC 用のものを使用して、同一ディレクトリ内で第 2 のファイル名に IDL ファイルをリンクすることをお勧めします。この場合、simp.idl は simpdce.idl に名前が変更され、また関連する ACF ファイルは simpdce.acf になります。Makefile は simpdce.idl を作成し、さらに IDL コンパイラを実行するときに simpdce.acf も検索します。インターフェイスのすべてのオペレーションが明示的ハンドルを使用することを示すために、ACF ファイルが使用されている点に注意してください。第 1 パラメータとして［handle］パラメータを指定せずにオペレーションが IDL ファイル内で定義されているので、1 つのオペレーションが自動的に関数プロトタイプとスタブ関数呼び出しに追加されます。

関数のバインディング―dcebind.c

ここではページ数の制限から dcebind.c 用のソース・コードは示していませんが、$TUXDIR/apps/rpcsimp にあります。

このファイルには次の 3 種類の作業を行う関数、dobind() が含まれます。

dcebind.c では次の事項を修正する必要があります。

エントリ・ポイント・ベクトル―dceepv.c

dceepv.c

#include <simpdce.h>   /* IDL コンパイラによって生成されるヘッダ */
#include <dce/rpcexc.h> /* RAISE マクロ */

static void myto_upper(rpc_binding_handle_t hdl, idl_char *str);
static void myto_lower(rpc_binding_handle_t hdl, idl_char *str);

/*
 * マネージャのエントリ・ポイント・ベクトルは、
 * 有効な DCE バインディング・ハンドルを生成して DCE サーバに送れるように定義されます。
 * Tuxedo  はハンドルをサポートしないので、エントリ・ポイント関数への入力ハンドルは、
 * 常に NULL になることに注意してください。
 */

 /* 2 つのオペレーションを持つマネージャ・エントリ・ポイント・ベクトル */
changecase_v1_0_epv_t changecase_v1_0_s_epv = {
  myto_upper,
  myto_lower
};

int dobind(rpc_binding_handle_t *hdl);

void
myto_upper(rpc_binding_handle_t hdl, idl_char *str)
{
  rpc_binding_handle_t handle;
  if (dobind(&handle) 0) {  /* サーバ用のバインディング・ハンドルを取得 */
   userlog("binding failed");
   RAISE(rpc_x_invalid_binding);
  }
  to_upper(handle, str);   /* DCE クライアント・スタブを呼び出す */
}

void
myto_lower(rpc_binding_handle_t hdl, idl_char *str)
{
  rpc_binding_handle_t handle;
  if (dobind(&handle) 0) { /* サーバ用のバインディング・ハンドルを取得 */
   userlog("binding failed");
   RAISE(rpc_x_invalid_binding);
  }
  to_lower(handle, str);   /* DCE クライアント・スタブを呼び出す */
}

dceepv.c にはゲートウェイで使用されるマネージャ・エントリ・ポイント・ベクトルが含まれます。マネージャ・エントリ・ポイント・ベクトルは BEA Tuxedo ATMI サーバ・スタブによって呼び出され、DCE クライアント・スタブを呼び出します。構造体のデータ型は simpdce.h で定義され、dceepv.c にインクルードされます。またデータ型は、ローカル関数 myto_upper() と myto_lower() によって初期化されます。これらの関数はそれぞれ dobind() を呼び出して、認証済み RPC のために注釈が付けられたバインディング・ハンドルを取得し、関連するクライアント・スタブ関数を呼び出します。

DCE マネージャ―dcemgr.c

dcemgr.c

#include <stdio.h>
#include <ctype.h>
#include "simpdce.h"    /* IDL コンパイラによって生成されるヘッダ */
#include <dce/rpcexc.h>  /* RAISE マクロ */

#include <dce/dce_error.h> /* dce_error_inq_text を呼び出すために必要 */
#include <dce/binding.h>  /* レジストリにバインディング */
#include <dce/pgo.h>    /* レジストリ・インターフェイス */
#include <dce/secidmap.h> /* グローバル名をプリンシパル名に変換 */

void
checkauth(rpc_binding_handle_t handle)
{
  int error_stat;
  static unsigned char error_string[dce_c_error_string_len];
  sec_id_pac_t *pac;           /* クライアント・パッケージ */
  unsigned_char_t *server_principal_name; /* 要求されるサーバ・プリンシパル */
  unsigned32  protection_level;     /* 保護レベル */
  unsigned32  authn_svc;         /* 認証サービス */
  unsigned32  authz_svc;         /* 権限サービス */
  sec_rgy_handle_t rgy_handle;
  error_status_t status;
  /*
   * クライアントがこの呼び出しのために選択した認証パラメータを
   * チェックします。
   */
   rpc_binding_inq_auth_client(
     handle,           /* 入力ハンドル */
     (rpc_authz_handle_t *)&pac,  /* 返されるクライアント・パッケージ */
     &server_principal_name,    /* 返される要求サーバのプリンシパル */
     &protection_level,      /* 返される保護レベル */
     &authn_svc,          /* 返される認証サービス */
     &authz_svc,    /* 返される権限サービス */
     &status);
  if (status != rpc_s_ok) {
     dce_error_inq_text(status, error_string, &error_stat);
     fprintf(stderr, "%s %s\n", "inq_auth_client failed",
       error_string);
     RAISE(rpc_x_invalid_binding);
     return;
  }
  /*
   * 呼び出し側が呼び出し側で必要な
   * 保護レベル、認証レベルおよび権限レベルを指定していることを確認します。
   */
  if (protection_level != rpc_c_protect_level_pkt_integ ||
    authn_svc != rpc_c_authn_dce_secret ||
    authz_svc != rpc_c_authz_dce) {
      fprintf(stderr, "not authorized");
      RAISE(rpc_x_invalid_binding);
      return;
    }
    return;
}

void
to_upper(rpc_binding_handle_t handle, idl_char *str)
{
  idl_char *p;

  checkauth(handle);

  /* ACL または参照モニタ・チェックはここで実行できます */
  
  /* 大文字に変換 */
  for (p=str; *p != '\0 '; p++)
    *p = toupper((int)*p);
  return;
}

void
to_lower(rpc_binding_handle_t handle, idl_char *str)
{
  idl_char *p;

  checkauth(handle);

  /* ACL または参照モニタ・チェックはここで実行できます */

  /* 小文字に変換 */
  for (p=str; *p != '\0 '; p++)
    *p = tolower((int)*p);
  return;
}

dcemgr.c には DCE サーバ用のマネージャ・コードがあります。checkauth() 関数は、クライアントの認証 (保護、認証、権限のレベル) を検査するユーティリティ関数です。各オペレーション、to_upper および to_lower はこの関数を呼び出してクライアントの妥当性を検査し、次にオペレーション自体を実行します。アクセス制御リストを使用するアプリケーションでは、ACL 検査は認証検査の後、オペレーションの実行の前に行われます。

DCE サーバ―dceserver.c

ここではページ数の制限から dceserver.c 用のソース・コードは示しません。使用する環境に応じて、このファイルにはいくつか修正を加える必要があります。

ここで、SERVER_PRINCIPAL は、サーバが実行される DCE プリンシパル、PASSWORD はプリンシパルに関連付けられたパスワード、SERVER_KEYTAB はサーバ・キー・テーブルの名前です。

<PRINCIPAL > は、サーバが実行される DCE プリンシパルの名前に変更する必要があります。

"ANNOTATION " は、注釈がサーバ用のディレクトリ・エントリに保存されるように変更できます。

dceserver.c は、実際にはアプリケーションで 2 回使用されます。1 回は DCE サーバ用の main() として使用され、もう 1 回は DCE ゲートウェイ用の tpsvrinit() (makefile で gwinit.c にリンクされ、DTPSVRINIT を使用してコンパイルされます) として使用されます。

特別なマクロ定義を指定しないでコンパイルすると、このファイルは、次の作業を行う DCE サーバのための main() を (argc と argv コマンド行オプションを持ちます) を生成します。

このプログラムは、コマンド行オプションを調べ、それらを使用するように修正できます。

-DTCLIENT でコンパイルすると、このファイルは上記のように main() を生成しますが、tpinit() を呼び出してクライアントとして BEA Tuxedo ATMI アプリケーションに参加し、終了する前に tpterm() を呼び出します。これは、プロセスが DCE サーバおよび BEA Tuxedo ATMI クライアントになるような、DCE から BEA Tuxedo に渡される呼び出し用の DCE ゲートウェイとして使用されます。

-DTPSVRINIT でコンパイルすると、このファイルは、次の作業行う BEA Tuxedo サーバのために tpsvrinit() (argc と argv サーバ・コマンド行オプションを持ちます) を生成します。

このプログラムは、コマンド行オプションを調べ、それらを使用するように修正できます。

これらの各事例で、ログイン・コンテキストは establish_identity を呼び出すことで確立されますが、この establish_identity は、サーバのネットワーク識別子を取得し、キー・テーブル・ファイル内のサーバのシークレット・キーを使用して識別子を解除し、プロセスのログイン・コンテキストを設定します。2 つのスレッドが開始されます。最初のスレッドは有効期限が切れる前にログイン・コンテキストを最新状態に更新し、もう一つのスレッドはサーバのシークレット・キーを定期的に変更します。

Makefile―rpcsimp.mk

rpcsimp.mk

CC=cc
CFLAGS=
TIDL=$(TUXDIR)/bin/tidl
LIBTRPC=-ltrpc
all:client server
# Tuxedo クライアント
client:simp.h simp_cstub.o
  CC=$(CC) CFLAGS=$(CFLAGS) $(TUXDIR)/bin/buildclient -oclient \
    -fclient.c -fsimp_cstub.o -f$(LIBTRPC)
#
# Tuxedo サーバ省略
#

# Tuxedo ゲートウェイ例
# 上記の Tuxedo クライアントとゲートウェイ・サーバおよび DCE サーバを使用
#
#
# Alpha FLAGS/LIBS
#DCECFLAGS=-D_SHARED_LIBRARIES -Dalpha -D_REENTRANT -w -I. \
  -I/usr/include/dce -I$(TUXDIR)/include
#DCELIBS=-ldce -lpthreads -lc_r -lmach -lm
#
#
# HPUX FLAGS/LIBS
#DCECFLAGS=-Aa -D_HPUX_SOURCE -D_REENTRANT -I. \
  -I/usr/include/reentrant -I${TUXDIR}/include
#DCELIBS=-Wl,-Bimmediate -Wl,-Bnonfatal -ldce -lc_r -lm
#
IDL=idl

ALL2=client simpgw dceserver
all2:$(ALL2)

# Tuxedo から DCE へのゲートウェイ
simpdce.idl:simp.idl
  rm -f simpdce.idl
  ln simp.idl simpdce.idl

gwinit.c:dceserver.c
  rm -f gwinit.c
  ln dceserver.c gwinit.c

gwinit.o:gwinit.c
  $(CC) -c $(DCECFLAGS) -DTPSVRINIT gwinit.c

dceepv.o:dceepv.c simpdce.h
   $(CC) -c $(DCECFLAGS) dceepv.c

dcebind.o:dcebind.c simpdce.h
  $(CC) -c $(DCECFLAGS) dcebind.c

simpgw:simpdce.idl gwinit.o dcebind.o dceepv.o
  blds_dce -i -no_mepv -o simpgw -f -g -f gwinit.o -f \ 
    dcebind.o -f dceepv.o simpdce.idl

# DCE サーバ
simpdce_sstub.o simpdce.h:simpdce.idl
  $(IDL) -client none -keep object simpdce.idl

dceserver.o:dceserver.c simpdce.h
  $(CC) -c $(DCECFLAGS) dceserver.c

dcemgr.o:dcemgr.c simpdce.h
  $(CC) -c $(DCECFLAGS) dcemgr.c

dceserver:simpdce_sstub.o dceserver.o dcemgr.o
  $(CC) dceserver.o simpdce_sstub.o dcemgr.o -o dceserver \ 
    $(DCELIBS)

# クリーンアップ
clean::
  rm -f *.o server $(ALL2) ULOG.* TUXCONFIG
  rm -f stderr stdout *stub.c *.h simpdce.idl gwinit.c

clobber:clean

makefile は実行可能クライアント、ゲートウェイ、DCE サーバ・プログラムを構築します。

このソフトウェアを構築する前に、rpcsimp.mk を修正して DCE サーバを構築するための正しいオプションとライブラリを設定する必要があります。上記で示したように、makefile には複数のプラットフォームに対応した設定が含まれています。使用しているプラットフォームに応じて、該当する DCECFLAGS と DCELIBS 変数ペアのコメント文指定を解除します (シャープ記号を削除します)。異なるプラットフォームを使用しているのであれば、独自の定義を追加します。

ステップ 5:構成の変更

ステップ 6:アプリケーションの構築

ステップ 7:コンフィギュレーション・ファイルのロード

次のコマンドを実行してバイナリの TUXCONFIG コンフィギュレーション・ファイルをロードします。

tmloadcf -y ubbconfig

ステップ 8: DCE の構成

上記で説明したアプリケーション例を実行するための DCE エンティティの設定手順を次に示します。すべての文字が大文字で表される識別子は、使用する環境に応じてカスタマイズ化します。

ステップ 9:コンフィギュレーションの起動

ステップ 10:クライアントの実行

変換する文字列を指定してクライアント・プログラムを実行できます。変換する文字列は省略できます。クライアント・プログラムは、まず文字列を大文字に変換し、この後小文字に変換します。

$ client HeLlO
to_upper returns:HELLO
to_lower returns:hello
$

ステップ 11:構成のシャットダウン

ステップ 12:作成ファイルのクリーンアップ

次のコマンドを入力し、作成したファイルを削除します。

make -f rpcsimp.mk clean