Scroll

Install askiavista

Follow
Table of contents:

Introduction

AskiaVista is a Web application, which means that there are two sides :

  • A client (user) side of the software is accessible from web. This user access does NOT require any installation. See client section below
  • A server side holds the computing power. The server is an IIS-based web service. If you have never performed a web-service installation before, please contact your IT department or Askia staff to perform the installation.

Minimum requirements

I. Client (Browser)

Version 5.x of askiavista is compatible with Internet Explorer 6 or higher only. Please make sure your browser settings are optimal.
Version 6.x of askiavista is compatible with the latest versions of Google Chrome, Safari, Firefox, Opera Next and Internet Explorer 10 and above.

We also highly recommend a minimum screen real estate of 1280px width * 1024px height.

II. Server

AskiaVista server is composed of two parts, which can be split depending on the architecture of your hosting center and your load-balancing needs. (Please refer to this article for more details on load-balancing) : 

  1. The AskiaVista web-interface : This is the customer-facing part. It is a series of front-end pages, hosted on Microsoft's Web-server : Internet information services (IIS).
  2. The AskiaVista calculation engine : this is AVServer.exe, a process that will crunch the data into tables, render charts and do all the leg-work. It sits on the file-system of the host and is kept up by a Windows service.

Most AskiaVista servers will host both the web-interface and the calculation engine. In case of bigger loads, a typical load-balanced cluster will contain : 

  • One customer-facing Windows server that will only be used for its web-server function. Only "Internet information services" will be installed. 
  • Other Windows servers (one or more) without IIS but with a lot of CPU/RAM power. It will host the server files contained in AVServer.exe.

Attention : the following section describes the minimum requirements on the host machine, shall it be used to host the AskiaVista application only. Additional pre-requirements are also needed in case the host machine is running other applications such as Webprod. Please refer to the corresponding pre-requirements sections in the AskiaField server installation page.

In case of a server application installation performed by Askia staff, the application will NOT be installed if one of these pre-requirements (or more) is not met on the host machine.

Before the installation : define user credentials that shall be used by AskiaVista

  1. Define an SQL user (only for a fresh installation)
    AskiaVista writes in a SQL database. During the AskiaVista setup, it will attempt to create the 2 databases in which the application is later going to write data. Therefore, whichever SQL user is assigned to AskiaVista, this user must have "db_creator" rights on the SQL server during the installation process. It can then be removed for production.
    During production, "db_owner" is required on the 2 created databases.
    NB:In the case of an installation performed by Askia staff, an "askiavista" SQL user will be created with enough rights to carry on the installation. Please contact Askia staff before the installation if a different user shall be used instead.

  2. Define an Windows user (only if the calculation engine needs to be installed)
    AskiaVista is a Windows application (.exe) that will run on the server.
    Therefore, the Windows user that will run the application (or the service, if the application is set to run as a service) must have the read/write/modify permissions on the Askia installation path (usually C:\Askia\AskiaCtrl)
    In the case of an installation performed by Askia staff, the Windows login that is provided in order to log on to the server will be the one used to run the application. Please contact Askia staff before the installation if a different user shall be used instead.

  3. Define an Application pool user (only if the web-interface needs to be installed)
    AskiaVista's front end is an IIS application. Therefore, it will use an application pool, which will be run by a specific user.
    This user must have the read/write/modify permissions on the Askia installation path (usually C:\Program Files\Askia or C:\Program Files (x86)\Askia).
    In the case of an installation performed by Askia staff, IIS application pools will be created with default names, and "NETWORK SERVICE" will be the user of these application pools. Please contact Askia staff before the installation if a different pool or user shall be used instead.

  4. Define a main AskiaVista interface user (only if the web-interface needs to be installed)
    When the installation is done, a login and password are required to login to the web interface as a super administrator.
    Please contact Askia staff after you completed the last step of this guide to reset the super administrator account for the first connection.
    In the case of an installation performed by Askia staff, the Askia representative will send you your 1st administrator login and password, along with a notice to customize it.


Hardware and Software requirements

