How to Install the SecureEdge Access Agent Using MSI for Unattended Enrollment

How to Install the SecureEdge Access Agent Using MSI for Unattended Enrollment

This article describes how to install and enroll the SecureEdge Access Agent on Windows devices using MSI unattended enrollment. By supplying a group enrollment token to the MSI installer, the agent can be installed and enrolled automatically without requiring users to complete browser-based authentication. This deployment method is ideal for manual and scripted installations.

Before You Begin

  • You must uninstall any existing SecureEdge Access Agent from the system.

  • You must delete any remaining SecureEdge Access Agent folders before starting the installation.

Step 1. Add an Identity Provider and User Directory

SecureEdge Manager must have an IdP and user directory configured so that users and groups can be used for enrollment. For more information, see SecureEdge Identity Management.

  1. Log in to SecureEdge Manager.

  2. Select the workspace you want to configure an identity provider and user directory.

  3. Go to Settings > Identity Providers and add your organization's IdP. For more information, see How to configure an identity provider.

    email.png
  4. Go to Settings > User Directories and connect your directory. For more information, see How to Configure User Directories.

Note on IdP selection

Email authentication is the simplest way to get started, but it is not recommended for production deployments. For production environments, integrate with a supported identity provider, such as Microsoft Entra ID, to simplify user management and authentication.

 

Step 2. Synchronize User Groups

After connecting the user directory, synchronize it to pull in the groups that will be used for enrollment.

  1. In SecureEdge Manager, go to Settings > User Directories.

  2. Select your directory and click Sync.

    entra-id.png
  3. Wait for the sync to complete, confirm that your intended groups appear in the directory listing, and verify the enrollment group before continuing to ensure the right users receive seats when the token is used.

 

Step 3. Create a Group Enrollment Invitation

Group-based enrollment generates a token that is tied to a directory group and a device profile. Any device that installs using this token is enrolled under that group.

  1. Go to Access > Enrollments.

  2. Select New Enrollment and click Group.

  3. Under License and seats, set the number of seats this limits how many devices can enroll with this token.

  4. Select a device profile to apply to enrolled devices and create an enrollment invitation. The new enrollment entry appears in the list with a generated <device profile> token.

  5. Copy the device profile token and paste it into a text file. You will need this value for the installation command in Step 4.

    cp-token.png

Virtual Machines without TPM:

If you are installing on a virtual machine (VM) that does not have a Trusted Platform Module (TPM), you must disable the TPM setting in the device profile to ensure successful installation.

 

Step 4. Run the MSI Installation Command

To install the SecureEdge Access Agent:

Open an elevated command prompt or PowerShell window on the target device and run the following command:

msiexec /i "C:\sea-install\SecureEdgeAgent_3.0.4-25_x64.msi" /qn /L*v "C:\sea-install\SEAInstall.log" TENANT_TOKEN="<replace_with_group_token>"

Replace the MSI path and token with your values:

  • Replace c:\sea-install with the SecureEdge MSI location.

  • Replace the TENANT_TOKEN with the token from the SecureEdge Manager.

Parameter breakdown:

Parameter

Description

Parameter

Description

/i <path>

Specifies the full path to the SecureEdge Access Agent MSI file. Update this to match the location where the MSI is stored on the target device.

/qn

Runs the installation silently with no UI.

/L*v <log path>

Writes a verbose installation log to the specified file, useful for troubleshooting failed installations or enrollments.

TENANT_TOKEN

The enrollment token copied from SecureEdge Manager in Step 3. Paste the complete token value inside the double quotes.

 

Step 5. Monitor Installation Progress

The installation runs silently. Allow a few minutes for the agent to install and complete enrollment.

You can track progress in two places while you wait:

Installation Log

Open the log file specified in the command to see MSI installation events:

C:\sea-install\SEAInstall.log

Look for a line containing Installation success or error status: 0 to confirm the MSI installation completed without error.

Agent Application Data Folder

Open the user AppData folder to observe files being created as the agent initializes and enrolls:

C:\Users\<username>\AppData\Local\Barracuda\SecureEdge Agent

New files and subdirectories appearing here indicate the agent is running and progressing through enrollment.

 

Step 6. Verify the Installation

To verify the installation, follow these steps:

  1. Check the Windows Services

    • Open Task Manager and select the Services tab, or run services.msc. Verify that the Barracuda SecureEdge Access Agent service is listed and its status is Running.

  2. Check the system tray

    • Confirm that the SecureEdge Access Agent icon appears in the Windows system tray. A Connected status indicates that the agent has enrolled successfully and established a session.

  3. Confirm enrollment in SecureEdge Manager

    • Log in to SecureEdge Manager, go to Access > Enrolled Devices. Verify that the device appears in the enrolled list and has an active enrollment status.

 

Troubleshooting

Issue

Resolution

Issue

Resolution

Installation completes but the device does not appear in SecureEdge Manager

Confirm the TENANT_TOKEN value was copied correctly. Check SEAInstall.log for errors and verify that the device has outbound internet access to the SecureEdge enrollment endpoint.

Enrollment fails on a virtual machine

Check the TPM configuration in the device profile assigned to the enrollment. If TPM is enabled in the profile but not available on the VM, enrollment will fail. After updating the profile, re-run the installation.

MSI returns error

This is a general installation failure. Open SEAInstall.log and search for entries containing error to identify the cause. A common cause is a previous agent installation that was not fully removed. Repeat Steps 4 and 5, then re-run the installation.

No seats available enrollment rejected

The group enrollment has reached its seat limit. In SecureEdge Manager, go to Access > Enrollments, select Subscription seat usage, and check seat availability.

Agent service is not running after installation

Open services.msc and try starting the Barracuda SecureEdge Access Agent service manually. If it fails to start, review SEAInstall.log and the agent logs in C:\ProgramData\Barracuda\SecureEdge Agent for error details.

 


We value your feedback.
If you have questions, suggestions, or feedback on our documentation, contact the Campus Product Documentation team.
For general product inquiries or technical support, please contact the global Barracuda Support team.