BuildForge Help

Build Forge Installation (Windows)

Use this procedure to install 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.

Procedure: respond to the dialogs as follows:

  1. Welcome Click Next.
  2. License Click I Agree.
  3. License host and type of console – fill in the requested information, then click Next.
    • License Host: enter the host name where the Rational License Server runs.

      You must enter a valid host name for the license server. If you plan to provide this information later, do not leave this field blank. Enter a character or value in this field. Leaving this field blank may result in an incomplete and unusable product.

    • The default HTTP port for the Management Console is port 80. If port 80 is not available or you require a different port, enter the port number in Http server port.
      Important: Do not use port 8080; it is the default port for Apache Tomcat.
    • Primary/Secondary Settings: choose Normal.
  4. Database settings – fill in the requested information, then click Install.
    • Location Name: This name is displayed in the user interface when you log in. It is optional for Normal or Primary consoles, but required for Secondary consoles.
    • 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. The default database name build is the required database name; do not change it.

    • Fill in the following:
      • DB Host - Use localhost or the host name for the current host.
      • Username - the default is build; you may change the user name
      • Password - supply a password for the user name
      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 displays the installer defaults. If you changed the defaults, you must re-specify 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
  5. 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.
  6. 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.
  7. Log in. Use user name root, password root. Change the root password immediately.