You are here: Home > CLI Commands > Just_CLI_Topics > rename

rename

rename <filename> <newfilename>

Description

This command renames an existing system file.

Syntax

Parameter

Description

filename

An alphanumeric string that specifies the current name of the file on the system.

newfilename

An alphanumeric string that specifies the new name of the file on the system.

Usage Guidelines

Use this command to rename an existing system file on the controller. You can use a combination of numbers, letters, and punctuation (periods, underscores, and dashes) to rename a file. The new name takes affect immediately.

Make sure the renamed file uses the same file extension as the original file. If you change the file extension, the file may be unrecognized by the system. For example, if you have an existing file named upgrade.log, the new file must include the .log file extension.

You cannot rename the active configuration currently selected to boot the controller. If you attempt to rename the active configuration file, the controller returns the following message:

Cannot rename active configuration file

To view a list of system files, and for more information about the directory contents, see dir.

Example

The following command changes the file named test_configuration to deployed_configuration:

(host) [mynode] (config) #rename test_configuration deployed_configuration

Command History

Release

Modification

ArubaOS 8.0.0.0

Command introduced.

Command Information

Platforms

License

Command Mode

All platforms

Base operating system.

Enable mode on Mobility Master.

/*]]>*/