Seneca Cloud BOX User manual

Page 1
MI003790
MI004560_100-EN
SENECA s.r.l.
Via Austria, 26 –35127 –PADOVA –ITALY
Tel. [phone] Fax. [phone]
Web site: www.seneca.it
Technical assistance: supp[email protected] (IT), [email protected] (Other)
Commercial reference: co[email protected] (IT), [email protected] (Other)
This document is property of SENECA srl. Duplication and reproduction are forbidden, if not authorized. Contents of the present
documentation refers to products and technologies described in it. All technical data contained in the document may be modified
without prior notice Content of this documentation is subject to periodical revision.
To use the product safely and effectively, read carefully the following instructions before use. The product must be used only for the use
for which it was designed and built. Any other use must be considered with full responsibility of the user. The installation,
implementation and set-up is allowed only for authorized operators; these ones must be people physically and intellectually suitable.
Set up must be performed only after a correct installation and the user must perform every operation described in the installation
manual carefully. Seneca is not considered liable of failure, breakdown, accident caused for ignorance or failure to apply the indicated
requirements. Seneca is not considered liable of any unauthorized changes. Seneca reserves the right to modify the device, for any
commercial or construction requirements, without the obligation to promptly update the reference manuals.
No liability for the contents of this documents can be accepted. Use the concepts, examples and other content at your own risk. There
may be errors and inaccuracies in this document, that may of course be damaging to your system. Proceed with caution, and although
this is highly unlikely, the author(s) do not take any responsibility for that. Technical features subject to change without notice.
USER MANUAL
Cloud BOX
Remote Connector
and
micro WebSCADA

USER MANUAL –Cloud BOX
2
Date
Revision
Notes
06/10/2016
01
First revision.

USER MANUAL –Cloud BOX
3
Table of contents
1. SOFTWARE OPEN SOURCE ......................................................................................6
2. INTRODUCTION...........................................................................................................6
2.1. Compatible Devices........................................................................................................................................ 6
2.2. Hardware specifications................................................................................................................................. 7
3. CLOUD BOX INSTALLATION......................................................................................7
4. CONFIGURATION........................................................................................................8
4.1. Default Network Address............................................................................................................................... 8
4.2. Access to the administration section.............................................................................................................. 8
5. CLOUDBOX ADMINISTRATION SECTION.................................................................9
5.1. Configuration ................................................................................................................................................. 9
5.2. Users.............................................................................................................................................................13
5.3. Groups ..........................................................................................................................................................14
5.4. Logs...............................................................................................................................................................14
5.5. Devices..........................................................................................................................................................14
5.6. Statistics .......................................................................................................................................................19
6. EDIT PROJECT..........................................................................................................20
6.1. Edit Page .......................................................................................................................................................20
6.2. "Dashboard with widgets” page....................................................................................................................22
6.3. "Events" page ...............................................................................................................................................23
6.4. "CSV Export" page.........................................................................................................................................25
6.5. "Trace Map" page, Log Trace on Map ...........................................................................................................25
7. STORAGE OF DATA AND PERFORMANCE............................................................25
8. ROUTER CONFIGURATION......................................................................................26

USER MANUAL –Cloud BOX
4
9. DATA COLLECTION (COLLECTOR) ........................................................................26
10. CLOUD BOX MAINTENANCE................................................................................28
10.1. Resetting the Cloud BOX hardware ...............................................................................................................28
10.2. Firmware upgrade.........................................................................................................................................35
10.3. Backup ..........................................................................................................................................................35
10.4. Restore .........................................................................................................................................................36
10.5. Use of an external disk..................................................................................................................................36
11. ADVANCED CUSTOMIZATION..............................................................................36

USER MANUAL –Cloud BOX
5
Seneca Cloud BOX
CAUTION!
UNDER ANY CIRCUMSTANCES, SENECA S.R.L. OR ITS SUPPLIERS SHALL NOT BE RESPONSIBLE FOR
LOSS OF RECORDING DATA/INCOMES OR FOR CONSEQUENTIAL OR INCIDENTAL DAMAGE DUE
TO NEGLECT OR RECKLESS MISHANDLING OF Cloud BOX, EVEN THOUGH SENECA IS WELL AWARE
OF THESE POSSIBLE DAMAGES.
SENECA, ITS SUBSIDIARIES, AFFILIATES, COMPANIES OF THE GROUP, ITS SUPPLIERS AND
RETAILERS SHALL NOT GUARANTEE THAT THE FUNCTIONS WILL SATISFY COMPLETELY
CUSTOMER’S EXPECTATIONS OR THAT Cloud BOX, THE FIRMWARE AND THE SOFTWARE SHALL
HAVE NO ERRORS OR WORK CONTINUOUSLY.

