ADV5. Create the virtual directories manually

Applies to the following products: 
Questionmark Perception
Applies to the following Perception versions: 
Perception 5.4

When you run the Perception installer, the default web shares required by Perception will be automatically created. However, users can make their own virtual directories manually, provided they match the default ones.

To create the web shares manually, you will need to create some virtual web directories that are assigned to sub-directories of the Perception installation folder. These directories can then be shared to provide entry points to Perception. For example, if your web site URL is example.com, you might want to access perception.php as follows:

http://example.com/assessments/perception.php

For this web entry point to function, you must tell the web server that the web share name (virtual directory name)/assessments maps onto the directory in which you have installed QPLA.

The following table outlines the default web shares and their access requirements.

Default physical directory Default web share name HTTP Access needed Default AppPool
C:\Program Files\Questionmark\Perception5\QABS\ qabs Read and Scripts Questionmark.QABS
C:\Program Files\Questionmark\Perception5\EM\ em5

Read and Scripts

Questionmark.Perception
C:\Program Files\Questionmark\Perception5\ QPLA\runtime\ perception5 Read Questionmark.QPLA
C:\Program Files\Questionmark\Perception5\ OpenAuthoring\ OpenAuthoring5 Read and Scripts Questionmark.Perception
C:\Perception5\server\PLMS\packages\ qm2golms5 Read and Scripts Questionmark.Perception
C:\Program Files\Questionmark\Perception5\QMWISe\ qmwise5 Read and Scripts Questionmark.Services
C:\Program Files\Questionmark\ Perception5\ST\ scooringtool5 Read and Scripts Questionmark.Perception
C:\Program Files\Questionmark\Perception5\Analytics\ ReportingWeb\ analytics Read and Scripts Questionmark.WebApplications
C:\Program Files\Questionmark\Perception5\Analytics\ ReportingService\ analyticsservice Read and Scripts Questionmark.WebServices
C:\Perception5\server\emtemp\ChartImages\ ChartImages Read and Scripts Questionmark.Perception
C:\Program Files\Questionmark\Perception5\ Configuration\Website\ configuration Read and Scripts Questionmark.Configuration
C:\Program Files\Questionmark\Perception5\ Configuration\Service\ configurationservice Read and Scripts Questionmark.Configuration
C:\Program Files\Questionmark\Perception5\Analytics\ ETLConfigurationService\ etlconfigurationservice Read and Scripts Questionmark.WebServices
C:\Program Files\Questionmark\Perception5\People\ OpenIdProvider\ identity Read and Scripts Questionmark.WebApplications
C:\Program Files\Questionmark\Perception5\People\ PerceptionIdentityManager\ perceptionidentitymanager Read and Scripts Questionmark.Services
C:\Program Files\Questionmark\Perception5\People\IdentityProvider\ perceptionidentityprovider Read and Scripts Questionmark.Services
C:\Program Files\Questionmark\Perception5\Portal\ portal Read and Scripts Questionmark.WebApplications
C:\Program Files\Questionmark\Perception5\People\ PeopleIdentityManager\ peopleidentitymanager Read and Scripts Questionmark.Services
C:\Perception5\Repositories\Shared\<repository name>\content <repository name>_con Read DefaultAppPool
C:\Perception5\Repositories\Shared\<repository name>\resources <repository name>_res Read DefaultAppPool
C:\Perception5\Repositories\Shared\<repository name>\system <repository name>_sys Read DefaultAppPool
C:\Perception5\Repositories\Shared\<repository name> \togo <repository name>_togo Read and Scripts DefaultAppPool

You can create your own web shares, naming them as required. However, the virtual directories will need to be directed to the physical directories highlighted in the table and be assigned the necessary access permissions. The web share will also need to be associated with a corresponding Application Pool.

The following table contains the default application pool configuration information:

Name .NET Framework Managed Pipeline Identity
DefaultAppPool v2.0 Integrated ApplicationPoolIdentity
Questionmark.Configuration v4.0 Integrated NetworkService
Questionmark.Perception v2.0 Classic NetworkService
Questionmark.QABS v2.0 Classic NetworkService
Questionmark.QPLA N/A Classic NetworkService
Questionmark.Services v2.0 Integrated NetworkService
Questionmark.WebApplications v4.0 Integrated NetworkService
Questionmark.WebServices V4.0 Integrated NetworkService

To create the required Application pools:

  1. Open IIS Manager
  2. In the Connections pane, expand the Server node in the tree, and then click Application Pools
  3. Click Add Application Pool... from the Actions menu on the right
  4. Enter a name for the Application Pool in the Name text-box
  5. Selected the desired .NET Framework version from the drop-down list
  6. Select the required Managed pipeline mode from the drop-down list
  7. Enable the Start application pool immediately checkbox
  8. Click OK

To create the web shares manually in IIS 7, complete the steps below:

  1. Open IIS Manager
  2. In the Connections pane, expand the Sites node in the tree, and then click Default Web Site.
  3. In the Actions pane, click View Applications
  4. On the Applications page, in the Actions pane, click Add Application
  5. In the Add Application dialog box, type a name of the web share in the Alias text-box. This alias is used to access the content from a URL.
  6. Click Select next to the Application pool text-box
  7. From the Application pool drop-down list, select the adequate pool and click OK
  8. In the Physical path text-box, type the physical path of the content folder, or click Browse(...) to navigate through the file system to find the folder
  9. Select the Application user (pass-through authentication) option in the Connect As dialog box
  10. Click Test Settings to verify the settings that you specified for the virtual application
  11. Click OK