Setup and Configuration

Configuring export to external cloud storage.

Survey Solutions may be configured to export data to major international cloud storage providers: DropBox Google Drive Microsoft OneDrive To enable export to the external storages the following configuration changes need to be done to the configuration file appsettings.Production.ini: Add section: [ExternalStorages:OAuth2] RedirectUri="https://YOURSERVERNAME/data-export-storages.html" ResponseType="code" Note that you need to substitute-in your server name in the RedirectUri parameter. Decide which external storages you want to make available to the users of your server (this is shared across all workspaces) from the above mentioned list of cloud providers.

April 29, 2021

Support packages

Support packages are also known as tablet information packages. These terms are used interchangeably in this documentation. Survey Solutions contains a built-in mechanism for collecting the data from tablets and transmitting it to the HQ server. This helps to investigate the issues where the interviewers can not supply any detailed problem report and commonly describe the problem with “it doesn’t work” or “it crashes” and it is difficult or not possible to access the device directly.

March 18, 2021

Device Logs

Survey Solutions contains a built-in mechanism for logging the problems and transmitting the log data from tablets to the HQ server. This helps to investigate the issues where the interviewers can not supply any detailed problem report and commonly describe the problem with “it doesn’t work” or “it crashes” and it is difficult or not possible to access the device directly. The information contained in the device logs is rather technical and should be interpreted by IT personnel or software developers.

March 18, 2021

Admin Settings

Survey Solutions server administrator may adjust the server settings. These settings affect simultaneously all surveys and all users in a particular workspace on the server and have the effect immediately when applied. These settings are visible only to the user logged in in an administrative role and can be accessed from: Menu → Administration → Settings. Export Encryption This group of settings contains settings that control the encryption of the data archive produced when exporting the data from Survey Solutions.

November 25, 2020

Survey Solutions Server

This article describes the main steps to setup your own Survey Solutions server. Study the requirements for a server. These requirements are minimal and may be periodically revised. Your survey may require a different hardware configuration. You may need to calibrate for a few months before the survey to determine the optimal configuration. Follow the installation instructions to install the prerequisites and the Survey Solutions itself. Note: there is only one installation set regardless where you want to install: to a physical server or to a cloud-based server.

November 20, 2020

Azure setup

Installation of Survey Solutions on Microsoft Azure In order to install - register on azure portal and login. Installation steps are going to use azure shell. After loggedin into azure shell execute command with variables that are going to be needed later. Feel free to change them as you need: RG=surveysolutions \ LOC=westeurope \ STOREACC=surveysolutions \ SHARE_NAME=surveysolutions \ PGSERVER=suso-postgres \ PGPASS=password \ WEBAPPNAME=surveysolutions-webapp \ SRVPLAN=AppSvc-SurveySolutions-plan RG - resource group where all survey solutions related resources are going to be grouped LOC - location where you will run survey solutions software.

November 5, 2020

Export Service

Version 20.08 and newer Version 20.08 is delivered with export service embedded within Headquarters application. No separate windows service is installed in the system, only IIS website. All the information regarding startup of export you can find in logs folder. You still need to have BaseUrl configured properly, but no need to manage ExportServiceUrl configuration. Version 20.07 and older Survey solutions comes in two parts. Headquarters user facing web application (usually executed within IIS web server) and Export background windows service.

August 12, 2020

Demo server

Survey Solutions developers team provides a special demo server equipped with the latest version of the Survey Solutions Headquarters for the users that want to: explore the interface of the software, try different roles, test pre-loading data files, see the new features added in a recent release. It is important to understand that this server may not be utilized for real survey data collection, because this server is a public server that anyone in the world can access, and also because the demo server is also periodically cleared (erazed), when it accumulates a lot of old surveys or users that are no longer active, usually once a month.

June 22, 2020

Installer Command Line Parameters

Survey Solutions installer may be launched with command line parameters. ParameterMeaningExampleDefault Siteport port number on which the site shall be installed in IIS 8080 9700 Connserver part of the DB connection string identifying the address of the database server Connport part of the DB connection string identifying the port of the database server 443 5432 Connusername user name for connection to the DB johnsmith postgres Connpassword password for connection to the DB MyPassword911 Installfolder full installation path where the Survey Solutions server should be installed C:\World Bank\Survey Solutions C:\Survey Solutions Additionally, specify /s for a silent install.

May 11, 2020

Alternative maps for servers in China

Survey Solutions map reports at the data server utilize maps provided by Google through their online service. The installation sets the parameters regulating access to this service with the parameters applicable to the majority of users, but these servers are known to be inaccessible from the networks in China. To enable access to Google maps from China, a different server, specific to China, must be used. The following two parameters should be changed in the GoogleMap section in appsettings.

May 6, 2020