Getting Started

Setup using Docker

The easiest and guaranteed to work in minutes way to start using ogamma Visual Logger is running it as Docker container. If you never tried to use Docker before, we encourage you to try to install and use this powerful technology.

In the Docker host machine (where Docker and Docker-compose are installed), open console ( in Windows, open PowerShell console, in Linux, open bash terminal), and run following below commands:

git clone https://github.com/onewayautomation/ogamma-logger.git

Note

If you do not have Git installed, alternatively you can download docker/docker-compose.yml file from project’s GitHub page.

cd ./ogamma-logger/docker

docker-compose up

As a result, Docker images will be downloaded from Docker Hub, containers from those images will start, and components of ogamma Visual Logger and suported databases with web based management tools will be available at the following below URLs:

  • http://localhost:4880 : ogamma Visual Logger configuration GUI, where you can setup connections to OPC UA servers and define what variables to collect data for;

    Note

    Web GUI of the ogamma Visual Logger is optimized and tested for screen resolution 1920x1080 in full size mode, in Google Chrome and Microsoft Edge. GUI layout might be disrupted in other combinations of browse and screen resolution. If this becomes blocking issue for you, please report it at https://github.com/onewayautomation/ogamma-logger/issues.

  • http://localhost:3000: Grafana web GUI, using which you can visualize data from OPC UA Servers;

    Default credentials are admin/admin.


  • http://localhost:4888: PgAdmin web GUI, using which you can analyze historical data utilizing standard SQL queries.

    Default credentials are admin@ogamma.io/admin.


  • localhost:5432 - PtostgreSQL database with TimescaleDB extension;

    Default credentials are: ogamma/ogamma.


  • localhost:8086- InfluxDB version 1.7;

  • http://localhost:8085: InfluxDB 1.7 management web GUI. (For details on how to use it refer to project home page at https://timeseriesadmin.github.io/).

    No credentials are required to access the page.


  • http://localhost:9999: InfluxDB 2.0 management web GUI and API base endpoint;

    Default credentials and other settings are configured in initialization script file /opt/start_and_init.sh: username/password: ogamma/ogamma123, organization: ogamma, bucket: ogamma, security token: secrettoken.

    You can configure these and other settings for InfluxDB 2.0 via its web GUI.

    Note

    InfluxDB 2.0 web GUI also provides tools to run queries, build dashboards with graphs, confure monitoring of data sor conditions and generating alerts, etc. Refer to its documentation for more details at https://v2.docs.influxdata.com/v2.0/.

  • opc.tcp//opcplc:50000: OPC UA simulation server (https://github.com/Azure-Samples/iot-edge-opc-plc). Note that from the host machine it will not be available using opcplc as host name though, which might cause problems if you want to connect to it using OPC UA client running in your host PC. Refer to Docker documentation on how to make it accessible from the host machine using host name.

Tip

To stop containers which were started by command docker-compose up, you can either type Ctrl+C in the same terminal window where they were started from, or open another terminal, navigate to the folder where file docker-compose.yml is located, and run command docker-compose down.


Next sections describe installation and configiration steps in detail.