[1. Naming Conventions and Basic Assumptions] 1. 命名規則と基本となる前提

[Source Basic Assumptions] ソースにおける基本となる前提

  • Unless otherwise specified, you should be running all maven build commands from within the Jetspeed directory (if you are just building Jetspeed) or from within your custom portal directory.
  • You must use "/" as a file seperator on both *nix and windows, e.g. c:/windows, and /home.
  • 特別に定めのない限り、全ての maven のビルドコマンドは (Jetspeed をビルドするときは) Jetspeed ディレクトリで実行されるか、作成しようとしているカスタムのポータル作成用ディレクトリで実行されます。
  • * *nix 環境であっても、Windows 環境であっても、例えば c:/windows や /home のように、ディレクトリのセパレータとしては "/" を使用しなければいけません。

[Naming Conventions] 命名規則

Below is a listing of common conventions used within this document.

この文書で使用する共通の規則を以下に示します。

Variables are represented as ${ some_variable }. This may signify a setting in Jetspeed or may represent a setting within your environment. Properties files are also capable of specifying variables within them.

変数は ${ some_variable } として表します。これは Jetspeed の設定を表すこともできますし、あなたの環境内での設定を表すこともできます。プロパティファイルもその中で変数を記述することができます。

For example, ${org.apache.jetspeed.server.home} references either a property defined further up in the properties file, a variable that has been defined somehwere within the build process or defined in another build file within Jetspeed.

例えば、${org.apache.jetspeed.server.home} はプロパティファイル内で以前に定義されたプロパティを参照したり、ビルドプロセス内のどこかで定義される変数や、Jetspeed 内の他のビルドファイル内で定義された変数を参照するかもしれません。

  • ${USER_HOME} : This is the user's home directory. For Windows systems, this generally c:\Documents and Settings\${userName} where ${userName} is the name you use to log into windows.

    ${USER.HOME} is synonymous with ${USER_HOME} within this document.
  • ${CATALINA_HOME} : This is the location of your tomcat installation, e.g. c:/tomcat .
  • ${USER_HOME} : ユーザのホームディレクトリです。Windows では、一般的に c:\Documents and Settings\${userName}\ になります。ここで ${userName} は Windows にログインするときのログイン名です。
  • ${CATALINA_HOME} : あなたが Tomcat をインストールした場所です。例えば c:/tomcat などです。

[Source Subversion (SVN)] Subversion (SVN) でのソース管理

Subversion (SVN) is used in the Jetspeed project to manage the source files. SVN is very similar to CVS. For those user's on Windows system who prefer non-command line access we suggest using TortoiseSVN which plugs into your Windows Explorer view. For those using the Eclipse IDE, the Subclipse plugin is available for SVN access.

Subversion (SVN) は Jetspeed のソースファイルを管理するために使われます。SVN は CVS にとても似ています。Windows システムでコマンドラインを使用しないユーザは、 TortoiseSVN を使ってみると良いでしょう。このツールは Windows Explorer にプラグインされます。Eclipse IDE を使っているユーザは Subclipse プラグインが SVN アクセスに使用できます。

[Maven Setup] Maven セットアップ

We will not go into the specifics of Maven as that is beyond the scope of this document. However, here are a few bits of standard maven jargon we feel is important for you to know.

この文書では、Maven の仕様については述べません。しかし、ここであなたが知っておくべき重要な maven の基本的な専門用語を以下に少しだけ挙げておきます。

You will see mention of a maven repository in this document. When you install Maven the .maven/ directory is created in your ${USER_HOME) directory.

Under .maven/ you will see a repository directory. This is were Maven stores all the jars that it downloads when you run your builds. This is also were Maven puts your jars and wars that you build. They will be stored in a directory structure that has the format of ${groupId}/${projectId}/jars/${projectId}-{$version}.jar for jar files and ${groupId}/${projectId}/wars/${projectId}.war for war files. The ${groupId}, ${projectId} and ${version} variables are discussed later on in this document. Jar and war files will also be created in your project in the /target directory.

あなたは文書内で maven リポジトリについて触れるのを目にすることがあるでしょう。maven をインストールすると、.maven/ ディレクトリが ${USER_HOME} ディレクトリに作成されます。

