BuildForge Help

Road Map: Management Console on Windows with a Supported Database

Use this road map to install the Express Edition Management Console on a Windows host and install a supported database (other than DB2 Express) on a separate host.

Table 1. Road Map: Management Console on Windows with a Supported Database on a Separate Host
  Task Topic
  Choose a supported database to use as the database for the Management Console Database Requirements
  Verify that a network connection exists for database host and the Management Console host Pre-Installation Setup
  Set up the database for the Management Console.

Create a database, database user, grant owner access to the database user.

  • Configure the database client driver (DLL) on the Management Console.
  • If you intend to use international data, the database must be configured to use a character set that complies with UTF-8.

Pre-Installation Setup

DB2 Setup

Microsoft SQL Server Setup

MySQL Setup

Oracle Setup

Sybase Setup

  Locate mc-<version>-Windows.exe on the download site or the product CD. Click the file and save it to a temporary directory. Build Forge Installation
  Double-click mc-<version>-Windows.exe and start the installation program. Build Forge Installation
  Follow the instructions in the installation program to install the Management Console.

At Database Settings, select Connect to existing database.

Build Forge Installation
  Download and unzip the JDBC driver for your database. Copy the jar file only to $CATALINA_HOME/common/lib. Add $CATALINA_HOME to your system PATH. Post-Installation Setup
  Verify that the client driver (DLL) for your database is listed in your system PATH. Post-Installation Setup
  (Proxy server only) To enable Management Console access, add the proxy server name and path to the <bf-install>/Apache/php.ini file. Post-Installation Setup
  (Oracle only) Set ora_ph_type=96 so the driver does not strip trailing blanks. Post-Installation Setup
  (DB2 only) Set DB2CODEPAGE=1208 to correctly display international characters. Post-Installation Setup
  Launch the Management Console:
  • Enter http://<hostname>[:<port_number>] (from any Web browser)
  • Enter http://localhost (from the local Web browser)
Build Forge Installation
  Wait for the database schema to load.

It might take a minute or so for the Management Console to load the database schema the first time.

Do not stop the Management Console engine before the load completes; doing so may require removing and reinstalling the database.

Build Forge Installation
  Log on using root/root. Change the root password immediately to restrict console access. Build Forge Installation