Ubuntu install

Various steps to follow :

    • Install the dependencies :

sudo apt-get install g++ gawk perl libgdbm-dev mysql-server apache2 make libunicode-string-perl

    • create a group called philologic :

sudo addgroup philologic

    • Make yourself a member (and whoever else) of that group in order to have the permissions to build philologic databases:

sudo usermod -a -G philologic your_username

    • Log out so that permissions apply.
    • Download latest version of philologic, unpack it.
    • Now it's time to compile : enter the philologic folder and execute :

./configure --with-authuser-group=philologic --with-cgi-path=/usr/lib/cgi-bin/philologic

sudo make install

    • Start the nserver :

sudo /etc/init.d/nserver start

    • Start apache (unless it's already started):

sudo /etc/init.d/apache2 start

    • Enter the folder where the files you want to load are :

philoload NAME_OF_DATABASE *.the_extension_of_your_files

e.g. : philoload mydatabase *.tei

    • If you want to load your metadata (such as title, author) in a mysql database, you should do the following create a mysql user other than root, and create a database and grant full access to your mysql user. You should also note that the default mysql.sock on Ubuntu is not where philologic thinks it is. You need to specify the proper path of the mysql.sock, which is mysqld.sock on Ubuntu. To do so, you need to edit /etc/philologic/philologic.cfg and specifiy the right path.

$SQLSOCKET = "/var/run/mysqld/mysqld.sock";

You'll also want to add your MySQL password in that file.

    • To load your database with mysql support, do :

philoload NAME_OF_DATABASE --loadsql --sqluser=name_of_user --sqlpass=password *.the_extension_of_your_files

    • Open your web browser and go to localhost/philologic/mydatabse.whizbang.form.html and you're good to go !

Troubleshooting Ubuntu 11.04

If makefrequencies generates web forms (databasename.frequencylist.html and databasename.timeseries.html) with the wrong variable names (XXXDBNAME, for example) make sure that /etc/philologic/philologic.cfg contains:

$GAWK = "/usr/bin/gawk";

(or wherever gawk is on your system)