Home

Introduction

Taranta (Webjive until v.1.1.5) is a web application that allows a user to create a graphical user interface to interact with Tango devices. The interface may include a variety of charts, numerical indicators, dials, commands that can be used to monitor and to control devices. Very little knowledge of web technologies is needed.

With Taranta you can use your web browser to:

• View a list of all Tango devices

• View and modify device properties

• View and execute device commands

• Create dashboards for interacting with Tango devices.

Online demo

https://webjive-demo.maxiv.lu.se/demodb (log in with demo/demo).

Current version

This is version 2.13.4 of Taranta.

• Home
• History of changes to Taranta (former Webjive)

User guide

• What is Taranta
• How to install Taranta
• How to contribute to Taranta
• Taranta Architecture
• How to use Taranta
• Sharing dashboard
• Working with SVG
• Available widgets
• Deprecated widgets
• Configuration
• Dashboard environment
• Error Handling Documentation

For developers

Usage of the source repository

1. Clone the repository.

2. Run

npm install

3. Type

npm start

Minimum node version: 7.6 (introduced async/wait)

Verified working node version: 9.11.2 (currently used by the dockerfile)

Docker >= v18 and GNU Make must be installed.

Architectural view

• Taranta Architecture
• Basic description of Taranta architecture
  • Taranta communication protocol
  • Taranta data injection points
  • Taranta data injection type
  • WebSocket middleware & store
• A Component and Connector View of Taranta Suite
  • Introduction
  • Taranta Suite Component and Connection Diagram
  • Taranta Suite Component Table
  • Taranta Suite Connection Table
  • Notes
    • TANGO
    • Docker
• A Module View Of Taranta Suite
  • Introduction
  • Taranta Suite - Front End Module View Diagram
  • Taranta Suite - TangoGQL Module View Diagram
  • Taranta Suite Package Table
• Taranta charts
  • Example deployment:

How to extend Taranta

• How to Deploy a Widget
  • Creating a New Widget

Known issues

• Current known issues
  • UTF-8 Encoding in POGO
  • Problem Description
  • Resolution
  • Taranta-Fix
  • Conclusion

External resources:

• TangoGQL
• Taranta authorization
• Taranta Dashboard

Redux state structure

State structure

• Redux Store Structure
  • Adding data in store

Authors

Taranta was initially written by the KITS Group at MAX IV Laboratory. Since 2018 also SKA Teams are developing it.