https://github.com/shan18/sbhs-vlabs
SBHS Virtual Labs Server, IIT Bombay
https://github.com/shan18/sbhs-vlabs
apache django mathematical-modelling python scilab virtual-laboratory
Last synced: 3 months ago
JSON representation
SBHS Virtual Labs Server, IIT Bombay
- Host: GitHub
- URL: https://github.com/shan18/sbhs-vlabs
- Owner: shan18
- Created: 2018-05-12T15:16:17.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2020-06-08T09:48:13.000Z (almost 5 years ago)
- Last Synced: 2025-01-08T16:56:19.738Z (5 months ago)
- Topics: apache, django, mathematical-modelling, python, scilab, virtual-laboratory
- Language: Python
- Homepage:
- Size: 23.8 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SBHS Virtual Labs Server
Please follow the steps below to set up the server code on your system:
+ Clone this repository.
`git clone https://github.com/FOSSEE/SBHS-Vlabs.git`
If you have permission issues, make sure that you are added as a collaborator.
Contact [email protected]
+ Install **pip** and **virtualenv**. These two packages need to be installed globally on your system.
+ Setup a virtualenv in your system.
To check which is the default python in your system:
`python --version`
+ If Python 2.7 is the default in your system, type the command
`virtualenv venv`
+ If Python 3.x is the default in your system, type the command
`virtualenv venv --python=python2.7`
+ Activate the virtualenv with `source venv/bin/activate`
+ Go into the project directory and install the dependencies.
```bash
cd SBHS-Vlabs/
pip install -r requirements.txt
```
+ Create and run the database migrations using the following commands
```bash
python manage.py makemigrations tables
python manage.py makemigrations yaksh
python manage.py makemigrations
python manage.py migrate
```
+ Run the server with `python manage.py` runserver. Open **localhost:8000** in your browser.
### Instructions for setting up Apache
+ Make sure you have **Apache 2.4** installed on your system.
+ Install the ***mod-wsgi*** module.
`sudo apt-get install libapache2-mod-wsgi`
+ Enable the module *(If not enabled already)*
`sudo a2enmod wsgi`
+ Open the file **index.wsgi** in your favourite editor.
Set the variable `path_to_venv` as the absolute path to your virtualenv
Set the variable `path_to_project_root` as the absolute path to your project root directory.
**Note the trailing slashes in both the path names.**
+ Copy the file *apache.conf* to the sites-available directory.
`sudo cp apache.conf /etc/apache2/sites-available/002-sbhs.conf`
+ Change the variables **python-path** and **python-home** to point to your **sbhs_server** directory and your **venv** respectively.
+ Change the path to your **index.wsgi** accordingly.
+ Once you're done with all this, enable this site and disable the existing default site.
```bash
sudo a2dissite 000-default.conf
sudo service apache2 reload
sudo a2ensite 002-sbhs.conf
sudo service apache2 reload
sudo service apache2 restart
```
+ Chown the entire project to set *www-data* as the group.
`sudo chown -R yourusername:www-data sbhs/`
+ Apache needs write permissions to the **log** and **experiments** directory.
```bash
mkdir -p log experiments
touch log/django-error.log
sudo chmod -R 775 log experiments
```
+ Reload Apache. Your site should be live now at **localhost/sbhs**
### Instructions for creating a superuser
+ Open **sbhs_server/tables/models.py**. Go to **create_superuser()** function in class **UserManager**.
Set the value of the **email** parameter with your desired email address.
+ Now create the superuser with the following command
```bash
python manage.py createsuperuser
```
Then enter the username and the password.
### Instructions for creating a user when hosting in localhost
When running the server in **localhost**, no email verification link will be sent to the user. The user has to be
manually verified by setting the corresponding **is_active** column of the table **tables_account** to 1 in the database.
+ Open the registration page, fill up the form and click on ***Create Account***
+ Login as root user in mysql
```bash
mysql -u -p
```
+ Select the database **sbhs** and set the **is_active** entry of the corresponding user in **tables_account** to 1.
```sql
use sbhs;
update tables_account set is_active=1 where id=;
```