Quick reference

• Maintained by:
  Open Foris Initiative

• Documentation:
  Open Foris Arena Website

• Online platform:
  Open Foris Arena

• Where to get help:
  Open Foris Support Forum

What is Arena?

Arena is a cloud-based platform for storing and processing data collected in field inventories or questionnaires. It provides a fast and flexible way to set up a survey and start entering data for a team. It offers tools for data quality assurance with the help of data validation and reporting methods. Arena also offers multilingual data entry forms, multi-cycle data management, and computing of new result attributes and running statistical analysis with integrated connection to RStudio Server or local installation of RStudio.

Arena also offers a map with access to very-high resolution satellite images. The Arena Map can be used, for example, for verifying locations of collected data, and for conducting sample-based image interpretation.

Installation

Prerequisites

• download and install Docker. Docker is an open platform for developing, shipping, and running applications.

• Install a local database (PostgreSQL) as a Docker container. Run this command from command line; it will create also a database named 'arena' and a user 'arena' with password 'arena' and will make the DBMS listen on port 5444 (you can change those parameters as you wish):

console $ docker run -d --name arena-db -p 5444:5432 -e POSTGRES_DB=arena -e POSTGRES_PASSWORD=arena -e POSTGRES_USER=arena postgis/postgis:12-3.0

You can also use an already existing PostgreSQL database installed in a different way and configure Arena to connect to it.

Prepare a file with the parameters to pass to Arena

The file (call it arena.env) must be a text file with this content:

```properties

Default web server port

ARENA_PORT=9090

DB

specify the connection parameters as a URL in the format

postgres://user:password@host:port/database

DATABASE_URL=postgres://arena:arena@localhost:5444/arena

or parameter by parameter

PGHOST=localhost PGPORT=5444 PGDATABASE=arena PGUSER=arena PGPASSWORD=arena

temporary uploaded files folder

TEMPFOLDER=/home/youruser/openforis/arena/upload

FILES STORAGE

(if both FILESTORAGEPATH and FILESTORAGEAWSS3BUCKET_NAME are not specified, files will be stored in DB)

FILES STORAGE (file system)

path of a folder in the file system used to store files

FILESTORAGEPATH=

FILES STORAGE (AWS S3 Bucket)

FILESTORAGEAWSS3BUCKET_NAME=

FILESTORAGEAWSS3BUCKET_REGION=

FILESTORAGEAWSACCESSKEY=

FILESTORAGEAWSSECRETACCESS_KEY=

Email

email service; allowed values: sendgrid / office365

- sendgrid service, only SENDGRIDAPIKEY is required

- office365 service: EMAILAUTHUSER and EMAILAUTHPASSWORD are required

EMAILSERVICE=sendgrid SENDGRIDAPI_KEY= # get it from https://sendgrid.com/

EMAILAUTHUSER=

EMAILAUTHPASSWORD=

Optional: custom email transport options could be specified.

EMAILTRANSPORTOPTIONS=

e.g. (for MS office365 service) EMAILTRANSPORTOPTIONS={"host":"smtp.office365.com","port":"587","auth":{"user":"testuser@mydomain.org","pass":"yoursecretpassword"},"secure":true,"tls":{"ciphers":"SSLv3"}}

Analysis

ANALYSISOUTPUTDIR=/home/your_user/openforis/arena/analysis

Server

HTTP Session

Secret used to sign the session ID cookie

SESSIONIDCOOKIE_SECRET=my-cookie-secret-key

Set to true if http requests must be forwarded to https

USE_HTTPS=false

RStudio Server (not mandatory)

RSTUDIODOWNLOADSERVER_URL=

RSTUDIOSERVERURL=

RSTUDIOPROXYSERVER_URL=

RSTUDIOPOOLSERVER_URL=

RSTUDIOPOOLSERVICE_KEY=

reCAPTCHA

RECAPTCHA_ENABLED=false

reCAPTCHA v2 keys; to be specified if reCAPTCHA is enabled (get it from https://www.google.com/recaptcha/about/)

RECAPTCHASITEKEY=

RECAPTCHASECRETKEY=

MAP

Planet Lab Maps API key (get it from https://www.planet.com/markets/mapping/)

MAPAPIKEY_PLANET=

System Admin user email address

used to create default system admin user when DB is empty

and to send emails to the users

ADMIN_EMAIL=

Admin user password: used only when default system admin user is created the first time

it MUST BE DELETED after the first startup

ADMIN_PASSWORD= ```

Install and run Arena

Running the following command from command line will install Arena as a Docker container:

console $ docker run --env-file ./arena.env --network="host" openforis/arena:latest

You can run this command in the same folder where you have defined the arena.env file or specify its path in the command, in the '--env-file' parameter. Arena will start on the port specified in the arena.env file (9090 by default). You can use the same command to start up Arena again once you stop it.

Open Arena in the browser

Once you started Arena with the previous command, you can open this address in your browser: http://localhost:9090

If the installation process was successful, the Arena login form should appear.

When Arena starts up the first time, a system admnistrator user is created using the parameters ADMINEMAIL and ADMINPASSWORD specified in the arena.env file, so you can use that email address and password to access Arena the first time. The password can be changed using the Change password function in Arena.

Run R Studio Server locally

To install RStudio Server as a Docker container run the following command (replace ANALYSISOUTPUTDIR with the value of the ANALYSISOUTPUTDIR environment variable):

console $ docker run -d --name arena-rstudio --network=host -v ANALYSIS_OUTPUT_DIR:/home/rstudio -e DISABLE_AUTH=true rocker/rstudio

To restart RStudio server run

console $ docker container restart arena-rstudio

Visit http://localhost:8787 in your browser to access the rStudio server instance.

License

Arena is MIT licensed.