scp2

scp2 {cipher cipher} {mac mac} {compression [on | off]} {port portnum} {vr vr_name} user [hostname | ipaddress]:remote_file local_file

or

scp2 {cipher cipher} {macmac} {compression [on | off]} {port portnum} {vr vr_name} local_file user [hostname | ipaddress]:remote_file

Description

The first command initiates an SCP2 client session to a remote SCP2 server and copies a configuration or policy file from the remote system to the switch.

The second command initiates an SCP2 client session to a remote SCP2 server and copies a configuration or policy file from the switch to a remote system.

Syntax Description

vr_name

Specifies the virtual router. The default virtual router is VR-Mgmt.

Note: User-created VRs are supported only on the platforms listed for this feature in the ExtremeXOS 30.7 Feature License Requirements document.
cipher Specifies the name of the cipher.
Possible values are:
  • 3des-cbc
  • aes128-cbc
  • aes128-ctr
  • aes192-cbc
  • aes192-ctr
  • aes256-cbc
  • aes256-ctr
  • chacha20-poly1305@openssh.com
  • rijndael-cbc@lysator.liu.se
mac Specifies the name of the Message Authentication Code.
Possible values are:
  • hmac-md5
  • hmac-md5-96
  • hmac-md5-96-etm@openssh.com
  • hmac-md5-etm@openssh.com
  • hmac-sha1
  • hmac-sha1-96
  • hmac-sha1-96-etm@openssh.com
  • hmac-sha1-etm@openssh.com
  • hmac-sha2-256
  • hmac-sha2-256-etm@openssh.com
  • hmac-sha2-512
  • hmac-sha2-512-etm@openssh.com
on Specifies that the data is to be compressed.
off Specifies that compression is not to be used. This is the default.
portnum Specifies the TCP port number to be used for communicating with the SSH2 client. The default is port 22.
user Specifies a login name for the remote host.
hostname Specifies the name of the remote host.
ipaddress Specifies the IP address of the remote host.
Note: For IPv6 addresses, use square brackets.
remote_file Specifies the name of the remote file (configuration file, policy file, image file, public key file) to be transferred.
local_file Specifies the name of the local file (configuration file, policy file, image file, public key file) to be transferred.

Default

The default settings for SSH2 parameters are as follows:
  • cipher—the full cipher list
  • mac—the full Message Authentication Code list
  • port—22
  • compression—off
  • vr_name—VR-Mgmt

Usage Guidelines

SSH2 does not need to be enabled on the switch in order to use this command.

This command logs into the remote host as user and accesses the file remote_file. You will be prompted for a password from the remote host, if required.

Host Name, User Name, and Remote IP Address Character Restrictions

This section provides information about the characters supported by the switch for host names and remote IP addresses.

When specifying a host name, user name, or remote IP address, the switch permits only the following characters:
  • Alphabetical letters, upper case and lower case (A-Z, a-z)
  • Numerals (0-9)
  • Period ( . )
  • Dash ( - ) Permitted for host and user names
  • Underscore ( _ ) Permitted for host and user names
  • Colon ( : )
  • At symbol ( @ ). Permitted only for user names
  • Slash ( / ). Permitted only for user names

When naming the host, creating a user name, or configuring the IP address, remember the requirements listed above.

Remote Filename Character Restrictions

This section provides information about the characters supported by the switch for remote filenames.

When specifying a remote filename, the switch permits only the following characters:
  • Alphabetical letters, upper case and lower case (A-Z, a-z)
  • Numerals (0-9)
  • Period ( . )
  • Dash ( - )
  • Underscore ( _ )
  • Slash ( / )

When naming a remote file, remember the requirements listed above.

Example

The following command copies the configuration file test.cfg on host system1 to the switch:

# scp2 admin@system1:test.cfg localtest.cfg

The following command copies the configuration file engineering.cfg from the switch to host system1:

# scp2 engineering.cfg admin@system1:engineering.cfg

The following command copies the file Anna5.xsf from the default virtual router to 150.132.82.140:

# scp2 vr vr-default Anna5.xsf root@150.132.82.140:Anna5.xsf
Upload /config/Anna5.xsf to
Connecting to 150.132.82.140...

History

This command was first available in ExtremeXOS 11.2.

Changes to cipher, as well as the addition of mac and compression, were first available in ExtremeXOS 15.7.1.

Ciphers and MACs that are unsupported in OpenSSH 8.1p1 were removed in ExtremeXOS 30.7.

Platform Availability

This command is available on the ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, X670-G2, X690, X695, and X870 series switches.