Java Pet Store 2.0 を WebOTX 上で動作させる方法 2008 年 9 月初版 NEC 第二システムソフトウェア事業部 0

Size: px

Start display at page:

Download "Java Pet Store 2.0 を WebOTX 上で動作させる方法 2008 年 9 月初版 NEC 第二システムソフトウェア事業部 0"

まいえいざわ
5 years ago
Views:

1 Java Pet Store 2.0 を WebOTX 上で動作させる方法 2008 年 9 月初版 NEC 第二システムソフトウェア事業部 0

2 目次 U1. はじめに U...2 U2. Pet Store 2.0 の特徴 U...3 U2.1 Java EE 5 の活用 U...3 U2.2 動作環境 U...4 U3. GlassFish 上で動作させるための手順 U...6 U3.1 プログラムのインストール U...6 U3.2 起動手順 U...7 U3.3 データソースの作成 U...8 U3.4 コンパイルと配備 U...8 U3.5 ブラウザ表示 U...8 U4. WebOTX 上で動作させるための手順 U...10 U4.1 プログラムのインストール U...10 U4.2 設定の書き換えU U4.3 データベースの設定 U...13 U4.4 起動手順 U...13 U4.5 データソースの作成 U...14 U4.6 コンパイルと配備 U...15 U4.7 ブラウザ表示 U

3 0B1. はじめに Java Pet Store 2.0 とは Sun Microsystems 社が Java Enterprise Edition 5 (Java EE 5) の仕様を検証することを目的として作成したオープンソースの Web アプリケーションサンプルですインターネット上の仮想的なペット販売サイトで Java EE 5 の仕様に基づいた様々な機能を提供しています Web アプリケーションサーバを用いたシステムの開発者はこのサンプルを用いて Java EE 5 に準拠したシステム構築をシミュレートすることができシステムの設計や実装に大いに役立てることができます Pet Store 2.0 は Java EE 5 に準拠したあらゆる Web アプリケーションサーバ上で動作するように作られていますが動作環境依存の部分は Sun Microsystems 社が公開している参照実装の Web アプリケーションサーバ GlassFish に対応していますそのため他の Web アプリケーションサーバ上で動作させるためにはその環境依存部を修正する必要があります本ドキュメントでは GlassFish 上で Pet Store 2.0 を動作させる手順について説明した後 WebOTX V8.1 上で動作させる方法について説明します GlassFish は GlassFish プロジェクトが Java EE 5 アプリケーションサーバのオープンソース開発を目的として作成した Web アプリケーションサーバです GlassFish は CDDL ライセンスの下で誰もが自由にソースコードにアクセスし閲覧することができライセンス条項を満たす範囲でソースコードを変更修正することも可能ですこのドキュメントの目的は GlassFish WebOTX という 2 種類の Web アプリケーションサーバを用いることにより環境依存的な部分を明確にするとともに Web アプリケーションサーバがデータベースサーバを内部に持つ場合と外部に持つ場合でシステム構築過程にどのような違いが生じるのかを読者が実際に操作しながら理解できるようにすることです Pet Store 2.0 の詳細は下記の URL を参照してください 2

4 1B2. Pet Store 2.0 の特徴 4B2.1 Java EE 5 の活用 Pet Store 2.0 は 2006 年にリリースされた Java EE 5 仕様の機能を利用しています Java EE 5 で新たに取り入れられた Ajax 技術 JPA (Java Persistence API) JTA (Java Transaction API) JSF (Java Server Faces) などを利用することで Web アプリケーションにおける操作性の向上やシステム全体における開発工程の軽減を図っています例えば Pet Store 2.0 の Catalog や Home のページは Ajax 技術を用いることにより画面を切り替えることなく一部の画像や文字を変更あるいは移動させる機能を実現していますこの技術は Google Map を用いてペットの居場所を検索する機能や最新のニュースを RSS によって表示させる機能にも利用されていますまたオブジェクト指向におけるオブジェクトとリレーショナルデータベースの内容の対応付けでは O/R マッピングを利用するために JPA が用いられていますその結果システム開発過程におけるデータベース操作に関わる煩雑な作業を大幅に簡素化しています <Catalog ページ > 3

