Migration Script Instructions
This Migration script installer is in the Open Preview development phase
The Migration script works for the preview installations packages (rapid7-component-manager-{version} and rapid7-insight-agent-agent-component-{version}) to the new packages (rapid7-insight-agent-{version}).
This migration script, which has undergone rigorous testing, is now ready for deployment in a production environment. Rest assured, its functionality is robust and reliable, although it may be refined based on valuable customer feedback.
Deprecation of packages
No immediate action is needed, however these steps must be completed by November 15, 2024. After this date, you will no longer be able to access either the old .sh or the old .rpm/.deb packages as they will be fully deprecated.
Step 1: Download the new Package Installer
Download the latest version of the Rapid7 Insight Agent Installer for the architecture of your choice.
Step 2: Download the migration script
Download the migration script .
Step 3: Run the migration script
After downloading the rapid7-insight-agent and the migration.sh file, open a terminal and navigate to the directory where your download is located (both files must be in the same folder). Run the following command:
sudo ./migration.shSuccessful installation
If your PIDs are different and the insight_agent has a new version, the installation has completed successfully.
If the PIDs are the same following the migration, restart the service and use the below commands:
systemctl restart ir_agent
OR
system ir_agent restart
The process will save all of your configuration files and Agent IDs and leave the new Insight Agent running using the same configurations.
What to do if you are installing over an existing .sh installation Insight Agent
If you used these commands to reinstall the Insight Agent over an existing .sh agent installation, make sure to restart the Insight Agent service after the installation finishes. You can do so with this command:
launchctl start ir_agent
Check that the Insight Agent has updated to the new installer
Following the migration, you can use the below commands to check that your Insight Agents are using the correct installer.
Migration test command (.deb)
dpkg -l rapid7-insight-agentMigration test command (.rpm)
rpm -q rapid7-insight-agentCheck which assets have used the Open Preview installers
To check which of your assets have used the .deb or .rpm installers as part of our Open Preview program, use the following commands:
Query assets (.deb)
dpkg -l rapid7-component-managerQuery assets (.rpm)
rpm -q rapid7-component-manager