Ako Akonet User manual

Monitoring and supervision software

for refrigerated facilities

User manual

AKONet

5010H002 Ed.06

Index

Page

Introduction .....................................................................................................................................................................3

Quick guide......................................................................................................................................................................3

Starting the Application.............................................................................................................................................3

Application Work Area ..............................................................................................................................................3

Administration menu........................................................................................................................................................5

General Configuration...............................................................................................................................................5

Users and Groups ...................................................................................................................................................10

LAN Configuration..................................................................................................................................................11

Datetime and Timezone...........................................................................................................................................11

Search for Devices...................................................................................................................................................11

Devices Registered..................................................................................................................................................12

Task Planner ...........................................................................................................................................................13

Alerts and Alarms ...................................................................................................................................................15

Mobility Configuration ............................................................................................................................................15

Backups..................................................................................................................................................................16

Modbus Testing ......................................................................................................................................................16

Remote Access (via TeamViewer).............................................................................................................................16

Alarm ............................................................................................................................................................................17

Facilities.........................................................................................................................................................................17

Services..........................................................................................................................................................................18

Devices ..........................................................................................................................................................................19

Device detail display ................................................................................................................................................20

Graphs...........................................................................................................................................................................22

Reports..........................................................................................................................................................................23

Other Reports .........................................................................................................................................................23

Sample Reports.......................................................................................................................................................23

Advanced Report.....................................................................................................................................................25

Synoptics .......................................................................................................................................................................25

Synoptics Design.....................................................................................................................................................26

Docs management..........................................................................................................................................................27

New Document.......................................................................................................................................................27

Appendix I: Akonet connection scenarios..........................................................................................................................28

No Ethernet-TCP/IP connection, only WiFi .................................................................................................................28

Ethernet-TCP/IP connection, without Internet access .................................................................................................29

Ethernet-TCP/IP connection, with Internet access ......................................................................................................30

5010H002 Ed.06

Introduction

Welcome to AKONet, AKO's new monitoring, supervision and control software.

AKONet has been designed since its conception to be accessible and very

easy to use, but at the same time very efficient and capable of scaling up to

meet the demands of even the largest projects.

The objective of this guide is to introduce the software and its architecture,

allowing users to start using it as quickly as possible, and subsequently to

provide all the necessary resources to get the most out of it.

For any questions related to the installation and/or configuration of the

devices, please refer to the Quick guide 5012H001 and note 5012H011, or

the Quick guide 5014H001 and note 5014H011.

Quick guide

Starting the Application

To access AKONet you need to open a browser (we recommend Google

Chrome) and enter one of the following IPs: the one of the WiFi if you are

accessing via WiFi (10.0.0.1); the one you have configured as the device IP if

you are accessing through intranet (or without IP and with the name of the

device akonet.xxxxxxx.xx); or localhost if you are accessing via TeamViewer.

For more information about the different ways to access AKONet, please

refer to Appendix I: Akonet connection scenarios (Page 28).

By default, the application responds on port 80 (http).

The default admin user is superuser and the password is superuser. After

entering the user and password, click the Login button and AKONet 's main

window will appear.

Application Work Area

Whenever you wish to save any changes made, remember to always press the Accept button afterwards.

The application work area is divided into three parts:

General menu area

This area contains the most important menu options of the application.

The options are displayed or are hidden according to the permissions of the group the user is assigned to. For more information, see section

Users and Groups (Page 10) of this manual.

5010H002 Ed.06

The menu points are:

Administration

In this menu you will find all the application's setup options, and here you can maintain Users and Groups, Alerts and Alarms, etc.

Alarm

This option will open the list of existing alarms, and you can confirm them, print them or change the filters to see the alarm log.

Facilities

This option will open a list of all facilities, whether they are Serial or Ethernet, positioned on a map. Clicking on them will allow you to access

the services of each one.

To enable this option, check the Geopositioning enabled check box in Administration->General Configuration->General Parameters-

>System Options (Advanced). There has to be at least one facility.

Services

This option displays all registered devices, grouped (using tabs) according to the services to which they belong. This should be the default view

of the application.

A service is a functional group of devices, for example, positive or negative cold rooms, and they are created by the client in order to identify the

