Prior to installing any Endpoint Management tools, we request that you adhere to the Computer Naming Convention

NOTE: An active Internet connection is required to install the Endpoint applications. Before installation, please unzip and extract the software to your default downloads folder.

 

Windows Installation Instructions

Windows Download (CIMS authentication required) 

BigFix Installation Instructions for Windows

  1. Open the BigFix folder.
  2. From here you will run the BESAgent.exe application by double-clicking on it.
  3. BigFix's configuration is standard, follow the installer pop-up's instructions and default configurations. You shouldn't need to change anything, just click "Next" followed by "Install".
  4. Once you have received confirmation from the Installer, click "Finish" and BigFix has successfully installed on your Windows machine.

Cortex XDR Installation Instructions for Windows

  1. Open the CortexXDR folder.
  2. You are going to run the CortexXDR Windows Installer Package by double-clicking on "CortexXDR.msi". 
  3. In the Setup Wizard window that pops up, follow the onscreen instructions.
  4. 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

  1. Open the InsightVM folder. 
  2. You are going to run the "InsightVM” Windows Batch File by double clicking it. This wil launch the Rapid7 Insight Agent Setup Wizard.
    • 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. 
  3. 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."
  4. After your machine has been verified as compatible with the InsightVM software, installation will proceed as expected.
  5. Once you have hit the "Finish" button, then you have successfully installed InsightVM on your Windows Machine.

 

macOS Installation Instructions

macOS Download (CIMS authentication required) 

BigFix Installation Instructions for macOS

  1. Open the BigFix folder.
  2. Double-click on the package file titled "BESAgent.pkg" in order to launch the BigFix Installer.
  3. Follow the onscreen instructions, making sure to select the option "Install for all users of this computer" when prompted.
  4. You will be prompted to enter your password, in addition to allowing BigFix access to your files -- permit BigFix to do so.
  5. The Installer will inform you when the installation has successfully finished.

Cortex XDR Installation Instructions for macOS

  1. Open the CortexXDR folder.
  2. Double click on the package file titled "CortexXDR.pkg" in order to launch the Cortex XDR Installer.
  3. 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".
  4. Once it has been allowed, you will be presented with the Cortex XDR Installer. Click "Continue", and then click "Install".
  5. You will be prompted to enter your password. After entering your password, click on "Install Software"
  6. You will soon see a pop up: "Installer" would like to access files in your Downloads folder. Click "OK". 
  7. You will be presented with two pop ups: One popup pertains to Cortex Documentation -- you may close (or hit "Ok") on this popup. The other pop up pertains to Endpoint Security Extensions. 
  8. The Endpoint Security Extension popup states: "Cortex XDR" would like to use a new endpoint security extension. 
    • For this pop up, please click on "Open System Settings". This will open up your System Settings, specifically within the Endpoint Security Extensions section. You should see a toggle for "Cortex XDR - TrapsSecurityExtension" Toggle this on, and enter your password to authenticate. Click Done.
  9. You will see an additional pop up: "Cortex XDR" would like to use a new endpoint security extension.
    • Click on "Open System Settings". You should be within the Network Extensions section, with a "Cortex XDR - NetworkExtension" toggle. Toggle this on, and enter your password to authenticate.
    • Note: You must do Step 8 completely, then move onto Step 9. Both of these steps require opening System Settings.
  10. In the event that you missed these popups, you can locate the revelant sections using these following steps:
    • To locate the Endpoint Security Extensions: System Settings --> General --> Login items & Extensions --> Extensions (section) --> By Category (tab) --> Endpoint Security Extensions --> click on the "i" --> You will be presented with the Cortex XDR toggle for Endpoint Security Extensions. Make sure it is Toggled ON.
    • To locate the Traps Network Extensions: System Settings --> General --> Login items & Extensions --> Extensions (section) --> By Category (tab) --> Network Extensions --> click on the "i" --> you will be presented with the Cortex XDR toggle for Network Extensions. Make sure it is Toggled ON. 
  11. In the installer screen, click on "Open Cortex XDR Configuration Wizard". This separate program should walk you through enabling full disk access on your machine for Cortex XDR.
  12. At the Full Disk Access screen within the Configuration Wizard, make sure that "pmd", and "TrapsSecurityExtension" are both toggled on. You will need to authenticate in order to toggle these items on. 
  13. Drag and drop Only the “Cortex XDR Security Extension” icon to progress in the Configuration Wizard. Note that it may not appear in the Full Disk Access settings window depending on your macOS version.
  14. You should also see a notifications-related popup: "Cortex XDR Agent" Notifications. Click on Options --> Allow.
    • Please note that Cortex XDR requires notifications to be enabled in order to function properly. 
  15. You should see a timed popup: "Cortex XDR" Would Like to Filter Network Content -- click on Allow.
  16. Upon viewing your screen, you’ll see a Cortex XDR emblem icon at the top menu. Clicking it shows “Protection Status: Enabled.” 
  17. If the status is disabled, please check in now and Allow any remaining pop-ups. Once all are Enabled This confirms that you have successfully installed Cortex XDR.

