SuSE Linux x86 への VisiBroker のインストール

このドキュメントでは、SuSE Linux x86（32 ビット）オペレーティングシステム上に、VisiBroker をインストールする方法について説明します。

VisiBroker 7.0 は、CD からインストールするか、http://www.borland.com/downloads/download_visibroker.html からダウンロードしてインストールすることができます。

ドキュメントの更新版については、http://www.borland.com/techpubs を参照してください。

特に、VisiBroker 4.x、5.x、6.x および 7.0 に関するドキュメントの更新版については、 http://info.borland.com/techpubs/visibroker/ をご参照ください。

注意：

VisiBroker の以前のバージョンがある場合には、それをアンインストールするか、新しいバージョンを別の場所、つまり別のインストールパス上へインストールすることを推奨します。評価バージョンをインストールした後で、VisiBroker を永続使用するためのライセンスを購入した場合、評価したソフトウェアを再インストールする必要はありません。新しいライセンスの有効化については、「ライセンスと登録」を参照してください。

インストールの準備

SuSE Linux 上にインストールする前に、次のことを行う必要があります：

プラットフォーム要件とシステム要件の確認
JDK 要件の確認

プラットフォーム要件とシステム要件

VisiBroker を SuSE Linux 上にインストールする前に、プラットフォーム、システム、JDK の各要件に関する最新情報を確認してください。

プラットフォーム固有の要件のほか、Borland VisiBroker コンポーネントは、通信に TCP および UDP によるブロードキャストサービスを使用しています。これらのコンポーネントを単一コンピュータ上で実行する場合でも、TCP および UDP サービスが有効になっている必要があります。

JDK 要件

SuSE 用インストールパッケージには、どのバージョンの Java Development Kit（JDK）も同梱されていません。 SuSE の Java 製品に関する情報については、http://www.ibm.com/developerworks/java/jdk を参照してください。

Borland VisiBroker のインフラストラクチャおよびツールは、JDK 1.4.2 を使用します。

重要： SuSE 上にインストールする前に、JDK がインストールされている必要があります。 JDK 1.4.2 の bin ディレクトリが、PATH 変数に入っていることを確認してください。

CD に収録されている インストールパッケージには、バンドルバージョンの Java Development Kit (JDK) が含まれています。しかし VisiBroker を Web よりダウンロードした場合は、インストーラを実行するために、環境に JRE 1.4.2 がセットアップされていることが必要です。

お使いの JDK の場所やバージョンを確認するには、次の構文を使用します：

$which java
/opt/local/bin/java
$java -version
java version "1.4.2"

SuSE Linux への VisiBroker CD のマウント

Borland VisiBroker CD には、SuSE オペレーティングシステム向けのインストールソフトウェアが収録されています。このセクションでは、SuSE に CD から VisiBroker をインストールするための準備について説明します。

手動で SuSE Linux 上に CD-ROM をマウントするには：

root 権限を持つユーザーとしてログインします。
ドライブに CD-ROM を挿入し、次のコマンドを入力します：
```
 # mount -t iso9660 -o ro /dev/cdrom /cdrom 
```
ここでの /cdrom は、CD-ROM のマウントポイントを表します。

CD-ROM を自動マウントソフトウェアを使用してマウントするには：

自動マウントソフトウェアを使用している場合、CD-ROM を CD-ROM ドライブへ入れると、自動マウント設定で指定されたディレクトリへ、自動的にマウントされます。この場合、次の手順「Borland VisiBroker のインストール」に進んでください。

自動マウントソフトウェアかどうかを確認するには、次のコマンドを使用します：

$ ps aux | grep automount

自動マウントソフトウェアを使用している場合には、出力メッセージが次に似たものになります：

root 628 0.0 0.2 1148 588 ? S 17:32 0:00 /usr/sbin/automount

VisiBroker インストール後、CD のマウントを解除するには：

ルートに移動し、次のコマンドを入力します：

umount /cdrom （CD-ROM を手動でマウントした場合）

eject cdrom （自動マウントソフトウェアを使用して CD-ROM をマウントした場合）

SuSE Linux への VisiBroker のインストール

