Collector Activation Key Does Not Work
First, make sure you have the correct activation key. It's located in the AgentKey.html file in the
/agent-key/ subdirectory of the destination directory where you installed the collector.
If the key is correct but still does not work, it may have been voided. This can occur if you do not activate the collector immediately after installing it or if you have restarted the server where the collector is installed.
If the activation key has been voided, you will need to delete and reinstall your Collector.
Where is the Activation Key for Linux Collectors?
If you cannot find the activation key for Linux installations, you can find it here:
Collector Shows as Inactive
Try restarting the Collector service. Contact Rapid7 support if restarting does not fix your issue.
- For Linux Collectors, run
service collector restartfrom the command line. On some systems, this command may need superuser privileges (
- For Windows collectors, open the Services app and restart the 'Collector' service.
Collector Failed to Activate
If activation fails, there is likely a network or routing configuration that is preventing your Collector host from communicating with the Insight platform. Verify that you have properly configured the necessary whitelisting allowances as detailed on the Collector Requirements page.
Increasing RAM to the Collector
You can increase the amount of RAM allocated to the collector in environments that require a lot of RAM. To do so, place a file in the same directory where you installed the collector with the name
collector.vmoptions which contains the following line:
where "#" is the number of GB of memory the collector should use.
- For a 4GB machine, you can tell the collector to use 3GB of memory by putting
-Xmx3gin the file.
- For an 8GB machine, you can tell the collector to take 6GB of memory by saving a collector.vmoptions file in the collector directory with the line
Error: The hostname [hostname of machine running the Collector] is not fully qualified. Agents may not be able to connect to this collector
To resolve this error, do one of the following:
On a VM:
- Power off your virtual machine.
- Change the machine name to a FQDN.
- Power on your virtual machine.
- In the Control Panel, go to Network and Sharing Center, and select Change Settings in the Computer Name, Domain, and Workgroup section.
- Right-click on the network adapter you are configuring and choose Properties
- Select Internet Protocol 4 (TCP/IPv4) and then choose Properties. Click on Advanced and then DNS.
- Add in the DNS suffix (or suffixes).
Installation Error on Linux
When installing the Collector on a Linux host, this error can occur:
1Unpacking JRE ...2Starting Installer ...3java.lang.NoClassDefFoundError: java.awt.Container4at com.install4j.runtime.installer.frontend.headless.AbstractHeadlessScreenExecutor.init(AbstractHeadlessScreenExecutor.java:67)5at com.install4j.runtime.installer.frontend.headless.ConsoleScreenExecutor.init(ConsoleScreenExecutor.java:24)6at com.install4j.runtime.installer.frontend.headless.InstallerConsoleScreenExecutor.init(InstallerConsoleScreenExecutor.java:6)7at com.install4j.runtime.installer.Installer.getScreenExecutor(Installer.java:92)8at com.install4j.runtime.installer.Installer.runInProcess(Installer.java:58)9at com.install4j.runtime.installer.Installer.main(Installer.java:46)10at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)11at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)12at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)13at java.lang.reflect.Method.invoke(Unknown Source)14at com.exe4j.runtime.LauncherEngine.launch(LauncherEngine.java:65)15at com.install4j.runtime.launcher.UnixLauncher.main(UnixLauncher.java:57)
This error indicates that you are missing one or more 32-bit libraries. To solve this issue, run the following command on the Linux host:
sudo apt-get install ia32-libs
Uninstall Error on RH Linux
When uninstalling the collector on a RHEL machine, complete the following if you see this error:
1Could not display the GUI. This application needs access to an X Server.2*******************************************************************3You can also run this application in console mode without4access to an X server by passing the argument -c5*******************************************************************
- Install the RPM package
- Run the uninstall script again.
Linux Collectors Do Not Show Collector Details
View your Linux Collector details on Data Collection > Data Collection Health > Collectors.
If your Linux collectors are not showing details like the hostname, IP address, OS version, or CPU and Memory usage, the Collector may be having trouble running code from the
Some distributions of Linux prevent code from running in the
/tmp directory for security reasons. To verify this is the issue, open your Collector's log file and look for log lines similar to the following:
1java.lang.UnsatisfiedLinkError: /tmp/jna-3506402/jna5825717272410834572.tmp: /tmp/jna-3506402/jna5825717272410834572.tmp: failed to map segment from shared object: Operation not permitted
To fix this issue, execute the following command in the
1sudo bash -c 'mkdir tmp && echo "-Djava.io.tmpdir=/opt/rapid7/collector/tmp" > collector.vmoptions'
Then, restart the Collector service after executing the above command to resolve the issue.