Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 41 Next »

This page is for network administrators who are setting up the Aggregator

This documents describes setup and configuration of the 3YOURMIND Aggregator for Machine Connectivity in the Agile MES. Before reading this, make sure you have read Machine Connectivity System Requirements.

Aggregator On Windows

Start by downloading the binary release. We will provide you with a link to a ZIP archive.

Make sure your Windows PC is in the same network as each machine you want to connect to.

  • Unpack the contents of the ZIP archive in a directory on the Windows PC (e.g C:\Users\PC\Aggregator)

  • Create a configuration following the Create a Configuration guide and save it in a file called config.json.

  • Put the config.json in the same directory as the aggregator.exe.

  • Run the executable.

Optionally you can install the Aggregator as a Windows service. This enables automatic start of the Aggregator service on system boot without human input.

  • Stop the executable.

  • Run install-as-service.bat as Administrator.

  • To remove the service and stop the Aggregator run uninstall-service.bat as Administrator.

Optionally adjust the settings of the service:

  • Click on Windows Start, type Services and hit enter to open the service configuration panel.

  • Adjust the settings of the 3YOURMIND Aggregator service as desired. You can e.g. enable automatic restart of the service in case of an error.

Troubleshooting

Why am I unable to connect to the machine even though I am using the correct URL?

Try to enable network discovery on the Aggregator’s PC.

Log files

After starting the Aggregator, a aggregator.log should have been generated in the same directory. The file is a good starting point for troubleshooting machine connectivity issues. Open it in a text editor to identify potential bottlenecks.

Windows Event Log

For unexpected errors in the Aggregator you can check the event log:

  • Click on Windows Start, type Event Viewer and hit enter.

  • Open Windows Logs → Application and look for any errors related to the aggregator.exe.

Aggregator In Docker

Since version 22.7, our cloud and on-premise deployments come with a dockerized Aggregator. Its configuration takes place in the admin panel.

Cloud deployments can only connect machines that are reachable from the internet.

  • Log into the admin panel of your deployment by visiting https://[your-url]/admin/.

  • Navigate to B3_ORGANIZATION → Organizations.

  • Add a new organization called button3d and attach a newly created site called button3d.

  • Navigate to B3_MACHINE → Aggregator Configurations.

  • Click on ADD AGGREGATOR CONFIGURATION in the top right.

  • Select the site button3d and paste the configuration (Create a Configuration) into the content field.

  • Click on Save in the bottom right.

Wait for 20s and check for errors in the admin panel under B3_MACHINE -> Aggregator configuration errors. If the Error field is empty then the configuration is valid.

If you want to make changes to the configuration in the future then simply edit the content field and save.

At this point, the Aggregator should have already pulled the new configuration and started reading data from the machines.


  • No labels