USER MANUAL –Cloud BOX
6
1. Software Open Source
The Cloud Box software and firmware contain open source software. You can get the source code of such
software by requesting them via email to [email protected].
2. Introduction
Cloud BOX is a server that allows you to:
Receive, store on a database and display the RTU events and data
View real-time and historical data on web pages in graphic mode
View the realtime and historical events / alarms on web pages in graphic mode
Send commands to the RTU even if these do not have a static IP
2.1. Compatible Devices
Compatible devices are:
Device
Z-GPRS3
MyAlarm2
Z-KEY
Z-LOGGER3
Z-UMTS

USER MANUAL –Cloud BOX
7
2.2. Hardware specifications
Device Type
Industrial Server
Motherboard Form Factor
Mini-ITX
Cooling
Passive (fanless)
Frontal I/O
2 x USB 2.0
Back I/O
2 USB 2.0 high current
2 USB 2.0
1 VGA
1 HDMI
1 Gb LAN
1 Jack DC (8 V to 19 V)
Processor
Intel Atom N2800
Processor Speed
1.86 GHz
Socket
Onboard (BGA)
Core Number
2
Chipset
Intel NM10
Memory
DDR3 SO-DIMM (non-ECC)
Memory Type
2 GB (minimum)
LAN Controller
Intel 82579L GbE
Supply voltage (AC Adapter)
8~19 V
AC Adapter Socket
Jack DC Onboard
Operating temperature
0°C ~ 40°C
Dimensions (WxHxD)
185.14 x 32 x 205 mm
Certifications
CE, FCC, RoHS
Storage
32 GB SSD Drive
3. Cloud BOX Installation

USER MANUAL –Cloud BOX
8
To install Cloud BOX proceed as follows:
Place the server horizontally, resting it on a flat surface or with the brackets that make it attachable to a wall
(supplied in the package).
Connect the power supply (on the round plug of the back) and the network cable. The device has no keyboard
or mouse, these are only necessary in case of maintenance and can therefore be left unconnected.
Boot the device with the front power button, no further settings are needed to the device.
CAUTION: CloudBox is a server device, so it is necessary that the switch off it’s make in a correct way, without
lifting the power when the server is turned on. It’s recommended, therefore, to connect an electrical device
such as a UPS rescue to prevent surges and / or power blackout.
Shutdown it’s make through the front button that must be pressed once briefly, the long press of the button
makes the immediate shutdown without possibility, for the operating system, to shut down their processes
and could make CloudBox unusable.
4. Configuration
4.1. Default Network Address
The Cloud Box is configured by default with the network settings obtained by DHCP, then, when connected
to a network Cloud Box will try to autonomatically acquire an IP address from the DHCP Server (very often
the Router).
If this operation is not successful, the following network parameters are set:
IP Address 192.168.90.101
subnet-mask 255.255.255.0
gateway 192.168.90.1
4.2. Access to the administration section
The first IP address acquired is viewable through Seneca Device Discovery software (available in the
CloudBox section at www.seneca.it).
You can then access the administration section via a PC with a browser using the following credentials:

USER MANUAL –Cloud BOX
9
Name
Parameter
USERNAME
[email protected]t
PASSWORD
seneca
URL
https://<<INDIRIZZO>>/admin/
5. CloudBox Administration Section
The administration section presents a navigation menu of this kind::
5.1. Configuration
For the first configuration, you must go to the "Configuration" section:

USER MANUAL –Cloud BOX
10
The first tab is for the network configuration parameters: classic IP address, netmask, gateway and DNS.
The "Service" tab, allows you to configure:
HTTP Port: The communication port that the device can be used for not encrypted communication, the
default is 80.
HTTPS Port: The communication port protected by SSL certificate (self-signed), the default is 443.
Log rotation time is the number of days after which the data logs are deleted; attention to the fact that the
logs instead of system (not visible from the panel) does not come influenced by this parameter.
Device Authentication Key: This parameter is the authentication key that they will use the device to send
data. It can be generated by the system or manually written. Pay attention to the value that you set because,
being in fact a password, you must choose it with a safety criteria. The surest way is to randomly generate it
with the appropriate button.
Allow device registration: if checked, the system allows new devices to self-register, or they will be discarded
instead.

