Webtribeチュートリアル用 サーバ環境設定

1. ダウンロード

Webtribeの動作環境として、下記のプログラムを用意する必要があります。
各サイトよりダウンロードを行って下さい。

ここでは、（C:\temp）にダウンロードします。

補足補足
本ドキュメントでは、上記モジュールをCドライブにセットアップする手順で進めております。
もしCドライブ以外にセットアップされます場合は、「第８章 補足」に記述されている方法に従ってセットアップ手順を変更する必要がありますので、ご注意ください。
初めて Webtribe をセットアップされる場合は、確実に動作させていただくためにも、本ドキュメントに記載されておりますディレクトリ構成の通りに設定していただくことをお奨めいたします。

　

2. JDKセットアップ

ダウンロードしたフォルダ（C:\temp）にある「j2sdk-1_3_1_06-win.exe」を実行します。
セットアップ先フォルダは、デフォルト（C:\jdk1.3.1_06）のままにしておきます。



images/jdk01.gif

「次へ(N)」をクリックします。



images/jdk03.gif

「はい(Y)」をクリックします。



images/jdk04.gif

「インストール先のフォルダ」指定は変更せずに、「次へ(N)」をクリックします。



images/jdk021.gif

ご利用のブラウザをチェックした上で「次へ(N)」をクリックします。



images/jdk05.gif

「次へ(N)」をクリックします。



images/jdk06.gif

「完了」をクリックします。

　

3. Tomcatセットアップ

ダウンロードしたフォルダ（C:\temp）にある「jakarta-tomcat-3.2.4.zip」をWinZip、Lhasa等のZIP圧縮形式の解凍ツールで解凍します。
解凍先フォルダは、C:\ にします。(解凍すると C:\jakarta-tomcat-3.2.4 というフォルダが作成されます。)



images/tomcat01.gif

images/tomcat02.gif

「tomcat.bat」の修正
（C:\jakarta-tomcat-3.2.4\bin）にある「tomcat.bat」をエディタで開き、以下の記述を追加します。

set JAVA_HOME=C:\jdk1.3.1_06
set TOMCAT_HOME=C:\jakarta-tomcat-3.2.4
【参考例】
rem JAVA_HOME Must point at your Java Development Kit installation.
rem
rem $Id: setupevaluation.xml,v 1.15.2.12 2002/11/12 08:10:52 yoshizu Exp $
rem -------------------------------------------------------------------------

set JAVA_HOME=C:\jdk1.3.1_06
set TOMCAT_HOME=C:\jakarta-tomcat-3.2.4

rem ----- Save Environment Variables That May Change ------------------------

set _CP=%CP%
set _TOMCAT_HOME=%TOMCAT_HOME%
set _CLASSPATH=%CLASSPATH%

rem ----- Verify and Set Required Environment Variables ---------------------

if not "%JAVA_HOME%" == "" goto gotJavaHome
echo You must set JAVA_HOME to point at your Java Development Kit installation


「Tomcat」の起動確認
「スタートメニュー」から「コマンドプロンプト」を起動し、次のコマンドを入力し「Tomcat」の起動を行います。

C:\>cd \jakarta-tomcat-3.2.4\bin
C:\jakarta-tomcat-3.2.4\bin>startup.bat


images/tomcat05.gif

images/tomcat06.gif

ブラウザを起動し、URLにhttp://localhost:8080/を 入力します。

補足補足
Tomcat は初期処理に約数十秒ほど時間がかかりますので、起動した後、少し待ってからブラウザで接続してください。
目安として「Windows タスクマネージャ」に表示される CPU 使用率が低くなったら、Tomcat の起動が完了しています。



images/tomcat07.gif

上記の画面が表示されれば、Tomcat のセットアップは完了です。

　

4. Webtribe WAR ファイル展開

4-1. ZIP ファイル解凍

ダウンロードした ZIP ファイル(webtribe.zip)を temp ディレクトリに解凍します。



images/wt41.gif

解凍すると C:\temp に webtribe というフォルダが作成されます。



images/wt42.gif

4-2. Webtribe WAR ファイルコピー

解凍したフォルダ(C:\tmep\webtribe)にある「webtribe.war」･「dyndoc.war」を（C:\jakarta-tomcat-3.2.4\webapps）にコピーします。



images/wt43.gif

4-3. Tomcat 再起動

次に、Tomcat を再起動します。
エクスプローラから C:\jakarta-tomcat-3.2.4\bin\shutdown.bat を実行し、Tomcat のコマンドプロンプト画面が閉じたのを確認してから、C:\jakarta-tomcat-3.2.4\bin\startup.bat を実行します。



