...
- A Virsae Cloud Collector and the URL for this collector
- PC's that will have VSM-E installed will require outbound internet access to the Cloud Collector URL on TCP port 443 using HTTPS, and the Ookla Speedtest server network on TCP port 8080 using HTTP and HTTPS.
- 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.
...
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 The VSM-E installer package.is available in 'Service Desk> Files and Folders' - Then navigate to 'Shared with me> Virsae> VSM>VSM Software> VSM-Everywhere'
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 groupGroup.
To create a Profile Group go to the Virsae VSM Web Portal and then navigate to Service Desk > Equipment Locations > VSM Everywhere.
Customer View menu ( of Service Desk > Equipment Locations):
Business Partner view (of from Customer tile > Service Desk > Equipment Locations):
Select VSM Everywhere (From from the required Equipment LocationsLocation):
Once you reach When on the Profile Groups page for the first time, you will see the following.
A profile group represents a set of metrics that the VSM-E client will track."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
...
- by selecting Enabled and then the desired metrics
- 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. (Note this cannot contain spaces) |
| 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 EnableEnabled | whereEnables 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. |
The Default groups group will have a tick beside their the name in the side navigation bar.
...
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.
Next you will have the opportunity to enter proxy details if required, or continue without a proxy. Click 'Next' to continue.
Next you will be able to select the use of the Virsae Self signed Certificate (this is the default and will be used in most cases) or you can select to use the Virsae CA signed Certificate or a Custom Certificate, both of these options will require the Virsae Support team to work with you.
- Use Virsae self-signed certificate
- Customer elects to use Self-Signed Virsae certificate
- Use Virsae CA Signed certificate
- Customer elects to use Virsae's public DigiCert certificate
- This certificate expires in July 2024
- Requires Virsae Support to update the virtual collector with the appropriate certificate
- Use custom certificate
- Customer elects to use their own preferred publicly signed certificate
- Requires Virsae Support to update the virtual collector with the appropriate certificate
Once you have made your selection, 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.
...
| Note | |||||
|---|---|---|---|---|---|
| |||||
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.
|
Some additional parameters are available for setting Proxy Server and Certificate options. If these are omitted from the script then Proxy will be set to false, and communication will use the Virsae Self Signed Certificate.
Proxy Server Parameters:
- USE_PROXY=
- "true"
- Customer elects to use a proxy server
- "false"
- Customer elects to not use a proxy server
- "true"
- PROXY_SERVER="FQDN_OR_IPADDRESS"
- Input an IP Address or FQDN as the target proxy endpoint to connect to
- PROXY_PORT="PORT"
- Input which port number on the target proxy server to communicate with
Certificate Parameters:
- CERT=
- "SelfSigned"
- Customer elects to use Self-Signed Virsae certificate
- "VirsaeCA"
- Customer elects to use Virsae's public DigiCert certificate
- Requires updating the virtual collector with the appropriate certificate
- "Custom"
- Customer elects to use their own preferred publicly signed certificate
- Requires updating the virtual collector with the appropriate certificate
- "SelfSigned"
- CERT_CN="CERTIFICATE_TARGET_HOST"
- Can only be used when CERT="Custom"
- Represents the Certificate Target Host to validate against
The version and MSI GUID can be found in the VSM_Everywhere.msi file properties.
...
| Note | |||||
|---|---|---|---|---|---|
| |||||
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", Using a proxy server and a Custom Certificate please replace these values with those which are suitable for your installation. | |||||
| Note | |||||
| |||||
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:
|
...
|
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".
...