Settings¶
Click Settings on the sidebar menu to configure your LPM session. Descriptions for each setting is described below.
Device Types¶
Select the type of devices to use with Lantronix Provisioning Manager. LPM automatically discovers devices of the selected type(s).
Setting | Description |
---|---|
Device Type | Choose OOB (Out-of-Band) Devices, IoT (Internet of Things) Gateways, and/or Switches. |
Device Credentials¶
Important Information on Device Credentials
Device credentials can be provided to LPM in an uploaded Credentials File (in .CSV or .TDI format) or in the Global Credentials setting. The credentials file can be used to provide credentials for multiple devices when each device has unique credentials. Global credentials can be used where the same credentials apply to multiple devices.
LPM attempts to log in to a device using the methods shown below, in sequential order:
- Credentials file (.CSV or .TDI)
If LPM fails to authenticate using the credentials in the credentials file or if a device isn't listed in the credentials file, it will attempt to use the authentication methods listed below. - Global credentials
- Model default credentials
By default, a device password is the last 8 characters of the Device ID (for devices manufactured after January 1, 2020) or is a model-specific password, such as "PASS" (for all older devices). - Last 8 characters of the Device ID
LPM will connect to Percepxion using credentials provided in the Provisioning Configurations settings to get the Device ID. If 2FA or SAML have been enabled on Percepxion, you will need to provide the required information in the pop-up that appears.
If credentials have not been provided in the Provisioning Configurations section, this method is skipped.
If authentication fails with all these methods, an error is shown under Operation Status for the relevant device. To resolve the error, click the menu button next to that device and click Device Credentials to set credentials for that specific device. Note that credentials entered in this manner are not saved when LPM is closed.
Credentials File¶
Click the edit button to upload a credentials file; this is a .CSV or .TDI file containing device credentials.
Click Save or press Enter to save the settings.
.CSV credentials file contents
The first line of the .CSV credentials file should be macaddress,serialnumber,deviceid,username,password
. Each subsequent line should follow the pattern with one device per line.
The MAC address must be supplied for each device in the file.
For example:
macaddress,serialnumber,deviceid,username,password
00:80:a3:a5:4b:14,0080A3A54B14,,admin,PASS
00:80:a3:a5:42:5c,0080A3A5425c,00204AKW08AH60EOZZ3S21G3ZRS0Y3EJ,,
00:80:a3:c3:07:8e,0080A3C3078E,00204A839PQHG5CW5O53JNACT9RLMZY9,sysadmin,PASS
LPM will attempt to log in to each device in the .CSV file as follows:
- LPM will attempt to log in using the provided
username
andpassword
. - If
username
orpassword
is not provided, LPM will attempt to log in using the last 8 characters of thedeviceid
as the password. - If login using the provided
username
andpassword
fails, LPM will use the last 8 characters of thedeviceid
as the password.
.TDI credentials file contents
The first line of the .TDI file should be the version number. The second line should be serial_num,device_id,device_key,device_name,device_description
. Each subsequent line should follow the pattern with one device per line.
For example:
version:2
serial_num,device_id,device_key,device_name,device_description
0080A3A5425C,00204AKW08AH60EOZZ3S21G3XFS0Y3ET,,EDS-MD8,Lantronix EDS-MD8
0080A3C3078E,00204A839PGHQ5CW5O53JNACTC4NVWEO,,SLC8000_078e,SLC8000 Advanced Console Manager
LPM will attempt to log in to each device in the .TDI file using the last 8 characters of the device_id
as the password.
Global Credentials¶
Click the edit button to configure the global credentials LPM uses to authenticate all devices if a credentials file has not been uploaded; see Important Information on Device Credentials for more information. Click Save or press Enter to save the settings.
Setting | Description |
---|---|
Username | Username used to authenticate the devices. |
Password | Password used to authenticate the devices. |
Server Settings¶
Click the edit button to configure the SFTP/FTP server settings for downloading and transferring configuration and firmware files to OOB devices. You can configure LPM to use an external SFTP server, an external FTP server, or allow LPM to function as an SFTP server to download the files.
Note
An SFTP or FTP server is only necessary when working with OOB devices.
Setting | Description |
---|---|
Server Type | Select either SFTP or FTP. If you select SFTP, you can use either an external SFTP server, or allow LPM to act as the SFTP server. If you select FTP, you must use an external FTP server. For the external server options, complete the Server IP Address, Username, Password, and Path fields as required. |
Built-In Server | (Selectable if Server Type is SFTP) If this option is checked, LPM acts as an SFTP server. This allows you to browse for configuration and firmware files on your local computer to send to devices. For the external server options, complete the Server IP Address, Username, Password, and Path fields as required. (If Built-In Server is enabled you do not need to configure any of the fields below.) |
Server IP Address | IP address of the SFTP/FTP server. |
Username | Username used to authenticate to the SFTP/FTP server. |
Password | Password used to authenticate to the SFTP/FTP server. |
Path | The path to a folder on the server in which the firmware and configuration files are stored. This field is only used when Built-In Server is unchecked. |
Sudo Password | (macOS/Linux only) The sudo password required. This option is required if Built-in Server is checked. |
Log¶
Configure Log Settings to choose the level of detail shown when Viewing Log Files.
Setting | Description |
---|---|
Log Level | Choices are Info and Debug; Debug displays additional information. |
Provisioning Configurations¶
Click the edit button to specify the Percepxion server settings. Click Save or press Enter to save the settings.
Setting | Description |
---|---|
Central Management Server Hostname | Hostname of the Percepxion, for example "percepxion.ai". |
Project Admin Credentials | Username and password used to log in to the Project Admin portal to import a device into a Percepxion project. |
Organization Admin Credentials | Username, password, portal, and organization used to log in to Percepxion with an organization admin or Percepxion admin account. Percepxion admins should provide their credentials here. Use the LocalAdmin checkbox to indicate if the provided organization admin credentials are used for local or remote (LDAP, RADIUS, TACACS+, SAML) authentication. If checked, the provided credentials will be used for local authentication; if unchecked, the credentials are used for remote authentication. |
Provision Type | The Percepxion deployment model, can be cloud or on-premise. |
Network Settings¶
Click the edit button to configure the IP Range(s) to scan for devices. Use the Interface List to select the network interface LPM will use. LPM scans the current subnet on all network ports for devices and the specified IP ranges, if set. Larger ranges take longer to scan and could result in timeout. See Timeouts and Retries below to configure timeouts and retries. Click Save or press Enter to save the settings.
Setting | Description |
---|---|
Unicast IP Range | The range of unicast IP addresses that LPM will scan to detect devices. Please write each IP range as "start_range-end_range", with each range on its own line. You may find that copying and pasting the IP ranges is less prone to error than typing them into the field. The range should be on the last byte of the IP address. Example syntax: 192.168.50.2-192.168.50.254 172.19.100.100-172.19.100.255 |
Interface List | The network interface used by LPM to scan for devices. An individual interface can be selected, or all interfaces can be selected. |
Number of Parallel Firmware Upgrades¶
Click the edit button to configure the number of firmware upgrades to perform at the same time. Click Save or press Enter to save the setting.
Timeouts and Retries¶
Click the edit button next to each of the settings you wish to change. Configure the timeouts in seconds of LPM actions and the maximum number of retries. Click Save or press Enter to save the setting.
Setting | Description |
---|---|
Firmware Upload Timeout | Number of seconds to wait during a firmware upload before the operation is considered to have failed. |
Discovery Timeout | Number of seconds to discover devices. |
Connection Timeout | Number of seconds that the connection to a device should timeout. This excludes device discovery and firmware upload. |
Operation Max Retries | Maximum number of times LPM will retry an operation. |