Merge branch 'main' into sysadmin-note-http2

Author: prestoncarman

_docs/developer/development_instructions/performance_testing.md

@@ -35,4 +35,20 @@ with your URL.
 
 _NOTE: Only run this on a server that you have permission to do so on._
 
+## SQL
+
+#### Viewing Queries Executed by Submitty
+
+When Submitty is in debug mode (enabled by default in a Vagrant VM), the footer of pages will have an additional `Show Page Details` link which shows all queries that were made on the database in the process of rendering the page.
+#### Running Queries
+
+See the [Database Design page](/developer/software_and_system_design/database_design) for information about connecting to the Submitty database to run queries.
+
+One way to run the query directly on the Submitty VM is to use the following command: `sudo su - postgres -c "psql -d submitty_f22_sample -XqAt -f explain.sql > analyze.json"` where `submitty_f22_sample` is replaced with the target database (see the [Database Design page](/developer/software_and_system_design/database_design) for info about the databases in Submitty), `explain.sql` is replaced with a text file that has your query in it, and `analyze.json` is the file that you want the query plan to be output to.
+
+#### Query Plan Visualization
+
+One method for profiling and visualizing queries is to use a query plan visualizer such as `https://explain.dalibo.com`. 
+
+For this site, you generate a query plan for your query by prefixing your query with `EXPLAIN (ANALYZE, COSTS, VERBOSE, BUFFERS, FORMAT JSON)`, running it and pasting the output into the site along with your query (without the EXPLAIN prefix). The site then provides a visualization of your query, showing details such as the time it takes for individual parts of the query to run.
 

_docs/developer/rensselaer_center_for_open_source/moorthy.md

@@ -2,7 +2,7 @@
 title: Moorthy
 category: Developer > Rensselaer Center for Open Source (RCOS)
 redirect_from:
-  - /developer/rcos_moorthy.md
+  - /developer/rcos_moorthy
   - /developer/rpi_summer_rcos
   - /developer/rpi_summer_rcos/index
 ---

_docs/developer/testing/python_unit_tests.md

@@ -7,6 +7,7 @@ The following Python modules of Submitty are unit tested:
 * Migrator (under `migrations/` folder)
 * Autograding (under `autograding/` folder)
 * python_submitty_utils (under `python_submitty_utils/` folder)
+* submitty_jobs (under `sbin/submitty_daemon_jobs/` folder)
 
 ### Running Python Unit Tests
 
@@ -43,6 +44,32 @@ python3 -m unittest tests.test_cli
 python3 -m unittest tests.test_cli.TestCli.test_no_args 
 ```
 
+#### Submitty Daemon Jobs
+
+Make sure the python system dependencies are locally installed, this can be done by running the following command at the root of the project structure.
+
+```bash
+python3 -m pip install -r .setup/pip/system_requirements.txt
+
+```
+
+For the submitty_daemon_jobs unit tests, you will need to set the top level directory to `sbin/submitty_daemon_jobs` when running them. This can be done by the following command
+
+```bash
+#in the sbin/submitty_daemon_jobs directory
+
+python3 -m unittest discover tests -t .
+```
+
+Or if you're using `coverage`
+
+```bash
+#in the sbin/submitty_daemon_jobs directory
+
+coverage run -m unittest discover tests -t .
+```
+
+
 ### Writing Python Unit Tests
 
 The [unittest](https://docs.python.org/3/library/unittest.html) documentation 

_docs/sysadmin/installation/system_customization.md

@@ -143,7 +143,8 @@ However, this should be only applied to the `php.ini` running the web server and
 
 ## Increasing the max number of files that can be uploaded at once
 
-By default, PHP only allows 20 files to be uploaded at a time. To change this limit, edit:
+By default, PHP only allows 20 files to be uploaded at a time.
+This limit is probably sufficient, but to change this limit, edit:
 
 ```
 /etc/php/7.4/fpm/php.ini
@@ -152,7 +153,8 @@ By default, PHP only allows 20 files to be uploaded at a time. To change this li
 and modify the variable:
 
 ```
-upload_max_filesize
+; Maximum number of files that can be uploaded via a single request
+max_file_uploads = 20
 ```
 
 Then restart PHP
@@ -182,6 +184,10 @@ post_max_size
 upload_max_filesize
 ```
 
+We have found that a value of `200M` for both variables has been
+appropriate, specifically for bulk uploading of scanned paper exams
+for online grading.
+
 And restart apache:
 
 ```