Loading an alternative driver into Netshot - netfishers-onl/Netshot GitHub Wiki

A driver is a piece of (Javascript) script which allows Netshot to talk with a specific family of devices. Netshot comes by default with a number of included "official" drivers, generally in their last known version at the moment of the package release. You can find the list of "official" Netshot driver files here.

If you want to write your own driver, or want to install a patched version of an existing driver, you can load that additional driver into Netshot by following these simple steps:

  1. Copy the driver (file.js) to the server where Netshot runs, into the driver folder, /usr/local/netshot/drivers by default.
  2. In the Netshot Web interface, as an admin user, go to the Admin tab and click Reload the drivers at the bottom of the page.
  3. You should then see the version of the driver updated in the table of drivers. The next snapshot should use the updated version.

Notes:

  • The location of additional drivers can be customized by the administrator using the entry netshot.drivers.path in the Netshot configuration file /etc/netshot.conf.
  • In case an updated driver doesn't show up in the table of drivers on the Admin page, look at the Netshot logs (by default /var/log/netshot/netshot.log) to find any error reported by Netshot when loading the driver.