| Info |
|---|
このガイドでは、JettyにBellaDati WAR をインストールする方法について説明します。 BellaDatiは、Jetty7以上サポートします。Jetty 9の最新の安定版リリースのいずれかを使用することをお勧めします |
| Warning |
|---|
BellaDati WARファイルは、WARアーカイブにパッケージBellaDatiアプリケーションです。これは、既存のアプリケーション・サーバーにデプロイし、既存のデータベースサーバー上のデータウェアハウスの実行に接続する必要があります。 |
始める前にBellaDatiのインストールを開始する前に、次の重要な注意事項をお読みください - 正しいJavaバージョンがあることを確認してください。詳細については、Installing Java に参考してください。
- 単一GlassFishアプリケーションサーバーで展開する複数のBellaDati WARアプリケーションはサポートされていません。我々この設定は確認されず、これを壊す可能性があるアプリケーションを更新しません。
- BellaDatiを実行する同じJettyコンテナに他のアプリケーションを配備しないことをお勧めします。特に、他のアプリケーションは大きなメモリが要求するまたはJettyの libサブディレクトリに追加のライブラリが要求する場合。コンテナ内に複数のアプリケーションが安定性に1つのアプリケーションのクラッシュなど影響を与える可能性があり、コンテナ全体をアクセス不能にする可能性があります。 さらに、アプリケーションを更新または再構成するには、コンテナ全体を再起動する必要があります。
1. ウェアハウスデータの設定PostgreSQLデータベースの設定 ページの指示に従ってください 2. BellaDati WARアーカイブダウンロードと解凍 BellaDatiダウンロードページからZIPアーカイブとしてBellaDati WARディストリビューションをダウンロードして、Windows7-ZipまたはLinux のGNU tarなどツールを使用してその内容を解凍します。ZIPアーカイブ内の一つファイルしかbelladati.warにこのセットアップが使用されません。  Windowsの組み込みのファイル解凍ツールを使用しないでください！このツールは長い名前のファイルを解凍することができません。他のユーザーもWinRARの問題を報告しています。
Solarisのデフォルトtarユーティリティを使用しないでください！ GNU tarは長いファイル名をより良いを扱えように、BellaDatiを解凍するために、このオペレーティングシステム上でのGNUtarを使用してください。 3. BellaDati WAR構成
前の手順で説明したように、BellaDati WARディストリビューションを正常にダウンロードして解凍します。 Belladatiを設定するには、以下の簡単な手順に従ってWARアーカイブ内に配置された設定ファイルを解凍して変更する必要があります。 1. Windows用の7-ZipやLinuxのunzipなどのツールを使用して、WARファイルからapplication.propertiesファイルを解凍します。 | Code Block |
|---|
unzip belladati.war WEB-INF/classes/conf/application.properties
|
2. 解凍されたWEB-INF/classes/conf/application.propertiesファイルを編集します。 JDBCプロパティで、最初の行の# 記号を削除します。 Updatejdbc.url、jdbc.usernameおよびjdbc.passwordを使用して、システム構成に合わせてください。 #で始まるすべての行をJDBCプロパティーセクションから削除することができます。 構成は次のようになります。 | Code Block |
|---|
# APPLICATION properties
application.url=http://localhost:8080
application.production-mode=true
application.secure-mode=false
# JDBC properties
jdbc.resource=jdbc/belladati_db
# when connecting directly to the db
jdbc.driverClassName=org.postgresql.Driver
jdbc.url=jdbc:postgresql://db_host:5432/belladati_db
jdbc.username=belladati_dbuser
jdbc.password=password
# SMTP properties
smtp.server.address=localhost
smtp.server.username=
smtp.server.password=
# EMAIL properties
email.sender=support@belladati.com
email.footer=BellaDati Inc.
# OpenID properties
application.mybelladati.url=https://my.belladati.com
application.registration=http://www.belladati.com/try
application.registration.openid=
# Google analytics properties
application.google-site-verification=
application.google-analytics-account=
application.google-analytics-account.mercato=
# Lucene index dir
lucene.indexes=indexes
|
3. WEB-INF/classes/conf/application.propertiesを保存し、WARアーカイブを更新します。 Linuxでは、コマンドは次のようになります。 | Code Block |
|---|
zip -d belladati.war WEB-INF/classes/conf/application.properties
zip -u belladati.war WEB-INF/classes/conf/application.properties
|
4. belladati.warを$JETTY_HOME/webapps.$JETTY_HOME/webappsにコピーします。 4. Jetty構成4.1 Java環境
Jettyを開始する前に、インストールしたJavaを指すJAVA_HOME変数を設定していることを確認してください。あなたはこのようにすることができます。 | Code Block |
|---|
$ export JAVA_HOME=/path/to/jdk |
または、/etc/default/jettyにJAVA_HOMEパラメータを追加できます。Jettyを起動するたびにJAVA_HOME変数を設定します。 4.2 Jettyにメモリ設定の構成
Jettyのメモリの設定は、以下の問題を回避するように修正する必要があります。 - BellaDatiはJettyがデフォルトで提供するものより多くのメモリを必要となります。これらのメモリの設定が増加されていない場合にBellaDatiを実行しているときにOutOfMemoryをエラーになる場合があります。
この問題を回避するため、以下の手順に従ってください。
JAVA_OPTIONS変数を設定します： | Code Block |
|---|
$ export JAVA_OPTIONS="-Xms1024m -Xmx2048m -XX:MaxPermSize=512m" |
また、/etc/default/jettyファイルにJAVA_OPTIONSを設定できます。 | Code Block |
|---|
JAVA_OPTIONS="-Xms1024m -Xmx2048m -XX:MaxPermSize=512m" |
Java Service Wrapperを使用している場合、以下の案内をしたが従ってください。
$JETTY_HOME/bin/jetty-service.confファイルを編集し、以下のコマンドを追加してください | Code Block |
|---|
wrapper.java.additional.3=-Xms1024m
wrapper.java.additional.4=-Xmx2048m
wrapper.java.additional.5=-XX:MaxPermSize=512m
wrapper.java.maxmemory=2048
|
他の環境とメモリの設定の詳細についてはシステム要求を参照してください。 | Note |
|---|
Xmxに2048 MB値（最大heapサイズ）は、評価目的のためだけに専用されていることを注意してください。本番デプロイするための推奨設定を見つけるために推奨JVMオプション の記事を参照してください。 |
4.3 ログの保存場所の設定BellaDatiが生成するログのデフォルトの場所（詳細は Configure logging を参照）は、belladati.warからの相対位置であり、長期保存には適していません。 Tログ・ディレクトリを変更するには、新しいJVMオプション -Dlogs.location=<location>（<location>はログが保存される親ディレクトリへの希望する絶対パス）をJettyに追加します（その方法の詳細については、セクション 4.2 をご覧ください）。 5. Jetty開始または再起動
今BellaDatiはJettyで実行してできました。$ JETTY_HOMEディレクトリからJettyの起動スクリプト（JettyバージョンとOSに依存）で Jettyサーバを起動できます（または再起動）。 bin/jetty.sh runbin/Jetty-Service.exe
6. セットアップウィザードを実行
お使いのブラウザをhttp://localhost:8080/belladatiに移動します。これはBellaDatiの設定手順を介してSetup Wizardを起動します。 BellaDatiダウンロードページからZIPアーカイブとしてBellaDati WARディストリビューションをダウンロードして、Windows7-ZipまたはLinux のGNU tarなどツールを使用してその内容を解凍します。ZIPアーカイブ内の一つファイルしかbelladati.warにこのセットアップが使用されません。 Windowsの組み込みのファイル解凍ツールを使用しないでください！このツールは長い名前のファイルを解凍することができません。他のユーザーもWinRARの問題を報告しています。 Solarisのデフォルトtarユーティリティを使用しないでください！ GNU tarは長いファイル名をより良いを扱えように、BellaDatiを解凍するために、このオペレーティングシステム上でのGNUtarを使用してください。
|