Introduction
With workers now having the ability and choice to work from home, VSM Everywhere 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 Everywhere client you will need the following:
- An up-to-date collector that has connected to the Virsae platform and is reachable by remote workers.
- A copy of the silent installer.
- Configured a group in the web portal
- Administrator-level permissions on the machine where the client will be installed.
Getting What You Need
If you do not have one or any of the above-mentioned requirements, the following sections will provide instructions on how to meet these requirements.
Configuring A Collector
With the introduction of VSM Everywhere, VSM customers and business partners have been given the ability to configure more than one collector under the same location.
To set up an additional collector under a single location, simply follow the same steps that are described in this article with the new collector.
Getting the Silent Installer
Contact your VSM Administrator for a copy of the installer package.
Configuring a Group
See the Web Portal Configuration section to learn about configuring groups.
Web Portal Configuration
Before a VSM Everywhere client can start tracking the performance of a system, it must first know what it needs to track.
Go to the Virsae Web Portal and then navigate to Service Desk > Equipment Locations > VSM Everywhere.
Customer Access (To Equipment Locations)
Business Partner Access (To Equipment Locations)
VSM Everywhere Access (From Equipment Locations)
After reaching the page, you will see the following.
A group represents a set of tracked metrics that the VSM Everywhere client will track.
Let's configure a group, click the "+" button at the bottom of the group list to begin adding a new group.
Enter a group name and choose which metrics you want to track.
The table below describes what each option represents.
| Field | Description |
|---|---|
| Group Name | The name of the 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 Enable | 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 ...... of a system. |
| Processor | Tracks the CPU usage of a system. |
| Speed Test Probe Enable | Enables the Speed Test Probe, which measures ........ |
A collector MUST have a default group.
When you create your first group, it will automatically be set as the default.
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.
A collector MUST have a default group.
As such, you can only REPLACE default groups when editing.
You can also delete groups at any time. All groups are deletable.
A collector MUST have a default group.
As such, when a default group is deleted and another group is available, it will be set as the default automatically.
Installing VSM Everywhere
After everything has been set up, to install VSM Everywhere, use the MachineProxyAgentE_Installer.msi to install via a command-line interface.
The installer accepts all of the default command line arguments provided by an MSI, as well as two additional arguments: CGWS and GROUP.
You can use either Command Prompt or PowerShell to install.
Installing Via Command Prompt
To get started with the installation we need to open Command Prompt in administrator mode.
First, press the Windows Key on your keyboard or click the Start icon on your taskbar.
Next search for "Command Prompt".
Find the "Command Prompt" option in the results.
Next press "Run As Administrator"
After opening the command-line interface, use the Installation Commands section to create an installation string.
Install Via Powershell
To get started with the installation we need to open Powershell in administrator mode.
First, press the Windows Key on your keyboard or click the Start icon on your taskbar.
Next search for "Powershell".
Find the "Powershell" option in the results.
Next press "Run As Administrator"
After opening the command-line interface, use the Installation Commands section to create an installation string.
Installation Commands
To install a program via your preferred command-line interface use the following string:
// Command Propmt > msiexec /i "C:\Path\To\MachineProxyAgentE_Installer.msi" /qn /norestart //Powershell > Start-Process msiexec.exe -Wait -ArgumentList '/i C:\Path\To\MachineProxyAgentE_Installer.msi /qn /norestart'
Enable Installer Logging
A full list of logging options are available here.
For ease of reference, you can activate verbose logging using the /L*v switch.
// Command Prompt > msiexec /i MachineProxyAgentE_Installer.msi /qn /norestart /L*v "C:\path\to\install.log" //Powershell > Start-Process msiexec.exe -Wait -ArgumentList '/i C:\Path\To\MachineProxyAgentE_Installer.msi /L*v "C:\path\to\install.log /qn /norestart'
CGWS Argument
CGWS takes a semi-colon separated list of IP addresses or Fully Qualified Domain Names (FQDNs) that represent the location of collectors that a VSM Everywhere client can connect to.
VSM Everywhere has the ability to connect to multiple collectors in case one collector is unreachable or overcapacity.
If no port is specified the default port of 8444 will be used.
> msiexec /i MachineProxyAgentE_Installer.msi /qn /norestart /L*v "C:\path\to\install.log" CGWS="192.10.10.10:6226;192.10.10.15:2662"
GROUP Argument
The GROUP argument takes the group name of a group configured inside of a web portal. If VSM Everywhere is installed with no group name, or if the collector could not find the requested group, the default group will be used instead.
> msiexec /i MachineProxyAgentE_Installer.msi /qn /norestart /L*v "C:\path\to\install.log" CGWS="192.10.10.10:6226;192.10.10.15:2662" GROUP="NZ/AUS"