cafe-grader-web

Commit r727:8cef8d08de9b public

parent | child
Description:
Update README.rdoc Fix some typo about database name. add number to each step
Commit status:
[Not Reviewed]
References:
default
Diff options:
Raw Diff | Patch Diff | Download Diff | Show whitespace | Increase context
Comments:
0 Commit comments 0 Inline Comments
Unresolved TODOs:
There are no unresolved TODOs
Side by Side Unified
Expand All Files Collapse All Files Wide Mode Diff
Add another comment
Browse Files

r727:8cef8d08de9b - - 1 file changed: 11 inserted, 9 deleted

Show file before | Show file after | Raw diff | Download diff | Show whitespace Increase context Show commentsHide comments
@@ -5,34 +5,36
5 5 1. Set up database. We need MySQL 5 database name, username and password.
6 6 2. Install RVM. cafe-grader runs on Ruby on Rails and the best way to install it is to use RVM.
7 7 3. Install necessary package for the system
8 8 4. Install cafe-grader from github
9 9 5. Deploy cafe-grader on apache with Phusion Passenger
10 10
11 + Very important!!! All commands should be run from a normal user.
12 +
11 13 The detail of each step are provided as follows.
12 14
13 - === Install MySQL 5
15 + === 1. Install MySQL 5
14 16
15 17 Install MySQL server for the server.
16 18
17 19 cafe@grader:~$ sudo apt install mysql-server
18 20
19 - Next, we will connect to mysql as root and set up the database. You can choose your DATABASENAME, USERNAME and PASSWORD.
21 + Next, we will connect to mysql as root and set up the database. You can choose your DATABASENAME, USERNAME and PASSWORD as you wish.
20 22
21 23 cafe@grader:~$ sudo mysql -u root
22 24
23 25 mysql> create database DATABASENAME;
24 26 Query OK, 1 row affected (0.00 sec)
25 27
26 - mysql> grant all privileges on grader.* to USERNAME@localhost identified by 'PASSWORD';
28 + mysql> grant all privileges on DATABASENAME.* to USERNAME@localhost identified by 'PASSWORD';
27 29 Query OK, 0 rows affected, 1 warning (0.00 sec)
28 30
29 31 mysql> flush privileges;
30 32 Query OK, 0 rows affected (0.00 sec)
31 33
32 - === Install RVM
34 + === 2. Install RVM
33 35
34 36 Since Ubuntu has dedicated package for RVM we will use that. Just follow instruction given in https://github.com/rvm/ubuntu_rvm. For your convenience, the step are reproduced here.
35 37
36 38 First, we install necessary package for installing RVM.
37 39
38 40 cafe@grader:~$ sudo apt install software-properties-common
@@ -44,19 +46,19
44 46 cafe@grader:~$ sudo apt-get install rvm
45 47
46 48 This is very important. You have to logout and login again since RVM change a lots of system.
47 49
48 50 If you are using GUI version of Ubuntu, be sure to have Gnome Terminal (or any other terminal you are using) perform login every time. This can be done by mark the check box "Run command as a login shell" in Gnome terminal or by adding --login to bash.
49 51
50 - === Install necessary package
52 + === 3. Install necessary package
51 53
52 54 cafe@grader:~$ sudo apt install libmysqlclient-dev default-jdk unzip nodejs php7.2-cli apache2 dirmngr gnupg apache2-dev
53 55
54 56 curl build-essential
55 57
56 - === Install cafe-grader
58 + === 4. Install cafe-grader
57 59
58 60 First, ensure that RVM is installed correctly.
59 61
60 62 cafe@grader:~$ rvm
61 63
62 64 If you get a result similar to this.
@@ -75,19 +77,19
75 77 cafe@grader:~/cafe_grader/web$ rails s
76 78
77 79 If Everything is OK, stop the WEBrick by Ctrl-C.
78 80
79 81 We are almost done. The last step is to set up apache and Phusion so that cafe-grader is served by apache.
80 82
81 - === Deploy cafe-grader on Phusion passenger via apache
83 + === 5. Deploy cafe-grader on Phusion passenger via apache
82 84
83 85 This will install a Passenger mod for apache. You can start by visiting https://www.phusionpassenger.com/library/walkthroughs/deploy/ruby/ownserver/apache/oss/install_passenger_main.html and fllow through the guide. We have reproduce the step here for Ubuntu 18.04. For other version, please select the appropriate one on the previous link.
84 86
85 87 The deploy is divided into two parts: Installing Passenger and deploying the app.
86 88
87 - 1. Installing Passenger as a mod for apache via PPA and enable it.
89 + ==== 5.1. Installing Passenger as a mod for apache via PPA and enable it.
88 90
89 91 cafe@grader:~$ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 561F9B9CAC40B2F7
90 92 cafe@grader:~$ sudo apt-get install -y apt-transport-https ca-certificates
91 93 cafe@grader:~$ sudo sh -c 'echo deb https://oss-binaries.phusionpassenger.com/apt/passenger bionic main > /etc/apt/sources.list.d/passenger.list'
92 94 cafe@grader:~$ sudo apt-get update
93 95 cafe@grader:~$ sudo apt-get install -y libapache2-mod-passenger
@@ -97,13 +99,13
97 99 cafe@grader:~$ sudo apache2ctl restart
98 100
99 101 Finally, we should check that passenger is installed correctly. Run the following command and fix anything as suggested by the command.
100 102
101 103 cafe@grader:~$ sudo /usr/bin/passenger-config validate-install
102 104
103 - 2. Deploying the app. First, we determine the exact location of our ruby that is installed via RVM.
105 + ==== 5.2. Deploying the app. First, we determine the exact location of our ruby that is installed via RVM.
104 106
105 107 cafe@grader:~$ passenger-config about ruby-command
106 108 passenger-config was invoked through the following Ruby interpreter:
107 109 Command: /home/cafe/.rvm/gems/ruby-2.3.7/wrappers/ruby
108 110 Version: ruby 2.3.7p456 (2018-03-28 revision 63024) [x86_64-linux]
109 111 To use in Apache: PassengerRuby /home/cafe/.rvm/gems/ruby-2.3.7/wrappers/ruby
You need to be logged in to leave comments. Login now