VisiBroker は、CD からインストールするか、http://www.borland.com/downloads/download_visibroker.html からダウンロードしてインストールすることができます。

VisiBroker をインストールする前に、インストール方法を選択します：

ボーランドの Web サイトから製品版をダウンロードする場合は、上記のサイトを参照してください。
CD からインストールする場合は、CD をマウントしてインストールを開始してください。
プロパティファイルの定義を使用して、自動インストールを実行する場合は、「自動インストールの起動」を参照してください。

CD から VisiBroker をインストールする場合：
1. CD-ROM をマウントします。
2. 次のコマンドを入力して、インストーラを起動します：
```
	$ /cdrom/install_linux
```
  ここでの /cdrom は、CD-ROM がマウントされたディレクトリです。
  重要：デフォルトブラウザを使用するために、Mozilla（/usr/bin にあります）がパスに入っていることを確認してください。
3. しばらくすると、CD スプラッシュ画面が表示されます。インストールウィザードが別ウィンドウで起動します。
4. インストールする製品を選択します。
  注意： CD に収録されている Readme やインストールガイドを表示したり、CD の内容を参照するには、スプラッシュ画面で該当する項目をクリックします。
  
  ほとんどのオプションでは、インストールウィザードで示されるデフォルトをそのまま使用できます。 [Previous] ボタンを使用すると、画面に戻って情報を変更することができます。
ダウンロードファイルからインストールする場合：
1. 次のコマンドで、インストーラを起動します：
```
 java -cp vb7-<release number>-linux-suse-<arch>.jar install 
```
  ここでの <arch> は、x86 です。
  
  ほとんどのオプションでは、インストールウィザードで示されるデフォルトをそのまま使用できます。 [Previous] ボタンを使用すると、画面に戻って情報を変更することができます。
[Introduction]： 最初のメッセージを読み、[Next] をクリックします。
[License agreement]： VisiBroker をインストールおよび使用するには、この契約に同意する必要があります。
[Choose the Install Folder]： VisiBroker の新しいインストールを作成するか、既存のインストールにコンポーネントを追加します。
重要： VisiBroker のこのバージョンは、以前のリリース上に上書きインストールすることはできません。
[Choose Product Components]： インストールする Borland Deployment Platform 製品に合わせて、次の製品コンポーネント群から必要な機能セットを選択します：

[VisiBroker Console]： VisiBroker ORB とサービス群を管理するための GUI とツール。

[VisiBroker Core]： VisiBroker for Java 開発ツール、VisiBroker for C++ 開発ツールと、サーバーコンポーネント。

[Documentation]： オンラインドキュメント一式。

[Examples]： VisiBroker のサンプルアプリケーション。

[VisiBroker Extended Services]： VisiBroker の拡張機能として購入可能なオプションのコンポーネント。
[Choose VisiBroker Extended Services]： 購入した VisiBroker Extended Services のインストールを選択した場合は、次の拡張サービスから選択します。

[VisiNotify]： OMG Event/Notification Service に対する ORB レベルの高機能実装。

[VisiSecure]： クライアントとサーバーの間にセキュリティで保護された接続を確立するためのフレームワーク。

[VisiTime]： OMG Time Service 仕様、バージョン 1.1 の完全実装。

[VisiTransact]： インターネットやイントラネットにおける CORBA アプリケーションでのトランザクションのための OMG トランザクション管理ソリューションの完全実装。

[VisiTelcoLog]： OMG Telecom Log Service 仕様、バージョン 1.1.2 の OMG 準拠実装。
[Choose Install Type]： インストールには次の2つタイプがあります： [Typical] （標準）インストールタイプ、[Custom] （カスタム）インストールタイプ。
- 標準インストールタイプ は、デフォルトの設定を使用する簡易インストールです。
  注意：標準インストールでは、VisiBroker の bin フォルダが PATH に追加されません。追加するには、インストールタイプで [Custom] を選択します。
- カスタムインストールタイプ では、Smart Agent のポートを指定できます。 Smart Agent は osagent とも呼ばれます。このポートは、ORB がサーバーと通信する際に使用されます。値は、5000 から 65535 の間で選択してください。デフォルトは 14000 です。

