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 will be available at the following below URLs:

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

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

    Default credentials are admin/admin.

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

    Default credentials are admin@ogamma.io/admin.

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.

Additinally OPC UA simulation server will be also available at opc.tcp//opcplc:50000. 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. 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.