BuildForge Help

Upgrading the Management Console on Windows

This procedure describes how to upgrade prior versions of the Management Console on Windows to the latest version.

Before proceeding, check the following list:

Upgrading from Version 7.0 or Later on Windows

These procedures apply for any version 7.0 or later installation, including those with an iFix applied. The iFix must have been correctly installed.
Before you start:
  • Stop the Tomcat server. Execute the shutdown command in the Tomcat bin directory:
    cd <bf-install>\$CATALINA_HOME\bin
    shutdown
  • If you are running Build Forge in the foreground, stop the engine. If Build Forge is running as a service, the installer stops it automatically.
  • Copy the installation image (mc-<version>-Windows.exe) to the Build Forge Management Console host.

To start the upgrade, double-click the installation image file. The installer starts. Respond to the following prompts.

Note: Default installation values are presented; they may not match the values in your buildforge.conf file. Enter the values in your existing buildforge.conf file.
  1. Welcome Click Next
  2. License Agreement Click I Agree
  3. Choose Install Location Enter the path of your current Build Forge installation.
  4. Build Forge Management Console Configuration Enter the following information, then click Next.
    • License Host - Enter the name or IP address of the license server host.
    • Primary/Secondary Settings - Click Normal.
  5. Database Configuration Choose Connect to existing Database, then provide the following information. Click Install when done.
    • DB name - name of the database
    • DB type - type of database (one of DB2, MySQL, Oracle, SQL Server, Sybase)
    • DB host - host name or IP address of the host where the database is located
    • Username - login name of the database user that Build Forge uses
    • Password - password for the login name
  6. Installing Wait for the installer to finish. Click Finish .
  7. Post-Install Steps Perform the post-installation steps in Post-Installation Setup.

Upgrading from Version 3.8 on Windows

To upgrade from version 3.8 to version 7.0 or later, you must perform the tasks in the following topics:
  1. Run the Windows Installer.
  2. Run the bfmigrate script to update your database.
  3. If you are migrating from a version of Build Forge that used the included MySQL database, run the bfdbmigrate script.

Run the Windows Build Forge Installer

Before you start:
  • If you are upgrading from Build Forge 3.8 with the included MySQL 3.2.3 database, before you run bfmigrate you must install MySQL 5.0 and migrate your Build Forge data. Migration to MySQL 5.0 must include setting up a user for Build Forge to use to connect to the MySQL 5.0 instance.
  • If you intend to migrate your database from MySQL to DB2 Express, the Build Forge installer creates a database named build and a Windows user build to use to log in to DB2 Express; you supply a password.
  • If you are running Build Forge in the foreground, stop the engine. If Build Forge is running as a service, the installer stops it automatically.
  • Copy the installation image (mc-<version>-Windows.exe) to your current Build Forge Management Console host.
Double-click the installation image file to start the installer. Respond to the following prompts.
Note: Default installation values are presented; they may not match the values in your buildforge.conf file. Enter the values in your existing buildforge.conf file.
  1. Welcome Click Next
  2. License Agreement Click I Agree
  3. Choose Install Location Enter the path of your current Build Forge installation.
  4. Build Forge Management Console Configuration Enter the following information, then click Next.
    • License Host - Enter the name or IP address of the license server host.
    • Primary/Secondary Settings - Click Normal.
  5. Database Configuration
    • If you are upgrading from version 3.8 with the provided MySQL database and intend to use the DB2 Express database provided with version 7.0 or later, choose Use IBM Rational Supplied Database, then provide the following information.

      The DB Name and DB Type fields are filled in. The default database name build is the required database name; do not change it.

      • DB host - use localhost or the host name of the current host.
      • Username - the default is build; you may change the user name
      • Password - supply a password for the user name
    • In all other cases, choose Connect to existing Database, then provide the following information. Click Install when done.
      • DB name - name of the database
      • DB type - type of database (one of DB2, MySQL, Oracle, SQL Server, Sybase)
      • DB host - host name or IP address of the host where the database is located
      • Username - login name of the database user that Build Forge uses
      • Password - password for the login name
  6. Installing - Wait for the installer to finish. Click Finish .

Run the bfmigrate Script

Run bfmigrate to migrate a 3.8 database schema to the version 7.0 or later database schema. For additional details, see Migration Script Reference.

After you run bfmigrate:
  • Log on to the Management Console and check your project information to verify that the migration was successful.
  • Optionally, delete your 3.8 database schema by running the bfmigrate -d command.
Important: If you are upgrading from Build Forge 3.8 with the included MySQL 3.2.3 database, before you run bfmigrate you must install MySQL 5.0. Migration to MySQL 5.0 must include setting up a user for Build Forge to use to connect to the MySQL 5.0 instance.
  1. Make sure the database is running.
  2. Run the bfmigrate script. From the Build Forge installation directory, run the following command.
    bfmigrate -m
  3. Wait for successful completion The migration script can take an hour or more to run. A successful run will end with the following message:
    Migration: 4156: Successfully migrated v3.8 data to v7.x
    If migrate fails, undo the migration, then try again. To undo:
    bfmigrate -u

Run the bfdbmigrate Script

Stop: Use these procedures only to upgrade for the following case.
  • From: Build Forge version 3.8 using the included MySQL database
  • To: Build Forge version 7.0 or later using the included DB2 Express database
Do not complete this task if you set up a non-provided database of any type with Build Forge version 3.8.
Run the bfdbmigrate script to migrate MySQL data (Build Forge 3.8) to DB2 Express data (Build Forge 7.0 or later).
  1. Make sure the database is running. The mysqld process should be running.
  2. Run the bfdbmigrate script. From the Build Forge installation directory, run the following command:
    bfdbmigrate
  3. Wait for successful completion The script creates a schema in the DB2 Express database. The script generates a series of messages as it runs. A successful run will end with the following message:
    Migration: 5148: Successfully migrated from old db to new
    A successful migration does not generate any error messages.
  4. Stop the mysqld process. Use Windows Task Manager, Processes tab. Check for the mysqld process. If it is running, select it and click End Process.
  5. Stop and then restart the Build Forge engine.
  6. Change the license server name to the Rational License Server name. The migration placed your old license key in the new database.
    1. Select Administration > System. A list of system settings is shown.
    2. Find the License Server system setting.
    3. Click the License Server name to edit its value. Enter the host name of the Rational License server where your Build Forge licenses are installed.
    4. Click Save.
  7. Post-Install Steps Perform the post-installation steps in Post-Installation Setup.