Sensor VMS Version 1.2

Version 1.2  now include the Guest sign-option and HTTPS certificates.

This Guide is split into the following sections:

1. Introduction and download

2. GP10 configuration

3. VMS Configuration

4. Setting the VMS as a service

5. Installing HTTPS Certificate onto browser

1. Introduction

Our Visitor Management System simplifies the process of managing visitors to your site. With a variety of options to choose from, visitors can sign in and receive badges in the form of QR codes, which are emailed directly to their smartphone. This enables them to gain secure and contactless access to your building without the hassle of issuing physical cards. We also offer customisable options to suit your requirements.

Our current methods include:

• Pre-booking an appointment to visit, including sign-in upon arrival.
• Signing in of "guest users" who do not require a user to be added to the system.

The VMS allows visitors to pre-book their visit via a registration page, where they can also accept custom terms and conditions, GDPR and health & safety policies with a signature. Once accepted, visitors receive an email notification containing a QR code to their phone. You can be notified upon the visitor's arrival and generate reports on their movements through GuardPoint 10.

If you have specific requirements, please feel free to get in touch. Our system is highly customizable to meet your needs.

The latest version of VMS can be downloaded from the following link: Download

2. GP10 Configuration

1. You will need the GP10 API module. You can check by going to Help > License and checking under Registered License.
   
   

   
   
   

2. Enable API for the GP10 users who will be logging into the VMS:

   Press on a Sensor access logo (left corner), then go to:
   
   Management > Users tab > Allow API.
   
   
   
   
   
   
   
   

3. In the Options tab > General screen, make sure Allow duplicate names are enabled.
   
   
   
   
   

4. Users who will be logging into the VMS admin system must have Allow API set to Yes in the GuardPoint 10 Users screen.
   
   
   
   
5. Go to Cardholders, then Customized Fields.
   
   Create 5 Text fields named Host Name, Visit Purpose, Host Signature, Visitor Signature and Tenant Email.
   Create a Yes/No field named NDA Agreed. > Press 'Save&Close'
   
   
   
   Warning: If you already have existing custom fields, please contact us for further instructions.
   
   

3. VMS Configuration

1. The Server-config.ini located in the VMS root folder file (typical location: C:\VMS\<VMS latest version>\_internal ) stores configuration such as: 
   

                    Typically it will only be the port that will need to be amended in this server-config.ini file

[SERVER]
port = 443  - This is the port the server is run on you must ensure this is not being used by another application like Microsoft IIS

**Warning! If you have this message: 

**Then you can/need to change port number in Server-config.ini to port:448.

Below screen shot example of the VMS running but the port is in use by IIS:

https = True
# OPTIONAL, REQUIRED, NONE
https_client_auth = OPTIONAL
debug = True
multi_threaded = True
file_log = False
cache_ttl = 3600
config_dir = company-configs
client_config_key1 = 8dgrXG95Ndagp32bcR2NJDieiZrhXCFH9p6sxIksrs4=
system_admin_emails = john.owen@countermac.com, josh@sensoraccess.co.uk, robert@sensoraccess.co.uk

# For Server Notification Emails
[SMTP]
provider = sendgrid
username = apiKey
password = ENC.gAAAAABkQmEeQa3wm6kGMgL1Svgx-PozBmzOqc4XjE0EIVOO7sGLwQgX5lG-wYc9Wyn9E3RpKojE7XdZLw_rPGRnEQcwh3vrjHqNcm5iz9yChS8_eT9nMmSPDBjTIcwTRRvosNDSdbKTNhGLCtG3aJP9WeDdgnhF7ZMPiEv37O7QL9UwH_cJdlw=
server = smtp.sendgrid.net
port = 587

[HTTPS]
key_file = keys/server-ecc.key
cert_file = keys/1625853244.crt
ca_file = keys/root.crt

Located in the company-configs folder is the DefaultCompany-Config.ini this contains the main setting for the VMS. Any setting in the browser P12 certificate will overwrite the setting in here. Any setting not included in the certificate the VMS will look for it in the DefaultCompany-config.ini

If you use the Guest Sign-in and Sign-out screens you will also need to set the area for both. Make sure this is exactly written to the same as in GP10

1. When you are done, save and close the file.
   
   
2. Start the VMS server application. You should see the following console screen.
   (The VMS exe may have a different name or logo depending on branding)
   
   
3.  You can now connect to the web interface with the server’s IP address / name and the port number.
   

If the console screen shows any errors, please double check the settings are correct and let us know at support@sensoraccess.co.uk.

Running the VMS as a service using the NSSM.

By default the VMS server runs in the foreground and requires the user to be logged in to stay active.

If the user logs out the application will be terminated. By using a free and public domain tool called “NSSM” we are able to package VMS as a service thus allowing it to run in the background even when user is logged out

The tool can be found here and is called NSSM (The Non-Sucking-Service-Manager)

https://nssm.cc/download

1. Navigate to where you have installed NSSM and open a command window in that directory, in our case this would be:

C:\Users\Administrator\Downloads\nssm-2.24\nssm-2.24\win64

Your command prompt should look the same as below:

2. Now using command prompt in the directory, type nssm install VMS followed by the path, right down to the executable. In our case here it is this:
   

   nssm install VMS "C:\Users\Administrator\Desktop\VMS_C2\VMS_C2\VMS_C2.exe”

   
   

After this, VMS will run as a service and can be configured by selecting it in the windows services menu, (You may need to do this just once so it knows to turn on whenever the computer is on).

5. Installing HTTPS Certificate onto browser

Please see the following guide on how to install the certificate depending on your browser:

 How to add VMS certificate