Remote Collector (RC)

The Device42 Remote Collector (RC)

The Remote Collector (aka the “RC”) is a virtual appliance that is (optionally) deployed separately from the D42 main appliance (aka Device42 “MA”). It is sent autodiscovery jobs and controlled from the MA, executing those jobs remotely. All auto-discovery jobs, including Power SNMP jobs [v14+] are supported and can be run remotely on an RC! [note Windows discovery requires that at least one Windows Discovery Service (“WDS”) instance is deployed]

You may configure an unlimited number of RC appliances as needed to suit your environment. The Remote Collector allow users to perform SNMP, IPMI, hypervisor and other auto discoveries across networks with only https access, and without needing to open numerous ports up across segments.

Each RC needs to have the ability to communicate over port 443 with the main appliance. The initial communication establishes a websocket on a connection port that can be random (an ephemeral port), but that is opened automatically and by default. The main Device42 appliance then talks to and controls the RC over the websocket port.

Installation and Configuration

To download the Remote Collector, head to our Auto-Discovery tools download page.; Click the Download button under “D42 Remote Collector”, which is at the top of the page.

A virtual appliance image is available for all major hypervisors. Deploy the VM image to your hypervisor, and proceed to login through the console or via ssh on port 22. The default credentials for the Remote Collector are:

username: client
password: device42

After logging in to the console, you will see the main console menu:

Remote Collector Console Menu

Initial (first-boot) Network Config

Upon initial installation, you will first need to configure your network settings so you can proceed with setup. A static IP is best as D42 can lose contact with an RC with a changing (dynamic) IP address. On the main console menu, choose “Network Interfaces” and press enter on the name of your interface to edit it. Use the spacebar to unselect DHCP and assign a static IP address using the following screen. ALL FIELDS are required:

RC menu, first boot

The “PREFIX” field above is asking for an integer that represents the subnet mask in slash notation, e.g. for, which is a /24, you will enter 24. Note that the PREFIX field has been removed and as soon as your RC connects to Device42, it will be updated.

Connect your RC to Device42

From the main console menu, select “RC Setup” to register your RC with your main Device42 appliance. To do this, you will need to first generate a One Time Password (OTP) from Device42. Visit Device42 in your browser and go to Tools>Auto-Discovery>Remote Collectors. Here you will be able to view any existing registered RCs and generate an OTP to register a new one:

Generate OTP

Click “Generate OTP” in the top right and copy the password you receive.

In the RC console, under “RC Setup” enter your OTP along with the IP address or FQDN of the main appliance:

new remote collector setup

Once inital setup is complete, more detailed information about the RC’s configuration is visible under the RC Setup sub-menu, including the option to reset and re-configure your RC.

configured rc setup menu

After the initial registration on port 443, all subsequent communication occurs over a secure websocket channel between RC and MA.

RC Deployment Example

Remote collectors are extremely flexible, and make discovery with Device42 easier than ever. You can deploy one or more, with no logical limit to the number of remote collectors.
main menu

In the deployment example pictured, a remote collector is deployed within each isolated DMZ Network Segment that, per firewall rules typical of a DMZ, the Device42 appliance is normally unable to directly reach and/or discover. Deploying a remote collector to these segments not only bolsters security by saving the Network Administrator from having to make multiple temporary (or permanent & insecure) firewall rules (aka ‘holes’) to allow discovery traffic to pass from the main appliance over the wide range of ports utilized by various vendors APIs. Please note that the diagram does not show the majority of network connectivity that would be present, and instead focuses mainly on what is discovered by the MA vs. the RC, and the communication between the RC & MA.

Instead, as mentioned briefly in the introduction, all communication and discovery information is securely transmitted between the RC and the MA once a connection is established via Port 443 (HTTPS/SSL). This means a single, secure and easily monitored 1:1 rule allows for comprehensive and continuous discovery of the secured network segment [as often as scheduled or desired] – without compromising its isolation or security.

Running Remote Discoveries

Once registered, you can now schedule any auto-discovery jobs from the main appliance, instructing them to run on the remote collectors of your choosing. Each autodiscovery screen now shows a “Remote Collector” drop-down menu. Clicking this box will display all registered Remote Collectors, and allows you to choose the RC you would like the discovery to run from:

Add SNMP autodiscovery and select Remote Collector

Updating your Remote Collector (RC)

As long as your RC is connected to a Device42 instance, the main Device42 instance handles updating of the Remote Collector. Thus, by keeping your main Device42 instance up to date, your can assure your remote collecors will are up to date as well.

Migrating Existing Power Appliance Jobs to a Remote Collector (RC)

Migrating jobs that were created for the original standalone power appliance is possible with existing tools. Simply follow the existing power job migration guide here to migrate jobs to the new RC of your choice.