5 5B2.2 動作環境 Pet Store 2.0 は 3 層構造のアプリケーションシステムをモデルとしています 3 層構造はプレゼンテーション層ビジネスロジック層データベース層から成りそれぞれの層は機能的に独立していますこのような階層構造はビジネスロジックやデータベースサーバにおける変更が他の層に影響を及ぼさないため開発保守において機能ごとに役割を分担することが容易となり大規模開発に大変適しています現在はこのような 3 層構造アーキテクチャが一般的ですエンタープライズレベルのサービスを提供する場合ビジネスロジック層において Enterprise JavaBeans (EJB) が用いられますがビジネスロジックからのリクエストがそれほど多くない動的アプリケーションの場合 EJB を使わず JSP/ サーブレットだけで実装するのが一般的です Pet Store 2.0 では EJB を使わず JSP/ サーブレットだけで実装を行っていますそのため WebOTX Application Server (WebOTX AS) 製品の全てのエディションで動作させることができますただし Web アプリケーションサーバは Java EE 5 の仕様に準拠している必要があります本ドキュメントの作成にあたっては WebOTX AS Web Edition V8.1 と WebOTX AS Standard-J Edition V8.1 上での動作をそれぞれ Windows 上で確認しましたそのため文中では Windows における表記表現を使用していますパスの表記においてを用いていますが Linux や HP-UX Solaris では / を使用してくださいまたペットに関する様々な情報や画像はデータベースに保存されます今回はデータベースに Java DB を使用しています <WebOTX AS Web Edition を使用した場合のシステム構造 > Web ブラウザ WebOTX AS Web Edition Web コンテナ Web サーバ Servlet JSP データベースプレゼンテーション層ビジネスロジック層データベース層 4

6 <WebOTX V8.1 の対応 OS 一覧 > Windows Windows Server 2008 Standard Edition Windows Server 2008 Enterprise Edition Linux Red Hat Enterprise Linux AS/ES 4.0 MIRACLE LINUX V4.0 Windows Server 2008 Datacenter Edition Windows Server 2003 R2, Standard Edition Windows Server 2003 R2, Enterprise Edition Windows Server 2003 R2, Datacenter Edition Windows Server 2003, Standard Edition Windows Server 2003, Enterprise Edition Windows Server 2003, Datacenter Edition (*)SE Linux 設定を有効化した場合は未サポートです無効化にしてください 5

7 2B3. GlassFish 上で動作させるための手順現在最新版の GlassFish V2 は JDK 5.0 以上の Java 環境で動作しますまたデータベースである Java DB も内蔵しています 6B3.1 プログラムのインストール 1 Java 実行環境 (JDK 5.0 以上 ) インストールしたフォルダを (Java インストールフォルダ ) とします下記のように Path 環境変数の設定を行ってください JAVA_HOME=(Java インストールフォルダ ) システム環境変数の Path に (Java インストールフォルダ ) bin; を追加 (C ドライブ直下の C: jdk1.5.0_16 へインストールした場合の例 ) JAVA_HOME=C: jdk1.5.0_16 Path=%JAVA_HOME% bin;c: WINDOWS system32;c: WINDOWS;... 2 GlassFish (Java DB を含む ) 下記の URL から glassfish-installer-v2ur2-b04-windows.jar ファイルを適当なフォルダにダウンロードしてください HUhttps://glassfish.dev.java.net/ja/downloads/v2ur2-b04.htmlU まずダウンロードした JAR ファイルを使って GlassFish をインストールします (C ドライブ直下の C: glassfish へインストールした場合の例 ) JAR ファイルを C ドライブ直下に配置し MC-DOS プロンプト画面で次のコマンドを実行します > java Xmx256m jar glassfish-installer-v2ur2-b04-windows.jar 展開後にできた glassfish フォルダで以下のように ant を実行すると GlassFish のセットアップが完了します > cd glassfish > lib ant bin ant f setup.xml 6

