Create the virtual directories manually | Questionmark

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:

  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 field.
  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 option.
  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 field. This alias is used to access the content from a URL.
  6. Click Select next to the Application pool field.
  7. From the Application pool drop-down list, select the adequate pool and click OK.
  8. 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.
  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.