注意：デフォルトを選択した場合、コンポーネントによっては環境パスへ手動で追加する必要が出てきます。VisiBroker の環境変数を追加するためにカスタムインストールタイプを選択した場合、インストーラは、変数 BES_LIC_DIR に <install_dir>/var を、変数 BES_LIC_DEFAULT_DIR に <install_dir>/license を設定します。

[Pre-Installation Summary]： インストールを開始する前に、表示された情報を確認してください。 [Previous] ボタンをクリックすると、すでに選択したページに戻り、内容を変更することができます。ただし、インストールする製品の変更はできません。選択内容を承認してインストールを開始するには、[Install] ボタンをクリックします。
[Registration]：
- インストーラを終了する前に Borland Product Registration Wizard （以降、登録ウィザード）を起動するには、[Yes] （デフォルト）を選択して [Next] をクリックします。登録ウィザードが別ウィンドウで起動します登録ウィザードを終了すると、[installer completion] パネルが表示されます。
- VisiBroker の評価バージョンまたは無料バージョンをインストールする場合は、登録ウィザードを起動するかどうかをたずねられません。 VisiBroker を使用する前に、ボーランドから電子メールで受け取ったライセンスアクティベーションキーファイルを、<install_dir>/license ディレクトリにコピーしてください。ライセンスアクティベーションキーファイルを受け取ってない場合、またはソフトウェアを再インストールする場合には、http://www.borland.com/downloads/download_visibroker.html にアクセスし、新しいライセンスキーをダウンロードしてください。
重要：製品を使用するには、ライセンスを登録し有効にする必要があります。

注意：後から lmadm 実行可能ファイル（<install_dir>/bin ディレクトリにあります）を実行して、ライセンスを登録、有効化したい場合には、[No] を選択して [Next] をクリックしてください。
[Make a Selection] 画面で、次のオプションのいずれかをクリックします：
[Have a serial Number]：シリアル番号を入力します。

[Have Activation file]：アクティベーションファイルへのパスを入力します。
インストール完了後、[Done] をクリックしてインストーラを終了させます。

注意： lmadm 実行可能ファイル（<install_dir>/bin ディレクトリにあります）を実行して、後からライセンスを登録、有効化することも可能です。

ホストによっては、インストール中にライセンス登録ウィザード（lmadm）が開始するのに、時間がかかる場合があります。この現象は、特にシステムが IPv6 スタックを使用するよう設定されている場合に見られます。マシンの設定やネットワークの設定が正しくない場合、接続の試みが遅くなる可能性があります。これを解決するには、インストール時のライセンス登録フェーズはスキップし、インストールが完了した後に別途ライセンス登録を行ってください。

注意：

VisiBroker が NFS マウントディレクトリにインストールされた際に、そのシステム一時ディレクトリの空き容量が十分でない場合、 NFS サーバーがそのディレクトリ内のファイルを定期的にロックするため、インストール後のクリーンアップ処理で、すべての一時ファイルを削除できない場合があります。この場合、一時的なディレクトリやファイルを、インストール後に手動で削除してください。

インストールログ

インストーラが生成するインストールログは、VisiBroker が CD からインストールされた場合には、インストールディレクトリのルートに、VisiBroker のインストールにダウンロードしたファイルが使用された場合には、そのインストーラファイルがあるフォルダに、書き出されます。

VisiBroker インストールログファイル：

<install_dir>/Borland_VisiBroker_InstallLog.xml

ファイルは XML 形式のログで、エラーなどのインストール固有の情報が保存されています。

GUI を使用しないインストーラの実行

UNIX システムでは、テキストのみのモードでインストーラを実行することができます。 UI モードを指定するパラメータを使用して、インストーラを起動できます。

テキストモードでインストーラを実行するには：

インストーラ実行可能ファイルがあるフォルダへ移動し、次のコマンドを入力します：
```
 java -cp <install_file>.jar install -i console 
```
インストーラが起動したら、画面上のインストールパネルの指示に従ってください。
インストーラは stdout へ書き込み、stdin から読み込みます。これにより、１つのシステムから別のシステムへ telnet で接続し、インストーラをリモートで実行することができます。

