How to Install the Secureworks Taegis XDR Agent

Summary: The Secureworks Taegis XDR Agent can be installed by following these instructions for Windows, Linux, or macOS.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

This article covers the installation process for the Secureworks Taegis XDR Agent.

Affected Product:

  • Secureworks Taegis XDR

Affected Operating Systems:

  • Windows
  • macOS
  • Linux
Note:

Click Windows, macOS, or Linux for the steps to install the Secureworks Taegis XDR Agent.

Windows

The Secureworks Taegis XDR Agent can be installed on Windows through the user interface (UI) or command-line interface (CLI). An administrator may then Confirm the Agent Installation. Click the appropriate process for more information.

  1. As an administrator, double-click the taegis-agent_[VERSION]_x64.msi installer file.
    Installer file
    Note: [VERSION] = The version of the .msi installer file
  2. The Taegis Agent Setup Wizard appears. Click Next to proceed.
    Setup wizard
  3. Click Next.
    Select installation folder
  4. Populate your Registration Key and Registration Server, then click Next.
    Registration Key and Registration Server
    Note:
    • The Registration Key is the key that is generated for any group that is created in Endpoint Management > Group Configuration. For more information about creating a group or locating the registration key, reference How to Create a Secureworks Taegis XDR Agent Group.
    • The Registration Server is the registration server URL displayed in the Endpoint Management > Group Confirmation screen of the Secureworks Taegis XDR Console.
    • Optionally, provide your host and port information for an environmental proxy server, if needed.
  5. Click Next.
    Confirm Installation
  6. If User Account Control (UAC) is enabled, click Yes. Otherwise, go to Step 7.
    User Account Control prompt
  7. The Secureworks Taegis XDR Agent installs. Once the installation is complete, click Close to exit the installation wizard.
    Installation Complete
  1. Right-click the Windows start menu and then click Run.
    Run
  2. In the Run UI, type cmd and then press CTRL+SHIFT+ENTER. This runs Command Prompt as an administrator.
    Run UI
  3. Type msiexec /i [PATH] REGISTRATIONKEY=[REGISTRATION KEY] REGISTRATIONSERVER=[TAEGIS SERVER] /quiet /norestart and then press Enter.
    Windows command line install
    Note:
    • [PATH] = The full directory path to where the taegis-agent_[VERSON]_x64.msi file is located.
    • [VERSION] = The version of the .msi installer file
    • [REGISTRATION KEY] = The key that is generated for any group that is created in Endpoint Management > Group Configuration. For more information about creating a group or locating the registration key, reference How to Create a Secureworks Taegis XDR Agent Group.
    • [TAEGIS SERVER] = The registration server URL displayed in the Endpoint Management > Group Confirmation screen of the Secureworks Taegis XDR Console.
    • Optionally, add the PROXY= switch and provide your host and port information for an environmental proxy server, if needed. For example, type msiexec /i [PATH]\taegis-agent_[VERSION]_x64.msi REGISTRATIONKEY=[registration key] REGISTRATIONSERVER=[registration server] PROXY=[proxyserver:port] /quiet /norestart and then press Enter.
  1. Right-click the Windows start menu and then click Task Manager.
    Task Manager
  2. From the Process tab, locate Taegis Agent Host and Taegis Agent Service in the Background processes list. If these cannot be located, contact Dell Support.
    Processes in the Background Processes list
    Note:

    For more information about contacting support, reference How to Get Support for Secureworks Taegis XDR.

macOS

An administrator may Install the Secureworks Taegis XDR Agent and then Confirm the Agent Installation. Click the appropriate process for more information.

  1. Double-click the Taegis-agent_[VERSION].pkg file to start the installation process.
    Installer package
    Note: [VERSION] = The version of the .pkg installer file
  2. Click Continue.
    Installer Introduction
  3. Click Install.
    Installer Destination Type
  4. Populate macOS administrative credentials and then click Install Software.
    Installer administrative credential prompt
  5. Once the installation begins, a System Extensions Setup prompt appears. Populate Key and Server Name information, then click Start.
    System Extensions Setup
    Note:
    • The Key is the key that is generated for any group that is created in Endpoint Management > Group Configuration. For more information about creating a group or locating the registration key, reference How to Create a Secureworks Taegis XDR Agent Group.
    • The Server Name is the registration server URL displayed in the Endpoint Management > Group Confirmation screen of the Secureworks Taegis XDR Console.
  6. A System Extension Blocked prompt appears. Click Open Security Preferences.
    System Extension Blocked
    Note: If there are more System Extension Blocked prompts after the first (Step 6), click OK on each of them. Security Preferences is only necessary to open one time (Step 6).
  7. In the lower left corner of the Security & Privacy screen, click the padlock icon to unlock settings.
    Padlock icon
  8. Populate macOS administrative credentials.
    System Preferences administrative credentials prompt
  9. At the bottom of the settings, locate Some system software was blocked from loading and then click Allow.
    Allow
  10. Select all instances of SecureworksTaegis and then click OK.
    Selecting SecureworksTaegis
  11. Click to Allow when prompted about allowing SecureworksTaegis to filter network content.
    Allow filtering
  12. From the Privacy Tab of Security & Privacy, select SecureworksTaegis, com.secureworks.agent.fim, and com.secureworksagent.pro.
    Selecting privacy options
  13. Select Later when prompted about SecureworkTaegis not having full disk access until it is quit.
    Later
  14. Close the Security & Privacy settings.
    Closing Security and Privacy
  15. From the System Extensions Setup screen, click Close.
    Close System Extensions Setup
    Note: A Secureworks Taegis XDR Agent Setup Screen may appear, stating "Agent does not have full-disk access enabled" with a red dot. This is expected, as the agent and operating system have not been restarted since we granted this right.
  16. From the Install Secureworks Agent screen, click Close.
    Installer summary
  17. Installation and configuration are now complete. Click the Apple logo on the top-left corner and select Restart.
    Restart
  1. After macOS has restarted from software installation, open the SecureworksTaegis app.
    SecureworksTaegis app
  2. The Secureworks Taegis XDR Agent Setup screen is displayed. Confirm that there are green dot statuses for System Extensions, Full Disk Access, and Connection Status.
    Review for green dots
  3. The Secureworks Taegis XDR Agent is successfully installed and registered. If there are red dot statuses for any items from Step 2, contact Dell Support.
    Note: For more information about contacting support, reference How to Get Support for Secureworks Taegis XDR.

