Some CLI commands require specification of a URL when transferring
a file to or from the CMM.
Note: When the CMM is
set to "Secure" security mode, only secure file transfer methods,
such as HTTPS and SFTP, can be used for tasks involving file transfer
when the CMM is
acting as a server. Unsecure file transfer protocols, such as HTTP,
FTP, and TFTP, are disabled when the CMM is
acting as a server when the security mode is set to "Secure".
Unsecure file transfer protocols remain available for a CMM acting
as a client for all commands when the security mode is set to "Secure".
The CMM supports
multiple server protocols for file transfer. The URLs for all protocols
follow the same basic format:
protocol://user:password;fingerprint=hostkey@hostname:port/path/filename
Where:
- protocol: Protocol to use for server connection (tftp,
ftp, http, https, or sftp).
- user: Optional user name for server connection.
- password: Optional password for user authentication during
server connection. The password can be used only when a user is specified.
- hostkey: Optional host key used to authenticate an encryption
key file. This host key can be used only when a user is specified.
The fingerprint and hostkey are optional during secure operation.
- hostname: Server hostname.
- port: Optional server port to use for file transfer. The
server port must be specified, if not using the default server port.
- path: Path to the file on the server.
- filename: File name of file being transferred.
Examples:
- To restore the CMM configuration
from an image previously saved to an unencrypted file named cmm1.cfg
and a passphrase of ’backuplock’ in the temp directory on a TFTP server
with an IP address of 9.37.177.215, while CMM 1
is set as the persistent command environment, at the system:mm[1]> prompt,
type
read -u tftp://9.37.177.215/temp/cmm1.cfg -p "backuplock"
- To update the CMM firmware
from a HTTP server and reboot the CMM in CMM bay
2 after a successful update, type the following command at the system:> prompt.
For this example, the IP address of the HTTP server is 10.12.100.109
and the firmware file containing the update is named cmefs.uxp, that
is in the flash sub-directory on the server. The verbose mode and
reboot flag are also specified.
update -u http://10.12.100.109/flash/cmefs.uxp -T mm[2] -v -r
- To save the CMM configuration
to a unencrypted file named cmm1.cfg and a passphrase of ’backuplock’
in the temp directory on a TFTP server with an IP address of 9.37.177.215,
while CMM 1
is set as the persistent command environment, at the system:mm[1]> prompt,
type
write -u tftp://9.37.177.215/temp/cmm1.cfg -p "backuplock"
- To download a key with an index of 1, of type openssh, for the
user named test, from an SFTP server with a host name of 10.40.1.15,
where the key is in the /home/user directory, with a file name of
file.ext, while CMM 2
is set as the persistent command environment, at the system:mm[2]> prompt,
type the following command. The server is being accessed using a user
name of user, a password of pass, and an optional fingerprint of sh-dss:14-25-f1-76-75-32-06-8b-ba-a6-e7-b8-23-44-40-34.
users -n test -dnld -ki 1 -kf openssh -u sftp://user:pass;fingerprint=ssh-dss:
14-25-f1-76-75-32-06-8b-ba-a6-e7-b8-23-44-40-34@10.40.1.15/home/user/file.ext
Note: The
URL for this downloaded file includes the following parameters:
- Protocol type: sftp.
- User name and password for server connection: user and pass.
- Fingerprint preamble: ssh-dss. The fingerprint
parameter must include a fingerprint preamble.
- Fingerprint parameter: c1:df:07:c4:e5:6a:7f:ce:47:a1:de:df:84:51:5f:bf.
- Server hostname: 10.40.1.15.
- Path on server: /home/user.
- File name: file.ext.
- To download a key with an index of 1, of type openssh, for the
user named test, from an SFTP server with a host name of 10.40.1.15,
where the key is in the /home/user directory, with a file name of
file.ext, while CMM 2
is set as the persistent command environment, at the system:mm[2]> prompt,
type the following command. The server is being accessed using a user
name of user, a password of pass; no optional fingerprint is specified
in this example.
users -n test -dnld -ki 1 -kf openssh -u sftp://user:pass@10.40.1.15/home/
user/file.ext
Note: The URL for this downloaded file
includes the following parameters:
- Protocol type: sftp.
- User name and password for server connection: user and pass.
- Server hostname: 10.40.1.15.
- Path on server: /home/user.
- File name: file.ext.