Differences

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

--- deploying_sis_on_intel_content_access_point_cmal100 [2020/04/23 03:39] – ghachey
+++ deploying_sis_on_intel_content_access_point_cmal100 [2021/02/02 02:10] (current) – external edit 127.0.0.1
@@ Line 9: / Line 9: @@
 {{ :misc-it:cmal100_430_1.jpg?nolink |}}
-===== Flashing the CMAL100 Device =====
-<note warning>If you are running an education version (e.g. one that redirects to RACHEL website when you connect to the WiFi network) then you can skip this section.</note>
+===== Accessing the CMAL100 Web Administrative User Interface =====
-You only need to do this if you have been mistakenly given an non-rooted locked version of this device (e.g. for prisons). If you have a locked version [[flashing-cmal100|flash your CMAL100 device first]].
+Plug the network cable in the first LAN port in the CMAL100 and in your main switch as shown below. It should receive an DHCP lease IP address on the "WAN".
+{{ :misc-it:flash-cmal100-1.jpg?nolink |}}
+Point your browser to [[http://my.content:8080|http://my.content:8080]]. Enter the username "admin" and password "admin" which is the default. Your password might be different.
+{{ :misc-it:flash-cmal100-2.png?nolink |}}
+You should be directed to the following. You can know the external (i.e. WAN) IP address from that status screen below. Mine was ''192.168.6.20'' at the time.
+{{ :misc-it:flash-cmal100-3.png?nolink |}}
+===== Accessing the CMAL100 Linux Operating System =====
+Before proceeding to the next section you first need to be able to SSH into a Linux machine. You either need to be on Linux, use Putty on Windows and even [[linux-in-windows|install Linux in Windows]]. Make sure can do that before you proceed to the following section.
 ===== OpenSIS Installation =====
@@ Line 20: / Line 33: @@
 The Pacific Student Information System (FedSIS, MISIS) is based on opensis. So here we document how to install that.
-First you need to ssh into the CMAL100 device. You either need to be on Linux, use Putty on Windows and even [[linux-in-windows|install Linux in Windows]].
+First, you need to ssh into the CMAL100 device from your own machine.
 <code>
-user@yourmachine:~$ ssh cap@ip.address.of.cmal100
+user@yourmachine:~$ ssh.exe cap@ip.address.of.cmal100
 </code>
@@ Line 37: / Line 50: @@
 <code>
-cap@CMAL-aaed:~$ wget -c https://codeload.github.com/OS4ED/openSIS-Responsive-Design/zip/master -O opensis-$(date +%
+cap@CMAL-aaed:~$ wget -c https://codeload.github.com/OS4ED/openSIS-Responsive-Design/zip/master -O opensis.zip
-F_%R).zip
+</code>
+Before installing anything upgrade the system.
+<code>
+cap@CMAL-aaed:~$ sudo apt-get update
+cap@CMAL-aaed:~$ sudo apt-get upgrade
 </code>
@@ Line 44: / Line 63: @@
 <code>
-cap@CMAL-aaed:~$ sudo apt-get install unzip
+cap@CMAL-aaed:~$ sudo apt-get install unzip aptitude
-cap@CMAL-aaed:~$ unzip opensis-2020-04-22_05\:29.zip
+cap@CMAL-aaed:~$ unzip opensis.zip
 </code>
@@ Line 59: / Line 78: @@
 The is already likely an Nginx web server running on the device for some other web services. You could install the SIS on that same server or you could leave that Nginx mostly untouched and install Apache2 with which OpenSIS was more heavily tested. This is the approach shown here but an experience sysadmin could opt to use Nginx.
-First, get Nginx to listen on port 81 instead of port 80. That way to access what was normally running on the device at ''http://my.content/'' you would access it at ''http://my.content:81/''. You do this by opening the file
+First, get Nginx to listen on port 88 instead of port 80. That way to access what was normally running on the device at ''http://my.content/'' you would access it at ''http://my.content:88/''. This will depend on your current setup. But one of the files in /etc/nginx/sites-avilable will be configured to listen on port 80.
+This could be
+<code>
+cap@CMAL-aaed:~$ sudo nano /etc/nginx/sites-available/rachel.nginx.conf
+</code>
+Or it could be
 <code>
-cap@CMAL-aaed:~$ sudo nano /etc/nginx/sites-enabled/default
+cap@CMAL-aaed:~$ sudo nano /etc/nginx/sites-available/default
 </code>
-And as shown below find the number 80 and replace it with 81 (2 places). Do *NOT* change anything else or things will break. to save press ''Control-X'' (i.e. the ''Control'' key followed by the ''x'' key at the same time) following by ''Y'' and ''Enter'' to say yes and close the text editor.
+The one with port 80 replace it with 88 (2 places). Do *NOT* change anything else or things will break. to save press ''Control-X'' (i.e. the ''Control'' key followed by the ''x'' key at the same time) following by ''Y'' and ''Enter'' to say yes and close the text editor.
 You can then restart the Nginx web server.
@@ Line 107: / Line 134: @@
 Now install the database server MySQL. You will need to enter the password. Use the same as the device cap password so you don't forget.
+<note important>If you already have the MySQL server installed then the following steps (i.e. next three commands) are not necessary. If you have MySQL already installed you may have to [[reset-mysql-root-password|Reset MySQL root password]] if you do not know it.</note>
 <code>
 cap@CMAL-aaed:~$ sudo aptitude install mysql-server
+</code>
+Make sure the mysql server is enabled and started.
+<code>
+sudo systemctl enable mysql.service
+sudo systemctl start mysql.service
 </code>
@@ Line 118: / Line 154: @@
 </code>
-With all the above completed you should be able to start installing the SIS. Back on the computer where you access the WiFI of the CMAL100 device in your browser point it to ''http://my.content/'' and it should present you with the following.
+Optionally check the above setting was changed.
+<code>
+mysql -u root -p -e "SELECT @@GLOBAL.sql_mode;"
+</code>
+With all the above completed you should be able to start installing the SIS. Back on the computer where you access the WiFI of the CMAL100 device in your browser point it to ''http://my.content/'' and it should present you with the following. Click ''New Installation''.
+{{ :misc-it:opensis-install-1.png?nolink |}}
+Make sure you have all dependencies met. Click ''Continue''.
+{{ :misc-it:opensis-install-2.png?nolink |}}
+Enter the MySQL Server details (i.e. the password put previously). Click ''Save & Next''.
+{{ :misc-it:opensis-install-3.png?nolink |}}
+Enter the database name. Click ''Save & Next''.
+{{ :misc-it:opensis-install-4.png?nolink |}}
+Enter the school details. Click ''Save & Next''.
+{{ :misc-it:opensis-install-5.png?nolink |}}
+Enter the first admin user as follows.  Click ''Save & Next''.
+{{ :misc-it:opensis-install-6.png?nolink |}}
+You should see the following. Click on ''Proceed to openSIS Login''.
+{{ :misc-it:opensis-install-7.png?nolink |}}
+Login with your admin user.
+{{ :misc-it:opensis-install-8.png?nolink |}}