deploying_sis_on_intel_content_access_point_cmal100
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
deploying_sis_on_intel_content_access_point_cmal100 [2020/04/22 02:52] – created ghachey | deploying_sis_on_intel_content_access_point_cmal100 [2021/02/02 02:10] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Deploying the Student Information System on Intel Content Access Point (CMAL100) ====== | ====== Deploying the Student Information System on Intel Content Access Point (CMAL100) ====== | ||
+ | |||
+ | <note warning> | ||
+ | |||
+ | <note important> | ||
This page documents how to install the SIS onto the Intel Content Access Point aka CMAL100 devices. The primary reason for installing the SIS on those mini school servers is to enable the school with poor to no Internet connectivity to have access to a Student Information System to improve their data management. | This page documents how to install the SIS onto the Intel Content Access Point aka CMAL100 devices. The primary reason for installing the SIS on those mini school servers is to enable the school with poor to no Internet connectivity to have access to a Student Information System to improve their data management. | ||
{{ : | {{ : | ||
+ | |||
+ | |||
+ | ===== Accessing the CMAL100 Web Administrative User Interface ===== | ||
+ | |||
+ | 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 " | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Point your browser to [[http:// | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | You should be directed to the following. You can know the external (i.e. WAN) IP address from that status screen below. Mine was '' | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | |||
+ | ===== 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 ===== | ||
+ | |||
+ | 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 from your own machine. | ||
+ | |||
+ | < | ||
+ | user@yourmachine: | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | |||
+ | Onced logged in make sure are in the use cap's home directory. | ||
+ | |||
+ | < | ||
+ | cap@CMAL-aaed: | ||
+ | </ | ||
+ | |||
+ | Download the latest OpenSIS into a zip file called opensis-[date and time of download].zip | ||
+ | |||
+ | < | ||
+ | cap@CMAL-aaed: | ||
+ | </ | ||
+ | |||
+ | Before installing anything upgrade the system. | ||
+ | |||
+ | < | ||
+ | cap@CMAL-aaed: | ||
+ | cap@CMAL-aaed: | ||
+ | </ | ||
+ | |||
+ | Install unzip on the device and decompress the file. | ||
+ | |||
+ | < | ||
+ | cap@CMAL-aaed: | ||
+ | cap@CMAL-aaed: | ||
+ | </ | ||
+ | |||
+ | Cope the decompressed files to the web servers directory and change the ownership. | ||
+ | |||
+ | < | ||
+ | cap@CMAL-aaed: | ||
+ | cap@CMAL-aaed: | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | |||
+ | 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 88 instead of port 80. That way to access what was normally running on the device at '' | ||
+ | |||
+ | This could be | ||
+ | |||
+ | < | ||
+ | cap@CMAL-aaed: | ||
+ | </ | ||
+ | |||
+ | Or it could be | ||
+ | |||
+ | < | ||
+ | cap@CMAL-aaed: | ||
+ | </ | ||
+ | |||
+ | The one with port 80 replace it with 88 (2 places). Do *NOT* change anything else or things will break. to save press '' | ||
+ | |||
+ | You can then restart the Nginx web server. | ||
+ | |||
+ | < | ||
+ | cap@CMAL-aaed: | ||
+ | </ | ||
+ | |||
+ | Install Apache2 and all other required software to run OpenSIS. | ||
+ | |||
+ | < | ||
+ | cap@CMAL-aaed: | ||
+ | </ | ||
+ | |||
+ | Now configure a virtual host to run the SIS web application. Open the file below (called differently based on country or school). | ||
+ | |||
+ | < | ||
+ | cap@CMAL-aaed: | ||
+ | </ | ||
+ | |||
+ | And copy the following text in it. you save it the same way as above: press '' | ||
+ | |||
+ | < | ||
+ | < | ||
+ | ServerAdmin webmaster@nuzusys.com | ||
+ | ServerName my.content | ||
+ | ServerAlias misis-local.pss.edu.mh | ||
+ | DocumentRoot / | ||
+ | LogLevel info | ||
+ | ErrorLog ${APACHE_LOG_DIR}/ | ||
+ | CustomLog ${APACHE_LOG_DIR}/ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | Now activate your newly setup virtual host website and restart the web server (or reload it). | ||
+ | |||
+ | < | ||
+ | cap@CMAL-aaed: | ||
+ | cap@CMAL-aaed: | ||
+ | </ | ||
+ | |||
+ | 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> | ||
+ | |||
+ | < | ||
+ | cap@CMAL-aaed: | ||
+ | </ | ||
+ | |||
+ | Make sure the mysql server is enabled and started. | ||
+ | |||
+ | < | ||
+ | sudo systemctl enable mysql.service | ||
+ | sudo systemctl start mysql.service | ||
+ | </ | ||
+ | |||
+ | Change an important setting of the MySQL server. You will have to enter the MySQL root password for the following command. | ||
+ | |||
+ | < | ||
+ | mysql -u root -p -e "SET GLOBAL sql_mode = ' | ||
+ | </ | ||
+ | |||
+ | Optionally check the above setting was changed. | ||
+ | |||
+ | < | ||
+ | mysql -u root -p -e " | ||
+ | </ | ||
+ | |||
+ | 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 '' | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Make sure you have all dependencies met. Click '' | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Enter the MySQL Server details (i.e. the password put previously). Click '' | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Enter the database name. Click '' | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Enter the school details. Click '' | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Enter the first admin user as follows. | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | You should see the following. Click on '' | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Login with your admin user. | ||
+ | |||
+ | {{ : | ||
deploying_sis_on_intel_content_access_point_cmal100.1587523931.txt.gz · Last modified: 2021/02/02 02:10 (external edit)