Page 586 / 757 Scroll up to view Page 581 - 585
xStack
®
DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
582
75
REMOTE COPY PROTOCOL (RCP) COMMANDS
RCP is a UNIX Remote Shell service which allows files to be copied between a server and client. RCP is an application
that operates above the TCP protocols, and uses port number 514 as the TCP destination port.
The RCP application uses client server architecture and the client can be any machine running the RCP client
application.
A Switch that supports the RCP client allows users to copy firmware images, configurations and log files between the
Switch and RCP Server.
Switches that do not support a file system should still be able to run an RCP client to copy firmware images,
configurations and logs between the switch and RCP server.
The Remote Copy Protocol (RCP) commands in the Command Line Interface (CLI) are listed (along with the appropriate
parameters) in the following table.
Command
Parameters
config rcp server
{ipaddress <ipaddr> | username <username 15>}
config rcp server clear
[ipaddr | username | both]
show rcp server
download firmware_fromRCP
[{ username <username 15>} {<ipaddr>} src_file <path_filename 64> |rcp:<string
128>] {unit [<unit_id 1-12> | all]} {dest_file <pathname 64>} {boot_up}
upload firmware_toRCP
[{ username <username 15>}{<ipaddr>} dest_file <path_filename 64>
|rcp:<string 128>] {src_file <pathname 64>}
download cfg_fromRCP
[{ username <username 15>} {<ipaddr>} src_file <path_filename 64> |rcp:<string
128>] {dest_file <pathname 64>}
upload cfg_toRCP
[{ username <username 15>}{<ipaddr>} dest_file <path_filename 64>
|rcp:<string 128>] {src_file <pathname 64>} {[include | exclude | begin]
<filter_string 80> {<filter_string 80>{<filter_string 80>}} {[include | exclude |
begin] <filter_string 80> {<filter_string 80> {<filter_string 80>}} {[include | exclude
| begin] <filter_string 80> {<filter_string 80> {<filter_string 80>}}}}}
upload log_toRCP
[{ username <username 15>}{<ipaddr>} dest_file <path_filename 64>
|rcp:<string 128>]
upload attack_log_toRCP
[{ username <username 15>}{<ipaddr>} dest_file <path_filename 64>
|rcp:<string 128>] {unit <unit_id 1-12>}
Each command is listed, in detail, in the following sections.
config rcp server
Purpose
Configure the global RCP server information.
Syntax
config rcp server {ipaddress <ipaddr> | username <username 15>}
Description
This command is used to configure the global RCP server information. This global RCP
Server setting can be used when the Server or remote user name is not specified.
ONLY one RCP server can be configured for each system.
If a user does not specify the RCP Server in the CLI command, and the global RCP Server
was not configured, the Switch will ask the user to input the Server IP address or remote user
name while executing the RCP commands.
Parameters
ipaddress
- The IP address of the global RCP Server. By default, the server is unspecified.
Page 587 / 757
xStack
®
DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
583
config rcp server
username
- The remote user name for logging into the global RCP Server. By default, the
global server’s remote user name is unspecified.
both
- Both the RCP Server IP address and remote user name.
Restrictions
Only Administrator level users can issue this command.
Example usage:
To configure the global RCP Server:
DGS-3627:admin# config rcp server ipaddress 172.18.212.106 username rcp_user
Command: config rcp server ipaddress 172.18.212.106 username rcp_user
Success.
DGS-3627:admin#
config rcp server clear
Purpose
This command is used to clear the RCP global server infomation.
Syntax
config rcp server clear [ipaddr | username | both]
Description
This command is used to configure the global RCP server information. This global RCP
Server setting can be used when the Server or remote user name is not specified.
ONLY one RCP server can be configured for each system.
If a user does not specify the RCP Server in the CLI command, and the global RCP Server
was not configured, the Switch will ask the user to input the Server IP address or remote user
name while executing the RCP commands.
Parameters
ipaddress
- The IP address of the global RCP Server. By default, the server is unspecified.
username
- The remote user name for logging into the global RCP Server. By default, the
global server’s remote user name is unspecified.
both
- Both the RCP Server IP address and remote user name.
Restrictions
Only Administrator level users can issue this command.
Example usage:
To configure the global RCP Server:
DGS-3627:admin# config rcp server clear username
Command: config rcp server clear username
Success.
DGS-3627:admin# config rcp server clear both
Command: config rcp server clear both
Success.
DGS-3627:admin#
show rcp server
Purpose
Used to display the global RCP server configured on the switch.
Page 588 / 757
xStack
®
DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
584
show rcp server
Syntax
show rcp server
Description
This command displays the global RCP server information.
Parameters
None.
Restrictions
Only Administrator level users can issue this command.
Example usage:
To display the global RCP Server configuration:
DGS-3627:admin# show rcp server
Command: show rcp server
RCP Server Address
: 172.18.64.43
RCP Server Username
: tld2
DGS-3627:admin#
download firmware_fromRCP
Purpose
This command is used to download the firmware from the RCP server.
Syntax
download firmware_fromRCP [{ username <username 15>} {<ipaddr>} src_file
<path_filename 64> |rcp:<string 128>] {unit [<unit_id 1-12> | all]} {dest_file <pathname
64>} {boot_up}
Description
This command is used to download a firmware image file from an RCP server.
Parameters
username
- The remote user name on the RCP Server.
ipaddr
- The IP address of the RCP server.
path_filename
- The pathname specifies the pathname on the RCP server or local.
Note:
If user specifies the relative file path, the path search strategy is depending on the
server system. For some system, will search the current user working directory firstly, then
the environment paths.
unit
- Specifies which unit on the stacking system. If it is not specified, it refers to the master
unit.
all
- When all is specified, the boot_up firmware image on all units will be updated.
boot_up
- Specifies it as a boot up file.
rcp: <string 128>
- Syntax: rcp: username@ipaddr/directory/filename
Example for FULL path: [email protected]/home/user_name/desxxxx.had
Example for relative path: [email protected]./desxxxx.had
Example for omitted user name in rcp string: 10.1.1.1./desxxxx.had.
Note:
No SPACE in the whole <string>.
Restrictions
Only Administrator level users can issue this command.
Example usage:
To download firmware from RCP:
Page 589 / 757
xStack
®
DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
585
DGS-3627:admin# download firmware_fromRCP username rcp_user
172.18.212.106 src_file
/home/DGS-3627.had
Command: download firmware_fromRCP username rcp_user
172.18.212.106 src_file /home/DGS-
3627.had
Connecting to server
...................
Done.
Download firmware
......................
Done.
Do not power off!
Please wait, programming flash
.........
Done.
Saving current settings to NV-RAM
......
Done.
DGS-3627:admin#
To download firmware form RCP using string:
DGS-3627:admin# download firmware_fromRCP rcp: [email protected]/home/rcp_user/DGS-
3627.had
Command: download firmware_fromRCP rcp: [email protected]/home/rcp_user/DGS-3627.had
Connecting to server
...................
Done.
Download firmware
......................
Done.
Do not power off!
Please wait, programming flash
.........
Done.
Saving current settings to NV-RAM
......
Done.
DGS-3627:admin#
To download firmware from RCP Server using rcp string without user name specified, and global RCP Server was not
configured:
DGS-3627:admin# download firmware_fromRCP rcp: 10.1.1.1.DGS-3627.had
Command: download firmware_fromRCP rcp: 10.1.1.1 DGS-3627.had
Using RCP Server Username
: rcp_user
Connecting to server
...................
Done.
Download firmware
......................
Done. Do not power off!
Please wait, programming flash
.........
Done.
Saving current settings to NV-RAM
......
Done.
DGS-3627:admin#
To download firmware from RCP using string on file system supported device:
DGS-3627:admin# download firmware_fromRCP rcp: [email protected] /home/DGS-3627.had
dest_file RUN26B18.had boot_up
Command: download firmware_fromRCP rcp: [email protected] /home/DGS-3627.had
dest_file RUN26B18.had boot_up
Connecting to server
...................
Done.
Download firmware
......................
Done.
Do not power off!
Please wait, programming flash
.........
Done.
Saving current settings to NV-RAM
......
Done.
Please wait, the switch is rebooting...
Page 590 / 757
xStack
®
DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual
586
To download firmware from RCP using global configured server:
DGS-3627:admin# download firmware_fromRCP src_file /home/DGS-3627.had dest_file
RUN26B18.had boot_up
Command: download firmware_fromRCP src_file /home/DGS-3627.had dest_file RUN26B18.had
boot_up
Using RCP Server IP: 172.18.212.106
Using RCP Server Username
: rcp_user
Connecting to server
...................
Done.
Download firmware
......................
Done.
Do not power off!
Please wait, programming flash
.........
Done.
Saving current settings to NV-RAM
......
Done.
Please wait, the switch is rebooting...
DGS-3627:admin#
To download firmware from RCP without specifies the RCP Server and remote user:
DGS-3627:admin# download firmware_fromRCP src_file /home/DGS-3627.had dest_file
RUN26B18.had boot_up
Command: download firmware_fromRCP src_file /home/DGS-3627.had dest_file RUN26B18.had
boot_up
No RCP Server IP Configured.
Would you like to specify a RCP Server IP
(N) 172.18.211.106
No RCP Server Username Configured
Would you like to specify a RCP Server Username
(N)
rcp_user
Connecting to server
...................
Done.
Download firmware
......................
Done.
Do not power off!
Please wait, programming flash
.........
Done.
Saving current settings to NV-RAM
......
Done.
Please wait, the switch is rebooting...
DGS-3627:admin#
To download firmware from RCP without specifies the RCP Server and remote user, and the global RCP server was not
configured:
DGS-3627:admin# download firmware_fromRCP src_file DGS-3627.had dest_file RUN26B18.had
Command: download firmware_fromRCP src_file DGS-3627.had dest_file RUN26B18.had
No RCP Server IP configured.
Would you like to specify a RCP Server IP?(N)
RCP: copy file aborted!
Fail!
DGS-3627:admin#
To download DGS-3627.had from Global RCP Server and save with default file path & name:

Rate

4.5 / 5 based on 2 votes.

Bookmark Our Site

Press Ctrl + D to add this site to your favorites!

Share
Top