VisiBroker for C++ サーバー、VisiTransact、VisiNotify における、ライセンス変数の設定

VisiBroker C++ サーバー、VisiTransact、VisiNotify を実行する前に、2つのライセンス環境変数（BES_LIC_DIR と BES_LIC_DEFAULT_DIR）を設定する必要があります。インストール中に、これらの環境変数の設定に使用する、シェルスクリプトが作成されています。

これらの変数を設定するには：

コマンドウィンドウを開きます。
<install_dir>/bin ディレクトリへ移動します。
使用しているシェルに適したスクリプトを特定します。
Korn シェルまたは Bourne シェルを使用している場合は、次のスクリプトを使用して環境変数を設定します。
```
vbroker.sh
```
C シェルを使用している場合は、次のスクリプトを使用して環境変数を設定します。
```
vbroker.csh
```
ログイン時にこのスクリプトが自動的に実行されるよう、.profile、.cshrc、または .login ファイルにコマンドを追加します。

自動インストールの利用

自動インストールプロセスを起動する前に、まず、インストールディレクトリ、サーバー名、JDK Home などの環境設定プロパティを記述したテキストファイルを作成する必要があります。各プロパティは 1 行で記述され、各行は CR で終わる必要があります。また、行末に空白があったり、ファイルの末尾に空白行があってはなりません。より詳しい情報については、セクション「自動インストールに使用するプロパティファイル」を参照してください。

テキストプロパティファイルを作成したら、それを <propertiesfile>.txt という名前で保存します（<propertiesfile> は作成したプロパティファイルのファイル名です）。これで、プロパティファイルで指定した値を使用する自動インストールプロセスを起動できます。

注意：すべてのプロパティと値で、大文字と小文字が区別されます。ディレクトリとファイルのパスを指定する場合は、必ずスラッシュ（/）を使用してください。

自動インストールに使用するプロパティファイル

プロパティファイルはテキストファイルであり、各プロパティは 1 行で記述され、各行は CR で終わる必要があります。また、行末に空白があったり、ファイルの末尾に空白行があってはなりません。ファイル内でプロパティはどんな順番でも構いません。

自動インストールに使用するプロパティファイルの内容

変数	値
INSTALLER_UI	`silent`（必須）。インストールのモードです。
USER_INSTALL_DIR	`<install_dir>`（必須）。 VisiBroker への完全パス名。デフォルトのインストールディレクトリは、`/opt/Borland/VisiBroker` です。
OSAGENT_PORT	（任意）。デフォルトは `14000` です。
USER_SHORTCUTS	`/dev/null`（必須）。
INSTALL_DOCS	オンラインドキュメント一式をインストールします。デフォルトは `YES` です。
INSTALL_EXAMPLES	VisiBroker のサンプルアプリケーションをインストールします。デフォルトは `YES` です。
INSTALL_TYPE	`VisiBroker`（必須）。VisiBroker をインストールします。
JVM_JDK_HOME	（任意）。ユーザーアプリケーションコードのホストとなる VisiBroker コンポーネントで使用する JDK パスを設定します。デフォルトは、VisiBroker に付属する JDK がインストールされる場所に設定されます。
INSTALL_VBCONSOLE	VisiBroker ORB とサービス群を管理するための GUI とツールをインストールします。デフォルトは `YES` です。
INSTALL_VISICORE	VisiBroker for Java 開発ツール、VisiBroker for C++ 開発ツールと、サーバーコンポーネントをインストールします。デフォルトは `YES` です。
VISI_SERVICES	`INSTALL_TYPE` が `VisiBroker` の場合、購入されているすべての VisiBroker Extended Services をインストールします。値は次のエントリで構成された、カンマ区切りのリストです： `VisiNotify` `VisiSecure` `VisiTime` `VisiTransact` `VisiTelcoLog` たとえば、VisiBroker Edition with VisiNotify と VisiTransact を購入した場合、これらの追加サービスをインストールするには、自動インストールの `<properties>.txt` ファイルに、次の行をいれます： `VISI_SERVICES=VisiNotify,VisiTransact` オプション製品である Extended Service のそれぞれの詳細については、「Choose VisiBroker Extended Services」を参照してください。
CONFIGURATION_SETUP	VisiBroker のサンプル構成をインストールします。デフォルトは `YES` です。
VISICORE_FEATURES	{ `Java` \| `.NET` }。 VisiBroker for Java/C++、または VisiBroker for .NET、もしくはその両方をインストールするのかを指定します。デフォルトは、VisiBroker for Java/C++ です。これは、INSTALL_VISICORE=NO が指定されている場合には、無視されます。

