Tributech Agent Companion

The Tributech Agent Companion is an application for the management of the Tributech Agent Edge & OEM. It allows to link them to a Tributech Node and configure them based on digital twins. It offers a twin builder UI (which can also be used stand-alone). It communicates with the APIs of the Tributech Node and Tributech Agent Edge / OEM and must be connected accordingly.

Download & Run

Windows

• Download (Windows)

• Identify Tributech Agent Companion X.X.X executable and double-click

note

Depending on your system configuration you might see a security warning from e.g. Microsoft Defender on the first run of the app executable. This is since our app is currently not signed. We will improve this in one of the future releases. In the meanwhile we recommend that you check the file with your antivirus software and ignore the warning if everything looks good. Ignore Microsoft Defender warning and run application anyway.

• The Tributech Agent Companion should now be started.

macOS

• Download (macOS)

Login to Tributech Node

• Click Login (top right corner).
• Enter the name/domain of your DSK Hub and DSK Node and click Login (below).
  (The provided information defines to which DSK Node an DSK Agent will be connected during the linking process.)
• A window with the login page of the authentication server will pop-up where you can sign in with your personal user account of your DSK Node.
• The window will be closed on successful login and the Agent Companion will be connected to the DSK Node (indicated by the green sign on top right at the DSK Node name).

Connect to Agent Edge

• We need to be able to connect to the API of the DSK Edge Agent to link & configure it with the Agent Companion.
  Our recommended option is to open an SSH connection to the deployed virtual machine of the DSK Edge Agent with an SSH tunnel/port forwarding for the remote port of the API forwarding it to an local port on your localhost.

ssh <vm-user>@<vm-ip> -L <local-port>:localhost:5000
# e.g.
ssh tributech@20.86.158.183 -L 5000:localhost:5000

• After the SSH connection with the tunnel/port forwarding is established we can connect to the DSK Edge Agent with the Agent-Companion.
  (e.g. http://localhost:5000)

Link Agent

• By linking the DSK Edge Agent all metadata for the agent is created on the DSK Node and we establish the trust between the parties. We need to be logged in to the desired target Node and connected to the DSK Edge Agent (indicated by the green signs on the top right).
• Click on Link/Relink Agent
• The next step after linking is to configure the DSK Edge Agent.
• Currently we support two different ways to configure the Agent, whereby using the Dataspace Admin Agent Configuration is the preferred option.