A number of demonstration screencast videos, and accompanying scripts, can be found by browsing to the demonstration/evaluation scripts page.
- A Linux operating system with Docker installed.
To install and run Annalist in a docker container, use the following commands.
If Annalist docker containers have been used previously on the host system, the following commamnds ensure you have the latest images:
docker pull gklyne/annalist_site
docker pull gklyne/annalist
Then
docker run --name=annalist_site --detach gklyne/annalist_site
docker run --interactive --tty --rm \
--publish=8000:8000 --volumes-from=annalist_site \
gklyne/annalist bash
Then, in the presented shell environment:
annalist-manager version
Check the version displayed: I've found docker sometimes caches older versions and fails up update to the latest available. If necessary, use docker rmi gklyne/annalist to remove old images from the local cache. If all is well, continue as follows:
annalist-manager createsitedata
annalist-manager initialize
annalist-manager defaultadminuser # Enter password when prompted
annalist-manager runserver
To shut down the server:
annalist-manager stopserver
then exit or Control-D to shut down the Docker container.
See Installing and setting up Annalist for details. What follows is just a very brief summary.
- A Unix-like operating system.
- Python 3 - 3.9 or later
(The software can be run on Windows, but the procedure to get it running is somewhat more complicated, and is not fully tested or documented.)
In a working directory, and with Internet connection:
python3 -m venv anenv3
source anenv3/bin/activate
python -m pip install --upgrade pip
python -m pip install --upgrade certifi
python -m pip install --upgrade setuptools
pip install annalist
Or, with Python 3.9:
/usr/local/bin/python3.9 -m venv --upgrade-deps anenv3
source anenv3/bin/activate
pip install annalist
The following commands create an initialize an annalist site in the invoking user's home directory; i.e. ~/annalist_site. See Installing and setting up Annalist for other options.
annalist-manager runtests
annalist-manager createsitedata
annalist-manager initialize
annalist-manager defaultadminuser
Enter and re-enter a password for the admin user when prompted.
annalist-manager runserver
or
annalist-manager rundevserver
Backup the current installation and site data, just in case.
NOTE that reinstalling the software currently wipes any locally defined user credentials: locally defined users must be re-created using the annalist-manager createadminuser command and/or through the werbsite admin link.
Install updated software into existing Python virtual environment:
source annenv/bin/activate
pip install annalist --upgrade
annalist-manager runtests
annalist-manager initialize
annalist-manager updatesitedata
Locally defined admin user credential should be re-created:
annalist-manager createadminuser
Existing user permissions are carried over from the previous installation.
annalist-manager runserver
or
annalist-manager rundevserver
See Installing and setting up Annalist and Guide to using Annalist for details. What follows is just a very brief summary to get started.
Browse to http:/localhost:8000/, log in using the admin account.
Fill in a collection name and short description in the boxes displayed, and click 'New'.
An Annalist collection consists of entity data records, types, lists, views and fields. You can start to create data records using the defaults provided, and add fields to those records as needed. Lusrt and view descriptions can be added to provide different ways to examine and update the data records.
See the demonstration screecast for an introduction to using Annalist. The sequence of operations performed by demonstration is described in documents/demo-script.md.
See the Guide to using Annalist for details.