.maven/ 以下に repository というディレクトリがあるはずです。ここにはビルドを実行するときに maven がダウンロードした jar ファイルが保存されます。ここはあなたのビルドでできた jar ファイルや war ファイルも置かれることがあります。jar ファイルは ${groupId}/${projectId}/jars/${projectId}-{$version}.jar の形式で置かれます。ポータル war ファイルは ${groupId}/${projectId}/wars/${projectId}.war の形式となります。${groupId}、${projectId}、${version} の各変数についてはこの文書の後の方で触れます。jar ファイルと war ファイル>は、あなたのプロジェクトの /target ディレクトリにも作成されます。

[2. Jetspeed build and maven-plugin Properties] 2. Jetspeed のビルドと maven プラグインのプロパティ

You need to set a few properties.

いくつかプロパティを設定する必要があります。

Creating your own custom portal is very easy with the maven plugin provided by Jetspeed 2. And, it is used when you build jetspeed from source as well. In fact, the jetspeed-2 build procedure is just one example of a custom portal configuration and setup.

カスタムのポータルを作るのは Jetspeed 2 が提供する Maven プラグインを使えばとても簡単です。ソースから Jetspeed をビルドするときも同様に Maven プラグインを使います。事実、Jetspeed 2 のビルド手順はちょうどカスタムポータルを設定し、構築する一例のようなものです。

The Jetspeed 2 maven-plugin defines default values for most of the properties you can set, but not all. When you download or checkout the jetspeed-2 source tree, you'll see it contains a project.properties file in the root folder overriding and setting some of these properties.

Jetspeed 2 の Maven プラグインは設定可能なほとんどのプロパティにデフォルト値を定義しています。しかし、全てに定義されているわけではありません。Jetspeed 2 のソースツリーをダウンロードしたり、チェックアウトしたとき、これらのプロパティのいくつかを設定したり上書きしたりする project.properties ファイルがルートフォルダにあるのがわかるでしょう。

As said before: not all properties are provided with a default value: you must specify a few yourself. And you'll most likely want to override some others.

前述のように、全てのプロパティにデフォルト値が定義されているわけではありません。いくつかのプロパティを指定 しなければなりません。そして、大体の場合はいくつかの値を上書きしたくなるでしょう。

Set or override the build or maven-plugin properties in your ${USER_HOME}/build.properties file.

ビルドプロパティもしくは Maven プラグインのプロパティは ${USER_HOME}/build.properties に設定もしくは上書きしてください。

[Required Portal Configuration Properties] 必須のポータル設定プロパティ

PropertyDescriptionDefault value
org.apache.jetspeed.portal.home The folder where the maven-plugin will (re)create or update your custom portal maven project configuration (with goal j2:portal.conf.project ). This will be where you will be performing all of your future custom portal development.

Example: /home/myportal/
no default
org.apache.jetspeed.portal.groupId The (maven) short name of your portal project group.

This value is used for the maven repository folder in which the project artifacts (like the portal war file) is stored.

Example: myprojects
no default
org.apache.jetspeed.portal.artifactId The (maven) short name of your portal project.

This value is used for the portal war file and the (portal) web application context name.

Example: myportal
no default
org.apache.jetspeed.portal.name The (maven) full name of your portal project.

This value is used by maven for generating JavaDoc titles.

Example: My Test Portal
no default
org.apache.jetspeed.portal.currentVersion The current version of your portal project.

This value is used by maven as name postfix for the generated artifacts.

Example: 1.0
no default
プロパティ説明デフォルト値
org.apache.jetspeed.portal.home (j2:portal.conf.project ゴールで) Maven プラグインがあなたのカスタムポータル用 Maven プロジェクトを(再)構築したり更新したりするフォルダ。この場所はあなたがカスタムポータルの開発を今後全て行う場所になります。 例: /home/myportal デフォルト値なし
org.apache.jetspeed.portal.groupId あなたのポータルプロジェクトグループの (Maven での) 省略名。

この値は (ポータル war ファイルのような) プロジェクトの成果物を保管しておく Maven のリポジトリフォルダに使います。

例: myprojects
デフォルト値なし
org.apache.jetspeed.portal.artifactId あなたのポータルプロジェクトの (Maven での) 省略名。

この値はポータル war ファイルや (ポータル) ウェブアプリケーションのコンテキスト名に使います。

例: myportal
デフォルト値なし
org.apache.jetspeed.portal.name あなたのポータルプロジェクトの (Maven での) フルネーム。

この値は JaveDoc のタイトルを生成するのに Maven が使います。

例: My Test Portal
デフォルト値なし
org.apache.jetspeed.portal.currentVersion あなたのポータルプロジェクトの現在のバージョン。

