VERSION VRN VN

Description:

 Interface to software version system. Perform updates, rollbacks, etc.

Form:

  Command Handler: SYSD
  VERSION|VRN|VN [OPTION]
  Options:
    SEARCH
      Search file system for update archive. Should have ".nfcms.tgz" extension.
    EXTRACT  [UPDATE_FILE]
      Extract the update file argued. UPDATE_FILE should define full path.
    LIST
      Show current and available software versions.
    SELECT [VERSION]
      Reboot into argued version. VERSION should match an option from "VERSION LIST".
    DELETE [VERSION]
      Delete VERSION (from VERSION LIST)
    INSTALL [UPDATE_FILE]
      Performs EXTRACT followed by SELECT for the argued firmware file.

Response:

  VERSION LIST RESPONSE
    Verbose- "OK\r\n" to acknowledge receipt of command, followed by
             "adtec/dpi1200/1.00.06\r\n"
             "adtec/dpi1200/1.00.07 (*** current selection ***)\r\n", or
             "ERROR- [Description]\r\n" if error, ending command
    Terse-   "0\r\n" to acknowledge receipt of command, or
             "adtec/dpi1200/1.00.06\r\n"
             "adtec/dpi1200/1.00.07 (*** current selection ***)\r\n", or
             "[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
    "\r\n" concludes modify responses (empty line)

  VERSION SEARCH RESPONSE
    Verbose- "OK\r\n" to acknowledge receipt of command, followed by
             "/tmp/dpi1200-v1.00.08.nfcms.tgz\r\n"
               "ERROR- [Description]\r\n" if error, ending command
    Terse-   "0\r\n" to acknowledge receipt of command, followed by
             "/tmp/dpi1200-v1.00.08.nfcms.tgz\r\n"
             "[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
    "\r\n" concludes display responses (empty line)

  VERSION EXTRACT|SELECT RESPONSE
    Verbose- "OK\r\n" to acknowledge receipt of command, followed by
               "ERROR- [Description]\r\n" if error, ending command
    Terse-   "0\r\n" to acknowledge receipt of command, followed by
             "[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
    "\r\n" concludes display responses (empty line)
    
  VERSION DELETE RESPONSE
    Verbose- "OK\r\n" to acknowledge receipt of command, followed by
               "ERROR- [Description]\r\n" if error, ending command
    Terse-   "0\r\n" to acknowledge receipt of command, followed by
             "[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
    "\r\n" concludes display responses (empty line)

Examples:

  Verbose command to search for updates:
  *.SYSD VERSION SEARCH<enter>
     Response is: OK\r\n
                  /tmp/dpi1200-v1.00.08.nfcms.tgz\r\n

  Verbose command to extract an updates:
  *.SYSD VERSION EXTRACT /tmp/dpi1200-v1.00.08.nfcms.tgz<enter>
     Response is: OK\r\n

  Verbose command to list versions:
  *.SYSD VERSION LIST<enter>
     Response is: OK\r\n
                  adtec/dpi1200/1.00.06\r\n
                  adtec/dpi1200/1.00.07 (*** current selection ***)\r\n
          adtec/dpi1200/1.00.08\r\n

  Verbose command to update software version:
  *.SYSD VERSION SELECT adtec/dpi1200/1.00.08<enter>
     Response is: OK\r\n

  Verbose command to delete software version:
  *.SYSD VERSION DELETE adtec/dpi1200/1.00.08<enter>
     Response is: OK\r\n
 

Notes:

 SELECT may not return due to system reboot.
Created By: Adtec Digital