revert
Purpose
Sets a particular group of a devices’ settings to its default values. Only one settings-group keyword can be specified per revert command. That is, entering several keywords on a single command to revert multiple settings is not allowed. A revert all command reverts all device settings but network, security, and host key/certificate settings.
Entering revert user, revert group, or revert permissions, displays a message indicating that those settings cannot be reverted individually, and instead must be reverted all together at the same time via the revert auth command. The revert auth command (revert authentication and authorization) reverts all users, all groups, and all permissions at the same time.
Required permissions
The only set permissions requirement is for the revert all command variant. Permissions used by the various set commands apply to the various revert command variants. revert all uses a different mechanism that bypasses the individual set commands, and therefore has its own permissions. To execute the revert all command, a user must have permissions set to set permissions revert‑all=execute. See set permissions for details on setting user permissions for commands.
Syntax
revert [settings group option]
where [settings group option] is one of the following keywords:
[all|
accesscontrol|
alarm|
auth|
autoconnect [port=range]|
buffer [port=range]|
camera|
clocksource [range=1-5]|
dcloud_msgservice|
ddns|
devicesecurity|
dhcpserver|
dialserv [port=range]|
dirp [range=1-20]|
dnsproxy|
ekahau|
failover|
forwarding|
geofence [index=1-16]|
gpio|
host|
hostlist|
ia|
login| mgmtconnection|
mgmtglobal|
mgmtnetwork|
mobile [index=1-2]|
mobileppp [index=1-2]|
nat [instance=1-8]|
network {all|globalsettings|interface=comma-separated list of interface names]}|
orbcomm|
passthrough|
pmodem [port=range]|
position|
ppp [port=1-5]|
profile [port=range]|
putty|
python range=1-4|
realport|
scancloak|
serial [port=range]|
service|
sharing [port=range]|
slideshow|
smscell{global|scl|python|command|all}
snmp|
socket_tunnel|
surelink [index=1-2]|
switches|
system|
tcpserial [port=range]|
term [port=range]|
trace|
time|
timemgmt
udpserial [port=range]|
video|
vncclient|
vpn {all|global|tunnel|phase1|phase2}|
vrrp [index=1-8]|
user (valid for single-user model devices only)
wimax|
wlan|
xbee
Options
Reverts all settings except these:
- Network settings
- Security settings (passwords and suppress login)
- Host key/certificate settings.
Reverts the access control settings configured by the set accesscontrol command.
Reverts the alarm settings configured by the set alarm command.
Reverts the permission settings configured by the set permissions command, the user settings configured by the set user command, and group settings, configured by the set group command.
This option is not available in Digi devices that implement the single-user model; see User Models and User Permissions in Digi devices for more information on user models.
Reverts the Autoconnect settings configured by the set autoconnect command.
port=range
The serial port to which the autoconnect settings apply.
Reverts the port-buffering settings configured by the set buffer command.
port=range
The port or ports to which the revert command applies.
Reverts the camera settings configured by the set camera command.
clocksource [range=1-5]
Reverts the settings configured by the set clocksource command.
range=1-5
The time source entry for which settings are reverted.
Reverts the Remote Manager SMS settings configured by the set dcloud_msgservice command.
Reverts the Dynamic DNS (DDNS) settings configured by the set ddns command.
Reverts the Remote Manager device security settings to their factory defaults.
Reverts the DHCP server settings configured by the set dhcpserver command.
Reverts the Dialserv settings configured by the set dialserv command.
port=range
The port or ports for which the DialServ settings are reverted. If not specified, all settings are reverted.
Reverts the device-initiated RealPort settings configured by the set dirp command.
range=1-20
Specifies which Device-Initiated RealPort connections are to be reverted. If not specified, all connections are reverted.
Reverts the DNS proxy settings configured by the set dnsproxy command.
Reverts the Ekahau client settings configured by the set ekahau command.
Reverts the IP network failover settings configured by the set failover command.
Reverts the port-forwarding settings configured by the set forwarding command.
Reverts the geofence/GPS settings configured by the set geofence command.
index=1-16
The index number for the geofence. If not specified, all geofence settings are reverted.
Reverts the GPIO settings configured by the set gpio command.
Reverts the host name set by the set host command.
Reverts the host settings configured by the set hostlist command.
Reverts the Industrial Automation (IA) settings configured by the set ia command.
Reverts the login settings configured by the set login command.
Reverts the Remote Manager connection settings configured by the set mgmtconnection command.
Reverts the Remote Manager global settings configured by the set mgmtglobal command.
Reverts the Remote Manager network settings configured by the set mgmtnetwork command.
Reverts the mobile settings configured by the set mobile command.
index=1-2
The slot number of the SIM card. Required on dual-SIM devices. Enter set mobile without options to display these index numbers and primary and secondary SIM card designations.
Reverts the mobile PPP connection settings configured by the set mobileppp command.
index=1-2
The index number of the SIM used for the mobile PPP connection. Enter set mobileppp without options to display these index numbers and primary and secondary SIM card designations.
Reverts the Network Address Translation (NAT) and port/protocol forwarding settings configured by the set nat command.
instance=1-8
The NAT instance to which the revert command applies. If an instance is not specified, all instances will be reverted.
network {all|globalsettings|interface=comma separated list of interface names]}
Reverts these settings:
- Ethernet settings, configured by the set ethernet command.
- Network settings, configured by the set network command.
- Wireless configuration settings, configured by the set wlan command.
revert network all
Reverts settings for all interfaces to default settings.
revert network globalsettings
Reverts the global network settings. See set network for details on these options.
Note The global settings include the TCP options. Reverting the TCP options does not affect existing connections. TCP service listeners continue to use the previous option values until the service is restarted or a reboot is performed.
revert network interface=comma-separated list of interface names
Reverts the interface-specific network settings for the specified interfaces. The interface option can be abbreviated as if.
revert network
revert network with no options is equivalent to revert network all.
Reverts the ORBCOMM satellite settings configured by the set orbcomm command.
Reverts the IP pass-through settings configured by the set passthrough command.
Reverts the modem emulation settings, configured by the set pmodem command.
[port=range]
The serial port for which modem emulation settings are reverted. Optional on a single-port device.
Reverts the position settings configured by the set position command.
Reverts the Point-to-Point Protocol (PPP) outbound connection settings, configured by the set ppp command.
port=1-5
The physical interface to which the revert command applies.
Reverts the profile settings configured by the set profile command.
port=range
The serial port number or range of serial ports for which profile settings are reverted.
Reverts the terminal emulation settings configured by the set putty command.
Reverts the Python program settings configured by the set_python command.
range=1-4
The index or indices of the Python instance to be reverted. To view the indices, enter set python with no options.
Reverts the Realport settings configured by the set realport command.
Reverts the network port scan cloaking settings configured by the set scancloak command.
Reverts the serial, RCI serial, and RTS toggle settings configured by the set serial, set rciserial, and set rtstoggle commands.
port=range
The serial port for which settings are to be reverted.
Reverts the service settings configured by the set service command.
Reverts the port-sharing settings configured by the set sharing command.
[port=range]
The serial port for which port-sharing settings are to be reverted.
Reverts the slideshow feature for displaying images from a USB storage device configured by the set slideshow command.
smscell {global|scl|python|command|all}
Reverts the SMS settings configured by the set smscell command. One or more settings groups can be specified. If no group is specified, all is assumed. Settings groups are:
global
Revert global SMS settings.
scl
Revert Sender Control List SMS settings.
python
Revert Python SMS settings.
command
Revert command SMS settings.
all
Revert all SMS settings (default).
Reverts the SNMP settings configured by the set snmp command.
Reverts the socket tunnel settings configured by the set socket_tunnel command.
Reverts the Digi SureLink™ settings configured by the set surelink command.
index=1-2
The index number of the SIM to which the hardware reset threshold settings apply. Enter set surelink without options to display these index numbers and primary and secondary SIM card designations.
Reverts the Multiple Electrical Interface (MEI) switch settings configured by the set switches command.
Reverts the system settings configured by the set system command.
Reverts the TCP serial settings configured by the set tcpserial command.
port=range
The serial port for which TCP serial settings are to be reverted.
Reverts the terminal connection settings configured by the set term command.
port=range
The serial port for which terminal connection settings are to be reverted.
Reverts the time settings configured by the set time command.
Reverts the time management settings configured by the set timemgmt command.
Reverts the trace settings configured by the set trace command.
udpserial [port=range]
Reverts the UDP serial settings configured by the set udpserial command.
port=range
The serial port for which UDP serial settings are to be reverted.
Reverts the user settings configured by the set user command.
This option is valid for Digi devices that implement the single-user model only. See "User Models and User Permissions in Digi devices" on page 13 for more information on user models.The two-or-more-user model reverts users via the revert auth command.
Reverts the video settings configured by the set video command.
Reverts the settings configured by the set vncclient command.
port=range
The serial port for which VNC client settings are to be reverted.
vpn {all|global|tunnel|phase1|phase2}
Reverts the Virtual Private Network (VPN) settings configured by the set vpn command. Keyword options allow for reverting all or selected VPN settings. See set vpn for descriptions of the settings.
all
Reverts all VPN settings.
global
Reverts global VPN options.
tunnel
Reverts VPN tunnel settings.
phase1
Reverts Internet Key Exchange (IKE)/Internet Security Association and Key Management Protocol (ISAKMP) Security Association (SA) Phase 1 options.
phase2
Reverts IKE/ISAKMP SA Phase 2 options.
Reverts the Virtual Router Redundancy Protocol (VRRP) settings configured by the set vrrp command.
index=1-8
The index number for the virtual router for which settings are to be reverted. Enter a set vrrp command without options to display index numbers.
Reverts the WiMAX radio settings configured by the set wimax command.
Reverts the wireless settings configured by the set wlan command.
xbee
Reverts the XBee RF module settings configured by the set xbee command.
Examples
Reset a device’s serial setting
The device serial setting is reset to the default serial configuration.
#> revert serial
Reset a serial port to default settings
#> revert serial port=2
PDF
