Varia library working group XPPL. https://gitea.xpub.nl/XPUB/XPPL
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
anglk 59be37d9a4 Update 'xppl/getannot.py' 8 months ago
ansible Ansible fixups. Just make it sure it works for real. 10 months ago
scripts Arrange custom scripts for running applications. 11 months ago
tests Get dummy test suite in place. 11 months ago
xppl Update 'xppl/getannot.py' 8 months ago
.gitignore Ignore egg files. 10 months ago
CHANGELOG.md Shorten that one. 10 months ago
Makefile Remove docker, just us plain RQLite. 11 months ago
Pipfile Drop python-dotenv and load straight form Pipenv + xppl.config. 11 months ago
Pipfile.lock Drop python-dotenv and load straight form Pipenv + xppl.config. 11 months ago
README.md Fix link to YAML and an Ansible link. 10 months ago
setup.py Add a dummy setuptools file. 10 months ago
tox.ini Get dummy test suite in place. 11 months ago
wsgi.py Setup application factory and dev/prod files. 11 months ago

README.md

Varia’s XPPL

The XPUB library living at Varia.

https://books.vvvvvvaria.org/

Run It Locally

Please note, the following instructions have only been tested on the Debian Stretch OS.

You’ll need to run an RQLite database first:

$ apt update && apt install -y make
$ make install-rqlite
$ make rqlited

Then get Pipenv and run the development server with:

$ pipenv install --dev --three
$ pipenv run devserver

The local development web server will now be available.

If you need to check the database contents, run:

$ make rqlite

And then run .help for which commands are available.

Test It

$ pipenv run tox

Refer to the tox.ini for configuration options.

Deploy It

See ansible/README.md for this.

Maintain It

The XPPL is made up of a few parts:

If you know Ansible (it’s just YAML), you can just read the entire configuration.

On the varia.zone machine, you can check the running services with:

$ sudo supervisorctl status all    # check all services
$ sudo supervisorctl stop xppl:*   # stop all XPPL services
$ sudo supervisorctl start xppl:*  # start all XPPL services

You can also view the error logs with:

$ sudo supervisorctl tail xppl:xppl-flask stderr
$ sudo supervisorctl tail xppl:xppl-rqlite stderr

The /var/xppl/xppl/uploads folder is managed by the Varia Syncthing UI.

The RQLite database is located at /var/xppl/rqlite/node.1. No cluster is configured.

No backups are configured right now.