Page History

Sv translation

language	en

Info
Manual installation is suitable for multi-server distributed deployment, or when expanding your current deployment. If you are not sure how to proceed with it, use the automated installers instead.

Before you begin

Please read the following important notes before you begin installing BellaDati IoT Data Controller:

Check that your target machine meets (at least) the minimal system requirements (appropriate HW and SW, including Java).
Your BellaDati instance is up and running, and it is accessible from your target machine.

Steps

Below are the steps in short:

Get IoT Data Controller JAR distribution archive
Start Audit module and get the server-ID
Obtain valid license key
Configure Audit module
Configure other modules (Receivers and Senders)
Start Audit and other modules

In the next chapters, each step is described in detail.

1. Get IoT Data Collector

Manual installation is based on running particular modules as Java programs, thus you need the IoT Data Controller JAR distribution. You can visit BellaDati Download Page for information about the current version and fordownloading instructions.

Once you have downloaded the the JAR distribution archive, you can unzip it's content, which should contain (see Files and directories to get more details about the content):

```
iot-collector-audit-x.y.z.jar
```

iot-collector-generic-receiver-x.y.z.jar

```
iot-collector-generic-sender-x.y.z.jar
```
```
config-audit.json
```
```
config-receiver.json
```
```
config-sender.json
```
```
cluster.xml
```

2. Obtain server-ID

Audit module is distributed as iot-collector-audit-x.y.z.jar file. You can start it by executing the following command:

Code Block

language	bash

java -Dapplication.name=audit-1 -Dfile.encoding=UTF8 -jar iot-collector-audit-x.y.z.jar

This command will start the audit with the default configuration of the cluster and audit. If necessary, it is also possible to manually specify these files:

Code Block

language	bash

java -Dapplication.name=audit-1 -Dvertx.hazelcast.config=cluster.xml -Dfile.encoding=UTF8 -jar iot-collector-audit-x.y.z.jar -conf config-audit.json

When you start the Audit module for the first time, it automatically creates file server-id.txt in your installation directory.

3. Obtain license key

Once you have the server-ID, you can request the license key from BellaDati support, either by creating request in our Help desk, or by contacting our support at support@belladati.com.

4. Configure Audit module

Each module configuration is container in appropriate conf.json file. Default filename for Audit module configuration is confg-audit.json, however the name can be changed and then just reflected when starting the module.

The default configuration is sufficient, unless you are deploying HA or multi-server IoT Data Controller instance. The only field you need to change is "license" (there are two "license" field, update both).

Code Block

language	js

{
  "instance": {
    "license": "n5NkzaEOALzvGs7LOExyAulYdqo8X+5==",
    ...
  },
  "audit": {
    "license": "n5NkzaEOALzvGs7LOExyAulYdqo8X+5==",
    ...
  }
}

For complete configuration example, click below.

Code Block

linenumbers	true
collapse	true

