Agent Deployment via Pulseway (MSI Installer)

VIPRE Endpoint Cloud Agent Deployment via Pulseway (MSI Installer)

Written By Alex Clark (Draft Writer)

Updated at October 31st, 2024

This article outlines the steps to deploy the VIPRE Cloud Agent for Windows through Pulseway using an MSI installer. Pulseway’s scripting and automation features allow you to manage deployment across your endpoints efficiently.

Prerequisites

  1. Administrative access to the Pulseway Web App
  2. The latest VIPRE Cloud Agent for Windows MSI installer, downloadable from the VIPRE Security portal
  3. Ensure all target machines meet the system requirements for the VIPRE Cloud Agent

Step 1 - Upload the VIPRE MSI Installer to Pulseway

Before you can deploy the agent, upload the VIPRE MSI installer to Pulseway:

  1. Log into Pulseway Web App (Pulseway Dashboard)
  2. Go to the Automation section and select Scripts
  3. Click New Script to create a new script for the VIPRE deployment

Step 2 - Create a Deployment Script

To deploy the VIPRE Cloud Agent, create a script that runs the MSI installer in silent mode:

  1. Script Name: Name the script, for example, “VIPRE Cloud Agent Deployment.”
  2. Script Language: Select Batch (since Pulseway supports multiple scripting languages, choose the one that best fits your environment).
Script Content:

Use the following script to install the MSI on the endpoints silently:

msiexec /i "C:\path\to\VIPREEndpointAgent.msi" /quiet /norestart

Make sure to adjust the file path to point to the location where the MSI installer will be located on the target machines. You can use Pulseway to copy the MSI installer to the desired location before running this script.

If the installer is hosted on a network share or cloud storage (e.g., Dropbox, OneDrive), you can modify the script to download it first:

powershell -Command "Invoke-WebRequest -Uri 'https://yourstorage.com/VIPREEndpointAgent.msi' -OutFile 'C:\temp\VIPREEndpointAgent.msi'" msiexec /i "C:\temp\VIPREEndpointAgent.msi" /quiet /norestart

Step 3 - Set Up File Transfer for the MSI Installer (Optional)

If the installer is not hosted on a cloud or network share, you can configure a file transfer task in Pulseway to copy the MSI installer to the target machines:

  1. Go to the Tasks section
  2. Select File Transfer, and upload the MSI installer
  3. Set the destination path where the MSI should be stored on the target machine (e.g., C:\temp)

Step 4 - Assign the Script to Target Devices

Now that the script is ready, assign it to the desired devices or device groups:

  1. Navigate to the Automation section and click Tasks
  2. Select New Task
  3. Choose the previously created script as the task
  4. Under Target Devices, select the devices or device groups you wish to deploy the VIPRE agent to

Step 5 - Schedule or Run the Deployment

You can choose to run the deployment immediately or schedule it for a later time:

  1. To deploy immediately, click Run Now, and the script will be executed on the selected devices
  2. To schedule the deployment for a specific time, configure a Task Schedule to run the script at an appropriate time to minimize user disruption (e.g., during off-peak hours)

Step 6 - Monitor the Deployment

Pulseway allows you to monitor the progress of your task deployment in real-time:

  1. Navigate to Automation > Tasks > History
  2. Review the task execution logs for any errors or failures during the deployment
  3. If the task fails, check for common issues such as:
    • Network connectivity issues
    • Incorrect file paths or script errors
    • Incompatible device OS versions

Step 7 - Post-Deployment Verification

Once the deployment is complete, verify that the VIPRE Cloud Agent for Windows was installed successfully:

  1. On the target devices, check Programs and Features to see if the VIPRE agent appears in the installed applications list
  2. Ensure the VIPRE services are running properly in the background
  3. Log into the VIPRE Cloud Console to confirm that the devices are reporting correctly and are being managed

Step 8 - Troubleshooting

If the deployment encounters any issues:

  • Check Task Logs: Review the task logs in Pulseway for errors during execution
  • Device Compatibility: Ensure that the target devices meet the minimum system requirements for VIPRE
  • Network or Firewall Issues: Ensure that no firewall or network rules are blocking the MSI download or installation

Post-Deployment Management

Scheduled Updates: As we release new MSI versions, follow the same process to upload and deploy the updated installer.

Automate Uninstallation: To uninstall the VIPRE Cloud Agent, create a similar script using the MSI product code:

msiexec /x {ProductCode} /quiet /norestart

The product code for the VIPRE Cloud Agent can be found in the Windows registry or extracted from an installed machine using a tool.

Following these steps, you can successfully deploy the VIPRE Cloud Agent for Windows across your organization’s devices using Pulseway. Pulseway’s automation features streamline the deployment process and ensure all endpoints are secured with the latest VIPRE agent.

For further assistance, contact VIPRE Support or refer to Pulseway’s documentation for more detailed instructions on automation and scripting.