GraphSpace is running at http://graphspace.org
GraphSpace has three dummy users:
- Username: [email protected] Password: user1
- Username: [email protected] Password: user2
- Username: [email protected] Password: user3
- Python v2.7.10
- postgreSQL
- virtualenv
- bower
- ElasticSearch
In order to run GraphSpace, please install postgreSQL and both the Python runtime and development environments. We have tested GraphSpace with Python v2.7.10 and postgreSQL v9.6.2. 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
- Create a virtual environment for the project:
virtualenv venv
- Start using the virtual environment:
source venv/bin/activate
- In
/graphspace/settings/local.py
file, change the postgres user credentials:DATABASES = { 'default': { 'ENGINE': 'django.db.backends.postgresql_psycopg2', 'NAME': <database name>, 'USER': <user name>, 'PASSWORD': <password (if any)>, 'HOST': 'localhost', 'PORT': '5432' } }
- Install graphspace:
sh install.sh
- Finally, start the GraphSpace server:
python manage.py runserver --settings=graphspace.settings.local
- 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.
- Follow instructions 1-5 in
Running GraphSpace locally
- Add settings file
production.py
by copying local settings file.cp graphspace/settings/local.py graphspace/settings/
- Update your
production.py
settings file. - InSet
URL_PATH
to the URL where your server will be running. Note: Please add the ending '/' character at the end of this value: For example: http://graphspace.org/ - Modify the
PATH
to point to where GraphSpace directory exists. Note: Please add the ending '/' character at the end of this value: For example: /home/ubuntu/GraphSpace/ - 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
and access this file using admin privileges: `sudo vim 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:
WSGIDaemonProcess GraphSpace python-path=/path_to_GraphSpace:/path_to_GraphSpace/venv/lib/python2.7/site-packages/ python-eggs=/path_to_python_eggs
WSGIProcessGroup GraphSpace
WSGIScriptAlias / /path_to_GraphSpace/graphspace/wsgi.py
<Directory /path_to_GraphSpace/graphspace/>
<Files wsgi.py>
Order deny,allow
Require all granted
</Files>
</Directory>
Alias /static/ /path_to_GraphSpace/static/
<Directory /path_to_GraphSpace/static/>
Require all granted
</Directory>
<Directory /path_to_GraphSpace>
Options Indexes FollowSymLinks
AllowOverride None
Require all granted
</Directory>
- Install module to recognize Django application through apache2:
sudo apt-get install libapache2-mod-wsgi
- Give permission to access static files through apache2. Navigate outside GraphSpace and type:
chmod 777 GraphSpace
- Create a directory for python-eggs.
mkdir /path_to_python_eggs
- Give permission to access static files through apache2.
chmod 777 /path_to_python_eggs
- 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.
Feel free to fork and send us pull requests. Here are the guidelines for contribution in GraphSpace.