VisiBroker 用の自動インストールプロパティの例

この例では、VisiBroker Edition を、デフォルト以外のエージェントポートへインストールし、さらに、いくつかの VisiBroker Extended Services もインストールします。

 INSTALLER_UI=silent
 USER_INSTALL_DIR=/opt/Borland/VisiBroker
 USER_SHORTCUTS=/dev/null
 OSAGENT_PORT=14925
 INSTALL_TYPE=VisiBroker
 VISI_SERVICES=VisiNotify,VisiSecure,VisiTime,VisiTransact,VisiTelcoLog

自動インストールの起動

プロパティファイルで指定した値を使用する自動インストールプロセスを起動するには：

コマンドラインシェルを開きます。
VisiBroker for SuSE Linux を、ボーランドの Web サイトからダウンロードします。
インストーラをダウンロードしたディレクトリへ移動し、インストーラを実行するために、そのファイルに対してすべて許可のアクセス権を設定します（chmod 777 <installer file>。ここでの 777 は「すべて許可」を意味します）。
次のコマンドを入力して、自動インストールプロセスを起動させます。必ず <propertiesfile> ファイルへの完全パス名を指定してください：
```
java -cp <installer file>.jar install -f <path to propertiesfile>
```

注意：自動インストールが完了したら、インストールした製品用に入手したライセンスを登録し有効にする必要があります。ライセンスは、1 つ以上のシリアル番号とライセンスキーが記載された電子メールか、ライセンスキーファイルを添付した電子メールの形で、ボーランドより送られてきます。 lmadm 実行可能ファイル（<install_dir>/bin ディレクトリにあります）を実行して、後からライセンスを登録、有効化することも可能です。

ライセンスと登録

VisiBroker を使用する前に、インストールした製品用に入手したライセンスを登録し有効にする必要があります。ライセンスは、1 つ以上のシリアル番号とライセンスキーが記載された電子メールか、ライセンスキーファイルを添付した電子メールの形で、ボーランドより送られてきます。

VisiBroker を新しくインストールしたマシン上に、元は以前のバージョンの VisiBroker がインストールされており、その製品の有効なノードロックライセンスを持っていた場合、lmadm コマンドラインツールを使用して、以前のライセンスを移行して、新しくインストールした VisiBroker ソフトウェアでも使用します。

オンラインで購入または評価用にダウンロードした製品のためのキーファイルをボーランドより電子メールですでに受け取っている、もしくは、その製品の無料バージョンをダウンロードした場合には、登録ウィザードを使用してキーファイルを適用するか、ファイルを <install_dir>/license ディレクトリにコピーして製品起動時に自動的に適用させることができます。

シリアル番号とキーをお持ちの場合には、次のいずれかの登録方法を使用して、VisiBroker 製品の登録、有効化を行うことができます：

[Direct]：お使いのシステムがインターネットに接続されている場合、これが最も簡単な方法です。製品登録ウィザードの指示にしたがって必要な手順をすべて実行すると、自動的にライセンスが有効化されます。より詳しい情報については、セクション「ダイレクト登録」を参照してください。
[Email]：電子メールアカウントを使用して任意のシステムから登録要求を送ると、アクティベーションファイルが電子メールで送付されてくるので、それをインストールに適用することができます。より詳しい情報については、セクション「電子メール登録」を参照してください。
[Web page]：ボーランドの Web サイトにアクセスして登録を行う点以外は、電子メールによる登録と同じです。より詳しい情報については、セクション「Web ページ登録」を参照してください。
[Telephone]：ボーランドの担当者に必要な情報を伝えると、電子メールまたは郵送でアクティベーションファイルが送付されてきます。より詳しい情報については、セクション「電話登録」を参照してください。

