PRINT

Installing the VI Perl Toolkit on Linux Platforms

The installer script for Linux is a Perl script, supported for use on default installations of several popular Linux distributions:

• Fedora Core 7
• SUSE Enterprise Server 10 (SP1)
• Ubuntu Desktop 7.04

Topics in this section include:

• Requirements
• Installing OpenSSL [Preliminary Task]
• Running the Installer

Requirements

The VI Perl Toolkit installer for Linux distributions requires Perl 5.8, plus these libraries:

• Linker utility (binutils package)
• GNU C libraries (glibc or libc6 package)
• OpenSSL library (libssl-dev package)
• XML DOM/SAX libraries (libxml2 package)

With the exception of OpenSSL, all of these packages are included in each of the supported Linux distributions, in the base (default) installation.

• To install OpenSSL on each of the supported Linux distributions, see Installing OpenSSL.
• To install the VI Perl Toolkit on a different Linux distribution (other than those listed), you must obtain and install the prerequisites using the mechanism appropriate for the distribution (apt, rpm, make, and so on). See the documentation for the Linux distribution for details.

  Finding OpenSSL on an Installation CD, DVD, or Mountpoint

  If you have trouble locating the OpenSSL package for a Linux distribution, you can list all files using the wildcard after the openssl-dev prefix, as in:

  >ls openssl-dev*

Installing OpenSSL

The installer script for Linux is a Perl script, supported for use on default installations of several popular Linux distributions. The default installations include the requisite Perl engine and all the required libraries—with the exception of OpenSSL. This section provides information about the preliminary setup tasks required to install the OpenSSL library on each supported platform, specifically:

• Fedora Core 7
• SUSE Enterprise Server 10 (SP1)
• Ubuntu Desktop 7.04

Fedora Core 7

See the Fedora Core documentation for configuration information.

1. Insert the Fedora installation DVD. In a moment, the DVD should be mounted on the desktop.
2. From the terminal console, enter:
   >cd "/media/Fedora 7 i386 DVD/Fedora" > rpm -i e2fsprogs-devel-1.39-11.i386.rpm
   > rpm -i krb5-devel-1.6-6.i386.rpm
   > rpm -i zlib-devel-1.2.3-10.fc7.i386.rpm
   > rpm -i openssl-devel-0.9.8b-12.fc7.i386.rpm
   

SUSE Enterprise 10 (SP1)

The SUSE Enterprise 10 DVD includes the OpenSSL package on the installation DVD.

See the SUSE Linux 10.1 documentation for configuration information.

1. Insert the SUSE installation DVD.
2. From the terminal console, enter:
   >cd /media/SLES10SP_001/suse/i586
   >rpm -i openssl-devel-0.9.8a-18.15.i586.rpm

Ubuntu Desktop 7.04

Ubuntu uses apt (advanced packaging tool) to keep a local repository of libraries up-to-date. The libssl-dev package is not available for install until this local repository is updated via the 'apt-get update' command. Before running apt to update the repository (and subsequently, install the OpenSSL library), the system must be properly configured and connected to the Internet.

See the Ubuntu documentation for configuration information.

From terminal console, enter:

> sudo apt-get update
> sudo apt-get install libssl-dev

Running the Installer

The installer is a Perl script, vmware-install.pl. Open a shell prompt and navigate to the location of the download. Unpack the download.

To install the VI Perl Toolkit using the Perl installer:

1. Download the VI Perl Toolkit Linux installer package, available on the VMware SDK downloads page:
   
   
   http://www.vmware.com/download/sdk/index.html
   
   
2. Launch the installer. You are prompted to accept the terms of the license.
3. Enter yes at the prompt to accept the license terms and continue.
   • If you do not type yes in full and press Enter, the installer will not continue.
   A prompt displays enabling you to provide a path for the install, or accept the default [/usr/bin].
4. Enter a new directory location, or accept the default by pressing enter:
   
   /usr/bin The installer searches for required Perl libraries, noting any differences between the required version level and that of the version installed.
   
   When the installation process completes, you’ll see a sucess message. the prompt returns at the command shell, after listing different version numbers for various required modules (if any).
   
   You can now run sample scripts or Utility Applications, to test out your installation.
   
   If you accepted the defaults during installation, the paths to the Utility Applications and samples sub-directories are as follows:
   
   

   Utility Applications:	/usr/lib/vmware-viperl/apps
   Sample Scripts:	/usr/share/doc/vmware-viperl/samples

Uninstalling the VI Perl Toolkit

You can uninstall the VI Perl Toolkit at any time using the vmware-uninstall-viperl.pl script:

>/usr/bin/vmware-uninstall-viperl.pl

Replace “/usr” with the appropriate path, if you specified a non-default path during installation.

Copyright © 2007 VMware, Inc. All rights reserved.

VI Perl Toolkit 1.0 | Released 30-Aug-2007 | Last updated 8-October-2007 12:30 am