OS Supported: Windows Server 2008 R2 64-bit or Windows 2012 R2 64-bit 1
Unsupported: Windows 2003 2 32-bit, Windows 2003 64-bit
Processor Intel Xeon 3xxx series or higher
RAM 8GB RAM (12GB recommended)
HD 40GB, plus enough space for survey data
Software Microsoft .NET Framework 2.0 & .NET Framework 4.5 & Access Database Engine x64 2013
Windows features (only for AskiaVista's front end)

Microsoft IIS 7 feature ACTIVATED

ASP.Net 2.0 AND 4.0. ACTIVATED

.NET framework 4.5 ACTIVATED

CGI ACTIVATED

ISAPI ACTIVATED

Read more about adding roles and features from the official Windows server documentation

Note : In the IIS 7+ Management Console, click the Machine root (should be the first node in the tree), in the list you should see CGI and ISAPI restrictions (if you don't see it you're probably not on the top node).

Under CGI and ISAPI restrictions you should see two items with "ASP.NET v4.0.30319", if it doesn't appears then follow the first answer of this topic. In all cases make sure that the two items "ASP.NET v4.0.30319" are allowed.

If ASP.Net 4.0 is not listed in the "Isapi and Cgi restriction" in the IIS at the server level then you can run the following the command line (with Administrator privilege): 

C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -i
Also see related discussion: http://stackoverflow.com/questions/5836228/asp-net-4-0-has-not-been-registered

SQL1 Microsoft SQL server 2008 R2 or higher, SQL Management Studio
VAS (recommended) 3GB RAM
Microsoft Security updates
Ports :80 for web HTTP
:443 for web HTTPS
:952 for AVM
:953 for AVM
:954 for AVTM
:505 for AVS
:1433 for SQL to AskiaVista DB & AskiaVistaReport DB

Recommendations

  • Read our architecture document before installing
  • Remote access for Askia technical support team
  • SFTP Server

 

Run a new installation

The following section is extracted from the installation procedure document that can be found in any "ManualSetup" file from our AskiaVista download section http://installers.askia.com/helpdesk/askiavista/

IMPORTANT NOTES:

THIS PROCEDURE IS ONLY FOR FRESH INSTALLATION
It requires local administrator privileges on the host server throughout the installation process. In most of the case, right-click and select "Run As Administrator" to be sure to run the installation correctly.
It also requires a SQL access with db_creator during the installation.

I. Setting up the host

  1. Make sure that all minimum physical requirements are met by the host server, as well as Feature and Software requirements.
  2. Download the latest version of the setup: http://installers.askia.com/helpdesk/askiavista/ (e.g. ManualSetup_AskiaVista_6.0.3.8_and_5.3.12.8.zip)
  3. Check that the setup is unblocked


    Right click on the setup file then click on "Properties".
    If there is a clickable button named "unblock" make sure to click on it, before validating with "OK".
  4. Extract the contents of the .zip file to an easily accessible directory on the server. (You will need the various directories and files for the next/ following steps)

 

II. SQL SERVER DATABASE INSTALLATION (Applies only to a new cluster installation)

  1. Open SQL Server Management Studio
  2. Create a database named "AskiaVista"
    1. Run the file "AskiaVista.sql" in the ManualSetup files under /Askia/AskiaCtrl/ (with SQL Management Studio, or another SQL engine)
    2. Select the "AskiaVista" database (from the "Available databases" drop-down) and run the script
  3. Create a database name "AskiaVistaReport"
    1. Run the file "AskiaVistaReport.sql" in the ManualSetup files under /Askia/AskiaCtrl/ (with SQL Management Studio, or another SQL engine)
    2. Select the "AskiaVistaReport" database and run the script
  4. In SQL Management Studio go to Security/Logins
  5. Right click and create a new login with the following details :
    • Login name: askiavista
    • SQL Server Authentication with paswword: askiavista
    • Uncheck "Enforce password policy" / "Enforce password expiration" and "User must change password at next login"
  6. Right click on the login and select "Properties". Go into "User Mapping" tab
    • Select AskiaVista and AskiaVistaReport with db_owner role
    • Validate

III. SETUP WEB APPS (Applies only to AskiaVista's web-interface machines)

  1. Copy and paste the folders from the ManualSetup files /wwwroot/ to the C:\Inetpub\wwwroot\ of your server (AskiaVista, AskiaVistaReader, AskiaVistaReader.Net4, AskiaVista6)
  2. Set enough rights to the user IIS_IUSRS or to the user that will be associate with Application pools (Full control)
    • The user of the Application pool must be able to read / write / modify / execute in AskiaVista/ folder
  3. Open Internet Information Services Manager (IIS). 
  4. Navigate to IIS' "Application Pool" view from the left-hand pane and add the following application pools (with a right-click) with the following basic settings :
    Name .Net Framework version Managed pipeline mode
    AskiaVistaPool   .Net Framework 2.0.50727 Classic
    AskiaVistaReaderPool .Net Framework 2.0.50727 Classic
    AskiaVista6Pool .Net Framework 4.0.30319 Integrated
    AskiaVistaReaderNet4Pool .Net Framework 4.0.30319 Classic
  5. Check the Application pool's "Identity" parameter. It should be "Network Service" by default.
    If not, right click on the application pools and Select "Advanced settings". Change the "Identity" parameter to "Network Service" and click OK.
  6. Navigate to the "Sites" view and convert all 4 projects to applications with their respective Application pool

    1. Right click on the project folder and select "Convert to application"          
    2. Select the matching application pool from the ones that were just created and click OK.

The web interface of the Vista application is now set up.


IV. SETUP SERVICES (Applies only to calculation engine machines)

  1. Copy the folder /Askia/ from ManualSetup files to C:\Askia\

  2. Set enough permissions on the AskiaCtrl\ folder to the IIS_IUSRS user or to the user associated with the AskiaVista Application pool.
    The user (identity) of the Application pool must be able to read / write / modify at least.
    Example : in IIS, if "Network Service" is the identity that runs the application pools, make sure that it is listed in the /Askia's security properties and possesses read/right/modify permissions
  3. Under C:\Askia\AskiaCtrl\ run the VCRedist_x64.exe [Visual C++ 2010 Redistributable package] (with Administrator privilege)
  4. Under C:\Askia\AskiaCtrl\ run the AccessDatabaseEngine_x64.exe [Microsoft Access Database Engine] (with Administrator privilege)
  5. Under C:\Askia\AskiaCtrl\ run APIRegister.bat [AskiaAPI.dll, AskiaVistaCtrl.dll, XlsGen.dll registration] (with Administrator privilege)
  6. Under C:\Askia\AskiaCtrl\ run AskiaVista.reg (with Administrator privilege) -> Validate the message to update the database registry
  7. Under C:\Askia\AskiaCtrl\ run AskiaVistaConfigurator.exe (with Administrator privilege)
    1. Verify the path and url in Storage & links tab
    2. Set the databases connection string under the Database tab
    3. Save the configuration [That should generate a file name Askia.config in the AskiaCtrl directory and update the database registry]
  8. Under C:\Askia\AskiaCtrl\ run AskiaVistaManagerInstall.bat [Install windows service] (with Administrator privilege)


---------------

ATTENTION:
If you also have a CCA installation, you may want to go into the "CCA Servers" tab of the AskiaVistaConfigurator.exe Tool, click the "New" button, and enter in your CCA Server Name and SQL Connection to the "Surveys" database.

This populates the [AskiaVista].[dbo].[AV_CCAServers] database.

(The name is just for organization; the connection string is the important part.)

e.g.
Name:
AskiaCCAServer

Surveys Connection: 
Provider=sqloledb; Data Source=(local); Initial Catalog=Surveys;Trusted_Connection=no;User Id=askia;Password=askia123

-MB (3/1/2016)

---------------

V. VALIDATIONS

  1. Click on Start > Administrative Tools > Services and start AskiaVista Manager service
  2. Open Internet Explorer and go to http://localhost/AskiaVista
    • Connect with the credentials provided by the Askia representative
    • Go to View / Admnistration mode / Configuration / Licence management and generate the licence key
    • Contact Askia to receive a licence file
    • Update the licence with the licence file
  3. Reconnect on AskiaVista and add the survey EX
    • The Survey structure generation will not works so close the popup window
    • Go to Configuration / Services management and restart both AskiaVistaServer and AVTasksManager
    • Go back to Surveys, right-click / Generate the survey structure of EX survey
  4. Test the survey
    • Go to View / Analyse mode and open the survey EX
    • Try a cross-tab and try to export the result
  5. Test AskiaVista6
    1. Open a recent browser (IE 9+ / Safari / Chrome / Firefox)
    2. Go to http://localhost/AskiaVista6/
    3. Enter the credentials you have been provided by the Askia representative
    4. Open the EX survey
    5. Run a cross-tab and export it 
  6. Final touches
    1. We strongly recommend you change your password after connecting.
    2. Now that you are logged on, follow these steps to activate Askia Support:

      In the View menu select Administration Mode
      Open the Configuration accordion.
      Browse to System configuration and double-click Services management
      In the Misc tab:

      • activate the Allow askiavista to automatically search for updates option
      • activate the Authorize Askia Support Team option
      • click the Search for updates
    3. Create a couple of user credentials for your team's Vista administrators

 

License activation (Applies only to a new cluster installation)

  • Open the Configuration accordion
  • Browse to System configuration and double-click on Licence Management
  • In the Upgrade Licence tab, click Download the licence key
  • Save the .ZIP archive and send it to your local Askia office or directly to support@askia.com.

 

 

Update AskiaVista v5 & v6

 

ATTENTION:
When updating to 6.0.3.8 or above, you may be required to install "ASP.NET MVC 4 for Visual Studio 2010 SP1 and Visual Web Developer 2010 SP1" in order for Vista6 to function properly.

You might receive a "Server Error in '/AskiaVista6' Application." error page when trying to load up http://localhost/askiavista6/ where it says something along the lines of "Count not load file or assembly 'System.Web.Mvc..."

The ChangeLog of 6.0.3.8 reads as follows:
"+ Task #6912: Migrate the project from ASP.NET MVC 2 to MVC 4"

-MB (2/25/2016)

 

WARNING: This document concerns versions 5.3.1.x or higher!
I. Setup the host

  1. Make sure that all minimum physical requirements are still met by the host server, as well as Feature and Software requirements.
  2. Download the latest version of the update_ package : http://installers.askia.com/helpdesk/askiavista/v6/Update_AskiaVista_6.X.X.X.zip
  3. Check that the setup is unblocked


    Right click on the setup file then click on "Properties".
    If there is a clickable button named "unblock" make sure to click on it, before validating with "OK".
  4. Extract the zip file.

 

II. Stop the services

  1. Stop askiavista
    From the Windows Services console, stop the AskiaVistaManager service.
  2. Verify running processes
    From the Windows Task Manager console, verify that AskiaVistaServer is no longer running.
    If AskiaVistaServer is still running, terminate the process.
  3. For Vista6: Stop AskiaVista Application pools (IIS Manager)

 

III. Save a backup

  1. Virtual
    If you are running askiavista in a virtual environment, take snapshots of the relevant VM.
  2. Manual
    If you are running askiavista on traditional hardware server, backup the following items:
    \AskiaCtrl\
    \AskiaVista\ (see: footnote1)
    Make BAK files of:
    1. AskiaVista DB (see: footnote2)
    2. AskiaVistaReport DB (see: footnote2)

IV. Update

1. Copy the content of the unzip folders into the original one (so you don't lose permissions on the folder)

Decompress the update_askiavista_5.3.x.x ZIP archive
Unzip AskiaVista.zip's contents to the server's \AskiaVista\ web application folder1
Unzip AskiaCtrl.zip's contents to the server's \AskiaCtrl\ folder

  1. Copy the folder /Askia/ from ManualSetup files to C:\Askia\
  2. Under C:\Askia\AskiaCtrl\ run APIRegister.bat [AskiaAPI.dll, AskiaVistaCtrl.dll, XlsGen.dll registration] (with Administrator privilege)

V. Restart services

From the Windows Services console, start AskiaVistaManager service and start AskiaVista application pools.
Now log onto askiavista and check its core functions to ensure that all is running fine.

VI. (optional) Rollback

1. Virtual

Revert to the snapshot of the VM made in step II. 1..

2. Manual

Use the backup files made in step II. 2., and put them back in place.

1 When updating an AVS-only instance, you can skip this step, as the server will have no IIS and therefore no \AskiaVista\ web application folder; for more info on AVS-only instances, see the list of askiavista architectures.
2 Please remember that regardless of whether you have a single-instance or a complex, multi-server architecture, askiavista platform, you will always have only one SQL instance backending your askiavista platform, ie. you only have one AskiaVista DB and one AskiaVistaReport DB to backup.

 

Older Setup files and Version History

Have more questions? Submit a request

Comments