EECS Technical Database

User Tools

Site Tools

You are here: Technical Database » Departmental Services » Labtest Mode
Trace:
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 [2025/02/04 10:45] – jasservices:labtest:start [2025/03/05 03:46] (current) – [3. Allow Access To Your eClass Quiz ID In Labtest Mode] jas
Line 247: Line 247:
 restrict list                                List labtest URL restrictions (including line numbers) restrict list                                List labtest URL restrictions (including line numbers)
 restrict add <restriction> [<line number>]   Add labtest URL restriction <restriction> restrict add <restriction> [<line number>]   Add labtest URL restriction <restriction>
-restrict eclass                              Allow access to eClass Quiz and VPL+restrict eclass                              Allow access to eClass (*)
 restrict delete <line-number>                Delete restriction <restriction> restrict delete <line-number>                Delete restriction <restriction>
 restrict edit                                Edit labtest restrictions restrict edit                                Edit labtest restrictions
Line 261: Line 261:
 labtest> restrict add -www.w3schools.com/html/html_editors.asp labtest> restrict add -www.w3schools.com/html/html_editors.asp
  
-To allow access to eClass Quiz/VPL, please read the following web page:+(*) To allow access to eClass Quiz/VPL, please read the following web page:
  
 https://wiki.eecs.yorku.ca/dept/tdb/services:labtest:start#accessing_external_hosts_in_labtest_eclass_example https://wiki.eecs.yorku.ca/dept/tdb/services:labtest:start#accessing_external_hosts_in_labtest_eclass_example
Line 319: Line 319:
 # <optional description> # <optional description>
 #version: <optional labtest version name> #version: <optional labtest version name>
-MM/DD/YYYY  HH:MM M labtest <HOSTSPEC> +MM/DD/YYYY  HH:MM M labtest HOSTSPEC 
-MM/DD/YYYY  HH:MM M default <HOSTSPEC>+MM/DD/YYYY  HH:MM M default HOSTSPEC
 </code> </code>
  
Line 329: Line 329:
   * HH:MM - hour:minute hour of your test (note that this is impacted by the next field)   * HH:MM - hour:minute hour of your test (note that this is impacted by the next field)
   * M - number of minutes of warnings to send to students before system will reboot (usually 5) - NOTE: If M=5, machines will REBOOT at HH:MM + 5 MIN, NOT at HH:MM   * M - number of minutes of warnings to send to students before system will reboot (usually 5) - NOTE: If M=5, machines will REBOOT at HH:MM + 5 MIN, NOT at HH:MM
-  * <HOSTSPEC> - lets us know which hosts you want to book. <HOSTSPEC> can contain:+  * HOSTSPEC - lets us know which hosts you want to book. <HOSTSPEC> can contain:
     * individual machines separated by commas: ea01,ea02,ea03     * individual machines separated by commas: ea01,ea02,ea03
     * groups of machines:      * groups of machines: 
Line 381: Line 381:
 </code> </code>
  
-If you have students with different accommodations for extra time, please submit a **separate** block for each accommodation type.  Here's the same booking request above with 5 machines getting an extra hour, 2 machines getting 30 minutes extra, and 1 machine getting 10 minutes extra.  **Accommodations cannot exceed your lab booking time.  In order to book machines past your lab booking time, please consult with tech.**+If you have students with different accommodations for extra time, please submit a **separate** block for each accommodation type.  Here's the same booking request above with 5 machines getting an extra hour, 2 machines getting 30 minutes extra, and 1 machine getting 20 minutes extra.  **Accommodations cannot exceed your lab booking time.  In order to book machines past your lab booking time, please consult with tech.**
  
 <code> <code>
Line 423: Line 423:
 </code> </code>
  
-...  or you can create one long session 9:00 AM - 11:00 AM, but you will have to clear the lab manually between sessions yourself:+...  or you can create one long session 9:00 AM - 1:00 PM, but you will have to clear the lab manually between sessions yourself:
  
 <code> <code>
Line 1093: Line 1093:
 In this section, we will configure labtest to provide secure access to an eClass quiz. In this section, we will configure labtest to provide secure access to an eClass quiz.
  
-===== 1.  Allow lab machines to access eClass in labtest mode =====+===== 1.  Allow Lab Machines Limited Access To eClass In Labtest Mode =====
  
-First, you need to allow the lab machines to access eClass in labtest mode.+First, you need to allow the lab machines limited access to eClass in labtest mode.
  
-If you're using Labtest Assistant, use the "restrict eclass" command:<code>+If you're using Labtest Assistant, use the "restrict eclass" command: 
 + 
 +<code>
 labtest> restrict eclass labtest> restrict eclass
 </code> </code>
  
