Stemmaweb - a Catalyst webservice for text tradition analysis
Trying it out
A Dockerfile is included in the repository, which will set up a test version of Stemmaweb on an Ubuntu 14.04 LTS virtual server, listening on port 3000. If you want to install a production version, read on below.
To run Stemmaweb you need a working Perl installation (5.12 or above) and, preferably, a working webserver. The following steps will get you set up to run the standalone service:
Ensure that the following software is installed (the list given is that of the relevant Ubuntu packages):
Install the following Perl modules:
Install the dependencies for Stemmaweb from this directory:
cd /PATH/TO/stemmaweb && cpanm -S --installdeps .
Make a test database (which relies on SQLite being installed) and test the installation at http://localhost:3000/ :
If you only want to test Stemmaweb, then you are done! Otherwise, create a database for the storage of text tradition data. This can be anything supported by Perl's DBI, so long as you have the database software and relevant DBD::* drivers installed.
Replace the database settings in stemmaweb.conf with the settings for your database. If you are using MySQL, for example, the contents of the stanza might look like this:
<model_args> dsn dbi:mysql:dbname=stemmaweb;host=DB_HOSTNAME <extra_args> user STEMMAWEB_USER password STEMMAWEB_PASS <dbi_attrs> mysql_enable_utf8 1 </dbi_attrs> </extra_args> </model_args>
(Optionally) configure Stemmaweb to run under FastCGI, Starman, or any other Catalyst-compatible application framework. See http://www.catalystframework.org for more information. The provided stemmaweb.psgi was written to work with Starman running behind Apache on a specified non-root URL path.