この文書は、Java BluePrints Solutions Catalog for Java EE 5, Early Access Ver. 0.4 distribution.に含まれるREADME.htmlの勝手翻訳です。

日本語訳に誤りがある可能性があります。翻訳の正確性は保証しませんので、自己責任においてご使用下さい。

間違い等あれば、こちらにトラックバックをお願いします。

Java™ BluePrints Solution Catalog for Java EE 5, Early Access Ver. 0.4 Installation Guide

Java EE 5用Java™ BluePrintsソリューションカタログ、早期アクセス版 Ver. 0.4インストールガイド

This document describes how to install Java BluePrints Solution Catalog onto your application server.

このドキュメントは、アプリケーションサーバにJava BluePrintsソリューションカタログをインストールする方法を説明しています。

Before installing the Solution Catalog, you need to download and install the following software:

ソリューションカタログをインストールする前に次のソフトウェアをダウンロード・インストールしておく必要があります:

  1. JDK 5.0 Update 6 or later: Download here
    JDK 5.0 Update 6 以降: ここからダウンロード
  2. Download and Install the Java  EE 5 SDK
    Java EE 5 SDKをダウンロード・インストールして下さい
    1. Download the Beta version of the Java EE 5 SDK
      Java EE 5 SDKのベータ版をダウンロードして下さい
    2. Install the SDK following the Installation Instructions
      インストール説明書に従ってSDKをインストールして下さい
The Java BluePrints Solution Catalog can also be deployed on the promoted builds of the GlassFish project:
Java BluePrints ソリューションカタログはGlassFishプロジェクトの昇格ビルドにもデプロイすることができます:
    1. Download a promoted build of the GlassFish project.  Note: As this is an early access release of the solutions catalog, it has been tested only on build 36 of GlassFish.
      GlassFishプロジェクトの昇格ビルドをダウンロードして下さい。注意: これはソリューションカタログの早期アクセスリリースであるため、GlassFishのビルド36のみでテストしています。
    2. Install GlassFish by following these steps: 
      次のステップに従ってGlassFishをインストールして下さい:
      1. Change to an empty directory (e.g. your home directory)
        空のディレクトリに移動して下さい(例えば、homeディレクトリ)
      2. Run:
        java -Xmx256m -jar glassfish-installer-9.0-b36.jar
        次を実行して下さい:
        java -Xmx256m -jar glassfish-installer-9.0-b36.jar
      3. change to the glassfish/ directory
        glassfish/ディレクトリに移動して下さい
      4.  Run:
        ant -f setup.xml
        次を実行して下さい:
        ant -f setup.xml

Environment Variables

環境変数

You need to set the following environment variables to setup the Java BluePrints Solution Catalog. 

Java BluePrintsソリューションカタログをセットアップするために次の環境変数をセットする必要があります。

Your PATH must include the following directories.

PATH変数は次のディレクトリを含む必要があります。

Unix: Windows:

Installing the Java BluePrints Solution Catalog

Java BluePrintsソリューションカタログのインストール

Note : If you are using this application on an already installed instance of the Java EE 5 and you had already deployed a version of the solution catalog, you need to undeploy all of its applications before performing the instructions listed below. For instructions on uninstalling the solution catalog application components, see the next section of this document.

注意: このアプリケーションをインストール済みJava EE 5上で使用する場合、かつ、あるバージョンのソリューションカタログがデプロイ済みである場合には、次の一覧にある作業を実行する前に全てのアプリケーションをアンデプロイしておく必要があります。ソリューションカタログアプリケーションコンポーネントのアンインストール作業を行うにはこのドキュメントの次のセクションを参照して下さい。

