Skip to main content
For an already registered Docusnap Enterprise Gateway you see its state, its configuration and the diagnostic data it reports to Docusnap365. Setting up a new gateway is described in Installing and Registering the Gateway.

​
Reading the overview

Scan › Gateways lists every registered gateway with a badge for its state: Every job is bound to exactly one gateway.
An Offline gateway can no longer be controlled from a job’s detail page: Stop, Pause, Resume and Run Now disappear, leaving only Edit and Delete. Check the gateway first in that case, before looking for the cause on the job—see Managing Jobs.
If no gateway is connected at all, Docusnap365 points this out on every scan page and walks you through the setup first when you create a job.

​
Viewing the details

​
General

The values under General are read-only: Registered On, Connected or Disconnected, Platform, Organization, Location and Support Mode (Active or Inactive). You upload support plugins in the Support section, see Logging and Support.
Connected or Disconnected names the state the last connection change led to and the time since that change. The gateway’s tile in the overview shows the same value.

​
IP ranges

The table records which address ranges belong to this gateway: First IP Address, Last IP Address and a description per row. Creating, editing and deleting take effect immediately, with no separate save step. A CSV import is available for many ranges at once; it only takes over rows with a valid first and last IP address and reports how many ranges were actually added.

​
Logging and Support

The pencil at Logging opens edit mode; only the fields you actually change are saved.
  • Log Level — Debug, Information, Warning, Error or None
  • Size per File and Number of Files—together a rotation: once the size is reached, a new file begins; once the number of files is reached, the oldest one is overwritten
Changing the unit at Size per File does not recalculate the number entered: 10 set to Bytes, switched to MB, becomes 10 MB—not 0.00001 MB. Set the unit first, then enter the number.
Set Debug only for the duration of troubleshooting and reset it afterwards—the level applies to everything this gateway logs for as long as it is set.
In the Support section you upload support plugins to this gateway. A support plugin is a version of a scan module that temporarily replaces the regular version on this gateway: when a job of that scan module starts, the gateway uses the version from the support plugin. Support mode gives nobody access to the gateway. Temporary access of Docusnap support to the subscription is governed by support access, see Support.
  • Upload Support Plugin appears below the switch while the mode is Inactive and opens a drop zone. It accepts files with the extension .dssp, several at once if needed. After the first plugin is uploaded, support mode shows Active.
  • Uploading requires a connected gateway. With the module access Viewer, the button is not shown.
  • A support plugin is valid for at most 365 days. Once its expiry date is reached, the gateway removes it by itself and uses the regular version again.
  • You switch off the Support Mode switch while it is Active. After the confirmation, Deactivate removes all support plugins and the gateway restarts.
Each further support plugin replaces the previous ones on the gateway; it does not add to them.
If the gateway rejects a support plugin—for example because its expiry date has passed—this appears only in the gateway’s log, see Reviewing and Exporting Logs. Directly after the upload, support mode still shows Active.

​
Diagnostics

The Diagnostics tab shows two tables: Log (Time, Level, Message) and Loaded Assemblies & Plugins with version, status and the time of the last update. How the data comes about depends on the state: if the gateway is Online, Docusnap365 requests the newest error and warning entries plus the plugin list freshly; if it is Offline, you only see what was cached last.
The search field above the log filters across every column, including the level text—a search for Warning works too. Download writes exactly the filtered rows to a file; filter first, then download.
The complete set together with the state data is delivered only by the export in the Docusnap Enterprise Gateway on its machine, see Reviewing and Exporting Logs.

​
Restarting the gateway

Next to the header menu on the detail page you restart the gateway service—possible only for an Online gateway. The gateway restarts only once the running jobs have finished; no further job starts until the restart. If something is currently running, the confirmation names the number of jobs.
Searches you start in the wizard or in an analysis package during that time—Search DNS Servers, Search DHCP Servers, Search DFS Servers, Search Nutanix Clusters, Load Servers from Active Directory or Reload Shares—are not run by the gateway. Start the search again after the restart.

​
Deregistering or deleting the gateway

The header menu carries one of two entries depending on the state: Deregister Gateway for an Online gateway, Delete Gateway for an Offline one. Both detach the gateway from the subscription the same way.
After both actions the local vault entries and the jobs of this gateway are no longer available. To keep the configuration of the jobs, pause them instead through Managing Jobs and leave the gateway in place. Check beforehand in the job lists which jobs hang on this gateway.
Once the gateway is connected, create the first job.