Represents a file action request to be committed immediately (with set request) or that is being commited (with get request). idle = there is no action being performed or prepared prepare = parameters of an action are being edited. This is used by the manager to willingly avoid editing parameters while another manager does so. copy = copy a file from source to target, where source and target have a broad meaning (local/remote file system or running configuration). See details below. rename = rename a local file (see details below) merge = merge a local file to running configuration Allowed Transitions: * idle to prepare * prepare to any other Automatic Transitions: * copy to idle, when action is done * rename to idle, when action is done * merge to idle, when action is done ****************************** * Action = copy * ****************************** The following table gives the corresponding CLI command for each combination of source and target type. + | \ Target|fileSystem |runningBinary |runningScript |ftp | |Source \ | | | | | + |fileSystem |file cp from |file restore |file replace |file cp from | | |SRC |binary-running-config |SRC |SRC | | |TRG |flash | |FTP_TRG | + |techSupport |file cp | | |technical-support | | |technical-support | | |TRG | | |FTP_TRG | + |runningBinary |file backup | | |binary-running-config | | |binary-running-config | | |flash | | |FTP_TRG | + |runningScript |file cp | | |running-configuration | | |running-configuration | | |TRG | | |FTP_TRG | + |ftp |file cp from |file restore | | |FTP_SRC |binary-running-config | | | | |TRG |FTP_SRC | | | + Comments: (a) FTP_SRC denotes ftp://[USER[:PSW]@]ADR[:PORT]/SRC FTP_TRG denotes ftp://[USER[:PSW]@]ADR[:PORT]/TRG (b) SRC, TRG, USER, PSW, ADR and PORT are respectively the values of prvtConfigSourceFileName, prvtConfigTargetFileName, prvtConfigRemoteUser, prvtConfigRemotePassword, prvtConfigRemoteAddress and prvtConfigRemotePort. When any of these are not mentioned in the command, then the value is not relevant. (c) tftp is the same as ftp, except that USER, PSW are not used (d) the error 'inconsistentValue' is returned for any combination marked 'not legal' (e) a successful execution of a copy action when target type is 'runningBinary' (equivalent CLI command is 'file restore binary-running config ...') results in a system reload (f) The above comments are also applicable to the other actions explained below. ****************************** * Action = rename * ****************************** equivalent to CLI command: file mv SRC TRG prvtConfigTargetType and prvtConfigSourceType must equal to 'fileSystem' ****************************** * Action = merge * ****************************** equivalent to CLI command: file merge SRC prvtConfigSourceType must equal 'fileSystem' prvtConfigTargetType must equal 'runningScript' ****************************** * Examples * ****************************** [1] To save the binary of the running configuration to a remote ftp server, with default username, default password, default port, IP = 10.2.144.20, and target file name 'example.bin', the procedure would be (assuming that prvtConfigAction is initially in 'idle' state): set prvtConfigAction <- 'prepare' set prvtConfigSourceType <- 'runningBinary' set prvtConfigTargetType <- 'ftp' set prvtConfigTargetFileName <- 'example.bin' set prvtConfigRemoteAddress <- '10.2.144.20' set prvtConfigAction <- 'copy' [2] To rename a file named 'first.txt' to 'second.txt', the procedure would be (assuming that prvtConfigAction is initially in 'idle' state): set prvtConfigAction <- 'prepare' set prvtConfigSourceType <- 'fileSystem' set prvtConfigTargetType <- 'fileSystem' set prvtConfigSourceFileName <- 'first.txt' set prvtConfigTargetFileName <- 'second.txt' set prvtConfigAction <- 'rename'