Snap XMP Help

On-Premises Snap Online installation guide

You are here:
< All Topics

System requirements

Windows Server 2012 or later running IIS, matching Microsoft’s minimum requirements, plus an additional 2GB memory

SQL Server 2012 or later, matching Microsoft’s minimum requirements

Further resources will be determined by load levels and usage profiles

These installation instructions have been written for Window server 2019. You will need to refer to the system documentation if installing on a different version of Windows server

This document assumes that your server is configured, secured and functioning properly using a server certificate for SSL

You will require server administrator skills and rights

You will need a Snap Desktop installation code during the Snap Online installation process. This is required to run the software used by Snap Online. This must be the only copy of Snap Desktop on the server. If you have a networked copy of Snap Desktop the networked copy must be run on a separate server.

Snap Online requires the use of a mail server for certain functionality. The mail server should be running on a separate server to reduce congestion.

Installation steps

IIS installation

Check if IIS has already been installed and if not, install it

Configure the server using ‘Add roles and features’ to have the following components to ensure the software installs and runs correctly:

Add Windows Authentication

Add the ASP.NET 4.7 role under the Application Development section

Include the features that are required for ASP.NET 4.7

Add the HTTP activation for WCF services and the Message Queuing (MSMQ) Activation (including the features required)

Create databases in SQL Server

Snap Online requires 5 separate databases to store the data.

NB: The collation must be Latin1_General_CI_AS. This needs to be set when the databases are created.

The naming convention allows for a prefix of your own choosing followed by the following names:

  • prefix_CustomURL
  • prefix_SOL
  • prefix_SOLMailing
  • prefix_SOLResources
  • prefix_SOLShares

The prefix along with user credentials for an account that has permission to create tables in these databases will be required when running the installer. We recommend you create a new user and set the new user to be the database owner.

Run the installer

The Snap Online setup.exe will install the following components:

  • Snap Online
  • Snap Desktop
  • Snap Pool12
  • Win2pdf (a pdf printer driver to enable reports to be generated)
  • AttachIt

Run setup.exe from your download:

Install all the pre-requisites and reboot as required.

Select where you would like the Snap Online software to be installed and the folder you would like to use to store the survey data.

When prompted select the SQL server and specify the user credentials and prefix chosen for the databases:

Press the Next button. The Snap Desktop installer will start.

Enter the installation code when asked to do so.

You do not need to install the sample surveys

You do not need the SPSS add-on

You do not need the shortcuts

The win2pdf installer will automatically start. Follow the prompts to install.

The SnapPool12 installer will automatically start. Follow the prompts to install.

Check the information dialog at the end for errors:

Restart server

Once the installer has finished restart the server to update the security permissions set up during the install.

Configuring Snap Online

Log in as sysadmin

Open the SnapOnline site in a browser: https://localhost/SnapOnline

NB – access needs to be over https://

Log into the sysadmin account. The default password is sysadmin.

Change the sysadmin password

Select Your account from the accordion and then select the Change password option:

Password complexity rules

The password complexity rules can be configured in the User interface:

Configure the site

Most of the configuration is set up for optimum working of Snap Online and so will not need to be adjusted. However, the following configuration is necessary:

AttachIt

Select Configuration in the accordion and select the AttachIt topic:

Set the ‘External service path’ to your sites public domain

Generate a new random GUID and copy the GUID into the ‘DownloadToken’ setting in AttachIt’s web.config (C:\inetpub\wwwroot\AttachIt)

Main site URLs

Select Configuration in the accordion and select the ‘Common settings’ topic:

You will need to configure the following with your site domain:

  • Base URL for the interviewer application
  • Base URL for the JavaScript interviewer
  • External URL for Snap Online

Content security policy for the interviewer site:

Select Configuration in the accordion and select the ‘Common settings’ topic:

You will need to configure the following with your site domain:

  • Custom url domain

Custom URL site

Select Configuration in the accordion and select the ‘Custom URL’ topic:

You will need to configure the following with your site domain:

  • Service URL path

Custom URL template

You will need to edit the config file C:\SnapOnline\WebContent\ShortUrl\config\MachineSpecific.config and change the setting:

<setting name=”UrlTemplate” serializeAs=”String”>

<value>http://localhost/s/{0}</value>

