BuildForge Help

Upgrading the Management Console on UNIX or Linux

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

Before proceeding, check the following list:

Upgrading from Version 7.0 or Later on UNIX or Linux

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:
  • (7.0.1 and later) Stop the Tomcat server. Execute the shutdown command in the Tomcat bin directory:
    cd $CATALINA_HOME/bin
    ./shutdown.sh
  • Stop the Build Forge engine.
  1. Download the Build Forge tarball (for example, mc-<version>-unix.tar.gz) from IBM or copy it from installation media to a temporary directory on your current Build Forge host.
  2. As a non-root user, backup your current Build Forge directory:

    mv buildforge bf-old

  3. As a non-root user, create an installation directory:

    mkdir /usr/local/buildforge

  4. As a non-root user, change to the installation directory:

    cd /usr/local/buildforge

  5. Copy the downloaded file from tmp to the current installation directory:

    cp /tmp/mc-<version>-unix.tar.gz .

  6. Unzip and extract the file contents to the installation directory:

    $ gunzip -c mc-<version>-unix.tar.gz | tar xvf -

    Note: Note that tar is set to use stdin for the pipe (using the - parameter)
  7. Run the bfinstall.pl Perl script with the -–with-dbtype parameter for your database type. Values are:
    • DB2: --–with-dbtype=db2
    • MySQL:-–with-dbtype=mysql
    • Oracle:–-with-dbtype=oracle
    The following example installs for DB2:
    $ ./bfinstall.pl --with-dbtype=db2
    Note: The script asks you to confirm the installation of PHP and Perl you are using, then validates the versions and installed components of PHP and Perl. You may see messages passed through from your compiler as well as output from the script itself.
  8. Restart the engine.
  9. Set permissions for Apache. See Set Permissions for Apache.
  10. Copy the war files for the reporting application and for services-layer APIs for Java and Perl.

    See Configure Tomcat for Build Forge

  11. Download and unzip the JDBC driver for your database. Copy the jar file only to $CATALINA_HOME/common/lib. See Install JDBC Drivers.
  12. (7.0.1 and later) Stop the Tomcat server:

    cd $CATALINA_HOME/bin

    ./catalina.sh stop

  13. (7.0.1 and later) Delete the quickReport and rbf-services directories from the Tomcat webapps directory:

    cd $CATALINA_HOME/webapps

    rm -r quickReport

    rm -r rbf-services

  14. (7.0.1 and later) Restart the Tomcat server:

    cd $CATALINA_HOME/bin

    ./catalina.sh start

Upgrading from Version 3.8 on UNIX or Linux

To upgrade from Build Forge version 3.8 to version 7.0 or later, you must perform the tasks described in this topic.
  • Run bfinstall.pl to upgrade
  • Run the bfmigrate script to update your database.
  • Complete post-upgrade tasks.
Important: If you are running Build Forge version 3.8 on MySQL, you must install MySQL 5.0 and migrate Build Forge data to MySQL 5.0 before running bfmigrate. (Migration to MySQL 5.0 must include setting up a user for Build Forge to use to connect to the MySQL 5.0 instance.)

Run bfinstall.pl to Upgrade Build Forge

  1. Stop the Build Forge engine.
  2. Download the Build Forge tarball (for example, mc-<version>-unix.tar.gz) from IBM or copy it from installation media to a temporary directory on your current Build Forge host.
  3. As a non-root user, backup your current Build Forge directory:

    mv buildforge bf-old

  4. As a non-root user, create an installation directory:

    mkdir /usr/local/buildforge

  5. As a non-root user, change to the installation directory:

    cd /usr/local/buildforge

  6. Copy the downloaded file from tmp to the current installation directory:

    cp /tmp/mc-<version>-unix.tar.gz .

  7. Unzip and extract the file contents to the installation directory:

    $ gunzip -c mc-<version>-unix.tar.gz | tar xvf -

    Note: Note that tar is set to use stdin for the pipe (using the - parameter)
  8. Run the bfinstall.pl Perl script with the -–with-dbtype parameter for your database type. Values are:
    • DB2: --–with-dbtype=db2
    • MySQL:-–with-dbtype=mysql
    • Oracle:–-with-dbtype=oracle
    The following example installs for DB2:
    $ ./bfinstall.pl --with-dbtype=db2
    Note: The script asks you to confirm the installation of PHP and Perl you are using, then validates the versions and installed components of PHP and Perl. You may see messages passed through from your compiler as well as output from the script itself.
  9. Restart the engine.

Run the bfmigrate Script

These procedures apply for any version 7.0 or later installation, including those with an iFix applied. The iFix must have been correctly installed.
Run the bfmigrate Perl script to update the Build Forge data in your database.
  1. Run the bfmigrate script. From the Build Forge installation directory, run the following command:
    bfmigrate.pl -m
  2. 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

Complete Post-Upgrade Tasks

  1. Set permissions for Apache. See Set Permissions for Apache.
  2. Copy the war files for the reporting application and the services-layer APIs for Java and Perl.

    See Configure Tomcat for Build Forge.

  3. Download and unzip the JDBC driver for your database. Copy the jar file only to $CATALINA_HOME/common/lib. See Install JDBC Drivers.