{
  "instance": {
    "license": "n5NkzaEOALzvGs7LOExyAulYdqo8X+5==",                  
    "name": "Awesome Company - TEST_ENV",                            
    "db": {                                                          
      "url": "jdbc:hsqldb:file:/path/to/instance-db;shutdown=true",  
      "user": "SA",                                                  
      "password": "",                                                
      "driverclass": "org.hsqldb.jdbcDriver",                        
      "max_pool_size": 100,                                           
      "drop": false                                                   
    },
    "auth": {                                                         
      "enabled": true,                                                
      "drop": false,                                                  
      "merge": true,                                                  
      "users": [                                                      
        {
          "username": "admin",                                        
          "password": "DAAF8173380C604B392A1EF8D7559AA0",             
          "salt": "BA1170DE9ADE8D29D2C18FD789EAB3BD",                 
          "roles": [ "ADMIN" ]                                        
        }
      ]
    }
  },
  "audit": {
    "license": "n5NkzaEOALzvGs7LOExyAulYdqo8X+5==",                   
    "name": "Audit 01",                                               
    "host": "localhost",                                              
    "port": 8000,                                                     
    "bodyLimit": 2097152,                                             
    "db": {                                                           
      "url": "jdbc:hsqldb:file:/path/to/my-audit-db;shutdown=true",   
      "user": "SA",                                                   
      "password": "",                                                 
      "driverclass": "org.hsqldb.jdbcDriver",                         
      "max_pool_size": 100,                                           
      "jsonVarcharLength": 2047,                                      
      "drop": false                                                   
    },
    "auth": {
      "enabled": true,                                                
      "drop": false,                                                  
      "merge": true,                                                  
      "users": [                                                      
        {
          "username": "viewer",                                       
          "password": "DAAF8173380C604B392A1EF8D7559AA0",             
          "salt": "BA1170DE9ADE8D29D2C18FD789EAB3BD",                 
          "roles": [ "VIEWER" ]                                       
        }
      ]
    },
    "ssl": {
      "enabled": true,                                                
      "keystorePath": "/path/to/server-keystore.jks",                 
      "keystorePassword": "wibble"                                    
    }
  }
}

Tip
See Audit configuration to get more information.

5. Configure other modules

See Configuring IoT Controller.

6. Start Controller modules

When all configuration is set, you can proceed to starting all modules. The first module to be started is always Audit.

Sv translation

language	ja

Info
手動インストールは、マルチサーバー分散デプロイメント、または現在のデプロイメントを拡張する場合に適しています。続行する方法がわからない場合は、代わりに Installing from Installerを使用してください。

始める前に

BellaDati IoT Data Controllerのインストールを開始する前に、次の重要な注意事項をお読みください:

ターゲットマシンが (少なくとも) System requirements (Javaを含む適切なハードウェアとソフトウェア) を満たしていることを確認します。
BellaDatiインスタンスが稼働しており、ターゲットマシンからアクセスできます。

ステップ

簡単な手順は次の通りです:

IoT Data Controller JARディストリビューションアーカイブを取得する
Auditモジュールを起動し、サーバーIDを取得する
有効なライセンスキーを取得する
Auditモジュールを構成する
他のモジュール (ReceiversとSenders) を構成する
Auditとその他のモジュールを開始する

次の章では、各ステップについて詳しく説明します。

1. IoTデータコントローラを入手する

手動インストールは、特定のモジュールをJavaプログラムとして実行することに基づいているため、IoT Data Controller JARディストリビューションが必要です。現在のバージョンとダウンロード手順については、BellaDatiダウンロードページにアクセスしてください。

JARディストリビューションアーカイブをダウンロードしたら、そのコンテンツを解凍できます。コンテンツには次のものが含まれている必要があります (コンテンツの詳細については、 Files and directoriesを参照してください):

```
iot-collector-audit-x.y.z.jar
```

iot-collector-generic-receiver-x.y.z.jar

```
iot-collector-generic-sender-x.y.z.jar
```
```
config-audit.json
```
```
config-receiver.json
```
```
config-sender.json
```
```
cluster.xml
```

2. サーバーIDを取得する

Auditモジュールは、iot-collector-audit-x.y.z.jarファイルとして配布されます。次のコマンドを実行して起動できます:

Code Block

language	bash

java -Dapplication.name=audit-1 -Dfile.encoding=UTF8 -jar iot-collector-audit-x.y.z.jar

このコマンドは、クラスターとAuditのデフォルト構成で監査を開始します。必要に応じて、次のファイルを手動で指定することもできます:

Code Block

language	bash

java -Dapplication.name=audit-1 -Dvertx.hazelcast.config=cluster.xml -Dfile.encoding=UTF8 -jar iot-collector-audit-x.y.z.jar -conf config-audit.json

Auditモジュールを初めて起動すると、インストールディレクトリにserver-id.txtファイルが自動的に作成されます。

3. ライセンスキーを取得する

