BuildForge Help

Database Requirements

The system installs a DB2® Express database by default (on the machine where you install the Management Console). The following databases and versions are supported:

Database Client Drivers

You must have database client drivers already installed on the host where you install 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

UNIX or Linux

DB2 Connect Client

n/a

Native

Oracle Client (can use Instant Client)

n/a

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
  UNIX/Linux Windows
Database PHP Driver Perl Driver PHP Driver Perl Driver
DB2 Express ibm_db2 DBD::DB2 (note 1) included included (note 1)
Microsoft SQL Server not supported not supported included included
MySQL mysqli (note 3) DBD::mysql (note 3) mysql and mysqli included
Oracle oci8 (note 2) DBD::Oracle oci8 (note 2) included
Sybase not supported not supported included included

JDBC Drivers

JDBC drivers are required for use with Tomcat, which drives the reporting system. 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 a Management Console installation on Windows. You install them manually on UNIX or Linux. Version number requirements are highlighted where relevant. Use the Perl CPAN utility to check for 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

Data:UUID (UNIX only)

DBI 1.49+

File::Basename

File::Path

File::Temp

Getopt::Std

HTML::Template 2.8+

HTTP::Request

IO::File

IO::Select

IO::Socket

IO::Socket::INET6 (for IPV6)

IPC::Open2

LWP::UserAgent

LWP::Simple

MIME::Lite

POSIX

Set::Crontab

Socket6 (for IPV6)

Sys::Hostname

Text::Balanced

Time::Piece

Time::Local

URI

URI::Escape

XML::Writer

XML::Writer::String

XML::XPath 1.13+