Knowledge Base Home

Call Support

Search the Knowledge Base

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3


Netmail Store 


Use the procedure below to perform a rolling upgrade of the Netmail Store software version. 



Please Read First!

  1. Please note that once you have run through this upgrade procedure and restarted the nodes, you cannot backrev to the previous version.
  2. Upgrading cannot skip a major version. If you are upgrading from a much older version, this should be done in steps (to check the version number, refer to your cluster's admin console).
    Please follow the recommendations below for upgrading Store:
    • Version below 4.x  upgrade to 4.x
    • Version 4.0.x - 5.0.x  upgrade to 5.1.x
    • Version 5.1.x upgrade to 6.5.x
  3. It is critical that each USB key is returned to the same node it was removed from.
Upgrade instructions:
  1. Download and mount/open the new software version.
  2. Unplug the USB flash drive from one of the nodes and plug connect it to a Windows computer.  Make note of the drive letter assigned to the device (eg, X:).
  3. Move the license.txt and node.cfg files from USB key to computer (they are found in the /caringo folder).
    *This step is very important, as the next step will overwrite the config file and possibly the license file.
  4. Copy all files from the new software package onto the USB flash drive. You will overwrite the existing files.
    *There are hidden files and folders, so make sure you get everything. You may need to turn on the "show hidden files and folders" option.
  5. Open a command prompt: Start Menu  Run: "cmd.exe"
  6. Run the syslinux.exe utility from the new package, passing the drive letter of the USB key as a parameter
    eg, "D:\syslinux.exe X:"
  7. Move the license.txt and node.cfg files back to the USB key in the /caringo folder.
  8. Stop the USB flash drive and unmount. This is typically done by double-clicking the icon on the task bar that is labeled "Safely Remove Hardware" and the clicking the Stop button for the USB flash device.
  9. Plug the USB flash device back into the Store node and restart the node.
    *Restarting the nodes should be done from the web console when ever possible. To do this you will need administrative credentials (which can be found in the node.cfg file of the USB key).
  10. Monitor the admin console and ensure it mounts correctly and has the new version number.

If you are doing a rolling upgrade of the nodes and it is taking longer than 15 minutes from the restart of the first node, you may want to suspend volume recovery temporarily until all systems are up and running the same version of software. To do this, from the web console, click Settings and check Suspend Volume Recovery. To save this you will need administrative credentials (which can be found in the node.cfg file of the USB key).


 In the majority of cases a Netmail Archive system will be pointing to a particular node for all its activity.  Netmail Archive jobs as well as end-user access will not be affected until this node is restarted.  Regardless, it is highly recommended that no jobs be running when that node is restarted.  AWA Remote Provider services may also need to be restarted after the upgrade.

Include Page