Create the virtual directories manually

Applies to the following products:

Questionmark Perception

Applies to the following Perception versions:

Perception 5.7

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\	scooingtool5	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
C:\Program Files\Questionmark\Perception5\Analytics\ReportingOData	analyticsodata	Read	Questionmark.WebApplications
C:\Program Files\Questionmark\Perception5\Analytics\ReportingODataService	analyticsodataservice	Read	Questionmark.WebApplications

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	v4.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:

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

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

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