Quickstart Guide for Perl

For Perl developers, this QuickStart provides the basics for configuring your development platform to begin building iControl applications.

After configuring your development environment, be sure to download the iControl SDK for samples to begin working with the iControl API.

Still have questions or need guidance? Be sure to visit the DevCentral Forums for help.


The following instructions outline the procedures to set up an Perl development environment in the Microsoft® Windows® operating system (with the ActiveState\u2122 ActivePerl® distribution), or the Red Hat® Linux® operating system. If you have a different operating system, or prefer to use different tools, use these instructions as a general guideline.

Configuring ActivePerl for Windows

    • Download the MSI installer of ActiveState Perl 5.8.0 build 806 (ActivePerl- from ActiveState:
    • To install ActivePerl, double click the ActivePerl- file that you downloaded. The ActivePerl setup wizard guides you through the installation process.
    • To configure ActivePerl from the command prompt, from the Start Menu, choose Programs>Accessories>Command Prompt.
    • To open the ActivePerl Programmer's Package Manager (PPM), version 3.1 shell, at the command line, type ppm3 and press Enter.
      This PPM shell opens.
    • To add a new repository, at the PPM shell prompt, type: rep add winnipeg http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer58 and press Enter.
    • At the ppm shell, type: install Crypt-SSLeay, and press Enter.
    • Ensure that both ssleay32.dll and libeay32.dll are installed in your Perlin directory.
    • To exit the ActivePerl ppm shell, type q and press Enter.


Configuring Perl for Red Hat Linux

    • Log in to your system as the root user.
    • Download the Crypt-SSLeay RPM for Perl.
      You can download perl-Crypt-SSLeay 0.45-2 from http://www.redhat.com/swr/i386/perl-Crypt-SSLeay-0.45-2.i386.html.
    • To install the RPM, at the command prompt, type rpm -Uvh perl-Crypt-SSLeay-0.45-2.i386.rpm, and press Enter.
      RPM installs the Perl Crypt-SSLeay package.
    • To open the Comprehensive Perl Archive Network shell (CPAN-shell), at the command line, type perl -MCPAN -e shell, and press Enter.
      The CPAN-shell prompt appears.
    • To install the SOAP:Lite modules, at the CPAN-shell prompt, type install SOAP::Lite and press Enter.
      The CPAN-shell guides you through the installation and configuration of SOAP::Lite.
    • To exit the CPAN-shell after you successfuly install SOAP::Lite, type quit and press Enter.