User Tools

Site Tools


services:labtest:start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
services:labtest:start [2024/03/18 14:16] jasservices:labtest:start [2024/04/23 08:48] (current) jas
Line 158: Line 158:
 NOTE: For the purposes of simplicity, this documentation will frequently refer to /eecs/dept/www/course which is a shortcut that refers to the course web directories for the current session and term. If you would like to refer to a course directory by its full path, you may use instead: /eecs/dept/www/course_archive/SESSION/TERM/COURSE.  For example, /eecs/dept/www/course_archive/2018-19/F/9999A. NOTE: For the purposes of simplicity, this documentation will frequently refer to /eecs/dept/www/course which is a shortcut that refers to the course web directories for the current session and term. If you would like to refer to a course directory by its full path, you may use instead: /eecs/dept/www/course_archive/SESSION/TERM/COURSE.  For example, /eecs/dept/www/course_archive/2018-19/F/9999A.
    
-===== 2.  Create a Start Page =====+===== 2.  Create a Labtest Start Page =====
  
-Create start page in your "labtest" directory, and call it "index.html".  Students will see this page when their test begins.  For the most minimal labtest setup, this is the only page you need.+Students will see the labtest start page when they begin your labtest.  Create an HTML start page in your "labtest" directory, and call it "index.html".  
  
-Here'an example of a start page written in HTML:+==== Basic Start Page ==== 
 + 
 +Here'a very basic example of a labtest start page:
  
 <code> <code>
Line 182: Line 184:
 </code> </code>
  
