Webtribe 1.1.1 更新手順

• 1.0.3 または 1.0.4 のプロジェクトへの上書きインストール(JAR ファイルを上書き)ではなく、必ず新規にインストールしてください。
  
  
• 既存の 1.0.3、または 1.0.4 のプロジェクトを残し、尚且つ既存のプロジェクトを1.1.1に置き換える　（1.0.3若しくは1.0.4を別プロジェクトとして退避し、既存プロジェ クトを1.1.1にする）　場合の手順については、以降に記載しております「動作確認」をご覧ください。
  

• WebtribeOMC インポート
  標準ルール、標準基本クラス等のパッケージの変更、追加がありますので、既存のリポジトリを1.1.0以降のバージョンで使用される場合は、WebtribeOMC のインポートを行ってください。
  インポートの手順については、Toolのディスクトップ起動後、メニューより「Tools」−＞「Webtribe OMC　Import」を行ってください。
  インポート対象ファイルには、下記ファイルを指定してください。
  
  • WEB-INF/repository/import/WedgeOmc.xml
  
  
• ユーザOMC（POMC) 情報の更新
  今回のバージョンより、DC 基本クラスがユーザレベルでの追加が可能になった為、既存のリポジトリを1.1.0以降のバージョンで使用される場合は、既存のリポジトリデータベースに対して、Webtribe 1.1 で追加された OMC 情報を追加する必要があります。
  追加された OMC 情報を既存のリポジトリデータベースに反映するためには、下記ファイルに記述されているSQLを実行してください。
  • WEB-INF/repository/sql/AddDcClass.sql


• ビジネスルールの編集
  
Ver1.1.0より  ITEM に対するメソッドが追加され、挙動が一部変更されています。
さらに Ver1.1.0 以前で使用しておりました継承元クラスが変更になりましたので、Ver 1.1.0 では新たに提供するクラスを継承元に指定します。
変更に伴う内容及び注意点は以下ようになります。
この変更に伴い、下記で述べさせていただいております「動作確認」のように、J2SDK 1.3.1 と 1.4 の違い等に起因する動作の差異を十分考慮し、動作確認を行っていただきます様、お願い申し上げます。

継承されるクラスについては、前バージョンよりご使用のAbstractBusinessRuleを継承し、且つITEMに対するメソッドに於きましても、互換性を保持しておりますのでそのまま使用していただく事は可能です。
※既に前バージョンで、ご使用のユーザビジネスルールに関しましては、現状のソースをそのままお使い頂く事を推奨しております。
ただし、再コンパイルは必要になります。新しいバージョンに添付されておりますjarファイルを「クラスパス」に設定して、再コンパイルを行います。
クライアントで実行されるビジネスルールについては「JDK1.4」での再コンパイルが必要になります。
（「クライアント側でビジネスルールの移行」のドキュメントは、VisualFrame 用として作成しておりますが、Webtribeにも、適応される内容ですので、参考にしてください。)
サーバで実行されるビジネスルールについては「JDK1.4」若しくは「JDK1.3」での再コンパイルが必要となります。
サーバ側のビジネスルールを再コンパイルする時、クラスパスに設定する jarファイルは次のようになります。

• {WEBTRIBE_ROOT}/WEB-INF/lib/WedgeServer.jar
• {WEBTRIBE_ROOT}/WEB-INF/lib/RuleCommonServer.jar
• {WEBTRIBE_ROOT}/WEB-INF/client/lib/RunClient.jar
• {WEBTRIBE_ROOT}/WEB-INF/client/lib/RuleCommonClient.jar

但し、新規に追加されるビジネスルールにつきましては、新しく追加された継承元クラスをお使いください。 また、標準ビジネスルールとして、ご提供させて頂いておりましたビジネスルールに関しましては、全て新しい継承元クラスを使用し、ITEMに対する処理についても新しいメソッドを使うように変更しております。
「ビジネスルール」の作成につきましては、ドキュメントに表記しております「基本クラス」欄の「ビジネスルール」以下をご参照ください。
ITEM用メソッドの対比については、こちらをご参照ください。