この値はプロジェクトの成果物の名前の最後に Maven に付け加えられます。

例: 1.0
デフォルト値なし

[Optional Portal Configuration Properties] 省略可能なポータル設定プロパティ

The following properties all specify a subfolder of the ${org.apache.jetspeed.portal.home} location as defined above.

このあとに述べるプロパティは全て、上で定義した ${org.apache.jetspeed.portal.home} のサブフォルダを指定します。

PropertyDescriptionDefault value
org.apache.jetspeed.portal.conf.dir The folder where the maven-plugin will generate and copy application server specific configuration files as a tomcat application context descriptor.

This folder and its contents is created or updated by plugin goal j2:portal.conf.tomcat .
target/portal-conf
org.apache.jetspeed.portal.sql.dir The folder where the maven-plugin will generate and copy portal and database server specific sql DDL and DML scripts.

This folder and its contents is always (re)created by plugin goal j2:portal.conf.sql .
target/portal-sql
org.apache.jetspeed.portal.db.dir The folder where the maven-plugin will create its build-in HSQLDB database(s).

This folder and its contents is created or updated by plugin goal j2:start.production.server or j2:start.test.server .
target/portal-db
org.apache.jetspeed.portal.webapp.dir The folder where the maven-plugin will copy the standard jetspeed web application resources.

This folder and its contents is created or updated by plugin goal j2:portal.copy.webapp .
target/${org.apache.jetspeed.portal.artifactId}
org.apache.jetspeed.portal.target.dir The folder where the maven-plugin will generate and copy runtime portal configuration files.

These configuration files contain values derived from build/plugin properties for the portal and OJB.

This folder and its contents is created or updated by plugin goal j2:portal.conf.jetspeed and goal j2:portal.conf.ojb .
target/${org.apache.jetspeed.portal.artifactId}
プロパティ説明デフォルト値
org.apache.jetspeed.portal.conf.dir Maven プラグインがアプリケーションサーバの設定ファイルを Tomcat のアプリケーションのコンテキスト記述子として生成しコピーするフォルダ。

このフォルダとフォルダ内のコンテンツは j2:portal.conf.tomcat プラグインゴールによって作成されたり更新されたりします。
target/portal-conf
org.apache.jetspeed.portal.sql.dir Maven プラグインがポータルやデータベースサーバの sql DDL と DML スクリプトを生成しコピーするフォルダ。

このフォルダとフォルダ内のコンテンツは常に j2:portal.conf.sql プラグインゴールによって (再) 生成されます。
target/portal-sql
org.apache.jetspeed.portal.db.dir Maven プラグインがビルドインの HSQLDB データベースを作成するフォルダ。

このフォルダとフォルダ内のコンテンツは j2:start.production.server もしくは j2:start.test.server プラグインゴールによって生成されたり更新されたりします。
target/portal-db
org.apache.jetspeed.portal.webapp.dir Maven プラグインが標準の Jetspeed のウェブアプリケーションのリソースをコピーするフォルダ。

このフォルダとフォルダ内のコンテンツは j2:portal.copy.webapp プラグインゴールによって生成されたり更新されたりします。
target/${org.apache.jetspeed.portal.artifactId}
org.apache.jetspeed.portal.target.dir Maven プラグインがランタイムのポータルの設定ファイルを生成したりコピーしたりするフォルダ。

これらの設定ファイルはポータルや OJB のビルド/プラグインプロパティから生成された値を含みます。

このフォルダとフォルダ内のコンテンツは j2:portal.conf.jetspeed もしくは j2:portal.conf.ojb プラグインゴールによって生成されたり更新されたりします。
target/${org.apache.jetspeed.portal.artifactId}

[Required Application Server Properties] 必須のアプリケーションサーバのプロパティ

Note: The maven-plugin currently only supports the Tomcat Server 5.0.x or 5.5.x

注意: Mavenプラグインは現時点では Tomcat 5.0.x または 5.5.x のみをサポートします。

PropertyDescriptionDefault value
org.apache.jetspeed.server.home The root folder of your Tomcat server installation.

Example: ${CATALINA_HOME}/ .
no default
org.apache.jetspeed.server.shared The location of the shared jars in your Tomcat installation.

Example: ${org.apache.jetspeed.server.home}/shared/lib/
no default
org.apache.jetspeed.deploy.war.dir The location of web applications in your Tomcat installation.

