remote-devices

Prev Next

remote-devices add

remote-devices add - Add a new remote device to the span of control of the Sensor Control. The remote units can then be discovered using the discovery related commands.

Description:
Allows remote devices to be added to the span of control of the Sensor Control manually. Adding remote devices provides the Sensor Control with the information (e.g. MAC address/Security key association) required to establish a secured management session between the Sensor Control and the remote device. Once the remote device is added, the Sensor Control must be authorized to manage the device.

Syntax:

  remote-devices add device-name <name> {
    {device-mac-addr <mac-addr>} |
    {device-security-key <key>}  |
    {authorize <yes|no>} |
    {connect <yes|no>} |
    {extra-reconnection-delay <enable|disable>} |
    {type <string>} |
    {layer2-interface <if-name>} |
    {destination-ip <ip>} |
    {tun-tcp-port <1-65534> } |
    {tun-dscp <0-63> } |
    {flex-monitor <enable|disable>} |
    {override-config <yes>} |
    {tun-ip <ip>} }+

  <name>     = <string>
  <mac-addr> = <string in MAC address format (e.g. xx:xx:xx:xx:xx:xx)>
  <key>      = <string in security key format (e.g. xx:xx:...:xx:xx)>
  <if-name>  = <string>

Parameters:

Parameter Description
device-name The assigned remote device name. This becomes the device-name used in other commands.
filename Unique filename containing the list of remote devices to add.
device-mac-addr The MAC address tied to the single remote device to add.
device-security-key The security key tied to the single remote device to add.
authorize (DEPRECATED) Authorization for the VCX Controller to manage the remote device(s).
connect Connection for the VCX Controller to manage the remote device(s).
extra-reconnection-delay Enable or disable the increased reconnection delay with the remote device.
type The type of the remote device. This is used to limit the device capabilities in pre-provisioning mode.
layer2-interface The layer-2 interface used to reach the remote device. This mandatory parameter is ignored when IPAD or ACP Layer-2 network delivery mode is used.
destination-ip The IPv4 address used to reach the remote device. This mandatory parameter is ignored when IPAD or ACP Layer-2 network delivery mode is used.
tun-tcp-port TCP port to use for the tunnel with the remote device.
tun-dscp DSCP value to use for the tunnel with the remote device.
flex-monitor Enable or disable the FlexMonitor on the remote device(s).
override-config Confirm to override remote-device persistent configuration.
tun-ip The tunnel IP address used in NFV tunnel and flow broker to create TCP connection through a NAT. This IP address has precedence over any other configured IP addresses.

remote-devices add import

remote-devices add import- Import a list of remote devices to the span of control of the Sensor Control. The remote units can then be discovered using the discovery-related commands.

Description:
Allows remote devices to be added to the span of control of the Sensor Control through a file containing a list of remote devices. Adding remote devices provides the Sensor Control with the information (e.g. MAC address/Security key association) required to establish a secured management session between the Sensor Control and the remote device. Once the remote devices are added, the Sensor Control must be authorized to manage the device.

Syntax:

  remote-devices add import
                 {http | tftp | ftp | sftp}://[<user-name>:<password>@]<url>

Examples:

  remote-devices add import http://mypc.com/remote_devices.csv
  remote-devices add import ftp://username:password@mypc.com/remote_devices.csv

Parameters:

Parameter Description
<user-name> <string>
<password> <string>
<url> <string>
The URL host subcomponent consists of a name or an IP address.
IPv4 addresses must be in dot-decimal notation, and IPv6 addresses must be enclosed in brackets ([]).

remote-devices authorize-all (DEPRECATED)

Deprecated Command

This command is deprecated. authorize-all is replaced by connect-all

remote-devices authorize-all - Authorize the management of all remote devices already added to the system by the Sensor Control.

Description:
Authorize all previously added remote devices. The Sensor Control will be authorized to manage them.

Syntax:

  remote-devices authorize-all

remote-devices connect-all

remote-devices connect-all - Connect all remote devices that are currently present on the Sensor Control.

Description:
Connect all remote devices that are currently present on the Sensor Control.

Syntax:

  remote-devices connect-all

remote-devices delete

