BuildForge Help

Installing the Perl API

To use the Perl API, you must install the software on a host where you plan run your applications.

The host will act as a client to the Management Console host.

  1. Install a Perl interpreter on the client host, such as ActiveState's ActivePerl version 5.8.4 or later. The following Perl prerequisite modules are required (ActivePerl version 5.8.8 includes them):
    • Exporter
    • LWP::UserAgent
    • HTTP::Request
    See the Perl documentation for information on installing Perl modules.
  2. Uncompress the Perl API package (downloaded in a previous step) to a temporary directory.
  3. Install the Perl API as a standard Perl distribution as described in the apidoc.txt file. On Windows you need nmake, which is included in Visual Studio or downloadable from the Microsoft web site (nmake 1.5–it must be installed where it can be found by the PATH environment variable, such as C:\Windows).

    In the temporary directory where the Perl API package was uncompressed, execute these commands:

    perl Makefile.PL
    nmake
    nmake install
    
    On UNIX or Linux systems (or in a Cygwin environment on Windows):
    perl Makefile.PL
    make
    make install
    
    Once installed, the top Perl API module is BuildForge::API. See the PerlDoc for each module for more information.