-Your index page can link to other resources that you store in your labtest directory, such as other PDFs.+On your start page, you can include information about the test, your rules and policies, the labtest questions (or a link to a PDF with the questions), and links to additional useful resources (such as PDFs) which you can include in your labtest directory.
  
 For your convenience, you may choose to provide a link to "/common" on your index page.  This link contains the Java API, and other documentation that is useful across labtests.  In non-labtest mode, the information appears [[http://www.eecs.yorku.ca/teaching/docs|here]].   For your convenience, you may choose to provide a link to "/common" on your index page.  This link contains the Java API, and other documentation that is useful across labtests.  In non-labtest mode, the information appears [[http://www.eecs.yorku.ca/teaching/docs|here]].  
Line 188: Line 190:
 Note: You cannot include links to content outside your labtest web directory.  Your regular course directory, or other Departmental web links will not be available during labtest. Note: You cannot include links to content outside your labtest web directory.  Your regular course directory, or other Departmental web links will not be available during labtest.
  
 +==== eClass Quiz Start Page ====
 +
 +If you are hosting your labtest as an eClass quiz, then your start page can redirect the student to the eClass quiz page like this:
  
-If you are hosting your entire labtest as an eClass quiz, then you might want your labtest start page to redirect the student to the quiz page like this: 
  
 <code> <code>
Line 545: Line 549:
 ====== Custom File Copy on User Login (optional) ====== ====== Custom File Copy on User Login (optional) ======
  
-If you want to be able to initialize a students labtest home directory with certain files  or directories when he logs in, simply create a directory called "ltinit" in your labtest directory (/eecs/dept/www/course/<COURSE>/labtest/ltinit).  The directory should be group labtest. ALL the files and directories in this directory readable by group labtest will be automatically copied to the ltinit directory in the student account when they login.  The files and directories will all be user readable, writable, and executable (mode 700).  Student files will never be overwritten, so if a student modifies files in the ltinit directory, and they log back in, the file will not be recopied from the server.+If you want to be able to initialize a students labtest home directory with certain files  or directories when he logs in, simply create a directory called "ltinit" in your labtest directory (/eecs/dept/www/course/<COURSE>/labtest/ltinit).  The directory should be group labtest. ALL the files and directories in this directory readable by group labtest will be automatically copied to the ltinit directory in the student account when they login.  Student files will never be overwritten, so if a student modifies files in the ltinit directory, and they log back in, the file will not be recopied from the server.
  
 For example: For example:
Line 589: Line 593:
 chgrp labtest /eecs/dept/www/course/9999/labtest/ltinit/labtest.sh chgrp labtest /eecs/dept/www/course/9999/labtest/ltinit/labtest.sh
 chmod g=rx /eecs/dept/www/course/9999/labtest/ltinit/labtest.sh chmod g=rx /eecs/dept/www/course/9999/labtest/ltinit/labtest.sh
 +</code>
 +
 +If you are using commands from /eecs/local/bin in ltinit, please ensure that you set the PATH variable accordingly in your labtest.sh script. For example, if you were installing a custom extension for vscode, and you want to use the "code" command in your script, ensure that /eecs/local/bin is in the PATH:
 +
 +<code>
 +#/bin/sh
 +
 +PATH=/eecs/local/bin:$PATH; export PATH
 +code --install-extension ~/ltinit/myextension.vsix
 </code> </code>
  
Line 608: Line 621:
 Create a file called "labtest.allow" in your labtest web directory (/eecs/dept/www/course/<COURSE>/labtest/labtest.allow).  Include in this file complete hostnames or IP addresses that you want students to be able to access during your test, one per line.  You can follow each hostname or IP address with a port number if required, otherwise web ports (both 80 and 443) will be assumed. Create a file called "labtest.allow" in your labtest web directory (/eecs/dept/www/course/<COURSE>/labtest/labtest.allow).  Include in this file complete hostnames or IP addresses that you want students to be able to access during your test, one per line.  You can follow each hostname or IP address with a port number if required, otherwise web ports (both 80 and 443) will be assumed.
  
-For example, if you're teaching a course EECS9999, and you want students in your labtest to be able to access the complete "www.w3schools.com" and "validator.w3.org" web sites during your test in addition to being able to access www.testing.com:8080, then create /eecs/dept/www/course/9999/labtest/labtest.allow containing:+For example, if you're teaching a course EECS9999, and you want students in your labtest to be able to access the "www.w3schools.com" and "validator.w3.org" web sites during your test in addition to being able to access www.testing.com:8080, then create /eecs/dept/www/course/9999/labtest/labtest.allow containing:
  
 <code> <code>
Line 707: Line 720:
   +eclass.yorku.ca/local   +eclass.yorku.ca/local
   +eclass.yorku.ca/repository   +eclass.yorku.ca/repository
 +  dm7crvy4e45rz.cloudfront.net
 +  +dm7crvy4e45rz.cloudfront.net
   cdn.jsdelivr.net   cdn.jsdelivr.net
   +cdn.jsdelivr.net   +cdn.jsdelivr.net
Line 716: Line 731:
 Ensure that the file is readable: <code>chmod 644 /eecs/dept/www/course/COURSE/labtest/labtest.allow</code> Ensure that the file is readable: <code>chmod 644 /eecs/dept/www/course/COURSE/labtest/labtest.allow</code>
  
-2.  Your labtest start page (eg. /eecs/dept/www/course/COURSE/labtest/index.html) (or a PDF that your star page refers to) **must** include a direct link to your specific eclass quiz.  It will look something like this: https://eclass.yorku.ca/mod/quiz/view.php?id=XXXX  You can get this link in eClass if you go to: Activities >> Quizzes  then hover your mouse over your quiz, or, if you click on the quiz to start it, you can copy and paste the URL from your browser. +2.  Your labtest start page (eg. /eecs/dept/www/course/<COURSE>/labtest/index.html) (or a PDF that your start page refers to) **must** include a direct link to your specific eclass quiz.  It will look something like this: https://eclass.yorku.ca/mod/quiz/view.php?id=XXXX  You can get this link in eClass if you go to: Activities >> Quizzes  then hover your mouse over your quiz, or, if you click on the quiz to start it, you can copy and paste the URL from your browser. 
  
 **IMPORTANT** If students try to access "https://eclass.yorku.ca" in their web browser during your labtest, **they will be blocked**.  Students can **only** visit your quiz by clicking on the link to the quiz from your labtest start page.  **IMPORTANT** If students try to access "https://eclass.yorku.ca" in their web browser during your labtest, **they will be blocked**.  Students can **only** visit your quiz by clicking on the link to the quiz from your labtest start page. 
Line 725: Line 740:
  
 NOTE: Some faculty would like to use eclass "assignment" in labtest. Note that eclass assignments do not permit IP address restriction.  A quiz with 1 question can replace an "assignment". NOTE: Some faculty would like to use eclass "assignment" in labtest. Note that eclass assignments do not permit IP address restriction.  A quiz with 1 question can replace an "assignment".
 +
 +** Always test your eclass quiz using ltcloud!  Don't assume that just because it works fine from your unrestricted PC that it will work fine in labtest. Ensuring that your quiz works in ltcloud will guarantee an improved experience in your test session. **
  
 ====== SecureQ Setup (optional) ====== ====== SecureQ Setup (optional) ======
services/labtest/start.1710785794.txt.gz · Last modified: 2024/03/18 14:16 by jas