InsightVM Installation Instructions for macOS

  1. Open the InsightVM folder.
  2. Control-click on "InsightVM.sh" 
  3. Click on "Open With"
  4. Select "Other..."
  5. Click on the "Enable:" section.
  6. Select "All Applications"
  7. Now search for "Terminal". Select it.
  8. Select "Open."
  9. You will be prompted, hit "Open"
  10. After successfully entering your password and granting access, the InsightVM installation will initiate. 
  11. You may be prompted to grant InsightVM access. If so, click on "Allow".
  12. Do not close the Terminal window until the installation process has completed. Once completed, you may then close your Terminal window.
  13. You may receive notifications that background items have been added. You may close these notifications. 

 

Linux Installation Instructions 

Linux Download (CIMS authentication required)

NOTE: Root access is required. You might need to search for how to enable root user depending on your Linux flavor. Typically, this requires first enabling the root password via the "sudo passwd root" command in Terminal. Afterwards, you can switch to root in Terminal using "su -" followed by entering your root password credentials. 

BigFix Installation Instructions for Linux

  1. First, make sure that you are currently logged in as the root user.
  2. Open up a Terminal window. Use the "cd" command to navigate to the Linux directory, which should contain the BigFix folder.

  3. 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 755 BigFix

  4. Create "BESClient" directory at the location /etc/opt -- you will need root permissions to do so:
    cd /etc/opt
    mkdir BESClient

  5. Navigate to this /etc/opt/ directory containing the BESClient directory that we have just created. Once there, execute the following command:
    chmod -R 755 BESClient

  6. Navigate into the BigFix folder. Depending on your Linux flavor, run one of the following commands.
    For RHEL
    rpm -ivh BESAgent.rpm

    For Debian
    dpkg -i BESAgent-debian.deb

    For Ubuntu
    dpkg -i BESAgent-ubuntu.deb

  7. While you're still inside of the BigFix directory, copy your action site masthead to the BESClient directory. This action site masthead contains configuration, license, and security information. Copy the file "actionsite.afxm" over to the BESClient directory using the following command:

    cp actionsite.afxm /etc/opt/BESClient

  8. Navigate to /var/opt/BESClient/ -- make sure to remove any files currently located in this directory. There 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. You can navigate to this directory and remove the files within using these following commands:

    cd /var/opt/BESClient

    rm *

  9. In the BigFix folder, copy the besclient.config file over to /var/opt/BESClient/ with the following command:

    cp besclient.config /var/opt/BESClient

  10. 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. You will not see an indicator of the installation process being underway. You can confirm, however, that the installation is underway by noting that new files are being written to /var/opt/BESClient.

 

Cortex XDR Installation Instructions for Linux

  1. First, make sure that you are currently logged in as the root user.
  2. Open up a Terminal window. Use the "cd" command to navigate into the CortexXDR folder.
  3. While inside of the CortexXDR folder, create the /etc/panw directory with the following command:

     mkdir -p /etc/panw

  1. Copy the configuration file "cortex.conf" using the following command:

     cp cortex.conf /etc/panw/

  1. Enable execution of the script with the following command:

     chmod 755 cortex.sh

  1. Run the installer script with the following command:

     ./cortex.sh

  1. Once installation has successfully finished, you should see "Done". 

InsightVM Installation Instructions for Linux

  1. First, make sure that you are currently logged in as the root user. 
  2. Open up a Terminal window. Use the "cd" command to navigate into the Linux directory, which should contain the InsightVM folder.
  3. Grant full read/write access to all folders and subdirectories in the InsightVM folder with the following command:

     chmod -R 755 InsightVM

  1. Navigate into the InsightVM folder:

           cd InsightVM

  1. We will now begin the installation process. 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"

  1. Once the installation has finished, you should see [SUCCESS]

 

 

Should you have any issues with installing any of the Endpoint applications, please contact the Courant Helpdesk.