images/wt45.gif

再起動後、（C:\jakarta-tomcat-3.2.4\webapps)に webtribe というフォルダと dyndoc というフォルダが作成されます。

C:\jakarta-tomcat-3.2.4
   │
   └─ webapps
          │
          ├─ dyndoc
          └─ webtribe

　

5. WebtribeのDB環境構築

5-1. DBファイル格納フォルダ作成

Oracle の稼働しているマシンのCドライブのルートに（\Webtribe\data）フォルダを作成します。

5-2. Oracle の TABLESPACE 及びユーザ作成

展開したフォルダ(C:\jakarta-tomcat-3.2.4\webapps\webtribe\WEB-INF\repository\db)にあります「OracleSchemaWebtribeRp.sql」、「OracleSchemaWebtribeAp.sql」ファイルを使って、ORACLE上にWebtribe用のTABLESPACEとユーザを作成します。
「コマンドプロンプト」を起動し、次のコマンドを入力します。

C:\>cd \jakarta-tomcat-3.2.4\webapps\webtribe\WEB-INF\repository\db

Oracle 8i または 9i の場合

C:\jakarta-tomcat-3.2.4\webapps\webtribe\WEB-INF\repository\db>sqlplus system/manager

Oracle 8 の場合

C:\jakarta-tomcat-3.2.4\webapps\webtribe\WEB-INF\repository\db>plus80 system/manager

と入力して下さい。

※但し、Oracleが稼働していないマシンから実行する場合は、system/managerの後に@ネットサービス名を入力

【参考例】

sqlplus system/manager@oraclehost
plus80 system/manager@oraclehost


OracleSchemaWebtribeRp.sql, OracleSchemaWebtribeAp.sql を実行してテーブルスペースとユーザを作成します。

SQL>@OracleSchemaWebtribeRp.sql
SQL>@OracleSchemaWebtribeAp.sql
SQL>exit

作成したユーザでログイン（「webtriberp」・「webtribeap」）出来るかを確認します。

ログインができることを確認したら exit と入力して、SQL Plus を終了してください。

5-3. チュートリアル用サンプルデータの作成

チュートリアル用サンプルデータを作成します。
webtribe.zip を解凍したディレクトリ(c:\temp\webtribe)の sql ディレクトリにある webtribeap.sql を SQL Plus から実行します。

  1. コマンドプロンプトを開きます。
  2. c:\temp\webtribe\sql ディレクトリに移動します。 
    cd \temp\webtribe\sql

  3. SQL Plus でユーザ webtribeap を使ってログインします。

    Oracle 8i または 9i の場合

    C:\temp\webtribe\sql>sqlplus webtribeap/webtribeap

    Oracle 8 の場合

    C:\temp\webtribe\sql>plus80 webtribeap/webtribeap

    ※但し、Oracleが稼働していないマシンから実行する場合は、webtribeap/webtribeap の後に@ネットサービス名を入力

    【参考例】

    sqlplus webtribeap/webtribeap@oraclehost
    plus80 webtribeap/webtribeap@oraclehost



  4. webtribeap.sql を実行します。
    SQL>@webtribeap.sql


images/wt44.gif
　

6. Webtribeセットアップ

6-1. リポジトリテーブル作成

SQL Plus からリポジトリテーブル作成用スクリプト C:\jakarta-tomcat-3.2.4\webapps\webtribe\WEB-INF\repository\db\oracle.sql実行します。

  1. コマンドプロンプトを開きます。
  2. C:\jakarta-tomcat-3.2.4\webapps\webtribe\WEB-INF\repository\db フォルダに移動します。 
    cd \jakarta-tomcat-3.2.4\webapps\webtribe\WEB-INF\repository\db

  3. SQL Plus を起動し、先ほど作成した webtriberp というユーザで接続します。
    Oracle 8i または 9i の場合 
    sqlplus webtriberp/webtriberp
    Oracle 8 の場合 
    plus80 webtriberp/webtriberp

    ※但し、Oracleが稼働していないマシンから実行する場合は、system/managerの後に@ネットサービス名を入力

    【参考例】

    sqlplus system/manager@oraclehost
    plus80 system/manager@oraclehost



  4. oracle.sql を実行します。 
    @oracle.sql

  5. exit で SQL Plus を終了します。 
    exit



images/wt21.gif

6-2. 定義ファイルの変更

6-2-1. クライアント側