remote-devices delete - Delete a remote device or a list of remote devices from the span of control of the Sensor Control.

Description:
Remote devices can be deleted from the span of control of the Sensor Control. The user can either specify one remote device or all of them so the user can modify the information related to each if ever needed.

Syntax:

  remote-devices delete {{device-name <name>} | all}

  <name> = <string>

Parameters:

Parameter Description
device-name Name of the remote device to be deleted from the span of control.
all All remote devices already added to the system are to be deleted from the span of control of the Sensor Control.

remote-devices deny-all (DEPRECATED)

Deprecated Command

This command is deprecated. deny-all is replaced by disconnect-all.

remote-devices deny-all - Deny the management of all remote devices already added to the system by the Sensor Control.

Description:
Deny all previously added remote devices. The Sensor Control will not be authorized to manage them.

Syntax:

  remote-devices deny-all

remote-devices disconnect-all

remote-devices disconnect-all - Disconnect all remote devices that are currently present on the Sensor Control.

Description:
Disconnect all remote devices that are currently present on the Sensor Control.

Syntax:

  remote-devices disconnect-all

remote-devices edit

remote-devices edit context - Set context on a remote device.

Description:
Set a remote device context. All CFM commands are contextual and will be applied to the selected remote device.

Syntax:

  remote-devices edit context <device-name>

Parameters:

Parameter Description
<device-name> <string>

OR

remote-devices edit - Edit the parameters needed to have a remote device within an Sensor Control's span of control.

Description:
Some attributes tied to remote devices can be edited so the span of control of the Sensor Control can take into consideration those attributes. The attributes are information (e.g. MAC address/Security key association) required to establish a secured management session between the Sensor Control and the remote device.

