Differences

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

--- services:labtest:start [2026/08/21 14:25] – jas
+++ services:labtest:start [2026/08/21 15:30] (current) – jas
@@ Line 188: / Line 188: @@
 There are various subcommands in Labtest Assistant - app, eecsvm, lock, ltinit, restrict, and submit, which will be described below.
+===== Labtest Applications Help =====
-===== App Dock Help =====
 <code>
@@ Line 997: / Line 996: @@
 Now if you test your labtest in ltcloud, the user will only be able to access the Firefox web browser.
-If you want additional software to be accessible in labtest, it must use a GUI.  You add to the lock file lines of the following format:
+If you want additional software to be accessible in labtest, create a file in the labtest folder called "apps" (eg. /eecs/dept/www/course/9999/labtest/default/apps).  The file contains a list of ".desktop" files available on the system for Applications that you wish to be included in the app dock at the bottom of the screen. A .desktop file is a plain text configuration file used in Linux and Unix-like operating systems to create application shortcuts, define program launchers, and integrate software into a desktop environment's application menu.
-  <app name>,<OPTIONAL app arguments>,<OPTIONAL app display name>
+These applications are ALWAYS included no matter what your settings: Firefox, Logout, and LTRestore
-For example, if you want Eclipse to be available in lock mode, you would add to the lock file:
+In labtest lock mode, no additional applications are added by default unless you add them to the app file.
-  eclipse
+**DISCLAIMER: Not all applications are suitable for labtest lock mode.  For example, VSCode requires access to the terminal for compiling and debugging code. Consult with tech when adding new applications in lock mode. **
-By default, there are no optional arguments, and if no alternate display name is mentioned, then it will appear in the menu with the same name as the command name, but with the first letter capitalized ("Eclipse").
+In regular labtest mode, these other applications are added by default:
-If you want to add Matlab:
+org.gnome.Ptyxis (this is the terminal)
+eclipse
+org.gnome.Nautilus (this is the file manager)
-  matlab,-desktop
+If you want to add an app, you need to find the desktop file for the app.  Desktop files are located in /eecs/local/share/applications/*.desktop.
-In order to run "Matlab", we have to pass "-desktop".  It would appear in the menu as "Matlab".
+If you add an app, but still want some of the defaults to appear, you have to add the defaults back as well.  For example, if you want to add IntelliJ, but you want to continue with the existing defaults, then create the "app" file containing:
-On the other hand, if you wanted to include Visual Studio Code, you would add:
+idea <- that's intellij
+org.gnome.Ptyxis (this is the terminal)
-  code,,Visual Studio Code
+eclipse
+org.gnome.Nautilus (this is the file manager)
-Now, "Visual Studio Code" will be displayed in the menu, but it will execute the command "code".
-In labtest lock mode, the window environment is a little different in order to support the locked down nature of the environment.
-When labtest mode is started, a web browser will appear with the labtest start page.  Additional software will be available by right clicking the desktop, or by clicking on the "Apps & Logout" menu in the bottom left corner of the desktop.
-Please ensure that you're careful when allowing access to software in lock mode.  Giving access to additional software may have unintended side effects.  For example, if you allow access to Eclipse, then students can compile and run code which can give access to system resources that would otherwise not be available.  Access to a terminal is still blocked.
+** Please ensure that you're careful when allowing access to software in lock mode.  Giving access to additional software may have unintended side effects.  For example, if you allow access to Eclipse, then students can compile and run code which can give access to system resources that would otherwise not be available.  Access to a terminal is still blocked. **
 ====== Accessing External Hosts In Labtest (optional) ======