CCFIW

A bridge between cloudcampus and Telefonica's IotAgentJSON. This software runs and exits after single update. One should combine this with a cronjob in order to update with the desired frequency

Features

• Quality of signal based on user's RSSI
• OK/KO AP's
• Nr of online users
• Sites and Devices metadata mapping
• Distinct Users per Hour

Support

CloudCampus version: iMaster NCE-Campus V300R021C00SPC111

IoTAgent version:

{"libVersion": "2.24.0","port": 8082,"baseRoot": "/","version": "1.22.0"}

Environment Variables

To run this project, you will need to add the following environment variables to your .env file or directly to the docker-compose.yml file.

ccampus.basepath | default: https://dashboard.lanaas.eu:18002

ccampus.username | default:

ccampus.password | default:

ccampus.workerssid | default: Corp,test1

idm.basepath | default: https://auth.iotplatform.telefonica.com:15001

idm.username | default:

idm.password | default:

idm.service | default:

idm.servicepath | default:

iotagent.apikey | default: <get one from iotagent POST iot/services>

iotagent.hostname | default: iota.iotplatform.telefonica.com

iotagent.iota_port | default: 8088

iotagent.json_port | default: 8185

iotagent.force_update | default: falseiotagent.ignore_sites | default:

redis.servers | default: redis:6379redis.database | default: 0redis.cluster | default: falseredis.master_name | default: redis.pool_size | default: empty(auto)redis.password | default: redis.tls_enabled | default: false

Requirements

• docker
• docker-compose

Setup

First, make sure you have all the required dependencies installed. Second, edit your docker-compose.yml file in order to setup the credencials and hosts desired. Third, run

 docker-compose up --build ccfiw

and wait for completion.

Hint: You can run the command above as a cronjob in order to keep data syncd.

Migration Guide

Every new release that changes Datamodel Structure, should be migrated by enabling the env_var iotagent.force_update for the 1st run. After that, set the force_update to false to continue normaly.

Ignoring unwanted Sites/PoI

By setting iotagent.ignore_sites (comma splitted PoI ID), sites (and their related entities) calculated from CloudCampus will not be updated on iotagent, if present on the list.