Example: ${org.apache.jetspeed.server.home}/webapps/
no default
org.apache.jetspeed.services.autodeployment.user A Tomcat user with the manager role.

Used to access the Tomcat Manager application from within the portal, explained below.
no default
org.apache.jetspeed.services.autodeployment.password The password of the Tomcat user above.

Used to access the Tomcat Manager application from within the portal, explained below.
no default
org.apache.jetspeed.catalina.version.major The major version of the Tomcat server you are using: 5 or 5.5

Example: 5.5
no default
プロパティ説明デフォルト値
org.apache.jetspeed.server.home Tomcat をインストールしたルートフォルダ。

例: ${CATALINA_HOME}/
デフォルト値なし
org.apache.jetspeed.server.shared Tomcat の共有の jar の置場。

例: ${org.apache.jetspeed.server.home}/shared/lib/
デフォルト値なし
org.apache.jetspeed.deploy.war.dir Tomcat のウェブアプリケーションの場所。

例: ${org.apache.jetspeed.server.home}/webapps/
デフォルト値なし
org.apache.jetspeed.services.autodeployment.user manager ロールに属する Tomcat のユーザ。

後で説明するように、ポータル内から Tomcat Manager アプリケーションへアクセスするのに使います。
デフォルト値なし
org.apache.jetspeed.services.autodeployment.password 前述の Tomcat ユーザのパスワード。

後で説明するように、ポータル内から Tomcat Manager アプリケーションへアクセスするのに使います。
デフォルト値なし
org.apache.jetspeed.catalina.version.major 使用する Tomcat のメジャーバージョン。5 もしくは 5.5 が使えます。

例: 5.5
デフォルト値なし

[Optional Database Server Properties] 省略可能なデータベースサーバのプロパティ

Jetspeed-2 and its maven-plugin uses, as well as provides, by default a HSQLDB database.

Jetspeed 2 と Jetspeed 2 の Maven プラグインはデフォルトでは提供される HSQLDB のデータベースを使用します。

If you want to use a different database you will need to override the following properties:

もし異なるデータベースを使用するのであれば、以下のプロパティを上書きする必要があります。

PropertyDescriptionDefault value
org.apache.jetspeed.production.database.default.name The type of database you are using. Used for sql script generation with Torque.

Currently supported databases (with corresponding Torque target database name):
  • hsql (hypersonic)
  • oracle (oracle)
  • mysql (mysql)
  • postgres (postresql)
  • mssql (mssql)
hsql
org.apache.jetspeed.production.database.url The jdbc connection urljdbc:hsqldb:hsql://127.0.0.1:9001
org.apache.jetspeed.production.database.user The database user name to connect with.sa
org.apache.jetspeed.production.database.password The database user its password to connect with. empty
org.apache.jetspeed.production.database.driver The jdbc driver class nameorg.hsqldb.jdbcDriver
org.apache.jetspeed.production.jdbc.drivers.path A Java classpath style path to the jdbc driver classes or jar(s) needed for connecting to the database.

Example: /lib/ojdbc14.jar;/lib/nls_charset12.jar
empty
プロパティ説明デフォルト値
org.apache.jetspeed.production.database.default.name あなたが使用するデータベースの種類。Torque が生成する SQL スクリプトのために使用します。

現時点でサポートするデータベースは以下の通りです。(Torque の対象のデータベース名と一致します。)
  • hsql (hypersonic)
  • oracle (oracle)
  • mysql (mysql)
  • postgres (postresql)
  • mssql (mssql)
hsql
org.apache.jetspeed.production.database.url JDBC の接続 URLjdbc:hsqldb:hsql://127.0.0.1:9001
org.apache.jetspeed.production.database.user データベースに接続する際のユーザ名。sa
org.apache.jetspeed.production.database.password データベースに接続するユーザのパスワード。
org.apache.jetspeed.production.database.driver JDBC ドライバのクラス名org.hsqldb.jdbcDriver
org.apache.jetspeed.production.jdbc.drivers.path データベース接続に必要な JDBC ドライバクラスや jar への Java クラスパススタイルのパス。

例: /lib/ojdbc14.jar;/lib/nls_charset12.jar

[Example: A minimal custom portal configuration] 例: 最小限のカスタムポータルの設定