Linux

The Secureworks Taegis XDR Agent can be installed on Linux using the .deb or the .rpm. An administrator may then Confirm the Agent Installation. Click the appropriate process for more information.

  1. Open Terminal.
    Terminal
    Note: Optionally, the CTRL+ALT+T keyboard combination can be used to launch Terminal.
  2. Type sudo apt install [PATH]/taegis-agent_[VERSION]_amd64.deb and then press Enter.
    Linux .deb install command
    Note:
    • [PATH] = Path to the .deb file
    • [VERSION] = The version of the .deb installer file
  3. Once the agent is successfully installed, it must be registered. Type sudo /opt/secureworks/taegis-agent/bin/taegisctl register --key [REGISTRATION KEY] --server [TAEGIS SERVER] and then press Enter.
    Linux .deb registration command
    Note:
    • [REGISTRATION KEY] = The key that is generated for any group that is created in Endpoint Management > Group Configuration. For more information about creating a group or locating the registration key, reference How to Create a Secureworks Taegis XDR Agent Group.
    • [TAEGIS SERVER] = The registration server URL displayed in the Endpoint Management > Group Confirmation screen of the Secureworks Taegis XDR Console.
  4. A registration success message is displayed when registration is successful.
    Registration success
    Note: If registration fails, collect logs to help troubleshoot the registration failure. For more information, reference How to Collect Logs for Secureworks Taegis XDR Agent.
  1. Open Terminal.
    Terminal
    Note: Optionally, the CTRL+ALT+T keyboard combination can be used to launch Terminal.
  2. Type sudo rpm -i [PATH]/taegis-agent_[VERSION]_x86_64.rpm and then press Enter.
    Linux .rpm install command
    Note:
    • [PATH] = Path to the .rpm file
    • [VERSION] = The version of the .rpm installer file
  3. Once the agent is successfully installed, it must be registered. Type sudo /opt/secureworks/taegis-agent/bin/taegisctl register --key [REGISTRATION KEY] --server [TAEGIS SERVER] and then press Enter.
    Linux .rpm registration command
    Note:
    • [REGISTRATION KEY] = The key that is generated for any group that is created in Endpoint Management > Group Configuration. For more information about creating a group or locating the registration key, reference How to Create a Secureworks Taegis XDR Agent Group.
    • [TAEGIS SERVER] = The registration server URL displayed in the Endpoint Management > Group Confirmation screen of the Secureworks Taegis XDR Console.
  4. A registration success message is displayed when registration is successful.
    Registration success
    Note: If registration fails, collect logs to help troubleshoot the registration failure. For more information, reference How to Collect Logs for Secureworks Taegis XDR Agent.
  1. Open Terminal.
    Terminal
  2. In Terminal, type sudo /opt/secureworks/taegis-agent/bin/taegisctl status to confirm that the agent is successfully registered. Agent is Registered should have a status of true.
    Confirming agent is registered
  3. If the agent is not running (Step 2), type sudo /opt/secureworks/taegis-agent/bin/taegisctl start and then press Enter.
    Starting agent
  4. Type sudo /opt/secureworks/taegis-agent/bin/taegisctl status and then press Enter. The agent status displays running.
    Agent status running

To contact support, reference Dell Data Security International Support Phone Numbers.
Go to TechDirect to generate a technical support request online.
For additional insights and resources, join the Dell Security Community Forum.

Affected Products

Secureworks
Article Properties
Article Number: 000193438
Article Type: How To
Last Modified: 03 Jun 2024
Version:  7
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.