This guide provides step-by-step instructions for deploying and managing Actifile agents using ConnectWise Automate RMM.
Step 1. Create a group named Actifile for deployment. For this group, set the search to the machines you want to deploy. This will automatically populate the group with computers that are to be deployed.
Step 2. Create a script for the Actifile deployment. Use the script below to check if Actifile is installed, install it if not, and record the result.
Replace the installer path and tenant's install key (highlighted in bold) with your values.
Script:
REM ===================DEFINE MSI,UPN,log file & folder here==============
SET MSINAME=ActifileAgent.msi (Full path to the installation file)
SET UPN=Actifile SET LOGSFOLDER="C:\ApplicationLogs\%UPN%_Install.log"
IF NOT EXIST "C:\ApplicationLogs" MD "C:\ApplicationLogs"
REM ===================Check if the Product exists already==================
SET PRODUCTKEY=HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall
REG QUERY %PRODUCTKEY%\{0D13F554-E542-4590-AACB-AA60CAE75A64}
IF NOT %ERRORLEVEL% EQU 0 (GOTO :INSTALL) ELSE GOTO :ENDHERE
REM =======================Install the application========================
:INSTALL
MSIEXEC.EXE /I "C:\Users\Simon Chulsky\Dropbox\Actifile\Deployment\ActifileAgent.msi" installkey=1234-1234-ABCD-EFGH /quiet
SET MSIERROR=%errorlevel% if %MSIERROR%==0 GOTO :ENDHERE
if %MSIERROR%==1641 GOTO :ENDHERE
if %MSIERROR%==3010 GOTO :ENDHERE
GOTO :ERROR
REM ================ Installation successful. Write to Event Log==================
:ENDHERE
EVENTCREATE /l Application /so %UPN%-Install-SUCCESS /t SUCCESS /id 1000 /d "Actifile Application installed successfully."
Exit 0
REM ================ Installation failed. Write to Event Log======================
:ERROR
EVENTCREATE /l Application /so %UPN%-Install-FAILED--(ERROR=%MSIERROR%) /t ERROR /id 999 /d "Actifile Application installation failed."
Exit %MSIERROR%
Step 3. Navigate to the group and open the Computers tab. Select Scheduled Scripts, add the newly created script, and set it to run at your preferred frequency (e.g., daily or every few hours).
Note: We recommend running the script at least once a day, or preferably every few hours. This ensures that computers frequently connecting and disconnecting are still included. Additionally, select the advanced option and ensure the script is configured to run only on online computers.
Managing Actifile Agents with PowerShell scripts
Starting with agent version 2.0.50.0, you can manage Actifile agents directly with PowerShell scripts that you can run via Automate.
The following files are installed automatically in C:\Program Files (x86)\Actifile\Powershell support scripts\ and enable MSPs to activate, deactivate, and manage agents using their RMM tools:
- List-Minifilters.ps1: Lists the loaded filters. Actifile is active if the Easefilter minifilter is loaded.
- Enable-Actifile.ps1: Starts Actifile services and sets their startup mode to "Automatic."
- Disable-Actifile.ps1: Stops Actifile services, unloads the minifilter driver, and sets the startup mode to "Manual."
- Kill-Actifile.ps1: Use this if the Actifile Agent cannot be unloaded.
- Unload-Actifile-Filter.ps1: Unloads the Easefilter minifilter. Note: If the services are running, the minifilter will automatically reload.