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 an .sh script 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 installer script. If you’re not downloading the installer directly to the network sensor host, relocate the installer script to your intended host machine.

Install the Network Sensor Software

To install the network sensor on your intended host machine:

1. On your network sensor host, open a terminal and navigate to the current directory of the installer script. Run the following command to make the script executable:

 
1
chmod u+x sensor_installer.sh

2. If you have not done so already, generate the activation token that the Insight Agent component of the network sensor installer will use to pull its dependencies. After generating, your token will automatically append itself to the network sensor installer execution command that you need to run in the next step.
3. Copy the execution command as shown in your download panel and run it in the terminal of your network sensor host machine. For reference, this execution command should be in the following format:

 
1
sudo ./sensor_installer.sh install_start --token <region_code>:<token>