Installation

Installing PhiloLogic consists of two steps:

  1. Install the C and Python libraries system-wide
  2. Set up a directory in your web server to serve databases from

You can find more detailed installation instructions for specific OSes here:

Downloading

IMPORTANT: Do not install from the master branch on github: this is the development branch and is in no way garanteed to be stable

You can find a copy of the latest version of PhiloLogic4 here.

Prerequisites

  • Apache Webserver
  • Python 3.8 and up
  • GCC
  • Make
  • gdbm
  • LZ4
  • Brotli (for Apache compression)

Installing

Installing PhiloLogic’s libraries requires administrator privileges. The C library depends on gdbm, which must be installed first, to compile correctly.

Just run the install.sh in the top level directory of the PhiloLogic4 you downloaded to install PhiloLogic and its dependencies:

./install.sh

Global Configuration

The installer creates a file in /etc/philologic/philologic4.cfg which contains several important global variables:

  • database_root defines the filesytem path to the root web directory for your PhiloLogic install such as /var/www/html/philologic. Make sure your user or group has full write permissions to that directory.
  • url_root defines the URL path to the same root directory for your philologic install, such as http://localhost/philologic/
  • web_app_dir defines the location of the PhiloLogic4 www directory. By default, the installer will copy the contents of the PhiloLogic www directory (which contains the web app) to /etc/philologic/web_app/.

Setting up PhiloLogic Web Application

Each new PhiloLogic database you load, containing one or more TEI-XML files, will be served by a its own dedicated copy of PhiloLogic web application. By convention, this database and web app reside together in a directory accessible via an HTTP server configured to run Python CGI scripts.

Make sure you configure the /etc/philologic/philologic4.cfg appropriately.

Configuring your web server is outside of the scope of this document; but the web install does come with a preconfigured .htaccess file that allows you to run the Web App. Therefore, you need to make sure your server is configured to allow htaccess files.