To install the solution catalog applications, follow these steps:
ソリューションカタログアプリケーションをインストールするには、次のステップに従って下さい:
  1. Start the Java EE server and wait till it is up and running.
    Java EEサーバを起動し起動が完了するまで待ちます。
    If you are using Unix, open a shell prompt and enter these commands:
    Unixを使用している場合、シェルを起動し次のコマンドを入力して下さい: 
     cd $JAVAEE_HOME/bin
     asadmin start-domain domain1
    If you are using Windows, open a command prompt and enter these commands:
    Windowsを使用している場合、コマンドプロンプトを起動し次のコマンドを入力して下さい: 
     cd %JAVAEE_HOME%\bin
     asadmin start-domain domain1
  2. Change directory to the <bpcatalog.home> directory. For the remainder of these instructions, we will use <bpcatalog.home> to refer to the installation directory of the solutions catalog. It is same as the directory where this README.html file is located. Copy build.properties.sample to build.properties and change the following properties in build.properties:
    <bpcatalog.home>ディレクトリに移動します。残りの作業では、ソリューションカタログのインストールディレクトリを参照するのに<bpcatalog.home>を使用します。README.htmlが置かれている場所と同一ディレクトリです。build.properties.sampleをbuild.propertiesにコピーし、build.propertiesの次のプロパティを変更します:
    Property Name
    プロパティ名    		 Description
    説明    		 Examples
    例
    javaee.home The installation directory of the Java EE 5 SDK
    Java EE 5 SDKのインストールディレクトリ    		 /home/username/glassfish
    javaee.server.name Host name of the server where the Java EE 5 SDK is installed
    Java EE 5 SDKがインストールされたサーバのホスト名    		 localhost
    javaee.server.port The port number for the server you chose while installing Java EE 5 SDK
    Java EE 5 SDKをインストールした際に選択したサーバのポート番号    		 8080
    javaee.server.username The administrator username specified for the serve while installing Java EE 5 SDK
    Java EE 5 SDKをインストールした際に決めたサーバ用に設定した管理者のユーザ名    		 admin
    javaee.server.passwordfile The path to a file containing the admin password for the Java EE 5 SDK. The password file needs to be in the following format:
    Java EE 5 SDK用の管理者パスワードを含んでいるファイルへのパス。パスワードファイルは次のフォーマットである必要があります:

    AS_ADMIN_PASSWORD=<javaeesdk-admin-password>

    Where you will replace <javaeesdk-admin-password> with adminadmin as the password for the Java EE 5 SDK.

    <javaeesdk-admin-password>の部分をJava EE 5 SDK用のパスワードとしてadminadminに書き換えて下さい。

    		 /path/to/passwordfile



    password value should be adminadmin 
    パスワード値はadminadminにしなければなりません
    javaee.adminserver.port The port number for admin server you chose while installing the Java EE 5 SDK
    Java EE 5 SDKをインストールした際に選択した管理者サーバ用ポート番号    		 4848
    Table 1: Properties specific to Java EE 5 SDK
    表1: Java EE 5 SDK特有のプロパティ

  3. Change directory to the<bpcatalog.home> directory. Run the setup script. This script will configure the various resources on the Java EE 5 SDK and deploy all the bpcatalog sample applications along-with the viewer application on the Java EE 5 SDK.
    <bpcatalog.home>ディレクトリに移動します。setupスクリプトを実行します。このスクリプトはJava EE 5 SDKの様々なリソースを設定し、Java EE 5 SDKにビューアアプリケーションと合わせて全てのbpcatalogサンプルアプリケーションをデプロイします。

    If you are using Unix, open a shell prompt and enter these commands:
    Unixを使用している場合、シェルを起動し次のコマンドを入力して下さい:
    sh setup.sh

    If you are using Windows, open a command prompt and enter these commands:
    Windowsを使用している場合、コマンドプロンプトを起動し次のコマンドを入力して下さい:
    setup.bat

  4. Access the catalog. After deploying the solution catalog, you can access it by pointing your browser to:
    カタログにアクセスします。ソリューションカタログのデプロイ後、ブラウザで次の場所を指定することができます:
    http://javaee5.server.name:javaee5.server.port/bpcatalog

    For example
    例えば
    http://localhost:8080/bpcatalog

Uninstalling the Java BluePrints Solutions Catalog

Java BluePrintsソリューションカタログのアンインストール

To undeploy, run the following commands:

アンデプロイするには、次のコマンドを実行して下さい:

For Unix, open a shell prompt and enter these commands:
Unixを使用している場合、シェルを起動し次のコマンドを入力して下さい:
sh setup.sh unsetup

For Windows, open a command prompt and enter these commands:
Windowsを使用している場合、コマンドプロンプトを起動し次のコマンドを入力して下さい:
setup.bat unsetup

Note this will undeploy all the applications as well as clean up any resources, such as a JdbcCoonection pool, that are used by the applications.

これは、例えばアプリケーションによって使用されているJdbcConnectionプールといったリソースを削除するだけでなく全てのアプリケーションをアンデプロイすることに注意して下さい。

Java BluePrints AJAX Components

Java BluePrints AJAX コンポーネント

In addition to the applications that use the components in the solutions catalog, the component libraries are available as jar files which you can use in your web applications. The component library jars are available in <bpcatalog.home>/src/lib/ directory. The bp-ui-14.jar components run on a J2EE 1.4 compatible application server as well as on a Java EE 5 compatible application server. The components in bp-ui-14.jar also available in Java Studio Creator 2. The second component library is named bp-ui-5.jar and can only be run on a Java EE 5 compatible application server. Feel free to try these out in your own web applications.
ソリューションカタログに含まれるコンポーネントを使用するアプリケーションに加えて、独自のWebアプリケーションで使用できるコンポーネントライブラリがjarファイルとして提供されています。コンポーネントライブラリのjarは<bpcatalog.home>/src/libディレクトリに置かれています。bp-ui-14.jarコンポーネントはJava EE 5互換のアプリケーションサーバだけでなくJ2EE 1.4互換のアプリケーションサーバで動作します。bp-ui-14.jar内のコンポーネントはまたJava Studio Creator 2でも提供されています。2番目のコンポーネントはbp-ui-5.jarという名前で、Java EE 5 SDK互換のアプリケーションサーバでのみ動作します。遠慮なく独自のWebアプリケーションでこれらを試してみて下さい。