サーバーIDを取得したら、へルプデスクでリクエストを作成するか、support@belladati.comでサポートに連絡することにより、BellaDatiサポートにライセンスキーをリクエストできます。

4. Auditモジュールを構成する

各モジュール構成は、適切なconf.jsonファイルのコンテナーです。Auditモジュール構成のデフォルトのファイル名はconfg-audit.jsonですが、名前を変更して、モジュールの起動時に反映することができます。

HAまたはマルチサーバーIoT Data Controllerインスタンスをデプロイする場合を除いて、デフォルトの構成で十分です。変更する必要がある唯一のフィールドは "license" です (2つの "license" フィールドがあり、両方を更新します)。

Code Block

language	js

{
  "instance": {
    "license": "n5NkzaEOALzvGs7LOExyAulYdqo8X+5==",
    ...
  },
  "audit": {
    "license": "n5NkzaEOALzvGs7LOExyAulYdqo8X+5==",
    ...
  }
}

完全な構成例については、以下をクリックしてください。

Code Block

linenumbers	true
collapse	true

{
  "instance": {
    "license": "n5NkzaEOALzvGs7LOExyAulYdqo8X+5==",                  
    "name": "Awesome Company - TEST_ENV",                            
    "db": {                                                          
      "url": "jdbc:hsqldb:file:/path/to/instance-db;shutdown=true",  
      "user": "SA",                                                  
      "password": "",                                                
      "driverclass": "org.hsqldb.jdbcDriver",                        
      "max_pool_size": 100,                                           
      "drop": false                                                   
    },
    "auth": {                                                         
      "enabled": true,                                                
      "drop": false,                                                  
      "merge": true,                                                  
      "users": [                                                      
        {
          "username": "admin",                                        
          "password": "DAAF8173380C604B392A1EF8D7559AA0",             
          "salt": "BA1170DE9ADE8D29D2C18FD789EAB3BD",                 
          "roles": [ "ADMIN" ]                                        
        }
      ]
    }
  },
  "audit": {
    "license": "n5NkzaEOALzvGs7LOExyAulYdqo8X+5==",                   
    "name": "Audit 01",                                               
    "host": "localhost",                                              
    "port": 8000,                                                     
    "bodyLimit": 2097152,                                             
    "db": {                                                           
      "url": "jdbc:hsqldb:file:/path/to/my-audit-db;shutdown=true",   
      "user": "SA",                                                   
      "password": "",                                                 
      "driverclass": "org.hsqldb.jdbcDriver",                         
      "max_pool_size": 100,                                           
      "jsonVarcharLength": 2047,                                      
      "drop": false                                                   
    },
    "auth": {
      "enabled": true,                                                
      "drop": false,                                                  
      "merge": true,                                                  
      "users": [                                                      
        {
          "username": "viewer",                                       
          "password": "DAAF8173380C604B392A1EF8D7559AA0",             
          "salt": "BA1170DE9ADE8D29D2C18FD789EAB3BD",                 
          "roles": [ "VIEWER" ]                                       
        }
      ]
    },
    "ssl": {
      "enabled": true,                                                
      "keystorePath": "/path/to/server-keystore.jks",                 
      "keystorePassword": "wibble"                                    
    }
  }
}

Tip
詳細については、 Audit configurationをご覧ください。

5. 他のモジュールを構成する

Configuring IoT Controllerをご覧ください。

6. コントローラモジュールを開始する

全ての構成が設定されたら、すべてのモジュールの開始に進むことができます。開始される最初のモジュールは常にAuditになります。

Page tree

Versions Compared

Old Version 21

New Version Current

Key

Before you begin

Steps

1. Get IoT Data Collector

2. Obtain server-ID

3. Obtain license key

4. Configure Audit module

5. Configure other modules

6. Start Controller modules

始める前に

ステップ

1. IoTデータコントローラを入手する

2. サーバーIDを取得する

3. ライセンスキーを取得する

4. Auditモジュールを構成する

5. 他のモジュールを構成する

6. コントローラモジュールを開始する