GraphSpace is running at http://graphspace.org
GraphSpace has three dummy users:
- Username: user1@example.com Password: user1
- Username: user2@example.com Password: user2
- Username: user3@example.com Password: user3
In order to run GraphSpace, please install sqlite3 and both the Python runtime and development environments. We have tested GraphSpace with Python v2.7.10 and sqlite3 v3.8.10. GraphSpace does not support Python v3. GraphSpace performs best on either Mozilla Firefox or Google Chrome browsers. The following steps describe how to install Python packages required by GraphSpace, download the GraphSpace code, and set up and start the server. The following instructions should apply to computers running a version of the Linux or OS X operating systems.
- Download the GraphSpace code by running
git clone https://github.com/Murali-group/GraphSpace.git
or by downloading the latest release: https://github.com/Murali-group/GraphSpace/releases. - Visit the GraphSpace directory:
cd GraphSpace
- Modify the
gs-setup.sh
file by populating theEMAIL_HOST_USER
andEMAIL_HOST_PASSWORD
fields. GraphSpace usesEMAIL_HOST_USER
as the email address through which GraphSpace sends emails to its users. - Propogate changes to these variables in
gs-setup.sh
file to the environment:. gs-setup.sh
. Please run. gs-setup.sh
and not./gs-setup.sh
as this will not propogate the changes to the environment properly. This step may require sudo privileges - Finally, start the GraphSpace server:
python manage.py runserver
- Visit
http://localhost:8080
and enjoy using GraphSpace!
This section describes the steps required to launch GraphSpace on a server that has apache2
running on it. First, please follow the steps in Running GraphSpace locally. Next, execute the instructions below.
- Visit the graphspace directory:
cd GraphSpace/graphspace
- In a text editor, open the file
gs-setup.sh
- Set
DEBUG=False
andTEMPLATE_DEBUG=False
- Propogate those changes to the environment:
. gs-setup.sh
- Visit the
apache2
directory:cd /path_to/apache2
. An example of the full path to this directory is/etc/apache2
. - Navigate to the
sites-enabled
directory:cd sites-enabled
- Create a file called
graphspace.conf
- Inside this file, copy and paste following lines, after replacing
path_to_GraphSpace
with the name of the directory where you downloaded GraphSpace:
WSGIScriptAlias / /path_to_GraphSpace/graphspace/wsgi.py
WSGIPythonPath /path_to_GraphSpace
<Directory /path_to_GraphSpace/graphspace>
<Files wsgi.py>
Order deny,allow
Require all granted
</Files>
</Directory>
Alias /static/ /path_to_GraphSpace/graphspace/graphs/static/
<Directory /path_to_GraphSpace/graphspace/graphs/static>
Require all granted
</Directory>
<Directory /path_to_GraphSpace>
Options Indexes FollowSymLinks
AllowOverride None
Require all granted
</Directory>
- Give permissions to the Apache server to access the GraphSpace database:
chmod 777 graphspace.db
- Navigate to the
GraphSpace/graphspace
directory and open up the filesettings.py
in a text editor - Replace URL_PATH with the IP address or domain name of the computer where the apache2 server is running, e.g., "http://graphspace.org/"
- Restart the apache server. On a computer running Ubuntu, the command is
sudo service apache2 restart
Refer to https://docs.djangoproject.com/en/1.8/howto/deployment/wsgi/modwsgi/ if any problems occur with the setup.
- Follow the instructions above to run GraphSpace locally or on Apache2.
- Navigate to the tests directory in GraphSpace:
cd tests
- Enter python command to run test cases:
python restapi_test.py
This script will test all the REST API commands supported by the GraphSpace server. If something fails, it will display the error.