選択した方法によっては、Borland Developer Network（BDN）アカウントを持っているかどうかをたずねられる場合があります。アカウントがない場合は、製品登録ウィザードでアカウントを作成するように求められます。

「ダイレクト」登録以外の方法では、一旦アクティベーションファイルをを受け取ることになります。このファイルを <install_dir>/license ディレクトリへコピーするだけで、製品の起動時にファイルが自動的に適用されます。

ダイレクト登録

Borland Product Registration Wizard を使用してダイレクト登録を行うには：

ウィザードの最初の画面で登録方法として [Direct] を選択し、[Next] をクリックします。
BDN アカウントを持っているかどうかを指定し、[Next] をクリックします。アカウントがない場合は、このウィザードでアカウントを作成するように求められます。
必要に応じて、インターネット接続のためのプロキシ設定を入力します。
概要情報を確認してから、[Next] をクリックします。ウィザードは、登録状況を管理、表示します。
登録が正常に完了したら、[Next] をクリックします。次に [Finish] をクリックしてウィザードを閉じます。

電子メール登録

Borland Product Registration Wizard を使用して電子メール登録を行うには：

ウィザードの最初の画面で登録方法として [Email] を選択し、[Next] をクリックします。
BDN アカウントを持っているかどうかを指定し、[Next] をクリックします。アカウントがない場合は、このウィザードでアカウントを作成するように求められます。
概要情報を確認してから、[Next] をクリックします。
[Email Registration] ペインの内容を、reg@borland.com 宛の電子メールのメッセージにコピーし送信します。[Next] をクリックします。
ウィザードを閉じるには、[Finish] をクリックします。製品アクティベーションファイルが電子メールで送られてきます。
このアクティベーションファイルを <install_dir>/license ディレクトリへコピーすると、製品の起動時にファイルが自動的に適用されます。

Web ページ登録

Borland Product Registration Wizard を使用して Web ページ登録を行うには：

ウィザードの最初の画面で登録方法として [Web page] を選択し、[Next] をクリックします。
ウィザードの [Web Registration] ステップで表示される登録キーをコピーし、[Finish] をクリックしてウィザードを閉じます。
Web ブラウザを起動し、URL "http://reg.borland.com" を開きます。
登録 Web ページで BDN アカウント情報を入力し、[Login] をクリックします。アカウントを持っていない場合は、[Create account] リンク（http://reg.borland.com/srs5/new_user.jsp）をクリックします。
[Product Registration] Web ページで、シリアル番号と登録キー（登録ウィザードからコピーしたもの）を入力し、[Continue] をクリックします。
アクティベーションファイルを受け取るための電子メールアドレスを確認し、[Register] をクリックします。製品アクティベーションファイルが電子メールで送られてきます。
このアクティベーションファイルを <install_dir>/license ディレクトリへコピーすると、製品の起動時にファイルが自動的に適用されます。

電話登録

Borland Product Registration Wizard を使用して電話登録を行うには：

ウィザードの最初の画面で登録方法として [Telephone] を選択し、[Next] をクリックします。
ドロップダウンリストから、自分の所在地に最も近い場所を選択します。
[Next] をクリックして、続いて [Finish] をクリックしてウィザードを閉じます。
電話サポートの番号に電話し、手元の電話登録ウィザードの画面に表示されている情報を伝えます。
アクティベーションファイルを受け取ったら、それを <install_dir>/license ディレクトリへコピーすると、製品の起動時にファイルが自動的に適用されます。

VisiBroker のアンインストール

VisiBroker をアンインストールするには：

アンインストール中にバックグラウンドで実行中のプロセス（osagent など）がないことを確認します。
<install_root>/UninstallerData ディレクトリへ移動します。
Web からダウンロードしたファイルからインストールした場合、次のコマンドを入力します：
```
java -cp uninstaller.jar uninstall
```
CD からインストールした場合、uninstall コマンドを入力します。
注意：インストール後に作成されたファイルやフォルダについては、アンインストールで削除されません。
uninstall コマンド実行後、インストールディレクトリを確認し、不必要なファイルやサブディレクトリを削除します。