This guide explains how to deploy the VIPRE Endpoint Cloud Agent using an MSI installer through Kaseya VSA. Kaseya’s IT automation capabilities make it simple to deploy software across multiple endpoints quickly and efficiently.

Prerequisites

1. Administrative access to Kaseya VSA.
2. The latest VIPRE Endpoint Cloud Agent MSI installer, available from the VIPRE Security portal.
3. Target machines should meet the system requirements for the VIPRE Endpoint Cloud Agent and be online in the Kaseya VSA environment.

Step-by-Step Deployment

1. Upload the VIPRE MSI Installer to Kaseya VSA

To deploy the VIPRE agent through Kaseya, the MSI installer needs to be uploaded to Kaseya’s Software Management:

1. Log into the Kaseya VSA Web Interface.
2. Go to Agent Procedures > Manage Procedures > Schedule/Create.
3. In the procedure editor, upload the VIPRE MSI installer into the Kaseya file repository:
   • Navigate to Agent Procedures > Files > Manage Files.
   • Upload the MSI installer to the appropriate directory, such as Shared Files or a custom directory for software deployment.

2. Create an Agent Procedure for MSI Installation

Now, create an Agent Procedure to run the VIPRE MSI installer:

1. Go to Agent Procedures > Schedule/Create > New Procedure.
2. Name the procedure (e.g., “Deploy VIPRE Endpoint Cloud Agent”).
3. Click Edit Procedure to open the procedure editor.

Add Commands to the Procedure:

Step 1: Use the Execute File command to execute the VIPRE MSI installer:

Set the File Path to point to where the MSI was uploaded (e.g., #vAgentConfiguration.agentTempDir#\VIPREEndpointAgent.msi).

Set the Command Line Parameters to:

Step 2: Optionally, use the Write Log Entry step to log the status of the deployment, helping you track successful or failed installations.

3. Assign the Procedure to Target Devices

After creating the Agent Procedure, you need to schedule it for deployment to the desired devices:

1. Go to Agent Procedures > Manage Procedures.
2. Select the “Deploy VIPRE Endpoint Cloud Agent” procedure.
3. Choose the machine group or individual devices where the procedure should be deployed.
4. Click Run Now to execute immediately, or schedule the deployment for a specific time using the Schedule Procedure option.

4. Monitor the Deployment

Kaseya VSA allows you to monitor the deployment progress and view logs in real-time:

1. Go to Agent Procedures > View Logs to check the status of the deployment.
2. Review logs for any errors or failures:
   • Common issues include network connectivity problems or devices being offline.
   • The logs will indicate if the MSI installer failed to run on any specific machine.

5. Post-Deployment Verification

After the deployment is complete, verify that the VIPRE Endpoint Cloud Agent is successfully installed:

1. Check the Programs and Features list on the deployed endpoints to confirm that VIPRE is listed as an installed program.
2. Ensure that VIPRE services are running in the background by checking the services in Task Manager or using a script to verify services remotely.
3. Log into the VIPRE Cloud Console to confirm that the new endpoints are appearing and reporting properly.

6. Troubleshooting

If any issues arise during the deployment, here are some common troubleshooting steps:

• Check Procedure Logs: Kaseya VSA logs will provide detailed information about why a deployment may have failed (e.g., incorrect file paths, insufficient permissions, or network issues).
• Device Compatibility: Ensure that the target devices meet VIPRE’s minimum system requirements.
• Firewall Settings: Make sure that the necessary firewall and network settings are allowing communication between the devices and VIPRE servers.

7. Automating Updates and Uninstallation

Automating Updates: When a new MSI version is released by VIPRE, follow the same process to upload the updated MSI and modify the Agent Procedure to deploy the new version.

Uninstalling VIPRE: If you need to uninstall the VIPRE Endpoint Cloud Agent, create a new Agent Procedure with the following command to silently uninstall:

Replace {ProductCode} with the actual product code of the VIPRE agent installed on the devices, which can be found in the Windows registry or by querying the system.

Conclusion

Using Kaseya VSA to deploy the VIPRE Endpoint Cloud Agent allows you to automate and streamline the process of securing endpoints across your organization. Follow these steps to ensure a smooth deployment and ongoing management of the VIPRE agent.

For additional assistance or troubleshooting, reach out to VIPRE Support or refer to Kaseya VSA’s documentation for further details on creating and managing Agent Procedures.