BuildForge Help

Database Requirements

You can install a DB2® Express database at the same time you install the Management Console. It is installed on the same host as the Management Console. If you prefer, you can use a different database that you already have. The following databases and versions are supported:

Database Client Drivers

You must have database client drivers installed before installing Management Console. The installation procedures include instructions on how to install and configure them. The following table shows the technology used as a database driver (on the Management Console host) to access the database (typically installed on a different host).

Table 1. Database Client Drivers

OS / DB

DB2 Express

Microsoft SQL Server

MySQL

Oracle

Sybase

Windows

DB2 Connect Client

ODBC

Native

Oracle Client (can use Instant Client)

ODBC

Database Connection Port

Build Forge assumes that you are using the default connection port for your database. If you are not using the default port, add the db_tcp_port keyword to the buildforge.conf file and set its value to the database connection port you are using.

PHP and Perl Database Drivers

These drivers are installed automatically during a Management Console installation on Windows. You install them manually on UNIX or Linux. See the installation procedures for more information.

Table 2. PHP and Perl Database Drivers
  Windows
Database PHP Driver Perl Driver
DB2 Express included included (note 1)
Microsoft SQL Server included included
MySQL mysql and mysqli included
Oracle oci8 (note 2) included
Sybase included included

JDBC Drivers

JDBC drivers are required for use with Tomcat, which drives the reporting system for Build Forge and for the Quick Report tool. Tomcat is also needed to support the services-layer Java and Perl APIs.

JDBC drivers for DB2 Express on Windows are installed automatically. For all other supported databases on Windows, UNIX, or Linux, you must download and install the drivers. Instructions are provided for each database on each platform.

Perl Modules

These modules are installed automatically during an Express Edition Management Console installation on Windows. Use the Perl CPAN utility to review the list ofr modules and install modules. Use the CPAN web site to get more information, http://www.cpan.org/.
  • To check for a module: perl -M<Module>::<Name> -e l
  • To open a CPAN shell: perl -MCPAN -e shell
  • To install a module from a CPAN shell: cpan> install <Module>::<Name>
Table 3. Perl Modules Required for Management Console
Perl Modules

Config::IniFiles

Data::Dumper

DBI 1.49+

File::Basename

File::Path

File::Temp

Getopt::Std

HTML::Template 2.8+

HTTP::Request

IO::File

IO::Select

IO::Socket

IPC::Open2

LWP::UserAgent

LWP::Simple

MIME::Lite

POSIX

Set::Crontab

Sys::Hostname

Text::Balanced

Time::Piece

Time::Local

URI

URI::Escape

XML::Writer

XML::Writer::String

XML::XPath 1.13+