Device registration to domain

Devices embedding the UBIQUITY Runtime must be registered to a domain. This registration allows their management and enables remote connection. Remote connections can be established by choosing either the Interactive Access or VPN options within UBIQUITY Manager.

The domain registration procedure might differ depending on the device type and firmware version.

Router RK1x/RM1x/GR1x featuring any firmware version

  1. Access UBIQUITY Manager and select Tools > Device setup.
  2. On the Device setup dialog window, select the first option: RK1x/RM1x/GR1x featuring any firmware version or RK2x/RM2x/DM2x featuring a firmware version older than or equal to 3.0.15.15.
    Note: A dialog window may appear asking for permission to open the Tool. Prior to confirming, you can check Always allow to prevent this message from prompting again during this session. If you use a different computer or a different browser, this message will prompt again.
    The dialog window allows to register and configure the device in two ways: via Local Area Network, by using an Ethernet connection to the device and selecting Local Area Network or via USB, by using a USB memory stick and selecting USB. Proceed with the registration, based on the configuration method that you prefer:
    • via Local Area Network
      1. Select Local Area Network.
      2. Enter default login credentials, then click Discover.
        Note: The default username is admin, and the default password is admin.
      3. The Routers found list shows all the devices that have a password matching with the one provided, and they are identified through the Ethernet interfaces MAC addresses. Select from the list the device that you want to register and configure, then click Configure.
      4. Configuration settings are split by categories. Expand each category and configure as needed.
      5. Access the Domain Registration section to register your device to domain and check Create and register … specifying a name for the router and defining its the initial location in the Domain tree.
        Note: You can change your router name at any time later.
        Note: You will be required to log in to the UBIQUITY domain to access the Domain tree.
      6. Select Apply at the bottom of the screen to complete your router registration and configuration. A message will confirm the operation result.
    • via USB
      1. Select USB.
      2. Enter default login credentials, then click Next.
        Note: The default username is admin, and the default password is admin.
      3. Configuration settings are split by categories. Expand each category and configure as needed.
      4. Access the Domain Registration section to register your device to domain and check Create and register … specifying a name for the router and defining its the initial location in the Domain tree.
        Note: You can change your router name at any time later.
        Note: You will be required to log in to the UBIQUITY domain to access the Domain tree.
      5. Select Apply at the bottom of the screen to complete your router registration and configuration. A message will confirm the operation result.
      6. A new dialog window appears and prompts you to browse to the UbiquityRouterConfig.xml router configuration file.

        A message will confirm the operation result.

      7. Copy the file to a USB memory stick and plug this latter into the router.
      8. The router detects the file on the USB memory stick and applies the configuration.

Router RK2x/RM2x/DM2x featuring a firmware version newer than 3.0.15.15

  1. Access the device System Manager through a browsing bar.
    Note:

    To access the device System Manager, enter the device IP address into a browsing bar. Then, enter admin as a username and admin as a default password.

    If you don’t know the IP address that is used to access your device System Manager, refer to the device User Manual on https://literature.rockwellautomation.com/ to learn more about the device factory settings or perform network discovery through Tools > Device Setup.

  2. Select the Server Connection section, then click Connect. Wait until a connection is established.
    Note: If the remote device is not registered to any domain yet, the web page displays an ID along with a password used for device registration to the domain.
  3. To register the device, log in to UBIQUITY Manager using a user's account with administration rights.
  4. Access the Explorer > Domain view section and open the folder where you want to store the remote device and click on the Add resource (circled plus button), then select Add device.
  5. Enter the ID and password obtained when selecting Connectin the device System Manager.

OptixPanel™

  1. Access the device System Manager through a browsing bar.
    Note:

    To access the device System Manager, enter the device IP address into a browsing bar. Then, enter admin as a username and admin as a default password.

    If you don’t know the IP address that is used to access your device System Manager, refer to the device User Manual on https://literature.rockwellautomation.com/ to learn more about the device factory settings or perform network discovery through Tools > Device Setup.

  2. Select the Server Connection section.
  3. Set the Server type to Legacy.
  4. Click Connect. Wait until a connection is established.
    Note: If the remote device is not registered to any domain yet, the web page displays an ID along with a password used for device registration to the domain.
  5. To register the device, log in to UBIQUITY Manager using a user's account with administration rights.
  6. Access the Explorer > Domain view section and open the folder where you want to store the remote device and click on the Add resource (circled plus button), then select Add device.
  7. Enter the ID and password obtained when selecting Connect in the device System Manager.

Hardware identification

Upon its first connection to the network, Runtime stores its identity on the device disk in a file named auth.bin. The location of this file depends on the system used, as indicated in the following table.

Table 1. Runtime for ASEM devices
System Path

ASEM HMIs and UBIQUITY Routers RK1x (WinCE)

\MMCMemory\ASEM\QPlatform\Identity/

ASEM HMIs and UBIQUITY Routers RK2x (Linux Yocto)

/persistent/data/ASEM/QPlatform/Identity/
Note: It is not possible to transfer the identity file from one device to another by copying the auth.bin file. However, you can create a backup of the file and restore it after uninstalling and reinstalling the operating system or Runtime.

The only scenario in which you cannot restore the identity file is when the disk is replaced. In this case, the device is recognized as a different machine.