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.
Log in to SecureEdge Manager.
Select the workspace you want to configure an identity provider and user directory.
Go to Settings > Identity Providers and add your organization's IdP. For more information, see How to configure an identity provider.
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.
In SecureEdge Manager, go to Settings > User Directories.
Select your directory and click Sync.
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.
Go to Access > Enrollments.
Select New Enrollment and click Group.
Under License and seats, set the number of seats this limits how many devices can enroll with this token.
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.
Copy the device profile token and paste it into a text file. You will need this value for the installation command in Step 4.
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-installwith the SecureEdge MSI location.Replace the
TENANT_TOKENwith the token from the SecureEdge Manager.
Parameter breakdown:
Parameter | Description |
|---|---|
| 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. |
| Runs the installation silently with no UI. |
| Writes a verbose installation log to the specified file, useful for troubleshooting failed installations or enrollments. |
| 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.logLook 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 AgentNew 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:
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.
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.
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 |
|---|---|
Installation completes but the device does not appear in SecureEdge Manager | Confirm the |
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 |
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 |