Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languageen


Info

BellaDati Import Node is a dedicated module, which provides the Import and Transformation services. Import Nodes may run separately and independent on the main server to achieve faster import performance.


Tip

Using Import nodes is recommended in following scenarios:

  • more than 10 imports running at the same time
  • huge data processing and transformation is expected
  • import frequency is less than 10 minutes

1. Before you begin

  • BellaDati Import Node is a Java application, it needs a proper JVM installed on the machine. See Java Requirements.
  • BellaDati Import Node is communicating directly with the main server and needs the direct access to the reporting database.
  • Running multiple Import Nodes on single server is supported.

2. Download BellaDati Import Node

BellaDati Import Node binary distributions are available on https://my.belladati.com portal under Downloads -> BellaDati Import Node.

3. Configure BellaDati Server

Note

Please make sure that the server time of BellaDati server and Import Node server is the same (e.g. UTC).


Add the following parameter to the application.properties file of your belladati.war archive and redeploy it:

Code Block
application.import.nodes=node1:2552,node2:2552,...,nodeX:2552

BellaDati Standalone users (installed by exe or dmg installers) can find the application.properties file in BellaDati installation directory (by default it's C:\Program Files\BellaDati, eventually /Applications/BellaDati).

Note

Port 2552 must be opened and accessible by the BellaDati main server.

node1, node2 etc. must be a valid hostname resolvable by the machine, where BellaDati is running or IP address

4. Configure BellaDati Import Node

Create the configuration file application.properties with the following content:

Code Block
application.url=http://belladati_host
application.production-mode=true
application.secure-mode=true
# JDBC resource
jdbc.driverClassName=org.postgresql.Driver
jdbc.url=jdbc:postgresql://db_host:5432/belladati_db
jdbc.username=belladati_dbuser
jdbc.password=belladati

5. Run BellaDati Import Node

Execute the following command:

Code Block
java -Xmx2048m -Dconf=application.properties -Dimport.node.host=IP_OF_THE_HOST -Dimport.workers.size=10 -Dimport.node.name=import-node-1 -Done-jar.main.class=com.belladati.remote.ImportNodeMain -jar belladati-import-node.jar &


Note
The IP_OF_THE_HOST parameter has to be replaced by the real IP address of the server, where BellaDati Import Node is running. 

To specify the port of the import node, there's parameter import.node.port which may be specified either in application.properties or as a java -D parameter ( e.g. -Dimport.node.port=2553 )

6. Verify the Import Node installation

You can easily check, whether the import node is running properly by opening the Settings -> Import Node administration page directly in BellaDati UI.




Note

If there are multiple import nodes, BellaDati will use the node which has more free workers.

Since BellaDati 2.9.7, BellaDati will execute the import locally in case the import nodes are not available (e.g. because of network error).

Sv translation
languageja


Info

BellaDatiインポートノードは専用のモジュールであり、インポートと変換サービスを提供します。インポートノードはメインサーバー上で独立して実行され、メインサーバ上で別々に独立した実行可能性があります。


Tip

インポートノードを使用すると、シナリオを以下に推奨されます。

  • 10以上のインポートが同時に実行されること
  • 膨大なデータ処理と変換が期待されること
  • インポート頻度は10分以下になること

1. 始める前に

    • BellaDatiインポートノードはJavaアプリケーションであり、マシンに適切なJVMがインストールされている必要があります。Javaの要件をご参照してください。
    • BellaDatiインポートノードは、メインサーバーと直接通信しており、レポートデータベースに直接アクセスする必要があります。
    • 単一のサーバーで実行されている複数のインポートノードがサポートされています。

2. BellaDati インポートノードをダウンロード

BellaDatiインポートノードのバイナリディストリビューションはhttps://my.belladati.com ポータル上で利用可能です。Downloads →BellaDati Import Node.

3. BellaDatiサーバーを構成

belladati.warアーカイブのapplication.properties ファイルに次のパラメータを追加し、それを再デプロイします:

Code Block
application.import.nodes=node1:2552,node2:2552,...,nodeX:2552

BellaDatiスタンドアロンユーザー(exeファイルまたはDMGインストーラーによってインストールされる)はBellaDatiのインストールディレクトリ内のapplication.propertiesファイルを見つけることができます。(デフォルトはC:\Program Files\BellaDati, eventually /Applications/BellaDati).

Note

2552ポートは、BellaDatiメインサーバによって開かれ、アクセスする必要があります。

4. BellaDatiインポートノードを構成する

以下の内容でapplication.properties構成ファイルを作成します:

Code Block
application.url=http://belladati_host
application.production-mode=true
application.secure-mode=true
# JDBC resource
jdbc.driverClassName=org.postgresql.Driver
jdbc.url=jdbc:postgresql://db_host:5432/belladati_db
jdbc.username=belladati_dbuser
jdbc.password=belladati

5. BellaDatiインポートノードを実行

次のコマンドを実行します:

Code Block
java -Xmx2048m -Dconf=application.properties -Dimport.node.host=IP_OF_THE_HOST -Dimport.workers.size=10 -Dimport.node.name=import-node-1 -Done-jar.main.class=com.belladati.remote.ImportNodeMain -jar belladati-import-node.jar &


Note
IP_OF_THE_HOSTパラメータはBellaDatiインポートノードが動作しているサーバの実際のIPアドレスによって置き換えなければなりません。

6. インポートノードのインストール確認

BellaDati UIに直接に設定→インポートとりノードの管理ページを開くことで正常に動作しているかどうか簡単に確認できます。

Note

If there are multiple import nodes, BellaDati will use the node which has more free workers.

Since BellaDati 2.9.7, BellaDati will execute the import locally in case the import nodes are not available (e.g. because of network error).7以降、インポートノードが利用できない場合(例:ネットワークエラー)、BellaDatiはローカルでインポートを実行します。