Campbell Scientific EasyFlux Owner's manual

Revision: 01/2020

Campbell Scientific, Inc.

Product Manual

Table of Contents

1. Introduction 1

2. Installation & Updates 1

2.1 Installation Instructions (Self-Hosted Only) 2

2.2 Set Language 14

2.3 Header and Footer Customization(Self-Hosted only) 15

3. Supported Web Browsers 16

4. Working with EasyFlux Web 16

4.1 Manage Users 16

4.2 Add Station 17

4.2.1 Manage Station Type 18

4.3 Add LoggerNet Datalogger 19

4.4 Manage Station Users 20

4.5 Manage Metadata 20

4.6 Station Info 21

4.7 Monitor Data 22

4.7.1 QA/QC 23

4.8 Download Data 23

4.9 Alerts 24

4.10 Add Alert 24

4.11 Map 25

4.12 Comparison 26

5. License Agreements 26

5.1 EasyFlux™ Web CSI-Hosted License Agreement 27

5.2 EasyFlux™ Web Self-Hosted License Agreement 35

5. Version 41

6. Index 42

Table of Contents - i

1. Introduction

EasyFlux™ Web is a web-based multiuser software system used for monitoring internet-

connected Campbell Scientific eddy-covariance stations.

EasyFlux Web functions with a Campbell Scientific CR6 running either the EasyFlux-CR6OP

program for open-path eddy-covariance systems or the EasyFlux-CR6CP program for closed-path

eddy-covariance systems, or a CR3000 running the EasyFlux-DL program for open-path eddy-

covariance systems. When a station is added, EasyFlux Web automatically pulls station

information available from the program running in the datalogger (ecosystem, latitude, and

longitude).

After adding your stations, you can graphically monitor data including QA/QC values, download

data, compare data between stations, and set up alerts to notify you by email of data values

outside of user-entered thresholds.

An administrator can set up user accounts and control the rights of each user.

2. Installation & Updates

Installation

There are two installation options for EasyFlux™ Web.

1. EasyFlux Web CSI-Hosted: Campbell Scientific can install the software for you in an Azure-

based environment and provide a link to access the software.

2. EasyFlux Web Self-Hosted: You can install the software directly on your server. When

installing the software on your server, the installation process will also install SQL Server

Express. EasyFlux Web is then accessed by typing the IP address of the server into a web

browser. If EasyFlux Web is installed on your local machine, you can access it by typing

localhost into a web browser or by clicking Launch Browser from the EasyFlux Web Server

Administration Utility.

Updates

EasyFlux Web CSI-Hosted comes with automatic updates as part of your annual subscription cost.

Your purchase of EasyFlux Web Self-Hosted allows you to receive updates for one year free of

charge. From the CSIEasyFlux Web Server Administration Utility

a

, press Check for Updates and

EasyFlux™ Web 1

follow the prompts to update your software. After one year, you are required to purchase yearly

maintenance agreements to continue receiving updates. After purchasing a maintenance

agreement, open the CSIEasyFlux Web Server Administration Utility, and select Manage License |

Register Add-On to input your maintenance license key. You can then press Check for Updates

to see if there is an update available.

Add Station Licenses

If additional station licenses are purchased for EasyFlux Web CSI-Hosted, Campbell Scientific will

add the licenses for you.

If additional station licenses are purchased for EasyFlux Web Self-Hosted, you must add them by

using the CSIEasyFlux Web Server Administration Utility

a

. After opening the utility, select

Manage License |Register Add-On to input the license key. Copy and paste the key from your

customer page on the Campbell Scientific website.

a

CSIEasyFlux Web Server Administration Utility is a separate application. Use the desktop icon to

open the application.

2.1 Installation Instructions (Self-Hosted

Only)

Performing a self-installation on your own machine is very simple. Run your executable file and

follow the prompts, using the default settings shown.

Following is a step-by-step guide to help you through the installation process. Follow each step

making sure that what you see is similar to that shown in the following screenshots. At each

screen, click Next to resume.

EasyFlux™ Web 2

At the following step, input a User Name and Company name. Any name you would like will

work. Input the installation key provided to you in the CDKey field (note: this is not the same as

your station license key).

EasyFlux™ Web 3

EasyFlux™ Web 4

EasyFlux™ Web 5

EasyFlux™ Web 6

EasyFlux™ Web 7

EasyFlux™ Web 8

EasyFlux™ Web 9

EasyFlux™ Web 10

Once you click Finish, you will notice two desktop icons have been created on your machine that

look like the following image :

The top icon is the EasyFlux™ Web Server Administration Utility. This is the utility you will use to

activate your station license keys (note: this is not the same as your installation key you input

during installation), adjust your server settings, start and stop the service, select a database,

perform scheduled backups, and check for updates. Select any option and refer to the help box

at the bottom of the screen for more information. The bottom icon is the LNDB (Loggernet

Database) Manager that shouldn’t require any attention. Please do not adjust any settings within

the LNDB Manager without contacting a Campbell Scientific employee.

Before trying to access your EasyFlux Web account in a web browser, open the EasyFlux Web

Server Administration Utility (shown in the following image). None of the defaults on this page

should require editing. The possible exception is the Port Number, and then only if the default

Port Number is taken by another web server installation.

EasyFlux™ Web 11

To add your station license key click Manage License… and then click Register Add-On…. The

next prompt will allow you to input your station license key. Once this is completed, you can

open your web browser and type in the IP address of your computer or simply type “localhost”

into your browser. This should pull up the main EasyFlux Web page. If a different web page is

pulled up (not EasyFlux Web), you may have a conflicting port number. This will require you

changing your port number, as mentioned above, to one that is not being used. If you are still

having trouble accessing the web page, contact a Campbell Scientific employee.

EasyFlux™ Web 12

EasyFlux™ Web 13

2.2 Set Language

The EasyFlux™ Web user interface text can be displayed in different languages. The Set

Language button (highlighted in the following image) on the navigation bar allows you to select

from a list of installed languages. If your preferred language is not listed, please contact

Campbell Scientific. After receiving a language pack from Campbell Scientific, press Upload

Language Pack to upload the language file.

EasyFlux™ Web 14

2.3 Header and Footer Customization(Self-

Hosted only)

The user can create their own header and footer for EasyFlux™ Web by creating text files with a

text editor. These files must be saved to the EasyFlux Web working directory. (By default, the

working directory is C:\Campbellsci\EasyFlux-Web.)

The files must be named:

l PageHeader.snippet

l PageFooter.snippet

HTML code can be added to these files to display logos, hyperlinks, images, or perform other

html customization as needed.

Contact Campbell Scientific for example files as well as general help on how to customize the

interface to your preference.

EasyFlux™ Web 15

3. Supported Web Browsers

EasyFlux Web has been tested with the following web browsers:

l Chrome

l Firefox

l Safari

Current versions of these web browsers should be used.

4. Working with EasyFlux Web

4.1 Manage Users 16

4.2 Add Station 17

4.2.1 Manage Station Type 18

4.3 Add LoggerNet Datalogger 19

4.4 Manage Station Users 20

4.5 Manage Metadata 20

4.6 Station Info 21

4.7 Monitor Data 22

4.7.1 QA/QC 23

4.8 Download Data 23

4.9 Alerts 24

4.10 Add Alert 24

4.11 Map 25

4.12 Comparison 26

.

4.1 Manage Users

To add user accounts, click on the User Info button in the top right corner.

EasyFlux™ Web 16

In the resulting window, click Manage Users, and then Add User. Fill in the requested

information. Note that the email address you provide will be used to send the alerts that a user is

subscribed to.

The Is Administrator checkbox gives a user the ability to add, edit, and delete users, stations, and

alerts, as well as edit metadata. If the Is Administrator checkbox is not checked, by default, the

user is able to view data, download data, and subscribe to alerts for any station they are

associated with. A user can be associated with a station and their permissions can be changed

from the Manage Station Users dialog box (see Manage Station Users (p. 20) for more

information).

An email will be sent to the new user, when an account is created. The email will contain a link

that the new user will follow where they will be instructed to create a password.

If you forget your password, go to the Login screen and select Forgot Password.

By default, there is a Public user that is able to view and download data for each station that it is

associated with.

NOTE:

You must be an administrator in order to manage users. If an administrative account has not

been set up, a Create User box will be displayed when EasyFlux™ Web is opened to allow you

to create an administrator.

You can also click Station Permissions to select any other enabled, non-admin user and to set the

rights for the selected user on all visible stations.

4.2 Add Station

A station can be added by clicking Add Station from the Map or Stations view to display the New

Station dialog box. If the datalogger has already been added to LoggerNet, you can select it from

the Manage LoggerNet Dataloggers drop-down list. If the datalogger has not been added to

LoggerNet, select Add LoggerNet Datalogger from the list. The Add LoggerNet Datalogger

dialog box will be displayed (see Add LoggerNet Datalogger (p. 19) for more information). After

EasyFlux™ Web 17

adding the LoggerNet datalogger, you will be returned to the Add Station dialog box with the

newly added LoggerNet datalogger selected.

On the left side of the screen, you can load an image or a video and provide a Description for the

station.

If available in the datalogger program, the Ecosystem, Latitude, Longitude, and Elevation fields

will be automatically filled in. (Note that the program is only checked for these fields when the

station is first added to EasyFlux™ Web. They can be modified by the user at any time in EasyFlux

Web.)

The default name of the EasyFlux Web station will be the same as its LoggerNet name. You can

give it a unique name in the Name field.

Select the Type of station: Select the Type of station. There are two types by default: EasyFlux DL

CR6 or EasyFlux DL CR3000. These types of stations are associated with dataloggers that have an

EasyFlux DL program running on them. Alerts, Data Monitors, and Metadata are all populated

based off of the information within the EasyFlux DL program. If this site's datalogger has a

different program then a new Type of site will need to be manually created. To create a new Type

of station see Manage Station Type below.

If not filled in automatically, specify the Ecosystem, the Latitude and Longitude in decimal, and

the Elevation of the station in meters, .

You can optionally enter an Abbreviation, Institution, and Location. (Clicking the icon next to

Location will fill in the information based on your current location. This will also override the

Latitude and Longitude obtained from the datalogger program.)

Press Save to save the information and exit the dialog box.

To delete a station or modify its settings, go to the Station Info, click on the station of interest on

the station dropdown, navigate to the Manage Station dropdown. Select Delete Station to delete

the station. Select Edit Properties to open the Edit Station dialog box which will allow you to

modify the settings of the station. From the Edit Station dialog box, you can use the

Enabled/Disabled toggle to choose whether a station is enabled. A disabled station will show up

with a black slash on the map. When a station is disabled, data will not be collected and alerts

will not be sent.

4.2.1 Manage Station Type

From the Edit Station dialogue box click on Manage Station Types. From here you can select

either New Type from this Station or Edit Station Types. If you select New Type from this Station a

prompt will appear that will allow you to name this station type. The station type will be created

based upon the configuration (Alerts, Data Monitors, and Metadata) of the site selected. Once

the type template has been created, it can be used to specify the configuration of new stations

EasyFlux™ Web 18

Page is loading ...

Campbell Scientific EasyFlux Owner's manual

This manual is also suitable for

Campbell Scientific EasyFlux Owner's manual

Related papers

Other documents