Specifying a URL for file transfer

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:

<em className="ph i">protocol</em>://<em className="ph i">user</em>:<em className="ph i">password</em>;fingerprint=<em className="ph i">hostkey</em>@<em className="ph i">hostname</em>:<em className="ph i">port</em>/<em className="ph i">path</em>/<em className="ph i">filename</em>

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.
```
<strong className="ph b">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</strong>
```
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.
```
<strong className="ph b">users -n test -dnld -ki 1 -kf openssh -u sftp://user:pass@10.40.1.15/home/
user/file.ext</strong>
```
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.

Give documentation feedback