-If you're setting your labtest up manually, you will need to create a labtest.allow file in your labtest directory which includes the allowed URL parts for eClass.  At an absolute minimum this would be:+If you're not using Labtest Assistant, you need to create a labtest.allow file in your labtest directory which includes the allowed URL parts for eClass:
  
-  eclass.yorku.ca+<code> 
 +eclass.yorku.ca/login 
 +eclass.yorku.ca/auth 
 +eclass.yorku.ca/pluginfile.php 
 +eclass.yorku.ca/theme 
 +eclass.yorku.ca/lib 
 +eclass.yorku.ca/local 
 +eclass.yorku.ca/repository 
 +eclass.yorku.ca/course/switchrole.php 
 +dm7crvy4e45rz.cloudfront.net 
 +eclass.yorku.ca/mod/quiz/startattempt.php 
 +eclass.yorku.ca/mod/quiz/attempt.php 
 +eclass.yorku.ca/mod/quiz/processattempt.php 
 +eclass.yorku.ca/mod/quiz/summary.php 
 +eclass.yorku.ca/mod/quiz/review.php 
 +eclass.yorku.ca/mod/quiz/autosave 
 +</code>
  
-If your labtest.allow file only includes "eclass.yorku.ca", then labtest will do the following:+===== 2. Determine Your eClass Quiz URL =====
  
-  * restrict user access to "Private Files". +Visit your eClass quiz from your machine that is **not** in labtest mode. Grab the quiz URL from the URL bar in your web browser.  The URL will look something like this: https://eclass.yorku.ca/mod/quiz/view.php?id=12345
-  * restrict user access to eClass communications (so they cannot chat with other students).+
  
-However, there are still problems:+You can also get this link in eClass if you go to: Activities >> Quizzes then hover your mouse over your quiz.
  
-  * Students will not be able to view images attached to quiz questions because eClass caches these on an external site which hasn't been allowed: dm7crvy4e45rz.cloudfront.net +===== 3. Allow Access To Your eClass Quiz ID In Labtest Mode =====
-  * Students would still be able to access eClass pages for any courses to which they are enrolled.+
  
-This labtest.allow file is best for eClass use because it resolves the remaining problems:+If you're using Labtest Assistant, use the following command to allow access your eClass quiz in labtest:
  
-  eclass.yorku.ca/login +<code> 
-  eclass.yorku.ca/auth +labtest> restrict add eclass.yorku.ca/mod/quiz/view.php?id=ID 
-  eclass.yorku.ca/pluginfile.php +</code>
-  eclass.yorku.ca/quiz +
-  -eclass.yorku.ca/mod/quiz/index.php +
-  eclass.yorku.ca/mod/quiz +
-  eclass.yorku.ca/theme +
-  eclass.yorku.ca/lib +
-  eclass.yorku.ca/local +
-  eclass.yorku.ca/repository +
-  eclass.yorku.ca/course/switchrole.php +
-  dm7crvy4e45rz.cloudfront.net+
  
-If you wish to use additional functionality in eClass (other than just quizzes), you may need to add additional URLs to labtest.allow.  For example, to add access to Virtual Programming Lab (VPL), add the following to labtest.allow:+Replace ID with your eClass Quiz ID.
  
-  eclass.yorku.ca/mod/vpl +If you're not using Labtest Assistant, add the following line to the end of your labtest.allow file in your labtest directory: 
-  vpl1.eecs.yorku.ca+ 
 +<code> 
 +eclass.yorku.ca/mod/quiz/view.php?id=ID 
 +</code> 
 +   
 +Replace ID with your eClass Quiz ID.
  
 Ensure that the labtest.allow file is readable: <code>chmod 644 /eecs/dept/www/course/COURSE/labtest/labtest.allow</code> Ensure that the labtest.allow file is readable: <code>chmod 644 /eecs/dept/www/course/COURSE/labtest/labtest.allow</code>
  
-===== 2. Provide a Link to Your eClass Quiz in Your Labtest Start Page =====+===== 4. Provide a Link to Your eClass Quiz in Your Labtest Start Page =====
  
-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. +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. You found this URL in step 2.
  
-If you're using Labtest Assistant, open your labtest start page using the "gedit" (GUI editor) or "edit" (text editor) commands and add a link to your eClass quiz on the page.+If you're using Labtest Assistant, open your labtest start page using the "gedit" (GUI editor) or "edit" (text editor) commands and add a link to your eClass quiz on the page.  For example: 
 + 
 +<code> 
 +Click <a href="https://eclass.yorku.ca/mod/quiz/view.php?id=12345">here</a> to take the quiz. 
 +</code>
  
 If you're not using Labtest Assistant, open the index.html file in your labtest directory, and add the link manually. If you're not using Labtest Assistant, open the index.html file in your labtest directory, and add the link manually.
