write command

This command saves the CMM configuration, including user accounts and permission groups, to a file.

Saved configurations are restored using the read command.

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".
  • For information about how to specify a URL for file transfer, see Specifying a URL for file transfer.

If command syntax is not correctly entered, or if a command fails to run, an error message is returned. See Common errors for a list of error messages that apply to all commands or write command errors for a list of error messages that are specific to the write command.

Table 1. write command.

The command table is a multi-row, four-column table where each row describes a CMM CLI command option: column one lists command function, column two provides a detailed command description, column three shows command-option syntax, and column four lists valid command targets.

Function What it does Command Target (see paths in Command targets)
Save CMM configuration to file Saves an image of the CMM configuration to a file. This image includes CMM users and permission groups. write -u URL -p passphrase

where:

  • URL is fully qualified uniform resource locator, including file name, of the tftp, ftp, http, https, or sftp server where the configuration file will be saved.
  • "passphrase" is a double-quote delimited passphrase that will be needed to restore the configuration file. Minimum passphrase length is 6 characters. Maximum passphrase length is 31 characters.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.

Example:

To save the CMM configuration to a file named cmm1.cfg in the temp directory on a TFTP server with an IP address of 9.37.177.215 and a passphrase of backuplock, while the Flex System Enterprise Chassis is set as the persistent command environment, at the system> prompt, type
write -u tftp://9.37.177.215/temp/cmm1.cfg -p "backuplock" -T mm[p]
To save the CMM configuration to a file named cfg.bkp in the /tftpboot/backup directory on a SFTP server with an IP address of 300.370.640.310 and a passphrase of Passphaase, while the Flex System Enterprise Chassis is set as the persistent command environment, at the system> prompt, type
write -T mm[p] -p "Passphaase" -u sftp://userid:password@300.370.640.310/tftpboot/
backup/cfg.bkp

The following example shows the information that is returned from these commands:

system> write -u tftp://9.37.177.215/temp/cmm1.cfg -p "backuplock" -T mm[p]
OK
system> write -T mm[p] -p "Passphaase" -u sftp://userid:password@300.370.640.310/
tftpboot/backup/cfg.bkp
OK