Make sure you have define at least the required properties as described above in your ${USER_HOME}/build.properties . A minimal custom portal configuration using the default HSQLDB database can be something like:

						
# required portal configuration properties          
org.apache.jetspeed.portal.home           = /home/myportal/
org.apache.jetspeed.portal.groupId        = myprojects
org.apache.jetspeed.portal.artifactId     = myportal
org.apache.jetspeed.portal.name           = My Test Portal
org.apache.jetspeed.portal.currentVersion = 1.0

# required application server properties
org.apache.jetspeed.server.home                      = ${CATALINA_HOME}/
org.apache.jetspeed.server.shared                    = ${org.apache.jetspeed.server.home}/shared/lib/
org.apache.jetspeed.deploy.war.dir                   = ${org.apache.jetspeed.server.home}/webapps/
org.apache.jetspeed.services.autodeployment.user     = j2deployer
org.apache.jetspeed.services.autodeployment.password = xxxxx
org.apache.jetspeed.catalina.version.major           = 5.5
					
Note: If you're going to build the default Jetspeed 2 portal directly from the source only the org.apache.jetspeed.portal.home property is required from the set of required portal configuration properties.

少なくとも前述の必須のプロパティは ${USER_HOME}/build.properties で定義する必要があることに注意してください。HSQLDB を使った最低限のカスタムポータルの設定は以下のようになります。

						
# 必須のポータルの設定プロパティ
org.apache.jetspeed.portal.home           = /home/myportal/
org.apache.jetspeed.portal.groupId        = myprojects
org.apache.jetspeed.portal.artifactId     = myportal
org.apache.jetspeed.portal.name           = My Test Portal
org.apache.jetspeed.portal.currentVersion = 1.0

# 必須のアプリケーションサーバのプロパティ
org.apache.jetspeed.server.home                      = ${CATALINA_HOME}/
org.apache.jetspeed.server.shared                    = ${org.apache.jetspeed.server.home}/shared/lib/
org.apache.jetspeed.deploy.war.dir                   = ${org.apache.jetspeed.server.home}/webapps/
org.apache.jetspeed.services.autodeployment.user     = j2deployer
org.apache.jetspeed.services.autodeployment.password = xxxxx
org.apache.jetspeed.catalina.version.major           = 5.5
					
注意: もしデフォルトの Jetspeed 2 ポータルをソースから直接ビルドするつもりなのであれば、必須のポータルの設定プロパティのうち、 org.apache.jetspeed.portal.home だけが必要になります。

[4. Creating a new Portal Application] 4. 新しいポータルアプリケーションの作成

Now we're going to configure, setup and build a new custom portal application using the Jetspeed-2 maven-plugin.

さて、ここでは Jetspeed 2 の Maven プラグインを使って、新しいカスタムポータルアプリケーションを設定し、セットアップし、ビルドします。

[4.1 Set the maven remote repository lookup configuration] 4.1 Maven のリモートリポジトリを見付けるための設定

To be able to setup a Jetspeed 2 based portal the maven remote repository lookup needs to be configured properly in your ${USER_HOME}/build.properties :

						
maven.repo.remote = http://www.bluesunrise.com/maven/, http://www.ibiblio.org/maven/, \
                    http://dist.codehaus.org/, http://cvs.apache.org/repository
					
Note: the order in which these repositories must be specified is significant!

Jetspeed 2 ベースのポータルの設定ができるためには、Maven のリモートリポジトリの場所を ${USER_HOME}/build.properties に以下のように設定する必要があります。

						
maven.repo.remote = http://www.bluesunrise.com/maven/, http://www.ibiblio.org/maven/, \
                    http://dist.codehaus.org/, http://cvs.apache.org/repository
					
注意: これらのリポジトリの順番も同じように指定しなければいけません。

[4.2 Install the Jetspeed 2 maven-plugin] 4.2 Jetspeed 2 の Maven プラグインのインストール

The first time, and when you want to upgrade to a newer version of Jetspeed 2, you need to install the maven-plugin as follows:

						
maven -DartifactId=maven-jetspeed2-plugin -DgroupId=org.apache.portals.jetspeed-2 -Dversion=2.1.2 plugin:download
					
Note: you can set the version flag to the specific version you want to install, 2.1.2 is just an example here.

最初に、そしてより新しいバージョンの Jetspeed 2 にアップグレードしたくなったときは、Maven プラグインを以下のようにしてインストールする必要があります。

						
maven -DartifactId=maven-jetspeed2-plugin -DgroupId=org.apache.portals.jetspeed-2 -Dversion=2.1.2 plugin:download
					