Building the Source

ソースコードのビルド

Note that this is an optional step, meant for people interested in experimenting with the source code of the applications. The source code for all the applications is available under the  src/ directory under the installation directory of the solutions catalog. There are two sections below, the first section describes how to build all the applications and the second section describes how to build just a single application.

これは任意のステップであることに注意して下さい、つまりアプリケーションのソースコードを検証することに興味がある人向けに作られています。全てのアプリケーションのソースコードはソリューションカタログのインストールディレクトリの下にあるsrc/ディレクトリ以下に存在します。これらは次に挙げるふたつのセクションに分かれています、ひとつ目のセクションは全てのアプリケーションをどのようにビルドするかを説明しており、二つ目は単一のアプリケーションのみをビルドする方法を説明しています。

Note, in these instructions, when referring to a directory location, we will use <bpcatalog.home> as the directory for your installation of the Java BluePrints Solutions Catalog. This is the directory that got created where you unzipped the download.

注意、これらの作業でディレクトリの場所を参照する際には、Java BluePrintsソリューションカタログをインストールしたディレクトリとして<bpcatalog.home>を使用します。これはダウンロードしたファイルを解凍して作成されたディレクトリを指しています。

Building all the applications

全てのアプリケーションのビルド

Note that the solutions catalog contains a number of applications, so building all of them may be time-consuming. Here are the build instructions:

ソリューションカタログはいくつものアプリケーションを含んでいることに注意して下さい、つまり全てのアプリケーションをビルドするには時間がかかるでしょう。ビルド手順を次に挙げます:

  1. Set up the environment as described above in the Environment Variables section of this document.
    このドキュメントの上記環境変数セクションで説明した通り、環境をセットアップします。
  2. Copy <bpcatalog.home>/build.properties.sample to build.properties in your home directory. On Windows, your home directory is usually at c:/Documents and Settings/username. On Unix, the home directory is usually under /home/username. Note that username is your login id to the computer. You may need to change some properties in build.properties as described in the Table 1.
    <bpcatalog.home>/build.properties.sampleをホームディレクトリ直下にbuild.propertiesとしてコピーします。Windows上では、ホームディレクトリは通常C:/Documents and Settings/usernameにあります。Unix上では、ホームディレクトリは通常/home/username以下となります。usernameはコンピュータへのログインIDであることに注意して下さい。表1の中で説明されているようにbuild.propertiesのいくつかのプロパティを変更する必要があるかも知れません。
  3. From the  <bpcatalog.home>/src directory run one of these ant commands
    <bpcatalog.home>/srcディレクトリからいずれかのantコマンドを実行して下さい
    Ant Target Name
    Antターゲット名
    		 Description
    説明
    default
    		 This target builds all the applications
    このターゲットは、全てのアプリケーションをビルドします
    run This target builds and deploys all the applications to the Java EE 5 SDK. It also launches their home pages in a browser
    このターゲットは全てのアプリケーションをビルドし、Java EE 5 SDKにデプロイします。また、ブラウザでホームページを表示します。
    deploy This target deploys all the applications to the Java EE 5 SDK
    このターゲットは全てのアプリケーションをJava EE 5 SDKにデプロイします。
    undeploy This target undeploys all the applications from the Java EE 5 SDK
    このターゲットはJava EE 5 SDKから全てのアプリケーションをアンデプロイします
    clean This target deletes all the compiled classes and built applications binaries
    このターゲットは全てのコンパイルされたクラスとビルドされたアプリケーションバイナリを削除します
    Note that before deploying the applications, you will need to start the appserver.
    アプリケーションをデプロイする前には、アプリケーションサーバが起動している必要ある点に注意して下さい。

Building a Single application

単一のアプリケーションのビルド

Somtimes you may want to build just one application instead of all the applications. The applications for the Web tier are available under <bpcatalog.home>/src/webtier.
ひょっとしたら全てのアプリケーションの変わりに単一のアプリケーションだけをビルドしたくなるかもしれません。Web層のアプリケーションは<bpcatalog.home>/src/webtier以下に存在します。
Here are instrcutions to build just a single application.
以下は単一のアプリケーションのみをビルドする手順です。
Copyright © 2005 Sun Microsystems, Inc. All Rights Reserved.