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
If you do not have Git installed, alternatively you can download docker/docker-compose.yml file from project’s GitHub page.
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;
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
http://localhost:4888: PgAdmin web GUI, using which you can analyze historical data utilizing standard SQL queries.
Default credentials are
localhost:5432- PtostgreSQL database with TimescaleDB extension;
Default credentials are:
localhost:8086- InfluxDB version 1.7;
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, security token:
You can configure these and other settings for InfluxDB 2.0 via its web GUI.
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
opcplcas 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.
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
Next sections describe installation and configiration steps in detail.