注意: インストールしたいバージョンを指定するためにバージョンフラグを設定することができます。ここでの例では 2.1.2 を指定しています。

[4.3 Generate a new portal project] 4.3 新しいポータルプロジェクトの生成

Once you have the maven-plugin installed and set properties as needed, generate a default portal configuration using the plugin as follows:

						
maven j2:portal.genapp
					
This maven goal actually executes several subgoals which are further described in the maven-plugin documentation itself.

Maven プラグインをインストールし、必要なプロパティを設定したら、以下のようにしてプラグインを使ってデフォルトのポータル設定を生成してください。

						
maven j2:portal.genapp
					
この Maven のゴールは実際は Maven プラグインの資料 に記述されるようないくつかのサブゴールを実行します。

[4.4 Further customization of the portal] 4.4 ポータルの追加のカスタマイズ

This section doesn't specify anything to do. After the portal project is generated you can adapt and customize it to your taste by overriding and merging your own configurations and extensions.

このセクションでは特別何かを行うという指示はありません。ポータルプロジェクトが生成されたら、自身の設定や拡張機能を上書きしたりマージしたりして、あなたが好みに合わせてカスタマイズを行ってください。

You can regenerate or update (part of) your portal project with the j2:portal.genapp goal as described in the previous section or use its subgoals directly.

前のセクションで説明したように j2:portal.genapp ゴールを使うか、このゴール内で実行されるサブゴールを直接使うなりして、ポータルプロジェクト (の一部) を再生成したり更新したりしてください。

[4.5 Build the portal] 4.5 ポータルのビルド

Once your portal configuration and setup is ready, you can build and install the portal application in your local maven repository (as needed for deployment) using the following standard maven goal from your custom portal project directory (in ${org.apache.jetspeed.portal.home}):

						
maven war:install
					

ポータルの設定とセットアップの準備ができたら、以下の Maven 標準のゴールをカスタムポータルプロジェクトのディレクトリ (${org.apache.jetspeed.portal.home} 内) で実行することにより、ローカルの Maven リポジトリ (配備に必要です) でポータルアプリケーションをビルドし、インストールすることができます。

You are now ready to deploy the new portal application. For this, skip the following section on building the Jetspeed 2 portal from source and continue with the deployment section.

さあ、これで新しいポータルアプリケーションの配備の準備ができました。新しいポータルアプリケーションの配備をするには、次の Jetspeed 2 のソースからのビルドのセクションを飛ばし、 配備 を続いて読んでください。

[5. Build Jetspeed 2 from source] 5. ソースからの Jetspeed 2 のビルド

Build the Jetspeed 2 portal directly from the source is somewhat easier to do but should only be done if you don't want to create a new, customizable portal.

ソースから直接 Jetspeed 2 ポータルをビルドするのは、幾分簡単です。しかし、これはあなたが新しいカスタマイズされたポータルを作りたくない場合のみそうすべきです。

[5.1 Setup the Jetspeed 2 source and build properties]5.1 Jetspeed 2 のソースとビルドプロパティのセットアップ

The Jetspeed 2 source contains a project.properties file which provides all of the required portal configuration settings as described above .

Jetspeed 2 のソースには project.properties ファイルが含まれています。これは、 必須のポータル設定プロパティ に述べたようなポータルの設定に必須の全てのプロパティが提供されています。

You should not define any of those properties in your ${USER_HOME}/build.properties .

Instead, you must set a org.apache.jetspeed.project.home property, specifying the location where you expanded the downloaded source or checked out the source from subversion, like:

						
# required Jetspeed 2 portal configuration property for building from the source
org.apache.jetspeed.project.home = /home/apache/jetspeed-2/
					
Note: you still need to specify the required application server properties as described above .

あなたの ${USER_HOME}/build.properties ファイル中にはこれらのプロパティを一切含んではいけません。

代わりに、 org.apache.jetspeed.project.home プロパティを設定しなければいけません。このプロパティは、以下のように、ダウンロードしたソースが展開されたか、subversion からソースをチェックアウトした場所を表します。

						
# 必要な、ソースからビルドするための Jetspeed 2 ポータル設定のプロパティ
org.apache.jetspeed.project.home = /home/apache/jetspeed-2/
					
注意: 必須のアプリケーションサーバのプロパティ で述べたプロパティについては、指定する必要があります。

The Jetspeed 2 project.properties uses this property to define the required org.apache.portal.home :

						
org.apache.jetspeed.portal.home = ${org.apache.jetspeed.project.home}
					