8 インストールしたフォルダを (glassfish インストールフォルダ ) とします 1 と同様に Path 環境変数の設定を行ってくださいシステム環境変数の Path に ;(glassfish インストールフォルダ ) bin を追加 (C ドライブ直下の C: GlassFish glassfish へインストールした場合の例 ) Path=;C: GlassFish glassfish bin;c: WINDOWS system32;c: WINDO WS;... 2 Pet Store 2.0 下記の URL から javapetstore-2.0-ea5-installer.jar をダウンロードし適当なフォルダに展開してください HUhttps://blueprints.dev.java.net/servlets/ProjectDocumentList?folderID= 5315&expandFolder=5315&folderID=0U インストールしたフォルダを (Pet Store インストールフォルダ ) とします 7B3.2 起動手順 GlassFish の起動手順は最初にデータベースサーバを起動し次に Web アプリケーションサーバ GlassFish を起動します 1 データベースサーバの起動まずデータベースを起動させてください GlassFish に付属しているデータベースは以下のコマンドにより起動停止させることができます >(GlassFish インストールフォルダ ) bin asadmin start-database ( 起動 ) >(GlassFish インストールフォルダ ) bin asadmin stop-database ( 停止 ) 2Web アプリケーションサーバの起動次にアプリケーションサーバを起動させてください GlassFish アプリケーションサーバは以下のコマンドにより起動停止させることができます >(GlassFish インストールフォルダ ) bin asadmin start-domain domain1 ( 起動 ) >(GlassFish インストールフォルダ ) bin asadmin stop-domain domain1 ( 停止 ) 7

9 8B3.3 データソースの作成す Pet Store 2.0 の動作で必要なデータソースの値は下記のコマンドを用いてサーバ側へ登録することができま > (Pet Store インストールフォルダ ) ant setup 登録される情報については (Pet Store インストールフォルダ )/bp-project/app-server-ant.xml ファイルの内容が反映されます 9B3.4 コンパイルと配備コンパイル配備ブラウジングは Pet Store 2.0 においては以下のコマンドで全て行うことができます >(Pet Store インストールフォルダ ) ant run アプリケーション画面を表示させるブラウザは build.properties ファイル内で指定することができます OS が Windows あるいは Mac の場合デフォルトでブラウザ表示させることができますがそれ以外の場合はブラウザの実行ファイルがある場所を下記のように指定してください default.browser=( ブラウザの実行ファイルがある場所 ) 10B3.5 ブラウザ表示データソースの作成コンパイル配備が全て成功すると下記の画面がブラウザに表示されます 8

10 画面の上部にある Enter the Store をクリックすると下記の Home ページが表示されます 9

11 3B4. WebOTX 上で動作させるための手順 2008/9/1 現在最新版の WebOTX V8.1 は Java EE 5 に準拠しています WebOTX はデータベースサーバを含んでいないため別途インストールするか既存のデータベースサーバを利用する必要があります今回は Java SE 6 に付随している Java DB をインストールし使用します 1B4.1 プログラムのインストール 1 Java 環境 (Java SE 6) と Java データベース下記の URL から Java SE 6 の最新版 JDK をインストールしてください (2008/9/1 現在の最新版は JDK 6 Update 7 です ) インストール途中に Java DB のインストールオプションにチェックがあることを確認してくださいインストールしたフォルダをそれぞれ (Java インストールフォルダ ) (Java DB インストールフォルダ ) としますそれぞれ Path 環境変数の設定を行ってください JAVA_HOME=(Java インストールフォルダ ) システム環境変数の Path に ;(Java インストールフォルダ ) bin を追加 (C ドライブ直下の C: jdk1.5.0_16 へインストールした場合の例 ) JAVA_HOME=C: jdk1.5.0_16 Path=%JAVA_HOME% bin;c: WINDOWS system32;c: WINDOWS;... DERBY_HOME=(Java DB インストールフォルダ ) システム環境変数の Path に ;(Java DB インストールフォルダ ) bin を追加 (C ドライブ直下の C: Sun JavaDB へインストールした場合の例 ) 10

