==== First steps ====
In order to install the [http://bit.ly/vGhettoGUI 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]]

==== 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 [http://xquartz.macosforge.org/trac/wiki/Releases 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" )

[[Category: Perl]]

== Installing the VI Perl Toolkit on OS X ==
'' by Wil van Antwerpen ''

Basically there are two ways in which you can get the VI Perl Toolkit working on OS X.

One way is by using the CPAN functionality of Perl which is already installed on your Mac and the other way is by using [http://www.macports.org/ MacPorts].
I will first walk you through how-to this using the CPAN Network and then show you how to get it working using macports.

Obviously, you will only need to use one of these methods in order to use the Toolkit.

FOR THE MOMENT I SUGGEST USING THE CPAN METHOD as MacPorts is still giving me problems.

== Installing Developer Tools ==
The VI Perl Toolkit needs to get a few extra modules added to the current perl setup that is by default installed on Mac OS X. In order to get these modules we use CPAN or macPorts.
Both have some prerequisites of their own and in this case it is the same for both.

Your system must have "make" installed.
The most straightforward way to get that package installed is to take your original OS X installation disk and install Developer Tools (XcodeTools.mpkg) which can be found under Option Installs on the DVD.
Just keep the default settings and you'll be fine.

It is a bit big though (over 2GB) so it is a steep requirement for just getting the VI Perl toolkit to work OK. If you don't have the space, the part that is needed is the BSD "make" command and a number of other commands. It should be sufficient to install the UNIX Development Support (or BSD SDK) sub-package of the Developer Tools.

== Getting the Perl VI Toolkit SDK ==
First step is to download the latest perl SDK from:
http://communities.vmware.com/community/developer/forums/vsphere_sdk_perl

for both OS X Leopard and Snow Leopard I downloaded the same 32 bits .tar.gz linux installer.

After downloading unpack the archive by running
tar -xvzf VMware-vSphere-SDK-for-Perl-4.0.0-161974.i386.tar.gz
from the command line.
cd into the new vmware-vsphere-cli-distrib/ folder
cd vmware-vsphere-cli-distrib/
and run:
perl MakeFile.pl
this will most likely return the following warnings:
Warning: prerequisite Class::MethodMaker 2.08 not found.
Warning: prerequisite Crypt::SSLeay 0.51 not found.
Warning: prerequisite SOAP::Lite 0.67 not found.
Warning: prerequisite UUID 0.03 not found.
Writing Makefile for VIPerlToolkit
The warnings we see here are the modules we need to install in perl that are missing for the toolkit to work.
So we are going to install these modules first, before we can continue with our main installation.

== Installing missing perl dependencies ==
So now we need to setup CPAN or MacPorts unless you already have it working, in that case you can skip the installation part.

=== CPAN: Is /usr/local setup? ===
By default cpan will try to install some documentation under the /usr/local folder, so this folder has to exist and it needs to have the correct ownership privileges setup.
See if the folder already exists:
$ ls /usr/
X11 bin lib sbin standalone
X11R6 include libexec share
In my case it isn't there yet, so create it:
$ mkdir /usr/local
mkdir: /usr/local: Permission denied
Ha!.. you can't create the folder unless you have elevated rights (of course)
$ sudo mkdir /usr/local
Password:
So now we create the folder, but as you will see its owned by root and we can't install our packages in there unless we allow our user.
$ ls -alh /usr/local
total 0
drwxr-xr-x 2 root wheel 68B Feb 27 01:06 .
drwxr-xr-x@ 12 root wheel 408B Feb 27 01:06 ..
In my case the username is "topaz", replace "topaz" with your username below:
$ sudo chown topaz:topaz /usr/local
$ ls -alh /usr/local
total 0
drwxr-xr-x 2 topaz topaz 68B Feb 27 01:06 .
drwxr-xr-x@ 12 topaz topaz 408B Feb 27 01:06 ..

=== CPAN: Configuration ===
With the developer tools setup now you have to configure CPAN. You can also use this step if you want to change your CPAN configuration.
Configuring CPAN makes sure that the tools finds the necessary commands on your system (make et al). To do that, run:

perl -MCPAN -e shell
cpan> o conf init

This throws up a bunch of questions.
/Users/topaz/.cpan/CPAN/MyConfig.pm initialized.


CPAN is the world-wide archive of perl resources. It consists of about 100 sites that all replicate the same contents all around the globe. Many countries have at least one CPAN site already. The resources found on CPAN are easily accessible with the CPAN.pm module. If you want to use CPAN.pm, you have to configure it properly.

If you do not want to enter a dialog now, you can answer 'no' to this question and I'll try to autoconfigure. (Note: you can revisit this dialog anytime later by typing 'o conf init' at the cpan prompt.)

Are you ready for manual configuration? [yes]
You can take the defaults for pretty much all of them, so just press enter.
It is fine if the configuration script doesn't find programs for things like lynx, wget, ncftp, ftp etcetera...

The main things to select are country to download from and the site(s) which you want to use for the repositories. Just make the most logical selections here.

=== CPAN: Installing the VI Perl Toolkit dependencies ===

Now we'll get the missing dependencies by running them one by one. We could add all of these on a single line, but we want it to be easy to see if the install was successful so we are running them one by one.
cpan Class::MethodMaker
this should now end with:
Appending installation info to /Library/Perl/Updates/5.8.8/darwin-thread-multi-2level/perllocal.pod
/usr/bin/make install -- OK

So continue with the next one:

cpan Crypt::SSLeay
Just choose the defaults if questions are asked. As long as it ends like the previous package you are fine.

Next up is:
cpan SOAP::Lite
Same same, choose defaults. In my setup it nagged that I missed out on some dependencies of its own and if I wanted to add those.. Sure.. let the installer add anything it suggests.

Finally:
cpan UUID
Which down here installed fine too, so now we can finally get back to installing the VI Perl Toolkit.

=== Setting up MacPorts ===
Go to the [http://www.macports.org/install.php Macports install page] and download the .dmg file for your environment and run the installer.
=== MacPorts: Installing the VI Perl Toolkit dependencies ===

sudo port install p5-class-methodmaker
On my Snow Leopard machine, this dragged in a complete new version of Perl (5.8.9), very nice.
Then we need Crypt::SSLeay
sudo port install p5-crypt-ssleay
and SOAP::Lite
sudo port install p5-soap-lite
Finally UUID
sudo port install p5-uuid

Now as I said it pulled in its own perl environment... so it turns out that we need to add another module which is missing.
sudo part install p5-xml-libxml

Woww this was quick and we can now get back to installing the VI Perl Toolkit, but first close your terminal as you need to restart that one in order to use the new Perl version installed in /opt/local/bin instead of the default one which is still in /usr/bin

== Install VI Perl Toolkit ==
Now go back to the folder where you unpacked the VI Perl Toolkit:

perl MakeFile.pl
Warning: prerequisite UUID 0.03 not found. We have 0.020.
Writing Makefile for VIPerlToolkit

That UUID is not yet version 0.03 seems to be OK (On Snow Leopard it is 0.04)
With this version of the toolkit, there are no tests defined for the make file so install it directly:

sudo make install
Password:
Manifying blib/man3/VMware::VIM25Runtime.3pm
Manifying blib/man3/VMware::VIM2Stub.3pm
Manifying blib/man3/VMware::VIM25Stub.3pm
Manifying blib/man3/VMware::VIM2Runtime.3pm
Installing /Library/Perl/5.8.8/vmware-install.pl
Installing /Library/Perl/5.8.8/VMware/VICommon.pm
Installing /Library/Perl/5.8.8/VMware/VICredStore.pm
....
many more lines here
....
Installing /usr/share/doc/vmware-viperl/doc/samples/vm/vmregister.pl
Installing /usr/share/doc/vmware-viperl/doc/samples/vm/vmunregister.pl
Installing /usr/share/doc/vmware-viperl/doc/samples/WSMan/checksensorhealth.pl
Installing /usr/share/doc/vmware-viperl/doc/samples/WSMan/firmwarerevisions.pl
Installing /usr/share/doc/vmware-viperl/doc/samples/WSMan/listfrus.pl
Installing /usr/share/doc/vmware-viperl/doc/samples/WSMan/listpowersupplies.pl

and that's how a successful Perl Toolkit install looks like.

If you want you can now delete your unpacked setup files and VI Perl tar.gz file.
You may want to keep the makefile around if you later want to uninstall this.

== Uninstall Developer Tools and cleaning up CPAN ==

If you want to uninstall the Developer Tools, you need to run the command:
/Developer/Library/uninstall-devtools --mode=all

Be aware that you can then no longer use CPAN or Macports to extend your system!

From CPAN you can remove an installed module by running a clean command.
Such as:
cpan clean Class::MethodMaker

This is a troubleshoot step and sometimes needed if a module gets stuck while trying to install it.
Again don't remove any module your install depends on.

If CPAN still gives problems, then you can remove your local CPAN configuration and cache directory by running:
rm -r ~/.cpan

== External link ==

The following link turned out to be very helpful while I was trying to get this to work:

[http://itknowledgeexchange.techtarget.com/virtualization-pro/managing-vi3-from-os-x-1051-leopard/ Managing VMware Infrastructure 3 (VI3) from OS X (10.5.1 Leopard)]

[[Category: Perl]]