（C:\jakarta-tomcat-3.2.4\webapps\webtribe\WEB-INF\client\conf）にある「common.wdg」ファイルをエディタで開き、以下の部分を修正します。

（C:\jakarta-tomcat-3.2.4\webapps\webtribe\conf）にある「common.wdg」にも同様の修正を行います。

6-2-2. サーバ側

（C:\jakarta-tomcat-3.2.4\webapps\webtribe\WEB-INF\conf）にある「common.wdg」ファイルをエディタで開き、以下の部分を修正します。

6-2-3. DynamicDocument

（C:\jakarta-tomcat-3.2.4\webapps\dyndoc）にある「index.html」をエディタで開いて、以下の部分を修正します。

6-2-4. Oracle 9i をお使いの方へ

Oracle 9i をセットアップすると、標準では Oracle HTTP Server もいっしょにセットアップされます。
Oracle HTTP Server は 8080 のポートを使いますが、Tomcat もデフォルトでは 8080 のポートを使いますので、ポートが衝突しないようにする必要があります。

【参考例】

ここでは Tomcat が使用するポートの番号を 8080 から 8090 に変更します。


6-3. JDBCドライバの設定

Cドライブのルートに \java\lib フォルダを作成します。(c:\java\lib)
次に、ダウンロードしたフォルダ（C:\temp）にある「classes12.zip」を先程作成したフォルダ C:\java\lib にコピーします。



images/wt22.gif

補足補足
評価版のデフォルトの設定では、このディレクトリ(c:\java\lib)に JDBC ドライバのファイル(classes12.zip)を参照するようになっています。
別のディレクトリに JDBC ドライバをコピーしたり、JDBC ドライバが異なる場合、データベースに接続できなくなりますので、ご注意ください。

6-4. DynamicDocumentに必要なJARファイルの設定

ダウンロードしたフォルダ（C:\temp）にある「xalan-j_2_4_1-bin.zip」からWinZip、Lhasa等のZIP圧縮形式の解凍ツールでbinディレクトリに格納されている「xalan.jar」、「xercesImpl.jar」と「xml-apis.jar」を解凍します。(この3つのファイルだけを使用します。)

※ Tomcat 4. x を使用している場合は、手順が少し異なります。
環境構築 → セットアップ →DynamicDocument の「XML パーサー、XSLT セットアップ」を参照してください。

解凍先のフォルダは、（C:\jakarta-tomcat-3.2.4\lib）にします。


images/wt23.gif

次に、解凍したJARファイルと衝突しないよう、（C:\jakarta-tomcat-3.2.4\lib）にある「jaxp.jar」と「crimson.jar」のファイルを退避させるために（C:\jakarta-tomcat-3.2.4）に移動します。
この 2つの JAR ファイルは Tomcat が使いますので、Tomcat が起動している場合は、Tomcat を停止(エクスプローラ等から c:\jakarta-tomcat-3.2.4\bin\shutdown.bat を実行)してから JAR ファイルを移動してください。


images/wt24.gif

C:\jakarta-tomcat-3.2.4\webapps\dyndoc\WEB-INF に classes ディレクトリを作成します。


images/wt37.gif

作成したディレクトリ(C:\jakarta-tomcat-3.2.4\webapps\dyndoc\WEB-INF\classes)に classes12.zip を解凍します。


images/wt36.gif

解凍後は classes ディレクトリに下のようなフォルダが展開されます。


images/wt38.gif

補足補足

DynamicDocumentはサーブレットとして実装していますが、サーブレットは ZIP 圧縮されたファイルを直接参照することができないため、classes ディレクトリに解凍して、CLASS ファイルを参照するようにします。


変更後、Tomcat を再起動します。
Tomcat が起動している場合は、エクスプローラから C:\jakarta-tomcat-3.2.4\bin\shutdown.bat を実行し、Tomcat のコマンドプロンプト画面が閉じたのを確認します。
次に C:\jakarta-tomcat-3.2.4\bin\startup.bat を実行します。



images/wt45.gif
　

7. Webtribe起動確認

7-1. Webtribe Serverの起動

（C:\jakarta-tomcat-3.2.4\webapps\webtribe\WEB-INF）にある「run.bat」を実行します。 以下の様な状態の画面が表示されれば、Serverの起動は完了です。


「RMI.bat」

images/wt01.gif


「ToolDBServer.bat」

images/wt02.gif


「ToolApServer.bat」

images/wt03.gif


「RunDBServer.bat」

images/wt04.gif


「RunApServer.bat」

images/wt05.gif


「RunDBServerJob.bat」

images/wt27.gif


