Creating a repository | Questionmark

Creating a repository

Applies to the following products: 
Questionmark Perception
Applies to the following Perception versions: 
Perception 5.2
Perception 5.1

Perception Server uses shared repositories. Once you have set up your database, you will need to create a new shared repository. To do so, follow the procedure below.

To create a repository:

  1. On your Perception server, open Shared Repository Manager

    To open Shared Repository Manager, click Start | All Programs | Perception Server 5 | Questionmark | Shared Repository Manager. If you are using Windows Server 2008 or Windows Server 2008 R2, you will need to right click on the Shared Repository Manager icon and select Run as administrator. You will be asked to confirm the action and may be required to enter an administrator password.

  2. Click Add New Repository... in the Shared Repositories menu

    The Repository Creation Wizard is displayed

  3. Click Next >
  4. Enter a name for your repository in the Repository name text box
  5. Select the type of database you are using from the Database type drop-down list
  6. If you are installing Perception Version 5.2 you can also select the language you would like your reports to appear in from the from the Language for standard reports drop-down and click Next.

  7. Enter an Initial topic name and Initial assessment folder name and click Next >

    The Initial topic name is the topic at the top of the topic hierarchy, and is also called the root topic. The Initial assessment folder is the assessment folder at the top of the assessment folder hierarchy, and is also called the root folder

  8. If you wish to enable security, ensure that the Check to enable security in the new repository box is ticked and click Next. We recommend that you enable security. If you are setting up a new repository on your database security is enabled by default and cannot be de-selected
  9. The following option will require you to fill in your database details:
    • If you selected SQL Server or Oracle as your database type, you should see the following screen:

      To continue:

      • Select the Database DSN (Database Source Name) of your database from the drop-down list. You must have already created a blank SQL Server or Oracle database and setup an ODBC connection to it, otherwise the DSN name will not appear in the list. (Refer to Database setup for instructions if you have not already done so.)
      • Tick the Check to run database scripts check-box as this is required to create the Perception tables in your database
      • Tick the Check to enable question searching capability check-box if you want authors to be able to use the Question Search facility in Authoring Manager. Ensure that OracleText has been installed if you are using an Oracle database or Full Text indexing has been installed and configured for the database if you are using SQL Server. Please refer to the documentation that accompanied your database server for more information about how to install and configure the necessary options.
      • If you will be importing data from Perception version 3 tick Check to import from V3. Otherwise leave the check box un-checked. If the data you will be importing from Perception version 3 contains Japanese data (characters) or similar place a check in the Convert V3 Japanese data on import check-box
    • If you select SQL Express you will be asked to confirm the Instance name (the default is SQLEXPRESS) and the sa logon password (as defined during the installation of SQL Server 2005/2008 Express).

      To continue:

      • Tick the Check to enable question searching capability check-box if you want authors to be able to use the Question Search facility in Authoring Manager. With SQL Server 2005/2008 Express you will need to have installed the Advanced Services edition
      • If you will be importing data from Perception version 3 tick Check to import from V3. Otherwise leave the check box un-checked. If the data you will be importing from Perception version 3 contains Japanese data (characters) or similar place a check in the Convert V3 Japanese data on import check-box
      • Once the above options have been determined, click Next and skip to step 11
  10. Click Next
  11. You should now be presented with either of the following screens depending on the database server you are using:
    • SQL Server

      You will need to enter the correct details for the SQL Server user you assigned to the database. To check you are logging into the correct database you created earlier, click Options >>

      Once the details have been entered click OK

    • Oracle

      You will need to enter the correct details you assigned to the Oracle database, to ensure that the ODBC connection can successfully be made (if this dialogue box does not automatically appear you can access it by clicking the Change Login Details button)

      Once the details have been entered click OK 

  12. Confirm the repository creation process by clicking Next. The repository will be created
  13. Click Finish to close the Repository Creation Wizard. A warning screen will be displayed

  14. Click Yes to set the shared repository to be accessed by authorized users of Enterprise Manager as well as participants
    If you click No the shared repository will not be set to be accessed by Perception Server and Enterprise Manager and all participant-facing software will not work

The shared repository has now been created. The Configure Perception Server window will be displayed to allow you to configure the repository and Perception to work together. To configure the two:

  1. Specify the Perception Server Application Folder. Either accept the default location or if you installed Perception to a different location click Browse to specify it
  2. The Web Access box displays the default names for the Resources Web Share and Content Web Share. Either accept the default name, or enter your own

    The System Web Share is only applicable if you have installed Perception on a multi-tiered setup as described in the section Installing a multi-tiered environment. The default web share as created by the installation is MyRepository_sys. This web share allows QPLA to access the necessary files on the QABS machine in a multi-tiered environment

  3. If you will be using Questionmark To Go or QMWISe for 3rd party applications to communicate with Perception place a check in the Configure this feature check-box and update the QMWISe URL so that it points to the QMWISe web share on your Perception server. Click Test to set and test the QMWISe URL setting
  4. To configure QMWISe fully you will also need to create a unique 8 digit Trusted Key that Perception can use to verify any communication between Perception and your 3rd party applications. For further information about Trusted Keys and QMWISe, please refer to the QMWISe API Guide
  5. Set the Web Share you would like to use for Questionmark to Go
  6. Click OK
  7. Configuration Server Notice will be displayed confirming that the configuration file has been successfully modified, click OK to continue.
  8. The repository has now been created and will appear in the Shared Repository Manager.

Once you have created your repository you should configure and verify your Perception server is working as expected.