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! [Please note: Windows discovery requires at least one Windows Discovery Service (“WDS”) instance be deployed].
You may configure an unlimited number of remote collector appliances as needed across your environment. RCs facilitate SNMP, IPMI, hypervisor and other auto discoveries across networks with only https access required, eliminating the need to open numerous ports up across network segments.
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 should be found at the top of the page.
We currently offer an
.OVH image for direct download. Should your hypervisor not support the OVF VM image format, please contact email@example.com and we’ll will work with you to provide an image compatible with your hypervisor.
Deploy the VM image to your hypervisor, boot it, and log in using the VM console or via SSH, 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:
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:
The “PREFIX” field above is asking for an integer that represents the subnet mask in slash notation, e.g. for 255.255.255.0, 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
Each RC must be able to communicate with the main appliance on port 443. After initial communication, a WebSocket connection is established between the RC & MA on an ephemeral port (selected randomly), allowing full-duplex communication between them. The Device42 main appliance can thus talk to and control the RC over the WebSocket.
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 via the main menu, head to Discovery -> Remote Collectors. Here you will be able to view any existing registered RCs and generate an OTP to register a new one:
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:
Once initial 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.
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.
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:
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 collectors 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.