So, they are the same when you build the Jetspeed 2 portal from the source.

Jetspeed 2 の project.properties ファイルは必須の org.apache.portal.home を定義するために、以下のようなプロパティを使います。

						
org.apache.jetspeed.portal.home = ${org.apache.jetspeed.project.home}
					
Jetspeed 2 ポータルをソースからビルドする場合と同じです。

When you are going to deploy the portal as described further below, you'll see references to the org.apache.jetspeed.portal.home which you can translate with the root folder of your Jetspeed 2 source.

後に述べるようにポータルを配備したいときは、 org.apache.jetspeed.portal.home を参照します。これはあなたの Jetspeed 2 のソースのルートフォルダと読み替えることもできます。

If you want to run the testcases when building the Jetspeed 2 sources and don't want to use the default HSQLDB test database, you need to override the default test database properties, similar to the production database properties as described above :

  • org.apache.jetspeed.test.database.default.name
  • org.apache.jetspeed.test.database.url
  • org.apache.jetspeed.test.database.user
  • org.apache.jetspeed.test.database.password
  • org.apache.jetspeed.test.database.driver
  • org.apache.jetspeed.test.database.drivers.path
Note: due to outstanding issue JS2-320 you currently must use hard coded values for the test database properties.

もし、Jetspeed 2 のソースをビルドしていて、デフォルトの HSQL テストデータベースを使わないときにテストケースを走らせたい場合は、 省略可能なデータベースサーバのプロパティ で述べた本稼働用のデータベースのプロパティと同じように、デフォルトのテストのデータベースプロパティを修正する必要があります。

  • org.apache.jetspeed.test.database.default.name
  • org.apache.jetspeed.test.database.url
  • org.apache.jetspeed.test.database.user
  • org.apache.jetspeed.test.database.password
  • org.apache.jetspeed.test.database.driver
  • org.apache.jetspeed.test.database.drivers.path
注意: 未解決の JS2-320 の問題のため、現時点ではテストデータベースのプロパティはハードコードされた値を使わなければいけません

[Initialize the maven-plugin] Maven プラグインの初期化

Instead of downloading and installing the Jetspeed 2 maven-plugin, you are going to build and install it directly from the source. You will need to repeat this every time you update to a newer version of Jetspeed 2 or change its project configuration, the plugin itself or the resources used by the plugin.

Jetspeed 2 の Maven プラグインをダウンロードし、インストールする代わりに、ソースから直接ビルドして生成します。この作業は Jetspeed 2 の新しいバージョンに更新したときやプロジェクトの設定を変えたとき、プラグイン自身を変えたとき、プラグインが使うリソースを変えたときに毎回実行繰り返す必要があります。

Build and install the maven-plugin as follows from the root directory of the Jetspeed-2 source:

						
cd ${org.apache.jetspeed.project.home}
maven initMavenPlugin
					

Jetspeed 2 ソースのルートディレクトリで以下のようにして Maven プラグインのビルドとインストールをします。

						
cd ${org.apache.jetspeed.project.home}
maven initMavenPlugin
					

[Optional: start the HSQLDB test database first] 省略可: HSQLDB テストデータベースの起動

If you are going to run the testcases and are using the default HSQLDB database configuration, you will need to start the test database before building Jetspeed 2 in a separate console:

						
cd ${org.apache.jetspeed.project.home}
maven j2:start.test.server
					

テストケースを走らせ、デフォルトの HSQLDB データベースの設定を使うのなら、Jetspeed 2 をビルドする前にテスト用のデータベースを別のコンソールで開始しておく必要があります。

						
cd ${org.apache.jetspeed.project.home}
maven j2:start.test.server
					

After the build is finished you can stop the database and close this console with a Ctrl-C .

ビルドが終わった後で、 Ctrl-C を押して、データベースをを止め、コンソールを閉じます。

[Build the Jetspeed 2 portal and demo portlet applications] Jetspeed 2 ポータルとデモポートレットアプリケーションのビルド

For a full build and installation of the portal and the demo portlet applications in your local maven repository run:

						
cd ${org.apache.jetspeed.project.home}
maven allClean allBuild
					

ローカルの Maven リポジトリにポータルとデモポートレットを全てビルドしインストールするには、

						
cd ${org.apache.jetspeed.project.home}
maven allClean allBuild
					
を実行します。

