Install vGhetto on OS X

First steps

In order to install the vGhetto client and to be able to run all of its accompanied scripts, you'll have to install the VI Perl Toolkit. So follow the installation tips for that here Install the VI Perl Toolkit on OS X

Also note that there is now a script in the subversion repository in the installers folder, called vghetto-osx.sh, that automates the steps below.

Graphical environment

The vGhetto client uses a graphical user interface and because of that, it has a dependency on the X11 server. Starting with OS X Leopard, this is included in the default install of OS X. So unless you are experiencing some real problems getting things to work I would not update X11 server. It is added to the steps below because you might have to redo it depending on your current setup.

Install module Tk

vGhetto uses the perl module Tk for the graphical environment, so this is one of the main dependencies. You can install it by running:

cpan Tk

During the install you'll see many displays popup to test the functionality from tk, that's normal. If you are extremely lucky it ends with OK..., but if you are like me you'll get:

Failed Test     Stat Wstat Total Fail  Failed  List of Failed
-------------------------------------------------------------------------------
t/canvas.t         1   256   158    1   0.63%  84
t/coloreditor.t  255 65280     8   11 137.50%  3-8
t/wm-tcl.t         1   256   315    1   0.32%  240
 (37 subtests UNEXPECTEDLY SUCCEEDED), 2 tests and 161 subtests skipped.
Failed 3/62 test scripts, 95.16% okay. 8/3686 subtests failed, 99.78% okay.
make: *** [test_dynamic] Error 255
  /usr/bin/make test -- NOT OK
Running make install
  make test had returned bad status, won't install without force

If that's your result too, then skip the next few steps as it is expected that a few test scripts will fail

Turns out I still had an X11 Server installed from tiger.

XQuartz 2.1.6 (xorg-server 1.4.2-apple33

So from the DVD, go to option installs and select Optional Installs.mpkg : In the applications part select X11.

Remove X11

Messed it up, got confused, want to start over?

Before you start deleting anything, make sure you have a Leopard's installation DVD available and downloaded the latest X11 package from the Xquartz Project.

• Delete pretty much all X11 from you system, and let it forget its receipts:

Code:

sudo rm -rf /usr/X11 /usr/X11R6
sudo pkgutil --forget com.apple.pkg.X11DocumentationLeo
sudo pkgutil --forget com.apple.pkg.X11User
sudo pkgutil --forget com.apple.pkg.X11SDKLeo
sudo pkgutil --forget org.x.X11.pkg

• Install X11User.pkg from Leopard's installation DVD, which is in /Volumes/Mac OS X Install DVD/Optional Install/Optional Installs.mpkg

• Install X11SDK.pkg from Leopard's installation DVD, which is in /Volumes/Mac OS X Install DVD/Optional Installs/Xcode Tools/Packages/

• Install the latest X11 package release from the Xquartz Project.

Install Tk second try

After installing X11 2.4.0 from the xquartz project, trying to install Tk gives even more errors:

 (32 subtests UNEXPECTEDLY SUCCEEDED), 2 tests and 173 subtests skipped.
Failed 22/62 test scripts, 64.52% okay. 1258/3686 subtests failed, 65.87% okay.
make: *** [test_dynamic] Error 255
  /usr/bin/make test -- NOT OK
Running make install
  make test had returned bad status, won't install without force

Install Tk third try

So much fun, after following the complete removal steps from X11 and only installing the default Leopard parts (not the quartz update) and rerunning the cpan Tk setup. Now I'm getting:

 (37 subtests UNEXPECTEDLY SUCCEEDED), 2 tests and 161 subtests skipped.
Failed 4/62 test scripts, 93.55% okay. 9/3686 subtests failed, 99.76% okay.
make: *** [test_dynamic] Error 255
  /usr/bin/make test -- NOT OK
Running make install
  make test had returned bad status, won't install without force

Well maybe having 4 failed tests is not so bad?

Force feeding tk-perl

If you scroll up on the part where we're trying to install Tk via cpan, then you'll see right at the top something along these lines:

/Users/topaz/.cpan/sources/authors/id/S/SR/SREZIC/Tk-804.028.tar.gz

So our Tk version is Tk-804.028 Move to our build folder:

cd /Users/topaz/.cpan/build/Tk-804.028

Now install by running:

sudo make install

If there's no complaint after that, you should be OK

time-modules

cpan Time::ParseDate

This should install the time-modules library and if it works OK, you should see this step end with:

Appending installation info to /Library/Perl/Updates/5.8.8/darwin-thread-multi-2level/perllocal.pod
  /usr/bin/make install  -- OK

Done

That's it. With all of these requirements in place, you should now be able to run the vGhetto client directly from OS X by running:

./vGhetto.pl

(You might have to make vGhetto.pl executable first by executing "chmod +x vGhetto.pl" )