BuildForge Help

Setting Up the Perl Client

To use the API, you must install the client API software on a host where you plan to 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 Client package (which you downloaded previously) to a temporary directory.
  3. Install the Perl Client 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 Client 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 client module is BuildForge::Services::DBO. See the PerlDoc for each module for more information.