device more easily.

Devices

This menu also shows the devices, but in a list format, displaying the most important variables of each one.

In this section you will see that the devices are grouped according to its model:

ŸAKO Controls, where you will find all the AKO control devices.

ŸCAMRegis; it will display all the temperature data logger devices.

ŸAKODUO; the DUO family devices will be displayed.

ŸCAMAlarms; all the alarms will be listed.

ŸAKOGAS; all the gas leak detection devices will be listed.

Graphs

This option allows you to enter the graph generation Wizard.

Reports

You can use this option to obtain all the reports (lists) of the samples of your devices.

Synoptics

This option allows you to access the graphical representation module of the facilities.

Docs Management

This last option gives you access to where the generated reports are stored.

This manual will provide more information about each of these options below.

Apart from these options, the top menu also has four other icons for the purpose of a series of basic tasks:

This icon will automatically take you to the application home screen.

The default view is the Services screen. This option displays all registered devices, grouped (using tabs) according to the services to which they

belong.

When you click this button, the system will save the current screen as the new application home screen for the current user.

This takes you to the application's help section.

Closes the session and returns to the login window.

Work area

This is the central application area, and it will be where all the application's screens are displayed.

Bottom information bar

Occurring alarm events are displayed in this area, as well as the date, the time and the current software version.

5010H002 Ed.06

Administration menu

Clicking on the administration icon will take you to the application’s administration menu.

You will see the following Administration screen.

General Configuration

This icon will take you to the main parameters of the application.

Facilities

The facilities can be of two types: Serial (USB AKO-80039) or Ethernet (IP AKO-80080), according to the type of MODBUS connection that has been selected.

There can only be one Serial facility and it will always point to the following port: /dev/ttyUSB_485. It is created by default and the Name is the only

thing that needs to be changed.

However, one can create as many Ethernet facilities as required (up to 12). They are used in cases where there are multiple devices located on various

different floors, when there are more than 25 devices, etc. Each one of these facilities should

point to the IP address that was previously assigned to the AKO-80080 converter.

Remember that in order for the facilities to be used in the application, their Status must be set

to Active.

Services

Another important point to bear in mind in the initial configuration is the configuration of the

services. A service is a logical way of grouping your facility’s devices. You can create as many as

necessary.

This step is not compulsory, since AKONet creates the Default service by default.

When a new service is added, it will be visible for all User Groups, but you can assign service

visibility to specific Groups when the service is added or

modified.

In this example, only Viewers, Administrators and

Operators would be able to see the devices that belong

to the Frozen Cabinets service. None of the other

groups would be able to view the service or the devices

in it. For more information about the different types of

users, see section Users and Groups (Page 10) of this

manual.

In order to sort the services, they can be dragged and

dropped.

More information about the services is provided in

section Services (Page 18) of this manual.

Once the service is created, the relevant devices will

need to be assigned to it. For more information on how

to assign devices to services, please refer to section

Devices Registered (Page 12) of this guide.

5010H002 Ed.06

General Parameters

AKONet's operation is governed by a series of general system variables. These can be

modified by any administrator user. From here, you can access the configuration of all

system variables, grouped as follows: Visual Configuration, Data Recording, Application

Refresh, Sending of alarms by SMS, Sending of alarms by eMail, Device and System.

Visual Configuration Options

This section includes the variables that affect the display of data relative to the user location, such as the date format, the first day of the week, etc.

Data Recording Configuration

The variables in this section determine the way in which AKONet is going to obtain log records.

Events refer to alarms. You will find more information about them below.

Long date format

This allows establishing the format in which the dates will be displayed (date and time).

Short date format

This allows establishing the format in which the dates will be displayed (only date).

First day to display in calendars

It establishes the first day of the week.

Server message language

It establishes the language in which the reports of the planned tasks will be generated, regardless of the

user language.

Application style (requires

rebooting)

AKONet allows changing the general appearance of the application based on some pre-set styles.

You need to reboot AKONet for the change to take effect.

Graph background colour

(requires rebooting)

AKONet allows changing the background colour of graphs between four different options.

You need to reboot AKONet for the change to take effect.

5010H002 Ed.06

Application Refresh

