Digi Connect IT Mini User Manual page 372

Applications
When you use the name submodule to upload a custom device name to Remote Manager, the
following issues apply:
If the name is being used by to another device in your Remote Manager account, the name will
n
be removed from the previous device and added to the new device.
If Remote Manager is configured to apply a profile to a device based on the device name,
n
changing the name of the device may cause Remote Manager to automatically push a profile
onto the device.
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, select Documentation > API Explorer.
2. For Path, type /ws/v1/settings/inventory/AllowDeviceToSetOwnNameEnabled.
3. For HTTP Method, select POST.
4. In the HTTP message body text box, type the following:
{
"name" : "AllowDeviceToSetOwnNameEnabled",
"value" : "true"
}
5. Click Send.
Upload a custom name
1. Log into the Connect IT Mini 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.6.10 (default, Jan 31 2020, 08:45:19)
[GCC 8.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>>
3. Import the name submodule:
>>> from digidevice import name
Digi Connect IT® Mini User Guide
Digidevice module
372