Page History
Sv translation | ||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||
Before You BeginYou should have ready vanilla installation of Ubuntu Focal 20.04 LTS available on physical HW or some type of container (AWS, Linux container,Docker,VMWare etc.). This guide expects, that any type of firewall is not applied and or communication to installed DWH and Servlet Container is allowed on the OS level. For production make sure that OS environment as well as servlet container is secured using SSL etc. This guide is not focused on security settings. 1. Setup Postgresql 10 data warehouseDecide if you will install Postgresql on the same host as Tomcat with BellaDati or Postgresql will be running on different host than Tomcat with Belladati
2. Install OpenJDK-8-jre apt package
3. Install Tomcat9 apt package3.1 Installation
3.2 Tomcat JAVA_OPTS configurationSince Tomcat is installed as apt package on Ubuntu. Configuration for Java System Properties used by Tomcat and therefore by belladati application has to be done as following
3.3 Tomcat service unit configuration
3.4 Tomcat Context configurationContext container in Tomcat processes requests to web applications. Let' setup belladati.war web application as Context for Tomcat. By default Tomcat still keeps the root Context "".Context for belladati web application will be /belladati. Since Tomcat will use autodeploy feature. Therefore Context is named according of file being deployed. In this case belladati.war
Since version 2.7.14 there is no special configuration change needed, however, there are several advanced settings (e.g. enforcing the SSL), which are configurable in application.properties only.
3.5 Modify Tomcat's |
Code Block |
---|
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443"/> |
You should modify this element by specifying the URIEncoding="UTF-8"
attribute:
Code Block |
---|
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8"/> |
Info |
---|
Please Note:
|
3.6 Modify Tomcat's context.xml
In order for Tomcat to be able to cache web resources of BellaDati a default value for the cache size must be modified. Modify the $TOMCAT_HOME/conf/context.xml
file in your Tomcat installation directory by adding following line:
Code Block |
---|
<Resources cacheMaxSize="51200" /> |
4. Download belladati.war
These steps will place belladati.war into /opt/belladati. From that directory Tomcat will deploy belladati.war by using autoDeploy feature into it's directory /var/lib/tomcat9/webapps, where it will create directory named after belladati.war, belladati
- download BellaDati-2_9_22.war.zip (your BellaDati version may differ) from My.BellaDati.com portal into /opt/belladati
- run sudo -u tomcat gunzip -S .zip BellaDati-2_9_22.war.zip
- run sudo -u tomcat mv BellaDati-2_9_22.war belladati.war
5. Disable automatic updates in Ubuntu Focal 20.04
To prevent Ubuntu to automatically update and upgrade Tomcat,Java,Postgresql packages edit file below as root (if Postgres is installed on different host, apply steps below also on the other host)
/etc/apt/apt.conf.d/20auto-upgrades
and replace existing content with
Code Block |
---|
PT::Periodic::Update-Package-Lists "0"; APT::Periodic::Download-Upgradeable-Packages "0"; APT::Periodic::AutocleanInterval "0"; APT::Periodic::Unattended-Upgrade "1"; |
6. Start and control tomcat service
BellaDati is now ready to run in Tomcat.While Tomcat will run as Ubuntu service under user tomcat.
Use commands below to control the service.Remember, that data warehouse of belladati (Postgresql must be up as well):
- systemctl status tomcat9 to see the status of service
- systemctl start tomcat9 to start the service
- systemctl stop tomcat9 to stop the service
7. Run the Setup Wizard
While tomcat9 service is running and systemctl status tomcat9 is showing that belladati was successfuly deployed you can access BellaDati via webbrowser.
Point your browser to http://localhost:8080/belladati
. This starts the Setup Wizard, which will take you through BellaDati's setup procedure.
Sv translation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
JP translate
始める前に Tomcat上BellaDatiのインストールを開始する前に、次の重要な注意事項をお読みください
1. データウェアハウス設定PostgreSQLデータベースの設定ページの指示に従ってください。 2. WARダウンロードして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設定2.7.14バージョンから特別な構成に変更がないですがapplication.propertiesで設定されているいくつかの拡張設定が(例えば、SSLを強制する)あります。
4. Tomcat構成4.1 Tomcatの設定コンテキストBellaDatiコンテキストは、Tomcatでセットアップする必要があります。以下となります。 conf/Catalina/localhost/ ディレクトリ構造を作成します。belladati.xmlファイルを作成し、Tomcatのインストールディレクトリ内に
はじめる前にUbuntu Focal 20.04 LTS を物理的なハードウェアまたはコンテナ(AWS、Linux コンテナ、Docker、VMWare など)にインストールしたバニラが用意されている必要があります。本ガイドでは、OSレベルでファイアウォールが適用されておらず、インストールしたDWHやサーブレットコンテナへの通信が許可されていることを想定しています。本番環境では、OS環境とサーブレットコンテナがSSLなどで保護されていることを確認してください。 このガイドは、セキュリティ設定に焦点を当てたものではありません。 1. Postgresql 10 データウェアハウスのセットアップBellaDatiでPostgresqlをTomcatと同じホストにインストールするか、BelladatiでPostgresqlをTomcatとは別のホストで動作させるかを決定してください。
2. OpenJDK-8-jreのaptパッケージのインストール
3. Tomcat9 aptパッケージのインストール3.1 インストール
3.2 Tomcat JAVA_OPTSの設定Ubuntuでは、Tomcatはaptパッケージとしてインストールされるため、Tomcatのシステムプロパティを設定する必要があります。Tomcatが使用するJavaシステムプロパティの設定、およびbelladatiアプリケーションが使用するJavaシステムプロパティの設定は、以下のように行う必要があります。
3.3 Tomcatサービスユニットの構成
3.4 Tomcat Contextの設定TomcatのContextコンテナは、Webアプリケーションへのリクエストを処理します。TomcatのContextとして、belladati.war Webアプリケーションを設定します。デフォルトでは、Tomcatはルートコンテキストを保持します。Tomcatはオートデプロイ機能を使用します。 そのため、Contextはデプロイされるファイルに合わせて命名されます。この場合、belladati.warになります。
バージョン2.7.14以降、特別な設定変更は必要ありませんが、いくつかの高度な設定(例:SSLの強制)があり、それらはapplication.propertiesでのみ設定可能です。
3.5 Tomcatのserver.xmlを変更BellaDatiがユーザー名やグループ名に国際化文字を正しく表示するためには、Tomcatインストールディレクトリの$TOMCAT_HOME/conf/server.xmlファイルを修正し、HTTPプロトコル用のコネクタ定義内にURIEncoding="UTF-8 "プロパティを指定する必要があります。 コネクタの定義は、server.xml ファイル内の以下の要素で指定します:
URIEncoding="UTF-8" 属性を指定して、この要素を変更する必要があります:
3.6 Tomcatのcontext.xmlを変更TomcatがBellaDatiのWebリソースをキャッシュできるようにするには、キャッシュサイズのデフォルト値を変更する必要があります。Tomcatのインストールディレクトリにある$TOMCAT_HOME/conf/context.xmlファイルに、以下の行を追加して修正してください。
4. Belladati.war のダウンロードこれらの手順により、belladati.war は /opt/belladati に配置されます。Tomcat はこのディレクトリから、autoDeploy 機能を用いて belladati.war を /var/lib/tomcat9/webapps に配備し、そこに belladati.war と同じ名前のディレクトリ belladati.war を作成する事になります。
5. Ubuntu Focal 20.04で自動アップデートを無効にするUbuntuが自動的にTomcat、Java、Postgresqlのパッケージを更新するのを防ぐために、rootで以下のファイルを編集してください(Postgresを別のホストにインストールしている場合は、以下の手順を別のホストにも適用してください) /etc/apt/apt.conf.d/20auto-upgrades
6. tomcatサービスの起動と制御TomcatはUbuntuのサービスとして、ユーザーtomcatで動作します。 サービスを制御するには、以下のコマンドを使用します。Belladatiのデータウェアハウス(Postgresqlも立ち上げておく必要があります)を忘れずに実行してください:
7. セットアップウィザードの実行tomcat9 サービスが動作し、systemctl status tomcat9 に Belladati が正常にデプロイされたことが表示されている間は、Web ブラウザで BellaDati にアクセスすることができます。 ブラウザを http://localhost:8080/belladati にポイントしてください。セットアップウィザードが起動し、BellaDatiのセットアップ手順が表示されます。 ここではサンプルファイルです。 Windowsでインストールする場合は、WARファイルとデータベースの場所に指定するパスがドライブ文字がある完全パスであることを確認してください(例えば 4.2 JAVA環境の設定
4.2.1 Linux/Solaris用Tomcatを開始する前に、あなたがインストールしたJava SDKを指すJAVA_HOME変数を設定していることを確認してください。以下の通りに進みます。
この変数は自動的にシステムが起動(.profileに追加)後に設定されていることを確認してください。
4.2.2 Windows用Windowsユーザーは環境変数ウィンドウに環境パラメータを指定できます。 4.3 Tomcat のホームディレクトリのアクセス権を設定するデフォルトでは、BellaDatiはTomcatホームフォルダ内に複数のディレクトリを作成しています。 これに従って、このディレクトリへの読み書きアクセス権を持つユーザとしてTomcatを実行する必要があります。 4.4 Tomcatでメモリ設定を構成Tomcatメモリ設定は、以下の問題を回避するように修正される必要があります。
この問題を回避するには、以下の手順に従ってください。 Note | -Xmx用2048 Linux/Solaris用
また、
Windows用 Warning | Windows上でJVM 32 bitを実行している場合は、最大1344MB(-Xmx1344)を使用できます。 Tomcatはサービスとしてインストールされていない場合:
Tomcatがサービスとしてインストールされている場合: このダイアログボックスで、Javaタブをクリックし以下の値を指定します。(利用可能なシステムメモリに依存) フィールド 値 Javaオプション(既存値に付ける)
初期メモリプール |
|
|
Code Block |
---|
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443"/>
|
URIEncoding = "UTF-8"属性を指定することで、この要素を変更する必要があります。
Code Block |
---|
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" URIEncoding="UTF-8"/>
|
Info |
---|
注意:
|
5. Tomcat開始または再起動
今BellaDatiはTomcatで実行できました。
サービスとして実行
Belladatiに使用するTomcatサービスを開始します。すでに実行している場合にそれを再起動します。
手動で実行
Tomcatがサービスとして実行されていない場合は、Tomcatのbin/startup.sh
or bin/startup.bat
のスクリプトでTomcatサーバーを起動します(または再起動する)。
6. ウィザードセットアップを実行
お使いのブラウザでhttp://localhost:8080/belladatiに移します。これはBellaDati設定手順を介して行くことができるセットアップウィザードを起動します。
-Xmxに2048 MB
値(最大メモリプール)は評価目的のみのために推奨されますのでご注意ください。本番デプロイするための推奨設定を見つけるために推奨JVMオプションの記事を参照してください
BellaDatiはTomcatのデフォルトで提供するものより多くのメモリを必要になります。これらのメモリの設定が増加されていない場合BellaDatiを実行しているときに、これがOutOfMemoryをエラーになる場合があります。