Line 1147: Line 1163:
 **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. 
  
-===== 3. Restrict IP Addresses Which Can Access Your eClass Quiz From Within eClass =====+===== 5. Restrict IP Addresses Which Can Access Your eClass Quiz From Within eClass =====
  
 Login to eClass.  Restrict access to your eClass quiz to the IP addresses of the lab machines where the students will be writing the quiz.  If you don't do this, even though your in-lab students will be limited in the proper way, students who are outside of the lab would also be able to write your quiz.  Go to: Activities >> Quizzes >> Settings >> Extra restriction on attempts >> Show more... >> Require network address.  Please copy and paste the specific address list below: Login to eClass.  Restrict access to your eClass quiz to the IP addresses of the lab machines where the students will be writing the quiz.  If you don't do this, even though your in-lab students will be limited in the proper way, students who are outside of the lab would also be able to write your quiz.  Go to: Activities >> Quizzes >> Settings >> Extra restriction on attempts >> Show more... >> Require network address.  Please copy and paste the specific address list below:
Line 1167: Line 1183:
   * If your test is being conducted in several labs, you can join two IP ranges with a comma in between them.  Note though that if the number of IP ranges separated by commas exceeds 18, the IP restrictions will not function correctly due to an eClass bug.  Please consult with tech to test your IP range prior to your test.   * If your test is being conducted in several labs, you can join two IP ranges with a comma in between them.  Note though that if the number of IP ranges separated by commas exceeds 18, the IP restrictions will not function correctly due to an eClass bug.  Please consult with tech to test your IP range prior to your test.
  
-===== 4. Limit the Start and End Time of Your Quiz in eClass =====+===== 6. Limit the Start and End Time of Your Quiz in eClass =====
  
 You will need to limit the start and end time of your quiz in eClass.  If you don't do this, then students on the lab machines will be able to access your quiz **before** your labtest!  Go to: Activities >> Quizzes >> Settings >> Timing and configure the "Open the quiz" and "Close the quiz" times.  Note that if students try to access the quiz before the open time, they will be denied because eclass will try to redirect them back to the course eclass page which has been blocked.  They should try again at the start time of your test. You will need to limit the start and end time of your quiz in eClass.  If you don't do this, then students on the lab machines will be able to access your quiz **before** your labtest!  Go to: Activities >> Quizzes >> Settings >> Timing and configure the "Open the quiz" and "Close the quiz" times.  Note that if students try to access the quiz before the open time, they will be denied because eclass will try to redirect them back to the course eclass page which has been blocked.  They should try again at the start time of your test.
Line 1174: Line 1190:
  
   * 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".   * 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".
 +  * If you're using VPL, you'll need to allow access to the following URL fragments with either "restrict add" in Labtest Assistant, or manually in your labtest.allow file:
 +    * eclass.yorku.ca/mod/vpl/view.php?id=ID
 +    * vpl1.eecs.yorku.ca
   * **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. **   * **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. **
  
Line 1563: Line 1582:
 Access the Labtest Cloud URL here: Access the Labtest Cloud URL here:
  
-  * https://webapp.eecs.yorku.ca/ltcloud?id=<your labtest ID>+  * https://webapp.eecs.yorku.ca/ltcloud 
 + 
 +The best way to access ltcloud is directly from a web browser when you are connected to [[https://remotelab.eecs.yorku.ca|EECS Remotelab]]. 
 +If you want to access LTCloud directly from your home PC, you can use [[https://www.yorku.ca/uit/faculty-and-staff-services/internet-access/#vpn|York VPN]].
  
-Note that if you are accessing this URL from a non-EECS IP address (such as from home), you must be connected to [[https://staff.computing.yorku.ca/internet-access/secure-remote-access/|York VPN]] in order to to use the service. 
-  
 After connecting to the Labtest Cloud URL, you will be required to authenticate with your EECS username and password.  After you successfully authenticate, the system will take about 10 seconds to setup your Labtest Cloud instance.  Click on the "Connect to Labtest Cloud" button, and, right from your web browser, you'll be connected to a virtual system running labtest!  You will be logged in as "ltstu" (labtest student) which is a ugrad account.  Testing as a student is the best way to test your labtest. After connecting to the Labtest Cloud URL, you will be required to authenticate with your EECS username and password.  After you successfully authenticate, the system will take about 10 seconds to setup your Labtest Cloud instance.  Click on the "Connect to Labtest Cloud" button, and, right from your web browser, you'll be connected to a virtual system running labtest!  You will be logged in as "ltstu" (labtest student) which is a ugrad account.  Testing as a student is the best way to test your labtest.
  
services/labtest/start.1738683907.txt.gz · Last modified: 2025/02/04 10:45 by jas
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki