https://github.com/dativebase/senex
Web-based administrative tool for OLDs
https://github.com/dativebase/senex
Last synced: 10 months ago
JSON representation
Web-based administrative tool for OLDs
- Host: GitHub
- URL: https://github.com/dativebase/senex
- Owner: dativebase
- Created: 2016-04-27T19:11:45.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2019-01-14T02:45:54.000Z (over 7 years ago)
- Last Synced: 2024-08-09T05:11:07.121Z (almost 2 years ago)
- Language: Python
- Size: 840 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGES.txt
Awesome Lists containing this project
README
Senex
================================================================================
.. image:: https://raw.githubusercontent.com/jrwdunham/senex/master/senex/static/senex-logo-2.png
Senex is a `Pyramid`_ web application for high-level administration of
`Online Linguistic Database (OLD)`_ applications.
With Senex installed, you can install the OLD and its dependencies as well as
do the following:
- create new OLD instances (e.g., for particular lanaguages)
- start and stop existing OLD instances
Requirements
--------------------------------------------------------------------------------
Right now Senex will only work with Ubuntu servers. Ubuntu 14.04 is the primary
target, though Senex may also work with Ubuntu 10.04.
The following must be installed in order for Senex to work. It can install the
rest of its requirements and the rest of the OLD's requirements on its own.
- Python 2.7
- MySQL server
- Apache 2 or Nginx
- git
The MySQL user specified via Senex's interface must exist and must have been
granted full privileges::
mysql> CREATE USER 'newuser'@'localhost' IDENTIFIED BY 'password';
mysql> GRANT ALL PRIVILEGES ON *.* TO 'newuser'@'localhost';
mysql> FLUSH PRIVILEGES;
Installing Senex
--------------------------------------------------------------------------------
First, if you don't have Python 2.7 as your system Python (which is the case
with Ubuntu 10.04), then install it using the instructions in `Install Python
2.7 on Ubuntu 10.04` below.
If Python 2.7 is your system python and you don't have Python setuptools
installed in it, then install it::
$ sudo apt-get install python-setuptools
If you don't have Python's virtualenv installed in your system Python, then
install it using easy_install from setuptools::
$ sudo easy_install virtualenv
Create a virtual environment::
$ cd ~
$ virtualenv env-senex
Download Senex's source from GitHub and install its dependencies::
$ git clone https://github.com/jrwdunham/senex.git
$ cd senex
$ ~/env-senex/bin/python setup.py develop
Install the OLD and its dependencies::
$ sudo ~/env-senex/bin/python senex/installold.py
Create Senex's database tables and serve it::
$ cd
$ env-senex/bin/initialize_senex_db senex/development.ini
$ env-senex/bin/pserve senex/development.ini
Install Python 2.7 on Ubuntu 10.04
--------------------------------------------------------------------------------
Install it::
$ sudo apt-get install python-software-properites
$ sudo add-apt-repository ppa:fkrull/deadsnakes
$ sudo apt-get update
$ sudo apt-get install python2.7 python2.7-dev
Install setuptools for Python2.7::
$ wget --no-check-certificate https://bootstrap.pypa.io/ez_setup.py -O - | sudo python2.7
If you don't have Python's virtualenv installed in your system Python, then
install it using easy_install from setuptools::
$ sudo easy_install-2.7 virtualenv
Creating a Development Setup for Senex
--------------------------------------------------------------------------------
If you don't have Python setuptools installed in your system Python, install it::
$ sudo apt-get install python-setuptools
If you don't have Python's virtualenv installed in your system Python, then
install it using easy_install from setuptools::
$ sudo easy_install virtualenv
Create and activate a virtual environment::
$ virtualenv env
$ source env/bin/activate
Download the Senex repo and install its dependencies::
$ git clone https://github.com/jrwdunham/senex.git
$ cd senex
$ python setup.py develop
Create Senex's database tables and serve it::
$ initialize_senex_db development.ini
$ pserve development.ini
.. _`Online Linguistic Database (OLD)`: http://www.onlinelinguisticdatabase.org
.. _`Pyramid`: http://www.pylonsproject.org/