Agent Controls
You can execute the following operations on the Insight Agent to perform several functions. The commands listed here are categorized according to the operating system of the asset.
Windows
Open a command prompt to execute the following commands:
Start the agent
Stop the agent
Windows Service Manager
You can also start, stop, and check the status of the Insight Agent service from the Windows Service Manager. To access the Service Manager, run services.msc in the command line.
Check the version number
- Navigate to the version directory using the command line:
- Run the following command to check the version:
Alternatively, browse to the "Rapid7 Insight Agent" from your Start menu and check its properties.
Reinstall the agent
If you need to reinstall the agent for any reason and want to avoid the step of uninstalling first, you can do so by running the .msi from the command line:
Maintaining the existing UUID of the agent
Maintaining the existing UUID ensures there are no agent duplicates in your environment.
As long as the agent is already on version 2.0 or later, reinstalling in this way ensures that its previously existing UUID will remain in use as long as the C:\Program Files\Rapid7\Insight Agent\components\bootstrap\common\bootstrap.cfg file is present at the time of reinstallation.
If you want a reinstalled agent to get a new UUID, uninstall the existing agent and completely remove the agent directory first before running the installer again.
Note that reinstalls of any agent running a version prior to 2.0 will not retain their original UUID.
Uninstall the agent
Browse to the "Rapid7 Insight Agent" from your Start menu, right click the agent icon, and select "Uninstall". You can also run the installer and select the Remove option.
Linux (.rpm)
Open a command prompt to execute the following commands:
Check the bootstrap sub-component of the Insight Agent is running (.rpm):
Check the current version running and PIDs (.rpm):
Check the Insight Agent ID (.rpm):
Uninstall (.rpm):
Following this command, there will be additional files left. These files are not inside the package, therefore the package manager is not capable of removing them.
To clean all the folder and files:
Linux (.deb)
Open a command prompt to execute the following commands:
Check the bootstrap sub-component of the Insight Agent is running (.deb):
Check the current version running and PIDs (.deb):
Check the Insight Agent ID (.deb):
Uninstall (.deb):
Following this command, there will be additional files left. These files are not inside the package, therefore the package manager is not capable of removing them.
To clean all the folder and files:
Mac (.pkg)
Open a command prompt to execute the following commands:
Check the bootstrap sub-component of the Insight Agent is running (.pkg):
Check the current version running and PIDs (.pkg):
Check the Insight Agent ID (.pkg):
Uninstall (.pkg):