Add machine to Gatemanager

How to add a machine to the Gatemanager

This guide outlines the process of adding a new machine to GateManager, ensuring seamless integration and management within the platform. Starting with prerequisites such as an assigned gateway with an active contract in the mobileIoT Suite, users are guided through each step, from logging into GateManager to configuring connectivity and binding licenses. The guide also covers essential tasks like waiting for device visibility, moving licenses, and configuring agents for remote connections. By following these detailed instructions, users can effectively add and configure machines in GateManager for streamlined management and remote access.

✅ Prerequisites

  • Administrator access to the mobile IoT Suite with the rights to activate a remote access session.
  • Have access to one of the ifm GateManagers, this probably depends on your region.
  • You're logged into the mobile IoT Suite.
  • You're familiar with the terms GateManager , SiteManager and LinkManager , if not please visit the Glossary for more explanation of these terms.

Prepare the Connection

We need to setup the mobile IoT Gateway such that it will establish a connection to the GateManager.

Login to GateManager

  • Access GateManager using your certificate and password as the domain administrator.

Copy Domain Token

  • Copy the Domain token to the clipboard by clicking the clipboard with red arrow icon.

Connect to the Gateway, CR3171

The next step is to connect to your CR3171 device locally.

Make sure that you are physically connected to the device with an ethernet cable.

Open the gateway WebUI

Enter http://192.168.82.1 in your browser and allow the unsecured connection to access the CR3171 WebUI.

Enter Credentials

In the pop-up window, the credentials to access the device.

The defaults are:

  • username = admin
  • password = <<ETH-MAC>> address of the connected device

Configure Connectivity

After being connected the device WebUI, we need to configure the connection to the GateManager Server.

  • Now navigate to Connectivity > Secomea Site Manager embedded > General preferences .


  • Enter the previously copied domain token into the Domain token * field.
  • Make sure that the correct GateManager address is filled-out.
  • Apply the changes and switch back to the GateManager.

Wait for to appear in GateManager

After a few minutes, the device will be show-up in the entered domain in GateManager.

Move Licenses

To actually be able to use the remote access service, one need to have a so-called LinkManager license attached to the machine, or in GateManager also called as ' Appliance '

❗ Additional licenses

If no free licenses are available in the #license domain, please contact your ifm representative.

Bind Licenses

  • Select the CR3171 marked with the green ✔ and the red ❗ by clicking on it. Click on the Bind license and 📌 attach here button. Confirm the license binding to the appliance .

Wait for Agents

After a few minutes, two default agents will appear under the appliance.

Desktop PC

One with the type "Desktop PC" , responsible for remote connection to the mobile IoT Gateway WebUI, in this case the CR3171.

Subnet

One with the type "Subnet" , responsible for remote connection to devices such as PLC and HMI which is connected and in the same network as the CR3171.

Configure the SiteManager

  • Select the gateway by clicking on it and push the SiteManager button.

Setup Assistant

"SiteManager Embedded - Setup Assistant" will appear in a new web browser window.

Edit Device Agents

  • Press the Edit button opposite the 2. Device Agents: label.
  • Check the settings of each agent by clicking on the Edit or "Finger on list" icon.

Verify Agent Settings

  • Ensure that both agents have the correct settings as shown in the screenshots.
Type "Desktop PC"
Type "Subnet"
  • Close the setup window

Summary

This guide provides a step-by-step walkthrough for integrating a new machine into GateManager, ensuring smooth operation and streamlined management. It covers the entire process, starting with preconditions and progressing through connectivity configuration, license management, and agent setup. The instructions ensure that users can establish secure and efficient remote access to machines.

Key Steps Overview:

Preparation:
  • Confirm that the gateway is assigned to a customer and has an active contract in the mobileIoT Suite.
Access GateManager:
  • Log into GateManager as a domain administrator, and copy the domain token for later use.
Local Gateway Connection:
  • Connect to the gateway locally, access its WebUI, and log in using the device's credentials.
Configure Connectivity:
  • Input the domain token into the gateway's configuration settings to establish a connection with GateManager.
License Management:
  • Transfer necessary licenses (SiteManager and LinkManager) to the appropriate domain and bind them to the gateway.
Agent Configuration:
  • Wait for the gateway to become visible in GateManager, where two agents—Desktop PC and Subnet—will appear. Verify their settings and adjust as needed to enable remote access to both the gateway and connected devices.


By following this guide, users can effectively integrate and configure machines in GateManager, enabling remote access to devices like PLCs and HMIs for maintenance, monitoring, and troubleshooting. This ensures operational efficiency and reduces downtime across industrial environments.