USER MANUAL –Cloud BOX
11
The third section covers all configuration and data backup parameters.
backup device: the system automatically identifies a local device (the main disk) and any connected USB
devices. If you press "Mount to" the system will hook them to the filesystem making them available; on the
contrary if you press "Unmounting all" the device will be dropped. From a drop down you can select on which
device you want to make the backup and then the restore.
Backup schedule: here you can set the system to automatically start a backup at the expiration of a certain
time (0-23) and, in certain days of the week.
Beware that this operation can be heavy for the server (depending on the data present in the system). This
operation, if the server is running, it will block other batch like the csv exports until the completion.
The FTP section contains the configuration parameters of two accesses that allow the following functions:

USER MANUAL –Cloud BOX
12
Updates: is a simple ftp access that you need to update devices remotely. RTU devices such as Z-GPRS3 may,
in fact, update the firmware or a SEAL program from an FTP server.
System account: With this access you have visibility of the root of all FTP folders (including access updates).
Here you can load a remotely restore or upgrade an application for Cloud BOX (this if you use the local disk,
see section Backup and Restore for more information). In addition there is a custom folder where you can
upload a custom logo (named logo.png or logo.jpg, in lower case). This logo will be applied to both the login
to the dashboard (replacing the title in text format). It’s also possible to upload a file custom.css with which
modify the dashboard style, see the personalization chapter for more info.
The general section, however, allows you to modify the operating parameters not strictly connected to the
system:
Station title: this parameter is the name of the station, useful if you have more than one Cloud Box.
Language: the default language to be assigned to each user
Use CDN: This flag enables the use of an external Content Delivery Network, allowing the browser to
download the libraries from internet without using the CloudBox bandwidth
Google map key: for tracking functions and GPS maps display was based on Google Maps technology.
For use this feature you must register and get a key that gives you access to a number of views (under the
contract). This parameter is required if you want to benefit from the maps, you can also get more information
about the terms of use of the maps in the link next to the key.

USER MANUAL –Cloud BOX
13
When you go to save the Cloud BOX recognize whether they were or not modified system parameters that
require a reboot. In this case the machine will restart within 30 seconds; This behavior is also possible in the
absence of changes by checking the option at the bottom of the page. The restart is possible only if there
are no pending batch, in this case the system will wait until the processing is complete to avoid failure or
data loss.
5.2. Users
Cloud Box provides a user management panel (Users link on the left); each user can be freely configured with
these parameters:
Active: Indicates whether the user is on or off.
Name: is the user name, an abbreviation that allows only letters and numbers.
Email is the email address linked to the user, will be used for the login.
Password: This is the credential that you will use with the email or name to access the resources allocated.
There are no limits or specific constraints, it is recommended to follow the basic safety rules.
Time Zone is the time zone where the user is located and is a fundamental parameter. When you view the
times, in fact, the system will adjust the displayed time taking account of this time zone and not that of the
server or device.
Role: User roles can be of three types, the first is the administrative which allows you to have access to the
Administration section. The user role is only used to access the dashboard. It’s also possible to configure if
the user can or not edit the dashboard.
Group: it’s the group of users that belongs to this credential access, for more details see the group
management.
Language: is the language that will be set as the default for this user.

USER MANUAL –Cloud BOX
14
5.3. Groups
When you create pages for displaying the data (dashboard) you want to restrict their access.
To provide this functionality, there are user groups.
A group may contain one or more users, and each page can be connected to a group.
The administrator automatically is inside all groups so, therefore, he can access to all pages.
For example you have 3 users and an administrator.
You want that user1 can only access the dashboard 1 and 2, while user2 and 3 can only access the dashboard
3 and 4.
You will have a scheme like:
5.4. Logs
The screen shows in a descending time order the Cloud Box application logs, here we show the notifications,
and errors. Each line can contain a navigable detail through its right button. This log can be manually cleared
or will be cleared automatically as configured.
Warning! Cloud BOX is a server machine, so the log section must be monitored to become aware of any
problems.
5.5. Devices
The programmed devices must point to the Cloud BOX using a device credential making using this type of
URL:
HTTP://<<IP ADDRESS>>/collector/1/<<KEY>>
OR (if availbale):

