Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.

Image Added


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.

Image Added



You will then be prompted to enter your Virtual Collector URL and the name of the profile group you setup earlier.

...

Note
titleInstall 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.

Code Block
languageyml
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""



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
  • 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
  • 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
titleInstall Command using proxy and certificate options

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
titleUninstall 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:

Code Block
languageyml
 msiexec /x "{988CA538-BD2B-4362-95B3-A89501732179}"

...

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" CERT="Custom" CERT_CN="certificate.host.com" USE_PROXY="True"  PROXY_SERVER="192.168.10.89"  PROXY_PORT="3128"


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".

...