Configuration Screen

This space is archived

For current information please use the current ExamSys documentation

Configuration Screen

Rogo 6.2.0

Sys admins can edit configuration settings from the admin section of Rogo my clicking on the configuration button.

Some settings can only be chagned via he configuration file.

Configurable settings

System Settings

name

description

default value

name

description

default value

system_maintenance_mode

Restricts access to the system to sysadmin users.

Disabled

system_academic_year_start

The Month/Day when the academic year changes (The system will use the current year from the system clock)

07/01

system_hostname_lookup

How machines are evaluated for summative exam access:

  • 'ipaddress' use the machines ip address

  • 'name' looks up the name of the machine from its ip address

ipaddress

system_install_type

Insallation type i.e. test (leave blank for production system)



system_password_expire

Lifetime (days) of internal database login



system_mediatypes

Media types that can be uploaded to rogo (pre exisitng medai will stil be displayed)

Enabled:

gif, jpeg, png, docx, pptx, xlsx, pdf,  mp3, wav, mp4

Disabled:

pdb, ply, obj, mtl, dds, zip, avi, mpeg, mov, mid, ram

system_maxmediasize

Max size (in bytes) that a media file that can be uploaded to Rogo

20971520

system_recover_postdata (From Rogo 7.4)

Attempt to recover POST data if session expired and user redirected to login screen

Disabled

system_user_accessibility (From Rogo 7.4)

Enable/Disable students being able to set their own user settings

Disabled



Miscellaneous

name

description

default value

name

description

default value

misc_search_leadin_length

The length in characters of the question preview tooltip on the question search and paper detail screens

160

misc_company

Name of organisation

University of

misc_dictionary_file

Location of dictionary file used to generate random passwords



misc_logo_email

Name of image file used as email logo

alt_logo.png

misc_logo_main

Name of image file used as website logo

logo.png

API

name

description

default value

name

description

default value

cfg_api_enabled

enable or disable Rogo API (used by external systems to integrate with Rogo)

Enabled

api_oauth_access_lifetime

Users are supplied with access tokens in order to communicate with Rogo via the API. These have a lifetime in seconds.

1209600

api_oauth_always_issue_new_refresh_token

Should Rogo provide a refresh token when responding to requests.

Refresh tokens can be used to generate a new access token before end of life so users have uninterrupted access.

Enabled

api_oauth_refresh_token_lifetime
 

The above refresh tokens also have a lifetime in seconds.

120960

api_allow_superuser

Allow super user that can access any external system.

Disabled

apilogfile

 

Location of API log file



Calculation Questions

name

description

default value

name

description

default value

cfg_calc_type

Name of calculation question engine

  • Rrserve (use the R stat program to calculate answers)

  • phpEval (use inbuilt php math functions to calculate answers)

Rrserve

cfg_calc_settings

Settings for calculation engine (applicable to Rrserve only)

  • host - R server hostname

  • port - R server port

  • timeout - in seconds

  • localhost

  • 6311

  • 5

Gradebook

name

description

default value

name

description

default value

cfg_gradebook_enabled

enable or disable gradebook functionality within Rogo. If enabled users can finalise the marks for summative and osce papers and publish them to external systems.

Enabled

IMS Enterprise

name

description

default value

name

description

default value

cfg_ims_enabled

enable or disable the IMS Enterprise Import functionality within Rogo.

Disabled

LTI Integration

name

description

default value

name

description

default value

cfg_lti_allow_module_create

Allow LTI client to create a module in Rogo if it does not exist.

Disabled

cfg_lti_allow_module_self_reg

Allow a student user in the LTI client to self register onto a module in Rogo.

Disabled

cfg_lti_allow_staff_module_register

Alloe a staff user in the LTI client to join a module team in Rogo.

Disabled

lti_auth_timeout

Lifetime (in seconds) of LTI login authentication.

9072000

lti_integration

LTI type:

  • default - generic LTI integration

  • UoN - University of Nottingham specific integration

default

lti_ssl_verifypeer

enable/disable peer verification on ssl

1

lti_ssl_verifyhost

enable/disable host verification on ssl (note 0 disables, 2 enables, 1 is deprecated in curl lib)

2

All Assessments

name

description

default value

name

description

default value

paper_autosave_backoff_factor

Factor used to vary length between save retry attempts

1.5

paper_autosave_frequency

How often (in seconds) a paper attempts to auto save the users progress

30

paper_autosave_retrylimit

Max number of saving attempts

3

paper_autosave_settimeout

Time (in seconds) to wait for save to suceed

5

paper_editor_supports_mathjax

Editors that support the mathjax preview mode (users can type latex/mathml and see a preview of the rendered output)

  • plain

plain

