User Manual

Answer: There are different ways to update your Netcraze router's operating system.

Manually, via the web interface (by clicking the appropriate button in the web interface, but in this case, the router must have a working Internet connection; via the operating system file — this method can be used for offline upgrades when the router is not connected to the Internet), via the Netcraze mobile app or the command-line interface (for advanced users).

Any Netcraze router can also update the NDMS operating system automatically, without user involvement.

Answer: Yes, it is possible, and we recommend doing so. Save the current router firmware file and the user settings (startup-config) on your computer. With these system files, you can reset the router's settings at any time. Connect to the Netcraze web interface and go to the General System Settings page. In the System Files section, in the file line of the firmware click the Save to computer icon to download this file's copy (the router's OS).

Your web browser will download the NDMS operating system file (*.bin file). If the Save file window appears, specify the location (the folder where the file will be saved) and click Save or OK.

See Saving NDMS image to a file for more information.

As a result, you will save a backup file of the router's built-in operating system on your computer, containing the currently installed version of NDMS, with your set of components.

Later, if necessary, you can restore the saved version of the system. You can do this by following the instructions Updating NDMS by a system file.

As for the router configuration (settings), in the startup-config file line, click the Save to computer icon to save the configuration file with the current user settings.

You will find more information in the instructions Saving the startup-config configuration file.

Answer: No. Any OS update will cumulatively update all NDMS components. All components are designed to work together, and updating a single component can lead to various system errors. Therefore, a NDMS rebuild is required even if you add or remove a single system component.

Answer: Error 507 during an operating system upgrade means that the router does not have enough internal memory to install the selected components. We recommend you uninstall unused components before the update. This is due to hardware limitations. This error may occur on entry models with 32 Mbytes of Flash memory.

Answer: As a rule, such an error appears due to the zip archive being selected as the system file. On our website, in the Download Center, NDMS files are presented as zip archives. After downloading the file (for your router model) from our site, you should first unzip (unpack) it. The downloaded file must have the .bin extension.

Answer: Try to perform the update again using a different web browser. Various add-ons, plug-ins or toolbars can hinder the installation of components. We recommend using the latest versions of the most popular web browsers (Google Chrome, Mozilla Firefox, Opera, Edge).

If the actions above do not help, download the current NDMS file for your router from the Download Center, and follow the instructions Updating NDMS by a system file.

Answer: Dev (test, debug) — draft versions are released by the developers and are available for installation. Information about testing can be found on the Netcraze Community forum. These versions have the same functionality as Main and Preview releases and contain additional bug fixes and new features. The latest Dev version available usually contains a fresh set of components that are used in current releases. This version differs from stable releases in that it is not fully internally tested and is therefore distributed on an 'as is' (or 'at your own risk') basis. The Dev version is initially intended to test fixes' workability and get familiar with new features. This version may contain bugs.

You can update the router's OS to the latest available Dev version from the router's web interface or via the command-line interface (CLI).

If installing the Dev version of NDMS via the web interface, open the General System Settings page, under NDMS Update and Component Options, select the Dev build update channel and click Update NDMS.

In the case of installing a Dev OS version using commands, connect to the command-line interface (CLI) of the router and execute the following commands:

components list draft
components commit

After successful execution of these commands, the device will automatically reboot. After that, connect to its web interface and check the NDMS version on the System dashboard page in the About the system section (it is indicated in the OS version field). The list of system components will remain the same.

Answer: Due to the different hardware configurations of Netcraze routers, it is not guaranteed that all components and specific combinations of components available for a particular model can be installed simultaneously. This is usually the case for junior models with up to 32 Mbyte of Flash memory. Also, some operating system components are mutually exclusive and cannot be run simultaneously. We recommend uninstalling the components you do not use and then installing the ones you do need. The recommended set of components can be obtained by installing the NDMS operating system for your router from the Download Center section.

Answer: This means that it was not possible to connect to our update server for some reason. Make sure that the router is connected to the Internet, and then try again. Perhaps, there may have been maintenance work on our server, and it was not accessible at some point. Try to perform a system update later.

Try adding an additional public DNS server manually to your router settings: Additional DNS servers.

If DoT/DoH and the Ignore DNS from ISP option are enabled in your router, try temporarily disabling DoT/DoH, enable getting DNS from ISP (disable the Ignore DNS option), and then reboot your router and check for an update to your router's operating system again.

Answer: This error means that you are trying to put the system file created for another Netcraze model. The built-in protection system has been activated.

Identify your Netcraze device's model. The model is shown on the device's bottom label, on the device's carton box, and in the web interface. Then, in the Download Center of our website, download the zip-archive with the NDMS, designed specifically for your device model, unzip the archive, and use the resulting file with the extension .bin for writing to the router.

Answer: Different versions of NDMS components may have different preset settings. Some device settings may not be refreshed when the operating system is updated. Also, upgrading firmware from a very old version to a new one can cause errors to appear in the web interface. We, therefore, recommend saving the current settings file (startup-config) and the firmware file before updating the router's firmware. If you are faced with such a situation, we recommend you perform a factory reset of the user settings and reconfigure your Netcraze.

Answer: Starting with NDMS 3.4.6, the firmware digital signature certificate has been updated on Netcraze cloud infrastructure and Netcraze devices. The previous digital signature certificates will be withdrawn. This has been done to improve the security of Netcraze devices and services.

If after installing version 3.4.6 and above, you try to write one of the previous firmware versions to the router, you will see a message that the firmware to be written is signed with the revoked certificate.