• 動作確認
  バージョンアップを行うことにより、動作が変わることがあります。
  特に CAMC で定義されたイベント処理、フォーカス制御については注意が必要です。
  このことから、バージョンアップを行う場合は、次の手順をお勧めします。
  ※CAMCに関しましては、弊社製品でもあるVisualFrameが、先行しバージョンアップしております関係上、バージョンアップに伴う「Webtribe 変更点」に関しまして
「Version.1.1.0変更点一覧 」及び「Version.1.1.0.2変更点一覧 」、「Version.1.1.1変更点一覧 」を合わせてご覧ください。


1. 既存のプロジェクトのディレクトリ名(フォルダ名)を別名でコピーしてバックアップ。
   (例)
   

   既存のプロジェクト名	webtribe
   バックアッププロジェクト名	webtribe2

   
   (例1:Windows)
   

   (コピー前)	c:\Tomcat4.1\webapps\webtribe
   (コピー後)	c:\Tomcat4.1\webapps\webtribe2

   
   (例2:Unix)
   

   (コピー前)	/opt/tomcat4/webapps/webtribe
   (コピー後)	/opt/tomcat4/webapps/webtribe2

   
   
2. 既存のプロジェクトのリポジトリを別のスキーマにバックアップ。
   
3. バックアッププロジェクト(webtribe2)のコンフィグレーションファイルを、新しいパスに合わせて編集。
   
4. バックアッププロジェクト(webtribe2)の JDBC 接続定義をバックアップスキーマを指すように編集。
5. RMI 接続ポート番号変更。
   
6. Windows でサービスとして実行している場合は、バックアッププロジェクト(webtribe2)をサービスに登録。
   
7. バックアッププロジェクト(webtribe2)の動作を確認。
8. J2SDK 1.4.2 をセットアップ。
   
9. Webtribe 1.1.1 をセットアップ。
   
10. Webtribe 1.1 プロジェクト(webtribe)を起動し、WebtribeOMC をインポート。
11. OMC 更新用 SQL(AddDcClass.sql)を実行。
    
12. EngineExport.bat を使って Webtribe 1.1 プロジェクト(webtribe)からリポジトリ定義(RTE)をエクスポート。
    
13. Webtribe 1.1 プロジェクト(webtribe)がバックアッププロジェクト(webtribe2)と同じように動くかどうかを確認。
    

Windows でサービスとして実行している場合は、既存のプロジェクトを(webtribe)をサービスから削除。

既存のプロジェクトのディレクトリ名(フォルダ名)をリネームバックアップ。

• (例1:Windows)
  

  (変更前)	c:\Tomcat4.1\webapps\webtribe
  (変更後)	c:\Tomcat4.1\webapps\webtribe2

  
  エクスプローラで webtribe フォルダを選択し、F2 キーを押してフォルダ名を「webtribe2」に変更します。
  
  
• (例2:Unix)
  

  (変更前)	/opt/tomcat4/webapps/webtribe
  (変更後)	/opt/tomcat4/webapps/webtribe2

  
  下記コマンドを実行します。
  

  cd /opt/tomcat4/webapps mv webtribe webtribe2

既存のプロジェクトのリポジトリを別のスキーマにバックアップ。

• 既存のプロジェクトのスキーマをエクスポート。
  exp webtriberp/webtriberp file=webtriberp.dmp
  
  
• バックアップ用スキーマを作成。
  webtriberp2 という名前で表領域を作成。
  webtriberp2 という名前でユーザを作成。
  
  
• エクスポートしたダンプファイルをバックアップ用スキーマにインポート。
  imp system/manager file=webtriberp.dmp fromuser=webtriberp touser=webtriberp2

バックアッププロジェクト(webtribe2)のコンフィグレーションファイルを、新しいパスに合わせて編集。

• index.html
  <param name = "CODEBASE" value = "/webtribe2" >
  
  
• RunClient.jnlp
  <jnlp spec="1.0" codebase="http://192.168.1.1/webtribe2" href="RunClient.jnlp">
  <!--
  <argument>-conf=http://192.168.1.1/webtribe2/conf/RunClientX.wdg</argument>
  -->
  
  
• conf\common.wdg
  <macro name="HtmlAlias" value="/webtribe2/" />
  <macro name="ServletAlias" value="/webtribe2/servlet/" />
  
  
• WEB-INF\setenv.bat
  set WEDGEROOT=c:/Tomcat4.1/webapps/webtribe2
  
  • 注意点
    JDK 1.3.1_11 をお使いになられる場合は、WEB-INF\setenv.bat の 1行目に
    

    set JAVA_HOME=c:\jdk1.3.1_11

    を追加してください。
  
  
• WEB-INF\web.xml
  <!ENTITY BASEDIR "c:/Tomcat4.1/webapps/webtribe2/WEB-INF/">
  
  
• WEB-INF\client\conf\common.wdg
  <macro name="HtmlAlias" value="/webtribe2/" />
  <macro name="ServletAlias" value="/webtribe2/servlet/" />
  
  
• WEB-INF\conf\common.wdg
  <macro name="ServerRoot" value="c:/Tomcat4.1/webapps/webtribe2/WEB-INF/" />
  <macro name="HtmlAlias"    value="/webtribe2/" />
  <macro name="ServletAlias" value="/webtribe2/servlet/" />
  
  
• WEB-INF\conf\menu.wdg
  <macro name="prj" value=" - webtribe2 1.0.4" />
  
  
• WEB-INF\ntservice\Common.ini
  WEDGEROOT=c:/Tomcat4.1/webapps/webtribe2
  
  
• WEB-INF\ntservice\rmi\service.ini
  Name = Webtribewebtribe2RMI
  OptionEnviron = c:/Tomcat4.1/webapps/webtribe2/WEB-INF\ntservice\Common.ini
  
  
• WEB-INF\ntservice\RunApServer\service.ini
  Name = Webtribewebtribe2RunApServer
  Depend = Webtribewebtribe2RMI
  OptionEnviron = c:/Tomcat4.1/webapps/webtribe2/WEB-INF\ntservice\Common.ini
  
  
• WEB-INF\ntservice\RunDBServer\service.ini
  Name = Webtribewebtribe2RunDBServer
  Depend = Webtribewebtribe2RMI
  OptionEnviron = c:/Tomcat4.1/webapps/webtribe2/WEB-INF\ntservice\Common.ini
  
  
• WEB-INF\ntservice\RunDBServerJob\service.ini
  Name = Webtribewebtribe2RunDBServerJob
  Depend = Webtribewebtribe2RMI
  OptionEnviron = c:/Tomcat4.1/webapps/webtribe2/WEB-INF\ntservice\Common.ini
  
  
• WEB-INF\ntservice\Servlet\service.ini
  Name = Webtribewebtribe2Servlet
  Depend = Webtribewebtribe2RMI
  OptionEnviron = c:/Tomcat4.1/webapps/webtribe2/WEB-INF\ntservice\Common.ini
  
  
• WEB-INF\ntservice\ToolApRmi4Engine\service.ini
  Name = Webtribewebtribe2ToolApRmi4Engine
  Depend = Webtribewebtribe2RMI
  OptionEnviron = c:/Tomcat4.1/webapps/webtribe2/WEB-INF\ntservice\Common.ini
  
  
• WEB-INF\ntservice\ToolApServer\service.ini
  Name = Webtribewebtribe2ToolApServer
  Depend = Webtribewebtribe2RMI
  OptionEnviron = c:/Tomcat4.1/webapps/webtribe2/WEB-INF\ntservice\Common.ini
  
  
• WEB-INF\ntservice\ToolDBServer\service.ini
  Name = Webtribewebtribe2ToolDBServer
  Depend = Webtribewebtribe2RMI
  OptionEnviron = c:/Tomcat4.1/webapps/webtribe2/WEB-INF\ntservice\Common.ini
  
  
• WEB-INF\ntservice\Waker\service.ini
  Name = Webtribewebtribe2Waker
  Depend = Webtribewebtribe2RMI,Webtribewebtribe2ToolDBServer,Webtribewebtribe2RunDBServer,Webtribewebtribe2RunDBServerJob,Webtribewebtribe2ToolApServer,Webtribewebtribe2RunApServer,Webtribewebtribe2ToolApRmi4Engine
  OptionEnviron = c:/Tomcat4.1/webapps/webtribe2/WEB-INF\ntservice\Common.ini
  

• index.html
  <param name = "CODEBASE" value = "/webtribe2" >
  
  
• RunClient.jnlp
  <jnlp spec="1.0" codebase="http://192.168.1.1/webtribe2" href="RunClient.jnlp">
  <!--
  <argument>-conf=http://192.168.1.1/webtribe2/conf/RunClientX.wdg</argument>
  -->
  
  
• conf/common.wdg
  <macro name="HtmlAlias" value="/webtribe2/" />
  <macro name="ServletAlias" value="/webtribe2/servlet/" />
  
  
• WEB-INF/setenv.sh
  WEDGEROOT=/opt/Tomcat4.1/webapps/webtribe2
  
  • 注意点
    JDK 1.3.1_11 をお使いになられる場合は、WEB-INF/setenv.sh の 1行目に
    

    export JAVA_HOME=/usr/java/jdk1.3.1_11

    を追加してください。
  
  
• WEB-INF/web.xml
  <!ENTITY BASEDIR "/opt/tomcat4/webapps/webtribe2/WEB-INF/">
  
  
• WEB-INF/client/conf/common.wdg
  <macro name="HtmlAlias" value="/webtribe2/" />
  <macro name="ServletAlias" value="/webtribe2/servlet/" />
  
  
• WEB-INF/conf/common.wdg
  <macro name="ServerRoot" value="/tomcat4/webapps/webtribe2/WEB-INF/" />
  <macro name="HtmlAlias" value="/webtribe2/" />
  <macro name="ServletAlias" value="/webtribe2/servlet/" />
  
  
• WEB-INF/conf/menu.wdg
  <macro name="prj" value=" - webtribe2 1.0.4" />
  

バックアッププロジェクト(webtribe2)の JDBC 接続定義をバックアップスキーマを指すように編集。

• WEB-INF/conf/common.wdg(または WEB-INF\conf\common.wdg)
  <macro name="ToolJdbcUser" value="webtriberp2" />
  <macro name="ToolJdbcPass" value="webtriberp2" />

RMI 接続ポート番号変更

• WEB-INF\setenv.bat
  (例:変更前)set RMIPORT=49152
  (例:変更後)set RMIPORT=49153
  
  
• WEB-INF\conf\common.wdg
  (例:変更前)<macro name="RmiPort" value=":49152" />
  (例:変更後)<macro name="RmiPort" value=":49153" />
  
  
• WEB-INF\ntservice\Common.ini
  (例:変更前)RMIPORT=49152
  (例:変更後)RMIPORT=49153
  

• WEB-INF/setenv.sh
  (例:変更前)RMIPORT=49152
  (例:変更後)RMIPORT=49153
  
  
• WEB-INF/conf/common.wdg
  (例:変更前)<macro name="RmiPort" value=":49152" />
  (例:変更後)<macro name="RmiPort" value=":49153" />

Windows でサービスとして実行している場合は、バックアッププロジェクト(webtribe2)をサービスに登録。

バックアッププロジェクト(webtribe2)の動作確認。

Webtribe 1.1.1 新規にセットアップ。

Webtribe 1.1.1プロジェクト(webtribe)を起動し、WebtribeOMC をインポート。

OMC 更新用 SQL(AddDcClass.sql)を実行。

既存プロジェクト(webtribe)からリポジトリ定義をエクスポート。

Webtribe 1.1.1プロジェクト(webtribe)がバックアッププロジェクト(webtribe2)と同じように動くかどうかを確認。

• webtribe プロジェクトを修正。
  webtribe プロジェクトの定義内容やビジネスルールを修正し、Webtribe 1.1.1 で動作するようにします。
  
  
• バックアッププロジェクトから復元。
  バックアッププロジェクト(webtribe2)から JAR ファイルを戻して、Webtribe 1.0.3(若しくはWebtribe 1.0.4） の環境を復元します。