12 DERBY_HOME=C: Sun JavaDB Path=%DERBY_HOME% bin;c: WINDOWS system32;c: WINDOWS;... 2 WebOTX AS Pet Store 2.0 は EJB を使用していないため全ての WebOTX AS V8 のエディションで動作しますが Java EE 5 に準拠していることが動作要件ですそのためここでは現在最新の WebOTX AS Standard-J Edition V8.1をインストールしますインストールしたフォルダを (WebOTX インストールフォルダ ) とします 3 Pet Store 節と同様にインストールを行ってください 12B4.2 設定の書き換え (Pet Store インストールフォルダ ) bp-project 配下にはデータソースの作成コンパイル配備を行う際に必要となる定義ファイルが多数存在しますこの工程では ant を実行することにより開始されますがその時これらの定義ファイル群を使用します ant の実行によりまず (Pet Store インストールフォルダ ) 配下の build.xml ファイルが読み込まれますこの XML ファイルの中で同じディレクトリにある bp-project.xml ファイルが読み込まれさらにその XML ファイルの中から (Pet Store インストールフォルダ ) bp-project 配下の main.xml ファイルが読み込まれます以下同様に連鎖的にファイルが読み込まれる仕組みになっていますしたがって読み込まれる定義ファイルの内容を利用環境に合うように書き換える必要があります Pet Store 2.0 ではデータソースの作成に利用するコマンドやそれに付随したオプションを app-server-ant.xml ファイルにまとめて記述していますまた Web アプリケーションサーバやデータベースの定義については拡張子.properties のファイルに記述しています書き換えた内容の詳細は以下 < 書き換えた内容 > に記述していますなお書き換え済みのファイルは zip 形式で圧縮し下記に置いてありますのでそれぞれ上書きコピーし適宜利用してください ( 本ドキュメントのファイル ) PetStore_webotx.zip この圧縮ファイルにアーカイブされたファイル群は次に示した Pet Store インストールフォルダにコピーしてくだ 11

13 さい app-server.properties app-server-ant.xml build.properties (Pet Store インストールフォルダ ) bp-project javadb.properties setup.xml (Pet Store インストールフォルダ ) setup < 書き換えた内容 > app-server-ant.xml 運用管理コマンドに関して GlassFish では asadmin を使用しましたが WebOTX では otxadmin を使用します GlassFish ではデータソースを作成するために 2 種類のコマンド create-jdbc-connection-pool create-jdbc-resource による二段階の操作が必要です一方 WebOTX ではこの工程を単一のコマンド create-jdbc-datasource で行うことができますまたコマンドに付随するオプション規則にも違いがあるためマニュアルにしたがって WebOTX 用に書き換えています app-server.properties javaee.home=(webotx インストールフォルダ ) javaee.server.username=(webotx ユーザ名 ) javaee.server.password=(webotx パスワード ) db.home =(Java DB インストールフォルダ ) db.user=(java DB ユーザ名 ) [*] db.password=(javadb パスワード ) [*] db.sid=( 接続先データベース名 ) [*] [*] 上記 Java DB のユーザ名とパスワードは任意ですデータベースにインスタンスを作成する際データソースを作成する際に必要になります build.properties Web アプリケーションサーバに関する情報を環境に合わせて書き換えてください javaee.home=(webotx インストールフォルダ ) javaee.server.name=(webotx サーバ名 ) javaee.server.port=(webotx ポート番号 ) javaee.adminserver.name=(webotxadmin サーバ名 ) 12

