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 Collector:
- 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 Collector 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 Collector 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:
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:
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 Collector instance. The only field you need to change is "license" (there are two "license" field, update both).
{ "instance": { "license": "n5NkzaEOALzvGs7LOExyAulYdqo8X+5==", ... }, "audit": { "license": "n5NkzaEOALzvGs7LOExyAulYdqo8X+5==", ... } }
For complete configuration example, click below.
See Audit configuration to get more information.
5. Configure other modules
6. Start collector modules
When all configuration is set, you can proceed to starting all modules. The first module to be started is always Audit.