BuildForge Help

Build Forge Express Edition Installation

Use this procedure to install the Express Edition of the Build Forge Management Console on Windows platforms.

Prerequisite: Locate mc-<version>-Windows.exe on the download site or the product CD. Click the file to save it to a temporary directory. Double-click mc-<version>-Windows.exe to start the installation program.
Note: The Launch Pad starts this installation process when you choose Rational Build Forge Management Console Installation.

Procedure: respond to the dialogs as follows:

  1. Welcome - Click Next.
  2. License - Click I Agree.
  3. Install Location - Accept the default or specify a different path, then click Next.
  4. HTTP Port – Accept the default (80) or enter the desired port number.
  5. Database settings – fill in the requested information, then click Install.
    • Use IBM Rational supplied database: choose this option to install a new copy of the DB2 Express database. The DB Name and DB Type fields are filled in. Fill in the following:
      • DB Host - Use localhost or the host name for the current host.
      • Username - must already be configured as a Windows user on this host.
      • Password - password for the Windows user on this host.
      Note: The installer does not check to see if DB2 Express is already installed. The new database server is installed on the same host as the Management Console.
      Note: If you are upgrading, the installer does not display your previous database settings, it redisplays the installer defaults. If you changed the defaults, you must respecify your settings.
    • Connect to existing database: choose this option if you have an existing database that you want the Build Forge system to use as its database. Fill in the following:
      • DB Name
      • DB Type
      • DB Host
      • Username
      • Password
  6. If you elected to install DB2 Express above:
    1. Install DB2 Express. The installer starts automatically and displays a progress bar.
    2. Reboot Now When you are asked when to reboot, reboot now. DB2 Express requires a reboot before you can access it through Build Forge.
  7. Access the Management Console. Start a browser. Go to the URL for the Management Console:
    • General form: http://<hostname>[:<portnumber>]. The port number is optional if you used the HTTP default, port 80.
    • Local: if you are running the browser on the same host where the Management Console is running, you can use http://localhost.
    Note: If you have installed a database other than DB2 Express and you cannot login, wait a minute or so and try again. On first startup the engine (bfengine) has to load the database schema.
    Important: Do not stop bfengine immediately after an install. Doing so can corrupt the database schema. In that case you would need to drop all Build Forge tables and reinstall.
  8. Log in. Use user name root, password root. Change the root password immediately.