Step 4: Download and Install the Network Sensor Software

Now that you’ve provisioned your Insight Network Sensor host, you’re ready to download and install the network sensor software. You can download the network sensor installer from the Network Sensors tab of your “Data Collection” screen in your Insight platform home page.

Download the Network Sensor Installer

To download the network sensor installer:

1. Go to insight.rapid7.com  and sign in with your Insight account credentials.
   • If you do not see the “My Products & Services” screen upon signing in, open the app switcher in the upper left corner of the screen and click My Account.
2. Expand your left menu and click the Data Collection Management tab.
3. On the “Data Collection Management” screen, click the Network Sensors tab.
4. If this is your first network sensor configuration, click Install to open the download panel.
   • If you’ve already deployed a network sensor before, click the Add New dropdown in the upper right corner of the screen and click Network Sensor.

The network sensor installer comes in the form of a .deb or .rpm package that you will need to execute on your intended Linux host.

5. On the download panel, click the Linux (64-bit) button to download the network sensor package. If you’re not downloading the installer directly to the network sensor host, relocate the installer package to your intended host machine.

Install the Network Sensor Software

After downloading the file for the architecture of your choice, place the installer in a directory on the host machine and navigate to it.

To install the Network Sensor on RedHat-based Linux (.rpm)

1. Open a terminal and navigate to the current directory of the installer. Install the package with the following command, using either the RPM or DNF package managers:

RPM installation command

sudo rpm -i ./rapid7-network-sensor.x86_64.rpm

DNF installation command

sudo dnf -i ./rapid7-network-sensor.x86_64.rpm

2. Identify the Installed Insight Agent version, to be used in the next step, using the following command:

RPM command

rpm -qi rapid7-insight-agent | grep Version

DNF command

dnf info rapid7-insight-agent | grep Version

To install the Network Sensor on Debian-based Linux (.deb)

1. Open a terminal and navigate to the current directory of the installer. Install the package with the following command:

sudo apt-get install ./rapid7-network-sensor_amd64.deb

2. Identify the Installed Insight Agent version, to be used in the next step, using the following command:

apt show rapid7-insight-agent | grep -Po 'Version: [\d.]+'

Configure the Insight Agent

With a Linux installation of the Network Sensor, you must configure the Insight Agent using the platform token.

1. Use the following configuration command, substituting {token} with your organization’s token:

sudo /opt/rapid7/ir_agent/components/insight_agent/{version}/configure_agent.sh --start --token {token}