Use Python to upload the device name to Digi Remote Manager

The name submodule can be used to upload a custom name for your device to Digi Remote Manager.

When you use the name submodule to upload a custom device name to Remote Manager, the following issues apply:

Together, these two features allow you to swap one device for another by using the name submodule to change the device name, while guaranteeing that the new device will have the same configuration as the previous one.

Note Because causing a profile to be automatically pushed from Remote Manager may change the behavior of the device, including overwriting existing usernames and passwords, the name submodule should be used with caution. As a result, support for this functionality is disabled by default on Remote Manager.

Enable support on Digi Remote Manager for uploading custom device names

  1. In Remote Manager, click API Explorer.
  2. For the HTTP method, select PUT.
  3. For Enter and API or select an example, type /ws/v1/settings/inventory/AllowDeviceToSetOwnNameEnabled.
  4. In the HTTP message body text box, type the following:
    {
       "name" : "AllowDeviceToSetOwnNameEnabled",
       "value" : "true"
    }
  5. Click Send.

Upload a custom name

  1. Select a device in Remote Manager that is configured to allow shell access to the admin user, and click Actions > Open Console. Alternatively, log into the TX64-Rail local command line as a user with shell access.

    Depending on your device configuration, you may be presented with an Access selection menu. Type shell to access the device shell.

  2. At the shell prompt, use the python command with no parameters to enter an interactive Python session:

    # python
    Python 3.10.1 (main, Mar 30 2023, 23:47:13) [GCC 11.2.0] on linux
    Type "help", "copyright", "credits" or "license" for more information.
    >>>
    

  3. Import the name submodule:
    >>> from digidevice import name
  4. Upload the name to Remote Manager:
    >>> name.upload("my_name")
  5. Use Ctrl-D to exit the Python session. You can also exit the session using exit() or quit().