The variables in this section are used to mark the number of seconds it takes the application to automatically update device data in the following screens:

Alarm, Services, Devices and Synoptics.

SMS Configuration

Here, you can configure a series of necessary variables for the correct functioning of SMS notifications.

See also sections Mobility configuration (Page 15) and Alarm (Page 17) of this manual.

If you have purchased the AKO-52043 GSM Modem, AKONet will be able send alarm notifications via SMS, but in order to do so, you should tick the

Sending messages by SMS box, as well as enter /dev/ttyUSB_SMS as Communications port. The other fields have to be left unfilled. The PIN

code of the Modem SIM card must be removed. For any questions related to the SMS Configuration, consult the AKO-52043 manual.

Click Accept to confirm the changes made and hit the Test button to check the sending of the SMS notifications.

Sample generation mode

This parameter allows establishing how the log will be obtained: each device can be made to record samples according to

different intervals, or all devices can log samples at the same time.

Interval in minutes between

samples

If the previous parameter is set to General interval, this interval can be established here.

Be careful, entering very small values would not be advisable (one minute for example). This will affect the

performance of the application. Intervals of 15 minutes are recommended.

Number of variation units required

for logging of new samples

In case of a General interval, this parameter will allow you to obtain extra samples if a device reaches a certain number

of variation units.

For example, all devices take samples every 15 minutes, but you have indicated that extra samples should be logged if

they vary in over one degree. If a device goes from 0 °C to 1 °C, this sample will be logged.

Number of months for sample

storage

This parameter refers to the number of months samples will be stored in the database. Adapt according to your needs, up until

a maximum of 120 months (or 10 years). Storage of 36 months is recommended.

Refresh seconds of devices in the

Device List display

This allows establishing the number of seconds it will take for data in the Device List screen to be updated.

Be careful, setting very low values will have a negative impact on performance.

Refresh seconds of devices in the

Services display

This allows establishing the number of seconds it will take for data in the Services screen to be updated.

Be careful, setting very low values will have a negative impact on performance.

Refresh seconds of elements

contained in a Synoptic

This allows establishing the number of seconds it will take for data in the Synoptics screen to be updated.

Be careful, setting very low values will have a negative impact on performance.

Refresh seconds for Alarm

notification

This allows establishing the number of seconds it will take for Alarm notification data to be updated.

Be careful, setting very low values will have a negative impact on performance.

5010H002 Ed.06

After confirming the parameters, the server will need to be rebooted in order for the changes to take effect.

eMail Configuration

Here, you can configure a series of necessary variables for the correct functioning of eMail notifications. See also sections Mobility Configuration (Page

15) and Alarm (Page 17) of this manual.

In order for AKONet to be able to send eMails, the computer on which the application is installed needs to have internet access.

Click Accept to confirm the changes made and hit the Test button to check the sending of the eMail notifications.

After confirming the parameters, the server will need to be rebooted in order for the changes to take effect. For more information, see

Appendix I: Akonet connection scenarios (Page 28).

Device Options (Advanced)

These advanced options control a series of parameters related to the application behaviour in case of communication, or modbus, errors between the

devices and AKONet. See also section Alarm (Page 17) of this manual.

Sending of SMS messages

This box should be ticked for AKONet to send alarms via SMS.

Communications port the GSM Modem is

assigned to

If the AKO-52043 GSM Modem is connected through USB, AKONet will recognise it automatically and will

assign it to this field.

Literal that will be attached as the header of

the SMS in the event of sending an alarm

This allows for the adding of a default SMS header text.

Literal that will be attached as the footer of

the SMS in the event of sending an alarm

This allows for the adding of a default SMS footer text.

Use default parameters

This box should be ticked for the service to work correctly.

Sending messages via eMail

This box should be ticked for the service to work correctly.

Number of days failed delivery eMails will

be kept

If eMails fail to be delivered, the system will keep them and will reattempt delivery for a predefined number of

days.

Literal that will be displayed in the subject

of the eMail on sending an alarm

This allows for the adding of a default eMail subject text.

Literal that will be attached as the header of

the body of the message of the eMail on

sending an alarm

This allows for the adding of a default eMail header text.

Literal that will be attached as the footer of

