Merge pull request 'Hui-improve-README.md' (#3) from Hui-improve-README.md into master
Reviewed-on: http://121.4.94.30:3000/mrlan/LRR/pulls/3Hui-LecturerEmail
						commit
						a5d9ac9400
					
				
							
								
								
									
										36
									
								
								README.md
								
								
								
								
							
							
						
						
									
										36
									
								
								README.md
								
								
								
								
							|  | @ -17,7 +17,41 @@ Our mission is to make the experience of submitting assignments great for tens o | ||||||
| 
 | 
 | ||||||
| # Installation Instructions | # Installation Instructions | ||||||
| 
 | 
 | ||||||
| Check file INSTALLATION.md (TBA) for details. | 
 | ||||||
|  | ## Hui's steps | ||||||
|  | 
 | ||||||
|  | I spent about two hours on installing LRR to a bare, remote Ubuntu server (Ubuntu 20.04 LTS). | ||||||
|  | 
 | ||||||
|  | LRR needs Apache and MySQL to run.  I followed [How To Install Linux, Apache, MySQL, PHP (LAMP) stack on Ubuntu 20.04](https://www.digitalocean.com/community/tutorials/how-to-install-linux-apache-mysql-php-lamp-stack-on-ubuntu-20-04) to set up these server applications. | ||||||
|  | 
 | ||||||
|  | LRR uses a database called `lrr`.  I need to export existing `lrr` to a plain text file (including many sql commands) and import that text file to the newly created `lrr` database on the new server. | ||||||
|  | The command for exporting the database is `mysqldump -u mnc -p lrr > lrr_database_dump.txt`. | ||||||
|  | The command for importing is `mysql -u mnc -p lrr < lrr_database_dump.txt`.  Read [How to Import and Export MySQL Databases in Linux](https://phoenixnap.com/kb/import-and-export-mysql-database) for more detail. | ||||||
|  | 
 | ||||||
|  | LRR also needs to store assignment submissions.  We store them in a folder called `../../lrr_submission`.  Note that `lrr_submission` is two levels above the project folder (where many PHP files reside).  I copied this folder from the existing one.  I think it is also OK if you create an empty folder.    | ||||||
|  | We need to set a proper owner and accessibility for `lrr_submission` using the following two commands: | ||||||
|  | `sudo chown -R www-data:www-data lrr_submission` and  `sudo chmod -R g+rw lrr_submission`.  Also, remember to change the user name and password in `lrr_submission//KeepItSafe.txt` for the database connection. | ||||||
|  | 
 | ||||||
|  | The above steps are preparation work. Now we could clone the LRR's repository to `/var/www/html/`. | ||||||
|  | Rename LRR to lrr.  Change the owner of lrr: `sudo chown -R $USER:$USER /var/www/lrr`. Edit apache configure file: `sudo nano /etc/apache2/sites-available/lrr.conf`. | ||||||
|  | 
 | ||||||
|  | 
 | ||||||
|  |     <VirtualHost *:80> | ||||||
|  |         ServerName lrr | ||||||
|  |         ServerAlias www.lrr.com | ||||||
|  |         ServerAdmin webmaster@localhost | ||||||
|  |         DocumentRoot /var/www/html/lrr | ||||||
|  |         ErrorLog ${APACHE_LOG_DIR}/error.log | ||||||
|  |         CustomLog ${APACHE_LOG_DIR}/access.log combined | ||||||
|  |     </VirtualHost> | ||||||
|  | 
 | ||||||
|  | Enable the site lrr: `sudo a2ensite lrr`.  Restart the apache server: `sudo systemctl reload apache2`. | ||||||
|  | Visit the LRR application by entering this URL in a web browser: http://121.4.94.30/. | ||||||
|  | 
 | ||||||
|  | 
 | ||||||
|  | ## Enock's steps | ||||||
|  | 
 | ||||||
|  | Enock has made a tutorial about how he deployed LRR to a remote server (http://lanlab.org/course/2021s/spm/PuTTY-Server.txt). | ||||||
| 
 | 
 | ||||||
| 
 | 
 | ||||||
| 
 | 
 | ||||||
|  |  | ||||||
		Loading…
	
		Reference in New Issue