RMM and MDM
      Back to home
      1. Knowledge Base
      2. Deploy the Local Data Agent
      3. RMM and MDM

      Deploy Actifile with Kaseya VSA

      The article explains how to install the Actifile agent using Kaseya VSA. It also includes troubleshootingtips to address common installation issues.

      Note: These procedures apply to VSA9 and earlier versions. For VSAX (Pulseway), you can use out-of-the-box PowerShell and deploy with Actifile’s standard PowerShell scripts.

      Install Actifile with Kaseya VSA

      Step 1. In the Kaseya VSA interface, select a cabinet or folder from the middle pane. Click the New Procedure button. This will open the Creating / Editing Agent Procedures dialog.

       

      Step 2. Assign the name Actifile Installation to your new procedure.

       

      Step 3. From the statements pane, select the required statements (highlighted in yellow in the picture below). Carefully fill in the parameters (highlighted in green and blue).

      Important: Ensure that the spaces in the commands are accurate. Kaseya VSA uses proportional fonts, which can make it appear as though there is a space where there isn’t one.

      Script:

      getURL("https://app.actifile.com/Home/DownloadAgentMsi","#vagentconfiguration .agenttempdir#\actifileagent.msi", "Wait for Completion", "All Operating Systems", "Halt on Fail") 
      If testFile("#vagentconfiguration.agenttempdir#\actifileagent.msi") Exists 
      executeShellCommand("msiexec /I #vagentconfiguration.agenttempdir# \actifileagent.msi installkey= /quiet", "Execute as System", "All Operating Systems", "Halt on Fail")

      Illustration:

      It should appear as shown in the screenshot:

       

      Step 4. To ensure a valid Actifile_installkey variable (see the following steps) exists for the customer you are deploying the Actifile agent to, consider adding this optional check to your script:

      If checkVar() Exists 

      The full procedure would be: 

      If checkVar() Exists 
      getURL("https://app.actifile.com/Home/DownloadAgentMsi","#vagentconf iguration.agenttempdir#\actifileagent.msi", "Wait for Completion", "All Operating Systems", "Halt on Fail") 
      If testFile("#vagentconfiguration.agenttempdir#\actifileagent.msi") Exists 
      executeShellCommand("msiexec /I #vagentconfiguration.agenttempdir#\actifileagent.msi installkey= /quiet", "Execute as System", "All Operating Systems", "Halt on Fail") 

       

      Step 5. Save your procedure using the File drop-down menu.

       

      Step 6. In the Variable Manager, create a new Managed Variable called Actifile_installkey. Learn more about using variables and Variable Manager in Kaseya official documentation.

       

      Step 7. In the partner portal, navigate to the Tenants page (new interface) or Customers tab (old interface). If the customer is not listed, click Add and complete the customer details.

      Note: A unique email address is required for each customer. You can use a Google-style ad-hoc alias, such as user+customername@gmail.com, for convenience.

       

      Step 8. Copy the install key and paste it into the Actifile_installkey variable for all group IDs associated with the tenant. Refer to this guide for details on locating the key.

       

      Step 9. Run the Actifile Installation procedure for group IDs that have an associated Actifile_installkey variable.

       

      Notes:

      • DO NOT set a default Actifile_installkey value.

      • Each group ID must have its own Actifile_installkey value.

      • If a tenant (a single customer) has more than one group ID (e.g., a bank with separate group IDs for branches), they should all share the same Actifile_installkey value.

       

      Troubleshooting

      If the installation fails, check the following:

      1. Verify that actifileagent.msi is downloaded to the target machine in the #vagentconfiguration.agenttempdir# folder. On a Windows machine, this folder is typically located at C:\kworking.

        If the file is missing, the getURL script command may be failing or improperly configured.

      2. Ensure the Actifile Agent and Actifile Updater services are running, and confirm that C:\Program Files (x86)\Actifile is fully installed.

        If these services are not running or the folder is incomplete, the installation command (executeShellCommand("msiexec ...")) may be incorrect.