But, if you also want to run the testcases during the build run the following instead:

						
cd ${org.apache.jetspeed.project.home}
maven -Dmaven.test.skip=false allClean allBuild
					

しかし、もしビルドの間にテストケースを実行したいのなら、代わりに以下のようなコマンドを実行します。

						
cd ${org.apache.jetspeed.project.home}
maven -Dmaven.test.skip=false allClean allBuild
					

You are now ready to deploy the Jetspeed 2 Portal.

さあ、これで Jetspeed 2 ポータルを配備する準備ができました。

[6. Deploy and Run] 配備と実行

[Optional: start the HSQLDB production database first] オプショナル: HSQLDB プロダクションデータベースの開始

If you are using the default HSQLDB database you need to start it before deploying the portal.

もしデフォルトの HSQLDB データベースを使うのであれば、ポータルを配備する前にデータベースを開始する必要があります。

To start the HSQLDB production database run the following in a separate console:

						
cd ${org.apache.jetspeed.portal.home}
maven j2:start.production.server
					

HSQLDB の本稼働用データベースを実行するには、以下のようなコマンドを別のコンソールで実行します。

						
cd ${org.apache.jetspeed.portal.home}
maven j2:start.production.server
					

You need to have this database running during the deployment and while running the application server. Afterwards you can stop the database and close this console with a Ctrl-C .

配備の間とアプリケーションサーバが実行中の間はデータベースを実行したままにしておく必要があります。終了後は Ctrl-C を押してデータベースを停止し、コンソールを閉じます。

Note: this is required when using the j2:quickStart goal as described below. The Jetspeed 2 maven-plugin provides other (sub)goals which you can use without (re)creating a production database and/or inserting default portal configuration data. See the Plugin documentation for further information about the available goals.

注意: これは後で述べる j2:quickStart ゴールを使うときに必要です。Jetspeed 2 の Maven プラグインには本稼働用データベースの (再) 作成なしに、そして/またはデフォルトのポータル設定データを挿入することなく使える、他の (サブ) ゴールがあります。利用可能なゴールのさらなる情報は プラグイン資料 を見てください。

[Deploy] 配備

We currently only cover deploying to Tomcat 5 or Tomcat 5.5.

現時点では Tomcat 5 か 5.5 への配備のみカバーしています。

Information about deployment to other application servers can be found at the The Jetspeed 2 Wiki .

他のアプリケーションサーバへの配備についての情報は Jetspeed 2 Wiki で見付かるでしょう。

To deploy a default Jetspeed 2 portal, including the demo portlet applications, run the following in a separate console:

						
cd ${org.apache.jetspeed.portal.home}
maven j2:quickStart
					
Note: the maven-plugin documentation described other goals you can use to customize the deployment to your taste.

デモポートレットアプリケーションを含む、デフォルトの Jetspeed 2 ポータルを配備するために、以下のようなコマンドを別のコンソールで実行します。

						
cd ${org.apache.jetspeed.portal.home}
maven j2:quickStart
					
注意: Maven プラグイン資料 にあなた好みの配備にカスタマイズするのに使える他のゴールに関する記述があります。

[Run] 実行

The final step is starting up your Tomcat server and the portal will automatically install any deployed portlet applications.

最後の手順は Tomcat サーバを起動することです。すると、ポータルは自動的に配備すべきポートレットアプリケーションを自動的にインストールするでしょう。

Then you can access the portal with your browser at:

or replace "jetspeed" in the above url with the name of you own portal application ( ${org.apache.jetspeed.portal.artifactId} ).

その後で、ブラウザでポータルに以下か

もしくは、この URL の "jetspeed" をあなたのポータルアプリケーションの名前 ( ${org.apache.jetspeed.portal.artifactId} ) に置き換えることで、ポータルにアクセスできます。

[Default installed user accounts] デフォルトでインストールされているユーザアカウント

With the default Jetspeed 2 portal deployment, several example user accounts are inserted into the portal database with which you can logon to the portal:

usernamepasswordroles
admin admin admin, manager, user
manager manager manager, user
jetspeed jetspeed manager
user user user
tomcat tomcat

デフォルトの Jetspeed 2 のポータルの配備では、いくつかのサンプルユーザのアカウントがポータルデータベースに登録されています。それを使って、ポータルへのログオンが可能です。

ユーザ名パスワードロール
admin admin admin, manager, user
manager manager manager, user
jetspeed jetspeed manager
user user user
tomcat tomcat