Syntax:

  remote-devices edit <device-name <name>> {
    {name <dev-name>}    |
    {device-mac-addr <mac-addr>} |
    {device-security-key <key>}  |
    {authorize <yes|no>} |
    {connect <yes|no>} |
    {admin-state <in-service|out-of-service>} |
    {in-service-feature-set <pmon|tgen>} |
    {feature-suites <suite-name> [force]} |
    {extra-reconnection-delay <enable|disable>} |
    {switch-back-delay <seconds>} |
    {type <string>  |
    {layer2-interface <if-name>} |
    {destination-ip <ip>} |
    {tun-tcp-port <1-65534> } |
    {tun-dscp <0-63> }
    {flex-monitor <enable|disable>} |
    {override-config <yes>} |
    {default-traffic-fwd <permit|drop>} |
    {tun-ip <ip>} }+

  <name>       = <string>
  <dev-name>   = <string>
  <mac-addr>   = <string in MAC address format (e.g. xx:xx:xx:xx:xx:xx)>
  <key>        = <string in security key format (e.g. xx:xx:...:xx:xx)>
  <suite-name> = <string>
  <seconds>    = <decimal>
  <if-name>    = <string>

Parameters:

Parameter Description
device-name The remote device's name for which attributes must be edited.
name New name to be assigned to the remote device (Max 25 characters).
device-mac-addr The MAC address tied to the single remote device to add.
device-security-key The security key tied to the single remote device to add.
authorize (DEPRECATED) Authorization for the VCX Controller to manage the remote device.
connect Connection for the VCX Controller to manage the remote device.
admin-state Administrative state of the remote device. When in service, the remote device is locked to the in-service feature set. On out-of-service, a loss of traffic can occur.
in-service-feature-set The feature set that will become active when the administrative state is in service.
feature-suites The active feature suite on the device.
extra-reconnection-delay Enable or disable the increased reconnection delay with the remote device.
switch-to-in-service-delay The delay in seconds before switching to in-service admin-state. The timer starts once the SAT test has completed. When the delay elapses, the device will switch to the in-service admin state. A delay of 0 sec disables the switch. This feature is only available in out-of-service admin state.
type The type of the remote device. This is used to limit the device capabilities in pre-provisioning mode.
layer2-interface The layer-2 interface used to reach the remote device. This mandatory parameter is ignored when IPAD/ACP Layer-2 network delivery mode is used.
destination-ip The IPv4 address used to reach the remote device. This mandatory parameter is ignored when IPAD or ACP Layer-2 network delivery mode is used.
tun-tcp-port TCP port to use for the tunnel with the remote device.
tun-dscp DSCP value to use for the tunnel with the remote device.
flex-monitor Enable or disable the FlexMonitor on the remote device(s).
override-config Confirm to override remote-device persistent configuration.
default-traffic-fwd Select how incoming traffic will be processed at the device's power-on stage: either permit: forwarded to the other port, or drop: dropped traffic instead of forwarding. The default setting is permit.
tun-ip The tunnel IP address used in NFV tunnel and flow broker to create a TCP connection through a NAT. This IP address has precedence over any other configured IP addresses.
force Allow forcing the upgrade of a remote device, uniquely used for support purposes.

IMPORTANT: dropping traffic at a remote device (instead of forwarding) will impact the interaction between the Sensor Control and all other remote devices downstream from this current device.

remote-devices edit context

remote-devices edit context - Select a remote device context

Description:
Set the current command context to the specified device. Subsequent commands will be performed only on the selected device instead of on all devices.

Syntax:

  remote-devices edit context [<dev-name> | None]

  <dev-name>   = <string> 

Parameters:

Parameter Description
dev-name The name of the selected remote device.
None Remove the current device context.

remote-devices factory-reset

factory-reset - factory reset the remote device

Description:
The factory-reset command allows you to factory reset the remote device, and a confirmation message will be shown (except in cases where users add the force option).

Syntax:

  remote-devices factory-reset <device-name>

remote-devices firmware

remote-devices firmware - Manage a remote device's firmware.

Description:
Use this command to manage the firmware load present on a remote device.

Syntax:

  remote-devices firmware {cancel <device-name>}

  <device-name> = <string>

Parameters:

Parameter Description
cancel Aborts the current update operation; the active feature suite is unchanged. Cancelling a feature update is not traffic affecting.

remote-devices override-config-all

remote-devices override-config-all - Confirm the override of all remote devices already added to the system by the Sensor Control.

Description:
Confirm all previously added remote devices. The Sensor Control will be allowed to override remote-device persistent configuration.

Syntax:

  remote-devices override-config-all

remote-devices reboot

remote-devices reboot - Reboot a remote device

Description:
Reboots the remote device within the span of control of the Sensor Control, removes the non-persistent configuration from the module and restarts the remote device. All non-persistent configurations are discarded by the module. However, after the reboot, the Sensor Control reapplies many non-persistent configurations back to the device. Persistent configurations (such as interface, policies and TWAMP stateful) are maintained.

Note: The device "Linked" state must be "Yes".

Syntax:

  remote-devices reboot <device-name>

  <device-name> = <string>

Parameters:

Parameter Description
device-name Name of the remote device to be rebooted.

remote-devices reboot-delete

remote-devices reboot-delete - Reboot a remote device and then delete it

Description:
Deletes and reboots the device within the span of control of the Sensor Control. All non-persistent configurations are discarded. Persistent configurations (such as interface, policies and TWAMP stateful) are maintained. After the reboot, the device is removed from the span of control of the Sensor Control.

Syntax:

  remote-devices reboot-delete <device-name>

  <device-name> = <string>

Parameters:

Parameter Description
device-name Name of the remote device to be rebooted.

remote-devices show

remote-devices show [[-d] | [<device-name>] [-d]]
remote-devices show context
remote-devices show feature-set
remote-devices show feature-suites
remote-devices show chassis
remote-devices show logs

Description:
Without an argument or a sub-command, displays the list of all associated remote devices in a table format. When a device name is specified, displays the detailed configuration and status of that device.

With a sub-command, shows a related group of configuration and status information for remote-devices:

  • remote-devices show context - Show the currently selected remote device
  • remote-devices show feature-set - Show the current feature-sets
  • remote-devices show feature-suites - Show the available feature-suites
  • remote-devices show chassis - Show the current chassis information
  • remote-devices show logs - Show field support logs

See the help texts for the associated sub-commands for more details.

Syntax:

  remote-devices show [[-d] | [<device-name>] [-d]]

  <device-name> = <string>

Parameters:

Parameter Description
device-name Name of the remote device for which configuration details are to be shown.
-d Used to enable an alternate display.

Output:

remote-devices show

Instance Remote Device Name             MAC address       Linked       Auth Admin State State
-------- ------------------------------ ----------------- ------------ ---- ----------- ------------
       1 P130-0016                      00:15:AD:44:60:0A Yes          Yes  OOS         Managed
       2 P130-0021                      00:15:AD:44:60:18 Yes          Yes  OOS         Managed

remote-devices show P130-0016

Remote Device Name              : P130-0016
Serial Number                   : P130-0016
MAC address                     : 00:15:AD:44:60:0A
Security Key                    :
Linked                          : Yes
Type                            : Nano 2 Optical
Authorized                      : Yes
Admin State                     : Out-of-service
Extra reconnection delay        : Enabled
Switch to in-service delay      : 0
Tunnel TCP port                 : 44240
Tunnel DSCP                     : 0
FlexMonitor                     : Disabled
Override-config                 : Yes
Default traffic forwarding      : Permit

Static Entry                    : Disabled
    Layer-2 Interface           : None
    Destination IP              : 0.0.0.0

Discovery VLAN                  : C-VLAN:471
Discovery VCX MAC               : 52:54:00:72:1A:5E
Discovery VCX IP                : ---
Discovery Destination MAC       : 00:15:AD:44:60:0A
Discovery Destination IP        : ---
Instance                        : 1
Connect                         : Yes
State                           : Managed
State Description               :
Management IP address           : ---
Tunnel IP address               : 172.1.0.1
Vendor                          : Accedian
CLEI code                       : SUIVAHDMAA
UDI                             : ---

remote-devices show chassis

remote-devices show chassis [<device-name>] - Show information on power supplies, temperature sensors and fan speed of remote devices

Description:
Without an argument, displays a summary in table format of current status of DC power supplies, temperature sensors and fan speeds of all associated GEN2 remote-devices. When a device name is specified, displays the current reading from that device of power supplies, temperature sensors and fan speeds, along with the status of environmental alarms associated with these sensors (when the sensors are available on the device).

Syntax:

  remote-devices show chassis [<device-name>]

  <device-name> = <string>

Parameters:

Parameter Description
device-name Name of the remote device for which chassis sensor details are to be shown.

remote-devices show context

remote-devices show context - Show the remote device context

Description:
Show the currently selected device context

Syntax:

  remote-devices show context

Output:

Selected context : A800-0123
or
Selected context : None

remote-devices show feature-set

remote-devices show feature-set [[-d] | [<device-name>] [-d]] - Show the current feature-set of the remote-devices

Description:
Without an argument, displays a summary in table format of the current administrative state and the active feature-set of all associated remote devices. When a device name is specified, displays the current administrative state and the active feature-set of that device.

Syntax:

  remote-devices show feature-set [[-d] | [<device-name>] [-d]]

  <device-name> = <string>

Parameters:

Parameter Description
device-name Name of the remote device for which feature-set details are to be shown.
-d Used to enable an alternate display.

remote-devices show feature-suites

remote-devices show feature-suites [<device-name>] - Show information of feature-suites associated with remote-devices

Description:
Without an argument, displays a summary in table format of the feature-suites currently selected on associated remote-devices. When a device name is specified, displays the current feature-suite selected for that remote device along with the update status of the selected feature-suite.

Syntax:

  remote-devices show feature-suite [<device-name>]

  <device-name> = <string>

Parameters:

Parameter Description
device-name Name of the remote device for which feature-suite details are to be shown.

remote-devices show logs

remote-devices show logs [<device-name>] - Print field support logs

Description:
Display a listing of field support logs associated with the remote device that has been collected up to now.

Syntax:

  remote-devices show logs [<device-name>]

  <device-name> = <string>

Parameters:

Parameter Description
device-name Name of the remote device for which field support logs are to be displayed.

© 2025 Cisco and/or its affiliates. All rights reserved.

For more information about trademarks, please visit: Cisco trademarks
For more information about legal terms, please visit: Cisco legal terms

For legal information about Accedian Skylight products, please visit: Accedian legal terms and trademarks