NOTE: Depending on your operating system, please make sure to unzip and extract to a directory of your choosing before getting started.
Windows Installation Instructions (64bit)
Windows Download (CIMS authentication required)
BigFix Installation Instructions for Windows
- Open the BigFix folder.
- From here you will run the BigFix-BES-Client.exe application by double-clicking on it.
- BigFix's configuration is standard, so just follow the installer pop-up's instructions and default configurations. You shouldn't need to change anything, so just click "Next" followed by "Install".
- Once you have received confirmation from the Installer, click "Finish". BigFix is now ready to use on your Windows machine.
Cortex XDR Installation Instructions for Windows
- Open the CortexXDR folder.
- You are going to run the Cortex_x64 Windows Installer Package by double-clicking on "Cortex_x64.msi".
- In the Setup Wizard window that pops up, follow the onscreen instructions.
- Once you hit the "Finish" button in the Setup Wizard, then you have successfully installed Cortex XDR on your Windows machine.
InsightVM Installation Instructions for Windows
- Open the InsightVM folder.
- You are going to run the IRapid7 Insight Agent Setup Wizard by double-clicking on the "InsightVM" Windows Batch File.
- If you are using Microsoft Defender, then it might raise a notification when running this batch file. Please click on "More info" and then "Run anyway" to proceed with the installation.
- Follow the onscreen instructions, using the suggested default configurations. When you arrive at the "Agent Pairing" screen, you will want to select the option "Pair using locally provided configuration files."
- After your machine has been verified as compatible with the InsightVM software, installation will proceed as expected.
- Once you have hit the "Finish" button, then you have successfully installed InsightVM on your Windows Machine.
macOS Installation Instructions (11 or higher)
macOS Download (CIMS authentication required)
BigFix Installation Instructions for macOS
- Open the BigFix folder.
- Double-click on the package file titled "BESAgent.pkg" in order to launch the BigFix Installer.
- Follow the onscreen instructions, making sure to select the option "Install for all users of this computer" when prompted.
- You will be prompted to enter your password, in addition to allowing BigFix access to your files -- permit BigFix to do so.
- The Installer will inform you when the installation has successfully finished.
Cortex XDR Installation Instructions for macOS
- Open the CortexXDR folder.
- Double click on the package file titled "CortexXDR.pkg" in order to launch the Cortex XDR Installer.
- You will be prompted with a pop up window: "This package will run a program to determine if the software can be installed." Select "Allow".
- Once it has been allowed, you will be presented with the Cortex XDR Installer. Click "Continue", and then click "Install".
- You will be prompted to enter your password. After entering your password, click on "Install Software".
- You will soon see a pop up: "Installer" would like to access files in your Desktop folder. Click "OK".
- You will be presented with two pop ups: Cortex XDR requires Full Disk Access and System Extension Blocked. Click "OK" on both of these windows to dismiss them.
- In the Install Cortex XDR screen, click on "Continue". This will bring you to a window stating The installation was successful in addition to opening the Cortex XDR Configuration Wizard.
- Click on the Cortex XDR Configuration Wizard window. Click "Continue".
- A pop up window will appear: "Installer" would Like to Modify Apps on your Mac. Click "OK"
- At the System Extensions & network filters screen, please follow the Cortex XDR Configuration Wizard's instructions. The Configuration Wizard provides graphical-based instructions, specifically showing you how to properly configure your system. Please follow these instructions as they are presented to you. If you have successfully followed the provided instructions, then you should be able to click on a "Continue" button. If you are unable to do so, please double-check the instructions provided by the Wizard.
- At the Full Disk Access screen, follow the provided graphical instructions. Please be aware that the instruction to "Drag-n-drop" the icons into the Full Disk Access step is only required if the "pmd" and "TrapsSecurityExtension" applications are not listed in your Full Disk Access settings window.
- Click "Continue" to finish up the Cortex XDR installation.
- Please also make sure to enable the "Cortex XDR Agent" Notifications in the Notifications Setting window.
- You should see a Cortex XDR emblem at the top of your screen. If you click on it, you should see "Protection Status: Enabled". This text confirms that you have successfully installed Cortex XDR.
Insight VM Installation Instructions for macOS
-
Open the InsightVM folder.
Please note that in order for this installation to work properly, InsightVM should remain in the Downloads folder. It is recommended to not move the InsightVM folder, as it should be located at /Downloads/Mac/InsightVM
- In the InsightVM folder, navigate to the "InsightVM" application and double click on it.
- If you receive a message that say “InsightVM” was blocked from use because it is not from an identified developer hit cancel and go to your
System Settings -> Privacy & Security. Scroll down to security section and you will see an option to “Open Anyway” and type in your password. - You may also receive a prompt to grant the application access to certain files and control over "Terminal" - make sure to click on "Allow".
- You will be asked to enter your Mac's password again. Note that you will not see what you type into Terminal, as this is a security feature.
- Upon entering your password in Terminal, click on the return key you may be prompted again to grant access -- click on "Allow".
- After successfully entering your password and granting access, the InsightVM installation will initiate.
- Do not close the Terminal window until the installation process has completed. Once completed, you may then close your Terminal window.
- You may receive notifications that background items have been added. You may close these notifications.
- Restart your machine for the InsightVM installation to take effect.
Should you have any issues with installing InsightVM, please contact the Courant Helpdesk.
Linux Installation Instructions
Linux Download (CIMS authentication required)
NOTE: You might need to search for how to enable root user depending on your Linux flavor.
BigFix Installation Instructions for Linux
- First, make sure that you are currently logged in as the root user.
- Open up a Terminal window. Use the "cd" command to navigate to the directory containing the BigFix folder.
- Make sure that all of the required files are in the same BigFix folder. Grant full read/write access to all folders and subdirectories in this BigFix folder with the following command:
chmod -R a+rwx BigFix
- Create "BESClient" directory at the location /etc/opt -- you will need root permissions to do so. Navigate to this directory containing this BESClient file, and execute the following command:
chmod -R a+rwx BESClient
- Navigate into the BigFix folder. Depending on your Linux flavor, run one of the following commands:
rpm -ivh BESAgent.rpm
OR
dpkg -i BESAgent.deb
- Copy your action site masthead to the Linux BigFix Client computer (the masthead contains configuration, license, and security information). The action site masthead (actionsite.afxm) can be found in your BigFix folder. Copy the file "actionsite.afxm" to the BESClient directory using the following command:
cp actionsite.afxm /etc/opt/BESClient
- Navigate to /var/opt/BESClient/ -- make sure to remove any files currently located in this directory. This will most likely be one file named "besclient.config.default" or "besclient.config". This file uses a default configuration, but we will be replacing it.
- In the BigFix folder, copy the besclient.config file over to /var/opt/BESClient/ with the following command:
cp besclient.config /var/opt/BESClient
- Start the BigFix client installation with the following command:
/etc/init.d/besclient start
Please be aware that this installation process might take some time, as files are being written into /var/opt/BESClient. Should you have any issues with installing the BigFix client, or have a different flavor of Linx, please contact the Courant Helpdesk.
CortexXDR Installation Instructions for Linux
- First, make sure that you are currently logged in as the root user.
- Open up a Terminal window. Use the "cd" command to navigate into the CortexXDR folder.
- Create the /etc/panw directory with the following command:
mkdir -p /etc/panw
- Copy the configuration file "cortex.conf" using the following command:
cp cortex.conf /etc/panw/
- Enable execution of the script with the following command:
chmod +x cortex.sh
- Run the installer script with the following command:
./cortex.sh
- Once installation has successfully finished, you should see "Done".
InsightVM Installation Instructions for Linux
- First, make sure that you are currently logged in as the root user.
- Open up a Terminal window. Use the "cd" command to navigate into the folder containing the InsightVM folder.
- Grant full read/write access to all folders and subdirectories in the InsightVM folder with the following command:
chmod -R a+rwx InsightVM
- Depending on whether you are using Intel or ARM Chip for your Linux architecture, use one of the following commands:
./agent_installer-x86_64.sh install_start --attributes "courant-linux-workstation"
OR
./agent_installer-arm64.sh install_start --attributes "courant-linux-workstation"
- Once the installation has finished, you should see
[SUCCESS]