Introduction
With workers now having the ability and choice to work from home, VSM Everywhere (VSM-E) provides customers and business partners with a tool to help monitor and diagnose unmanaged systems that are active outside of an office environment.
Setting Up VSM Everywhere
What You Will Need
Before installing the VSM-E client you will need the following:
- A Virsae Cloud Collector and the URL for this collector
- A copy of the VSM-E installer
- A VSM Everywhere profile group configured in the web portal
- Administrator-level permissions on the machine where the VSM-E client will be installed.
Configuring a Cloud Collector
The VSM-E client is designed to communicate with a VSM Cloud Collector. Click here for instructions on setting up an Equipment Location with the 'Appliance' type set to Virtual (Virsae Cloud).
Once a VSM Cloud Collector has been administered please contact support@virsae.com to request the URL for this collector.
Getting the Installer
Contact support@virsae.com for a copy of the VSM-E installer package.
System Requirements
| Item | Specification |
|---|---|
| CPU | Recommended 4 cores @ 2.4ghz |
| RAM | 4GB |
| Disk | 10GB |
| O/S | Windows10 or above with .NET Framework 4.72 or higher |
Configuring Profile Group for VSM Everywhere
Before a VSM-E client can start tracking the performance of a system, it must first know what metrics it needs to track. This is determined by creating a VSM-E Profile Group.
To create a Profile Group go to the VSM Web Portal and then navigate to Service Desk > Equipment Locations > VSM Everywhere.
Customer View menu ( Service Desk > Equipment Locations):
Business Partner view (from Customer tile > Service Desk > Equipment Locations):
Select VSM Everywhere (from the required Equipment Location):
When on the Profile Groups page for the first time, you will see "No Profile Groups Found"
- To configure a profile group, click the "+" button at the bottom of the group list to begin creating a new group.
- Enter a Group Name and
- Choose which metrics you wish to track.
- Once complete click the 'Add Group' button
A Profile Group represents a set of metrics that the VSM-E client will track:
The table below describes what each option represents.
| Field | Description |
|---|---|
| Group Name | The name of the profile group. |
| Set As Default Group | If a collector cannot find a group that is requested by a VSM Everywhere client, this is the group that will be used. |
| Performance Counter Probe Enabled | Enables the Performance Counter probe. If this option is not selected, you cannot select the "Disk", "Memory", "Process", and "Processor" options. |
| Disk | Tracks the disk usage of a system. |
| Memory | Tracks the memory usage of a system. |
| Process | Tracks the running process on the host system. |
| Processor | Tracks the CPU usage of a system. |
| Speed Test Probe Enable | Enables the Speed Test Probe, which measures internet performance from the host. |
| Speed Test Frequency | Select a recurring frequency between 5 minutes and 60 minutes. (Default value is 10 minutes) This requires a VSM-E version of 1.0.53 and above. |
Default groups have a tick beside their name in the side navigation bar.
You can edit groups at any point by pressing the "Edit Group" button. All fields are editable.
You can also delete groups at any time.
A collector MUST have a default group.
When you create your first group, it will automatically be set as the default.
When the existing default group is deleted and another group is available, it will be set as the default automatically.
Installing VSM Everywhere
VSM Everywhere can be deployed to each target machine manually via an installation package or automatically via a software deployment tool such as Microsoft Intune.
Both methods are detailed below:
Manual Installation
Obtain the latest installation package via your Virsae Service Delivery Manager or support@virsae.com.
The installation will be within a ZIP file which you must extract. To do this right click on the ZIP file and select 'Extract All...' you will then be prompted to confirm the directory to extract the files to, most times the default suggestion will be fine.
Once the files are extracted right click on the setup.exe file and then select 'Run as administrator'.
You may be presented with a Windows User Account Control dialogue warning this installation is from an unknown publisher. If you cannot confirm the source of the install files is Virsae, then please do not continue, otherwise let the installation continue.
You will then be presented with the installer title page, click 'Next' to continue.
The end user license agreement will be presented. Once you have read and accept this please check the 'I accept...' box and then click 'Next' to continue.
The default installation location will then be presented. For most installations this location will be fine, however if you wish to install to a different location please modify this then click 'Next' to continue.
You will then be prompted to enter your Virtual Collector URL and the name of the profile group you setup earlier.
If you do not have a Virtual Collector URL, please contact your Virsae Service Delivery Manager or support@virsae.com
Once these value have been entered click on the 'Check' button to confirm connectivity to the cloud.
If connectivity is working correctly you will see a 'Successfully Connected' dialogue presented. If you are not successfully connected please double check the URL and Profile Group and check that you have internet connectivity open on port 443 to the Virtual Collector URL.
If your test was successful, click 'OK' then "Next' to continue.
Confirm your installation by clicking the 'Install' button.
Your installation will proceed, once complete click the 'Finish' button to close the installer.
This completes installation of the VSM Everywhere client.
Install Via Microsoft Intune
Prepare a Win32 App For Intune
To install the VSM Everywhere client using Microsoft Intune, you will need to convert the .msi installer into the .intunewin type.
Follow the instructions detailed inside of the Prepare Win32 app content for upload article with the VSM_Everywhere.msi installer.
Add A Win32 App
Once the .intunewin file has been created, we can add it to Microsoft Intune which will automate the installation of the VSM Everywhere client to devices.
Use the Add, assign, and monitor a Win32 app in Microsoft Intune tutorial to add the installer to Microsoft Intune.
For "Step 2: Program", in the above tutorial, use the examples below on this page to define your Install and Uninstall commands. Include the version number provided in the MSI. This will help with support and updates.
Install Command
The following install command will install VSM Everywhere into 'C:\Program Files\Virsae Group\Machine Proxy Agent E' with the URL set to "a356dhgj4g5j690f9e333a60da99x.VL-beta.virsae.io" and the Group set to "NZ/AUS", please replace these values with those which are suitable for your installation.
msiexec /i VSM_Everywhere.msi /qn /norestart /L*v "C:\Windows\Temp\install.log" TARGETDIR="C:\Program Files\Virsae Group\Machine Proxy Agent E" CGWS="a356dhgj4g5j690f9e333a60da99x.VL-beta.virsae.io:443" GROUP="NZ/AUS"
Uninstall Command
Use the following MSI GUID for the uninstall command: Refer to the version table below for the appropriate GUID.
I.e. the uninstall command will be:
msiexec /x "{988CA538-BD2B-4362-95B3-A89501732179}"
| Version | MSI GUID |
|---|---|
| 1.0.27 | 988CA538-BD2B-4362-95B3-A89501732179 |
| 1.0.29 | 834A1283-7988-4DDB-8C32-43EEA8ED177A |
The version and MSI GUID can be found in the VSM_Everywhere.msi file properties.
For "Step 4: Detection Rules", Manually configure a detection rule, selecting MSI and enter the version GUID above. Optionally use "File" detection and check for the folder "C:\Program Files\Virsae Group\Machine Proxy Agent E".
In Supersedence set the previous version you want upgraded by this version and ensure 'Uninstall previous version' is set to No.
Collecting Logs
If an installation fails, use the Win32 app installation troubleshooting guide to collect logs from where you have defined logs to be sent in the installation command that was defined
in the Add a Win32 App section.
App Availability and End User Notifications
To control what notifications an end-user receives and when the VSM Everywhere client should be installed by, see the section linked here: "Set Win32 app availability and notifications".