</setting>

And replace “http://localhost” with your site domain. This is the base URL for surveys that respondents will use.

Email responses and invites

Snap Online can be configured to send and receive emails. Snap Online uses the SMTP server to send emails regarding administration tasks such as password reset and invitations to participants as well as email alerts configured on a survey by survey basis. The incoming mail server can be set up to use POP3/IMAP basic authentication or Office 365 Exchange Online OAUTH certificate based authentication – details can be entered in the Inbox accounts page.

Snap Online can be configured to process an inbox to handle replies to invitations including bounced emails.

After an SMTP mailer has been configured you will need to enable to the job which is periodically called to send the invitations. Select Job scheduler in the accordion and Edit the ‘Send invitations’ job:

Adding ReCAPTCHA to password reset and account register pages

It is possible to add Google’s reCAPTCHA v2 to the password reset and account registration pages. To use reCAPTCHA, you will need to sign up for an API key pair for your site and then edit the MachineSpecific.config file entering your own keys:

C:\SnapOnline\WebContent\FMSMVC\config\MachineSpecific.config

<add key=”RecaptchaSiteKey” value=””/>

<add key=”RecaptchaSecretKey” value=””/>

See https://developers.google.com/recaptcha for more details

Initialising the system

To create surveys in the Snap Online editor you need to have a starting template. Snap Online can be configured to share the contents of a global folder so that any starting templates you upload to this folder will be available to all accounts.

Create an account to hold the global folder

Select User admin in the accordion and select the ‘Create new user’ option:

Fill in the details, setting the Permissions to be ‘Researcher’ and select the ‘Create user’ button at the bottom of the page:

Upload a starting template into the account

Select the account and use the ‘Upload template’ option to upload a zip file containing a Questionnaire template and an optional image (with the same name as the template). A blank starting template can be found in the ‘Questionnaire templates’ folder alongside the Snap Online installer setup.exe. Clear the ‘Create default licence’ option before selecting the file:

Once the template has uploaded you can log into the account to set up the global folder:

Select the ‘New folder’ option and create a folder:

Move the template into the folder by dragging the item in the accordion:

Select the folder in the accordion and make a note of the (folder) ID on the URL

Log out of the account to return to the Admin area. Select Configuration in the accordion and select the ‘Licensing-system’ topic. Copy the folder ID into the ‘Global Resources Folder id’:

Follow the steps above to upload all custom Questionnaire templates for your system.

Creating new user accounts

Each account on the system has a permit (which details what the account is able to to) and a licence (how much the account can do). Permits are defined by Permission groups and allocated when the user is created and can be changed at any time. Some default Permission groups are created during the installation process eg Researcher (the permit for users who need to create surveys), Analysis (the permit for users who just need to view reports and analyses) and Interviewer (the permit for users who use the mobile interviewing app (Snap Offline Interviewer) to conduct face to face or kiosk based surveys). The Permissions groups can be adjusted to allow or disallow functionality. On saving a change any account using that Permission group will be affected immediately.

When creating an account you will allocate a Permit and can specify licence limits. The limits that can be applied are:

Survey limit (maximum number of surveys that can be created/uploaded),

Number of units (responses and attachIt file size make up units and can be ‘charged’ according to ‘Charging rates’ which can be configured via the accordion.)

Number of days for licence (how long the licence lasts for once activated)

Snap Online has been written with the intention that the ‘User name’ is the same as the email address. For example: when the reset password option is used the form asks for an email address. Strictly speaking it is requesting the user name field and will use the email address field to send the email. All user names must be unique, however the same email address can be used on multiple accounts. This allows admin accounts to be created with a unique user name but use the email address of an existing account.

Multi Factor Authentication (MFA)

It is possible to allow users to set MFA up on their account. A User Admin needs to enable this feature which will then allow the user to set up MFA choosing either email or an Authenticator app as an additional factor:

If a user has a problem logging in after setting up MFA a User Admin is able to clear the MFA settings reverting the user back to basic authentication:

Alternatively, MFA can be enabled for all accounts by editing: C:\SnapOnline\WebContent\FMSMvc\Config\machinespecific.config

And setting MakeMFAAvailable to “true”

Once you have finished configuring Snap Online log out by clicking the Logout button at the top right of the screen

Contents