the body of the message of the eMail on

sending an alarm

This allows for the adding of a default eMail footer text.

5010H002 Ed.06

System Options (Advanced)

This last group contains parameters for the configuration of a series of general features related to application performance.

Document Folders

The document management module allows for the storage of all your facility related documentation within AKONet, for example, sample reports,

graphs, etc.

From here, you can access the configuration of your document folders. They can be organised as desired. Just give them a Name and a Description. The

URL refers to the storage path of the documents, that is, the folder on the Linux server where the documents will be stored.

This step is not compulsory, since AKONet creates the Default folder by default.

More information about document management is provided in section Docs Management (Page 28) of this manual.

Generate alarms if communication errors

occur

This feature allows enabling or disabling alarm generation in the case of communication errors with any given

device.

Number of communication errors to

generate a communication alarm

If the previous parameter has been enabled, this parameter indicates how many errors should occur before

alarm generation is triggered.

Change a device to Offline mode if

communication errors are generated

This check box allows for the removal of a device from the network in case of communication errors.

Number of errors to change the device to

Offline mode

If the previous parameter has been enabled, this parameter indicates how many errors should occur for any

given device to be taken Offline.

Send alarms when the device goes to Offline

mode

If this feature is checked, the system will send an eMail alert after taking the device Offline.

Sending messages when the alarms are

disabled

When activated, an alarm generated by a device which was subsequently solved (for example, a maximum

alarm), will trigger the system to send a notification with the information that the alarm does not exist anymore.

AKO Live Update Enabled

AKONet is equipped with an automatic update functionality in order to guarantee your version of AKO is the

most recent one at all times.

When activated, the system will check for new updates every 8 hours.

In order to download and install the updates correctly, the computer on which the application is installed

needs to have internet access. Remember that while an update is being executed, the system will

be temporarily down and users will not be able to access it until the process is finished.

5010H002 Ed.06

Users and Groups

This icon will take you to the configuration screen of the application users and groups.

In order to create the users and groups of users needed for the correct functioning of the application, the goal is to register those users who:

ŸAre going to access the application.

ŸWill need to be notified via SMS or via eMail in case of any system alarms.

ŸWill need to receive reports via eMail.

Before creating the users, it is important to set up groups of users and assign permissions to them; in other words, it is important to prevent users from

having unrestricted access to the application.

Maintenance of Groups

To create the user groups, go to the Groups tab.

Careful, the Administrators group should not be deleted yet, as doing so would remove the superuser.

A series of AKONet functions can be assigned to each group of users:

ŸAdministration: this option allows or denies access to the administration menu, and enables or disables the synoptics create and edit

options, the document maintenance option in the document management module, and, in general, any option for the purpose of deleting

general features.

ŸDevice Configuration: this option provides access to the modification and configuration of device variables.

ŸSet Point: this option provides access to the modification of service temperature Set Points.

ŸAccess to Graphs: Access to the graph generation function can be allowed or denied using this option.

ŸAccess to Synoptics: Allows or denies access to the synoptics module.

ŸAccess to Reports: This option controls which users should get access to the reports module.

ŸAccess to Doc. Man.: This option controls which users should get access to the document management module.

Three groups are created by default: Administrators, Operators and Viewers. The creation of further groups is not generally required, although they can

of course be created as desired.

ŸAdministrators, with unrestricted access to the application.

ŸOperators, with access to everything except for the Administration option; all users who need to modify system variables, such as Set Points,

should be included in this group.

ŸViewers, with no access to Administration and Device Configuration; all users whose daily job consists exclusively of monitoring tasks, and

who in no case should have access to the modification of system variables, should be included in this group.

Maintenance of Users

After registering all required groups, it is time to create the users who are going to use the system. To do so, go to the Users tab.

Click New to add new users. This button will take you to a pop-up window for the registration of said users. Here, you should include all the user data.

You should pay special attention to the group you assign the user to.

Make sure you fill in the eMail and Mobile Telephone fields correctly so that the user may receive alarm notifications via eMail and/or SMS.

For more information, see section Mobility Configuration (Page 15) of this manual.

To configure which users should be allowed to view facilities, click on the Permissions button and select the relevant facilities from the list of those

available.