14 javaee.adminserver.port=(webotxadmin サーバポート番号 ) javaee.server.username=(webotx ユーザ名 ) javaee.server.password=(webotx パスワード ) javadb.properties 先に説明した app-server.properties ファイルへ記述した任意の接続先データベース名を記述してください db.sid=( 接続先データベース名 ) [*] 13B4.3 データベースの設定 1. ドライバの登録 WebOTX から Java DB への接続を可能にするためには Java DB の JDBC ドライバ derbyclient.jar を WebOTX に登録する必要があります下記の場所にある JDBC ドライバを (WebOTX インストールフォルダ ) domains domain1 lib ext にコピーしてください (Java DB インストールフォルダ ) lib derbyclient.jar 2. インスタンスの生成 (Java DB インストールフォルダ ) bin にある startnetworkserver.bat を実行しデータベースサーバのネットワーク接続を開始してください次に同じ場所にある ij.bat を実行した後下記のコマンドを用いてデータベース上にインスタンスを作成してください > connect 'jdbc:derby://localhost/testdb;;user=test;password=test; create=true;'; ただし下記の項目に関してはデータソース作成時に決めた任意の名前に書き換えてください localhost/testdb=(web アプリケーションサーバのホスト名 )/( 接続先データベース名 ) user=(java DB ユーザ名 ) password=(java DB パスワード ) 14B4.4 起動手順 1 まずデータベースサーバを起動します WebOTX の otxadmin 運用管理コマンドにより起動停止させることができます 13

15 >(WebOTX インストールフォルダ ) bin otxadmin start-database ( 起動 ) >(WebOTX インストールフォルダ ) bin otxadmin stop-database ( 停止 ) 2 次に WebOTX AS を起動します 1 と同様に WebOTX の otxadmin 運用管理コマンドにより起動停止させることができます >(WebOTX インストールフォルダ ) bin otxadmin start-domain domain1 ( 起動 ) >(WebOTX インストールフォルダ ) bin otxadmin stop-domain domain1 ( 停止 ) 15B4.5 データソースの作成 3.4 節と同様に以下のコマンドを用いてデータソースを作成してくださいこのとき反映される (Pet Store インストールフォルダ )/bp-project/app-server-ant.xml ファイルは 4.2 節で書き換えたものです >(Pet Store インストールフォルダ ) ant setup 実行途中でコマンドプロンプト上にコマンド create-jdbc-datasource は正常に実行されましたと表示されればデータソース作成は成功ですデータソースが作成された後それが利用可能な状態にあるかを以下のコマンドを用いてテストしてくださいオプションとして (WebOTX ユーザ名 ) (WebOTX パスワード ) ( データソース名 ) が必要です >(WebOTX インストールフォルダ ) bin otxadmin ping-jdbc-datasource u (WebOTX ユーザ名 ) w (WebOTX パスワード ) ( データソース名 ) コマンド ping-jdbc-datasource は正常に実行されましたと表示されればデータソースは利用できる状態にありますデータソースがうまく作成されていない場合は以下のコマンドにより setup を解除し設定を確認してください >(Pet Store インストールフォルダ ) ant unsetup 14

16 16B4.6 コンパイルと配備 3.5 節と同様にコンパイルと配備を行います >(Pet Store インストールフォルダ ) ant run 17B4.7 ブラウザ表示コンパイルと配備が成功すると 3.6 節と同様ブラウザに Enter the Store と書かれた画面が表示されますこの文字をクリックすると Pet Store 2.0 の Home ページが表示されます一旦配備に成功すればブラウザに直接下記の URL を入力することによってもページを表示することができます HUhttp://localhost/petstore/U 15

Red Hat Enterprise Linuxのcron(8)デーモンにデフォルト定義されたtmpwatch命令の動作による、WebOTXのトラブル対処方法

Red Hat Enterprise Linuxのcron(8)デーモンにデフォルト定義されたtmpwatch命令の動作による、WebOTXのトラブル対処方法 Red Hat Enterprise Linux の cron(8) デーモンにデフォルト定義された tmpwatch 命令の動作による WebOTX のトラブル対処方法 2009 年 2 月 NEC 第二システムソフトウェア事業部 1. 概要 Red Hat Enterprise Linux では OS インストール後の初期状態において cron(8) デーモンによって実行される命令が複数定義されます

Java Pet Store 2.0 を WebOTX 上で 動作させる方法 2008 年 9 月 初版 NEC 第二システムソフトウェア事業部 0

Java Pet Store 2.0 を WebOTX 上で動作させる方法 2008 年 9 月初版 NEC 第二システムソフトウェア事業部 0