Thursday, November 28, 2024

Installing Ellogon on Mac OS X

This article contains information about how a binary installation of Ellogon can be installed and used under the Mac OS X (Leopard/Snow Leopard) operating system.

Step 1: Download ActiveTcl

In order to run Ellogon, Tcl/Tk version 8.6 (or newer) is required. In addition, Ellogon requires some common Tcl/Tk packages (such as tcllib, TkTable, tablelist, tDom, etc.), and thus, a "Batteries Included" distribution is recommended. The Ellogon Development Team recommends the distributions from ActiveState, known as ActiveTcl.

ActiveTcl distributions can be downloaded from the following locations:

Step 2: Install ActiveTcl

Once the ActiveTcl DMG image file has been downloaded, it will be mounted automatically by the operating system, and the following window will be displayed:

Please double click on the package icon and follow the instructions to install ActiveTcl.

Step 3: Update the package repository of ActiveTcl

Once ActiveTcl has been successfully installed, an update of its packages repository is recommended. In order to perform this update, open a Terminal (from Applications/Utilities/Terminal) and execute the following commands:

  • sudo teacup timeout -1
  • sudo teacup update-self
  • sudo teacup update
  • sudo teacup install grammar::fa

The commands displayed above may require some time to finish. Please be patient and don't interrupt their execution. It is a good idea to perform the last two commands once per month, in order to update the packages repositories up to date.

Step 4: Download Ellogon

Ellogon binary distributions can be downloaded from the following locations:

Step 5: Install Ellogon

Currently, Ellogon binary distributions for Mac OS X are distributed in the form of tar.gz archives, and not as DMZ image files. Thus, Ellogon cannot be installed automatically as ActiveTcl does, and requires some manual actions in order to install it. Once an Ellogon binary distribution has been downloaded, it is highly probably that it will be extracted, leaving a .tar file in the "Downloads" directory:

Double-clicking on the tar archive, will extract the archive, creating a folder containing the Ellogon files, which will be shown in the Finder window:

The created folder containing the Ellogon files must be moved into a different location. A suitable location is in the home directory of the user.

The Ellogon Development Team is working on a DMZ installer for Ellogon.

Step 6: Run Ellogon

Running Ellogon should be done through a Terminal. The user should start a Terminal (from Applications/Utilities/Terminal) and execute the following command:

  • wish8.6 <full path to Ellogon folder>/ellogon

where <full path to Ellogon folder> must be substituted with the full path of the Ellogon folder. Assuming that the Ellogon folder was moved to the home directory of the user, the command that must be executed in the Terminal is:

  • wish8.6 ~/Ellogon-191/ellogon

If everything has been performed ok, Ellogon will be initiated, as shown in the following image (OSX 10.6 - Snow Leopard).

Ellogon also works on OS X 10.5 (Leopard):