OGRE is an ebook storage and synchronisation service.
OGRE comes in two parts:
- a server built in Python relying on Flask and Celery
- a cross-platform client script in Python which synchronises ebooks to the server.
A Vagrantfile is included to start a development OGRE server.
cd ogreserver/config
vagrant up
SSH into the VM and bootstrap the server with the salt CM configs:
vagrant ssh
sudo salt-call state.apply
Once this is complete, you should have a working OGRE server. You can check things are running with:
sudo supervisorctl status
ogreserver:celerybeat RUNNING pid 17857, uptime 0:04:22
ogreserver:celeryd.high RUNNING pid 17859, uptime 0:04:22
ogreserver:celeryd.low RUNNING pid 17858, uptime 0:04:22
ogreserver:gunicorn RUNNING pid 17860, uptime 0:04:22
s3proxy RUNNING pid 17856, uptime 0:04:22
A preconfigured tmux dev environment is available also:
tmux attach
The client app to sync with the server can be run with the ogre command. Install it locally into
a virtualenv:
cd ogreclient
pip install -e .
And run a sync to your VM:
ogre --ogreserver 172.16.8.128:8005
Calibre is required for ogreserver. New calibre releases are suppied via Github, but unfortunately
old releases are removed when a new one arrives. To that end, a new calibre release is pushed to S3
periodically and ogreserver retrieves it from there.
See the salt state calibre.sls.
Download a latest release and push:
curl -L -O https://github.com/kovidgoyal/calibre/releases/download/v3.2.1/calibre-3.2.1-x86_64.txz
aws s3 cp calibre-3.2.1-x86_64.txz s3://calibre-binary-mirror/ --acl=public-read
Get the sha1sum (required by salt's file.managed):
sha1sum calibre-3.2.1-x86_64.txz