scp2

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

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 32.6.1 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 ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, X690, and X695 series switches.