paper_marks_negative

negative mark scale available to papers

0,-0.25,-0.5,-1,-2,-3,-4,-5,-6,-7,-8,-9,-10

paper_marks_partial

Partial mark scale available to papers

0,0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9,1,2,3,4,5

paper_marks_postive

Positive mark scale available to papers

1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20

paper_mathjax

enable or disabled mathjax rendering of latex/mathml scientific notation

Enabled

paper_max_duration

Max duration (in minutes) an exam can be set to run for

779

paper_timezones

Timezones that can be applied to papers

(UTC-11:00) Samoa
(UTC-10:00) Hawaii
(UTC-09:00) Alaska
(UTC-08:00) Pacific Time (US and Canada)
(UTC-07:00) Arizona
(UTC-06:00) Central Time (US and Canada)
(UTC-05:00) Eastern Time (US and Canada)
(UTC-04:30) Caracas
(UTC-04:00) Santiago
(UTC-03:30) Newfoundland
(UTC-03:00) Buenos Aires
(UTC-02:00) Mid-Atlantic
(UTC-01:00) Azores
(UTC) Dublin, Edinburgh, Lisbon, London
(UTC+01:00) Amsterdam, Berlin, Stockholm
(UTC+02:00) Athens, Bucharest
(UTC+02:00) Cape Town, Johannesburg
(UTC+03:00) Kuwait, Riyadh
(UTC+03:30) Tehran
(UTC+04:00) Moscow, St. Petersburg, Volgograd
(UTC+04:30) Kabul
(UTC+05:00) Islamabad, Karachi
(UTC+05:30) Kolkata, Mumbai, New Delhi
(UTC+06:00) Dhaka
(UTC+06:30) Yango (Rangoon)
(UTC+07:00) Bangkok, Hanoi, Jakarta
(UTC+07:00) Bangkok, Hanoi, Jakarta
(UTC+08:00) Beijing, Chongqing, Hong Kong
(UTC+09:00) Osaka, Sapporo, Tokyo
(UTC+09:30) Adelaide
(UTC+10:00) Canberra, Melbourne, Sydney
(UTC+11:00) Solomon Is., New Caledonia
(UTC+12:00) Auckland, Wellington

paper_threejs

Enables/ Diables threejs support from 3d models

0

paper_textbox_editor_default

Default editor used by students to answer textbox questions

Plain Text
WYSIWYG
MathJax

paper_types

Enable disable paper types from being available

Formative, progress, summative, survey, osce, offline, peer_review all enabled

paper_breaktime_scale

The scale for additional break time that can be set for a user

5,10,25,33,50,100,200,300

paper_breaktime_mins

If enabled breaktiem scale is in minutes otherwise percent of total exam time

0

paper_pause_exam

If enabled summative remote exams can be paused by a student entitled to breaks

0

paper_hide_repeat_scenario

If enabled repeat scenarios on a screen that are 95% similar are hidden from the user

0

paper_seb_enabled

Enable/Disable safe exam browser integration for progress and summative papers.

1

Summative Assessments

name

description

default value

name

description

default value

cfg_summative_mgmt

 

Enable to manage summative exams centrally rather than adhoc

Disabled

summative_cohort_sizes

  

Cohort size ranges

<whole cohort>,0-10,11-20,21-30,31-40,41-50,51-75,76-100,101-150,151-200,201-300,301-400,401-500

summative_hide_external

 

Hide summative exams from paper creation menu

Disabled

summative_hour_warning

  

Set earliest hour a summative exam should be set

10

summative_max_sittings

  

Set maximum number of sittings a summative exam should have

6

summative_midexam_clarification

 

User roles that can view mid exam clarifaction notices

invigilators,students

summative_warn_external

 

Warn a user if they atry to create a summative exam - incase an external system is supposed to be the source of authority

Disabled

summative_remote

when enabled all summative exams are treated as being remote i.e. not in labs

disabled.

summative_issuelink

when

summative_remote

enabled the help link displayed on the exam index screen

blank.

summative_issuelink2

when

summative_remote

enabled the help link displayed on the exam finish screen

blank.

Reports

name

description

default value

name

description

default value

rpt_percent_decimals

number of decimal places displayed for percentages in reports

2

Standard Settings

name

description

default value

name

description

default value

stdset_hofstee_distinction

Default settings for hofstee distinction mark

  • min pass

  • max pass

  • min fail

  • mas fail

median,100,0,100

stdset_hofstee_pass

Default settings for hofstee pass mark

  • min pass

  • max pass

  • min fail

  • mas fail

0,median,0,100

stdset_hofstee_whole_numbers

Enabled or disable use of whole numbers in Hofstee standard settings

Enabled

Support

name

description

name

description