USER MANUAL –Cloud BOX
15
HTTPS://<<IP ADDRESS>>/collector/1/<<KEY>>
On Seal this url must be inserted in the Cloud section:
Once configured and started the device will make a first send that will provide data on the beginning of the
Cloud BOX datalogging session. This recording operation is automatic, but linked to the flag of the new
registrations (as seen in the basic configuration paragraph);
this flag can be changed on the fly from this screen with the right button. The device management shows in
tabular form all devices registered successfully.
A registered device is stored with a generic name linked to its own unique identifier, for example devices
such as Z-GPRS3 will arise with the modem IMEI. Of each device you can change the configuration in the
device tab.

USER MANUAL –Cloud BOX
16
The first tab manages the description, here you can see the time stamp of the last time the Cloud BOX
recorded data from this device.
The device name is set automatically, then you can customize it. You must then go to assign the device model
that is sending data, this parameter is very important because the editor will put or not a set of commands
that the device can execute.
The timezone, like for the user, specify the time zone of the device.
When the device is programmed from scratch a new session is initiated, these parameters are then sent
along with the new sampling time and are recorded by Cloud BOX. For convenience, on the left, are shown
the last log line and the last recorded event.

USER MANUAL –Cloud BOX
17
The tag data is the configuration of the variables sent from the device to Cloud BOX. Initially, this table is
empty or can vary due to a reprogramming.
Pressing the "import from data" button the system analyzes the last log line and, based on this, the tags are
populated.
This tag set is always updated in additive way, this to preserve the integrity of the data. One thing to watch
out is that a tag that changes the data type from integer to floating point does not lose the previous, but any
widgets will be updated in floating point mode.
The tab of each tag can be changed by writing a variable name and a data type to be set in accordance with
this project in the device. The data types are general and are needed from the editor in order to enable a
better choice based on the type. Internally, however, the data is always stored as a 64-bit float.
Name
Type
Integer
Integer with or without sign
Boolean
True / False

USER MANUAL –Cloud BOX
18
Floating Point
It’s a floating point type
Latitude
GPS Latitude
Longitude
GPS Longitude
The aggregate function is essential for the representation of historical graphs (trend).
When you want to view long periods of time on a graph you run into the problem that the number of points
is huge.
To overcome this drawback, is used the operation of decimation (downsampling). The system automatically
understands what is the minimum resolution displayed on the selected time window.
If we want to see a full week of a device sampling once a minute we will have 1440 samples for 7 days (10080
samples).
To allow a view not too dense (and therefore difficult to read) are imposed for example up to 300 samples;
it follows that we will have to group data in the sections of about 34 minutes. By grouping the data for this
resolution there is the need to choose how to represent with a single sample this group of samples.
It’s therefore necessary to take these groups of samples (groups of 34 samples) and translate them into one
sample to represent all of them.
If it were an analog value as a temperature, the aggregate function could be for example an average.
Case studies can be very different as the needs. For this it is possible, in addition to the data type, also
describe the function that aggregates them when necessary. These functions are coded as follows:

USER MANUAL –Cloud BOX
19
Function
Description
Count
Number of samples in the time interval
Min
Minimum value in the time interval
Max
Maximum value in the time interval
Mean
Average value in the time interval
Sum
The Sum of values in the time interval
Stddev
Standard Deviation in the time interval
First
First value in the time interval
Last
Last value in the time interval
In the last tab, logs, are a subset of the general log, here are visible only the rows of logs related to the specific
device.
5.6. Statistics
This screen provides an overview of the server status, offers a number of indexes to be monitored. The upper
part is made up of several panels that show static data such as network and firmware version of Cloud BOX.
Other indicators provide for example the load of the machine RAM and hard always represent the
consumption of server resources; If the RAM gets too close to the upper limit it is likely that the server can
freeze or slow down dramatically. The disc is critical if approaches to filling, in this case it is likely to have
inconsistent data in the system and subsequently the block of all applications.

USER MANUAL –Cloud BOX
20
6. Edit Project
The project configuration can only be modified by users with authority to modify the pages:
The dashboard has been tested using the following browsers
Chrome 50 or later for
Windows, Android, Ios, OSx
Each project may contain several pages of different types. The different types of pages do not require
configuration of the contents, have specific uses and do not required further parameters in addition to the
basic parameters.
Click to create, remove and move the pages:
6.1. Edit Page
Click Edit to change the page parameters: