Peter Heslin's Homepage > Software > Diogenes

Installation for Linux

System Requirements

You must have Perl installed, but probably all Linux distributions will have this installed already by default. For 64-bit and non-x86 platforms, see the notes under "troubleshooting" below.

Installation Procedure

Download Diogenes to a convenient location and unpack the .tar.bz2 file either with your graphical file manager or at the command line (tar xf filename). The resulting directory, "diogenes-3.x" has a file in it called "linux-installer.pl". Run it at the command line or by double-clicking it and opting to run it in a terminal.

Now Diogenes is installed, and you may delete the file you downloaded and the directory that resulted from unpacking it. Type "diogenes" at the command-line to try Diogenes. The first time you try to access each of the databases (tlg, phi, etc.), you will be prompted to give its location.

With luck, there will be an entry for Diogenes in your main applications menu (it works for Ubuntu, at any rate). If not, you can create your own launcher for "diogenes" (or "/usr/local/bin/diogenes"). Alternatively, at the command-line, type "diogenes" for the graphical interface, and "dio" for the command-line interface.

Troubleshooting

Your installation of Diogenes includes a 32-bit x86 binary application. This binary will run on an amd64 platform if the usual 32-bit compatibility libraries are installed (see the note below). It will not run on non-x86 platforms, however, but there are several easy workarounds available.

Here is some advice from a user, Peter Totleben:

It seems that there are two problems. First, 64-bit installations of Ubuntu-based distributions do not come with the 32-bit gtk2 libraries installed. Second, it seems that Ubuntu-based distributions are not configured to run XULRunner out-of-the box. Fortunately, there is a simple solution for both of these issues.

  1. Install the 32 bit libraries. Unfortunately, Ubuntu and friends distribute all the 32-bit libraries in one big package called ia32-libs. To install this package, all one needs to do is type "sudo apt-get install ia32-libs" in a terminal.

  2. In order to configure XULRunner, after installing Diogenes, one needs to type "cd /usr/local/diogenes/xulrunner" and then "sudo ./xulrunner --register-global"

That should be it. After taking these steps, Diogenes should work fine in recent versions of Ubuntu, Mint, etc. on 64-bit systems.

Non-x86 Architectures

Neel Smith has posted a nice account of installing Diogenes on Linux-PPC; the information should apply to any Unix-like system:

The Last Resort

If all else fails, you can just run the server by hand and connect to it with an ordinary web browser, such as Firefox. Run

/usr/local/diogenes/perl/diogenes-server.pl
        

and look at the message it prints out, something like:

Startup complete. You may now point your browser at
this address:
http://127.0.0.1:8888
        

Copy and paste that URL into your browser and bookmark it. Whenever you want to use Diogenes, you need to start the server before navigating to the link. You could set up your system to start the server automatically on boot-up.