「ToolAp4Engine.bat」

images/wt28.gif

補足補足

サーバ起動時に

JAVA_HOME was not defined and could not found java directory.
Please set environment variable JAVA_HOME.

というメッセージが表示された場合は、JDK がセットアップされているパスの検索に失敗しています。
このメッセージが表示された場合は、環境変数 JAVA_HOME に JDK がセットアップされたパスを設定してから、Webtribeを起動し直してください。

【参考例】

Windows 2000 の場合

  1. 「マイコンピュータ」をマウスで右クリックし、プロパティを選択します。
  2. 「詳細」タブを選択します。


    images/javahome01.gif
  3. 「環境変数」ボタンをクリックします。


    images/javahome02.gif
  4. 「環境変数」ダイアログが表示されますので、「ユーザ環境変数」または「システム環境変数」の「新規」ボタンをクリック。


    images/javahome03.gif
  5. 「新しいユーザ変数」ダイアログが表示されますので、「変数名」に JAVA_HOME を入力し、「変数値」に JDK がセットアップされているパスを入力します。

    (例: D:\jdk1.3.1_06 にセットアップされている場合 ==> D:\jdk1.3.1_06)



    images/javahome04.gif
  6. 「新しいユーザ変数」ダイアログの「OK」ボタンをクリックします。
  7. 「環境変数」ダイアログの「OK」ボタンをクリックします。


7-2. リポジトリ初期設定

7-2-1. ToolClient 起動

（C:\jakarta-tomcat-3.2.4\webapps\webtribe\WEB-INF\client）にある「ToolClient.bat」を実行します。



images/wt29.gif

Usernameに「webtribe」、Passwordに「webtribe」を入力し、「OK」をクリックします。

7-2-2. リポジトリ初期データインポート



images/wt26.gif

「Tools」メニューから「ALL Import」メニューを選択します。



images/wt30.gif

「はい」をクリックします。



images/wt31.gif

C:\jakarta-tomcat-3.2.4\webapps\webtribe\WEB-INF\repository\import\webtribe0.jar を選択して「開く」をクリックします。



images/wt32.gif

「リポジトリのインポートが正常に終了しました。」というダイアログが表示されたら、「了解」をクリックします。



images/wt33.gif

「Close」をクリックします。

7-2-3. ToolClient インポート確認



images/wt34.gif

左端にある「OperationM」ボタンをクリックします。



images/wt35.gif

上のような画面が表示されたら、正常にインポートができています。

7-3. 「DynamicDocument」の確認

ブラウザを起動し、URLにhttp://localhost:8080/dyndoc/ を入力します。



images/wt17.gif

「DynamicDocument表示」をクリックします。



images/wt18.gif

上記の画面が表示されれば、正常に動作しています。

　

8. 補足

プログラムのセットアップ先をデフォルト指定以外に変更した場合、各プログラム毎に以下の様な変更・修正が必要になります。

8-1. 「Tomcat3.2.4」

8-1-1. 「Webtribe」のセットアップ先の変更

「webtribe.war」・「dyndoc.war」のコピー先を（Tomcatのセットアップ先に指定したフォルダ\webaaps）に変更します。

8-1-2. 「setenv.bat」の修正

（C:\jakarta-tomcat-3.2.4\webapps\webtribe\WEB-INF）にある「setenv.bat」ファイルをエディタで開き、以下の部分を修正します。

「修正箇所」
「set WEDGEROOT=c:/jakarta-tomcat-3.2.4/webapps/webtribe/WEB-INF」
「修正内容」
「set WEDGEROOT=c:/Tomcatのセットアップ先に指定したフォルダ/webapps/webtribe/WEB-INF」

set WEDGEROOT=c:/tomcat/webapps/webtribe/WEB-INF
注意注意
Tomcat 3.2.xのバージョンは、デフォルトではスペースを含むディレクトリに対応していないため、(C:\Program Files\jakarta-tomcat-3.2.4)のようなスペース含むディレクトリにはセットアップされないことをお奨めします。

8-1-3. 「web.xml」の修正

（C:\jakarta-tomcat-3.2.4\webapps\webtribe\WEB-INF）にある「web.xml」ファイルをエディタで開き、以下の部分を修正します。

「修正箇所」
<!ENTITY BASEDIR "C:/jakarta-tomcat-3.2.4/webapps/webtribe/WEB-INF/">
「修正内容」
<!ENTITY BASEDIR "C:/Tomcatのセットアップ先に指定したフォルダ/webapps
/webtribe/WEB-INF/">