Performing an update installation

This task describes how to perform an update installation.

Before you begin

About this task

Build Forge® 8.0 only supports upgrades from version 7.1.1.3 and later. For versions earlier than 7.1.1.3, you must first upgrade to 7.1.1.3 and then upgrade to 8.0

Procedure

  1. Start IBM® Installation Manager.
  2. In Installation Manager, click Update.
  3. On the Update Packages panel, select a package group to find updates, and click Next.
    Note: To see only the recommended update packages, select the Show recommended only check box.
  4. Select the updates or fixes to install:
    1. Select the installation from the list.
    2. Click Next.
    Versions are displayed that you can update.
  5. From the list of versions, select the installation and click Next.
  6. Select the I accept the license terms check box, and click Next. The Update Packages page is displayed, and your features are selected.
  7. Click Next.
  8. To test the configuration, configure the database connection for JAS and click Test connection near the bottom of the screen. After the test passes, click Next.
  9. Configure the database client library and click Test connection. After the test passes, click Next. The information you edited in your buildforge.conf file is displayed.
  10. On the Update Packages, Console Start Options panels, enter information at the following prompts:
    • On the JAS Database Configuration panel:
      1. In the Database type field, enter the type of database you are updating.
      2. At the prompt, Do you wish to populate this database at install time, select either the Yes or No check box.
      3. In the Database Host field, enter the IP address for the host.
      4. In the Database Port field, enter the port to use for this database connection. 3306 is the default.
      5. In the Database Username field, enter the user name to be used when logging on to the database.
      6. In the Password field, enter a password that is required to log on to the database.
      7. In the Confirm Password field, re-enter the password.
      8. In the JDBC Driver location field, click Browse to search for and select the location of the JDBC driver. The required driver JAR files and required JDBC driver class are displayed.
      9. Click Next. The second Update Packages, Console Start Options panel is displayed.
    • Console Start Options panel
      1. In the Database Name field, enter the database name. bfdotcmd is the default.
      2. In the Password field, enter a password that is required to log on to the database.
      3. In the Confirm Password field, re-enter the password.
      4. In the JDBC Driver location field, click Browse to search for and select the location of the JDBC driver. The required driver JAR files and required JDBC driver class are displayed.
      5. To test the database configuration connection, click Test connection.
      6. After the test passes, click Next.
    • On the Database Client Library Configuration Information panel, complete these fields:
      1. In the Path to the My SQL Client Libraries field, click Browse to search for and select the path to your SQL client libraries.
      2. To test the database connection again, click Test connection. The result of the test connection is displayed.
      3. Click Next.
  11. Enter information at the following prompts to continue the update:
    1. UNIX and Linux – At the prompt Which user should Build Forge run as, enter a user name or accept the default user, root. This user starts the Build Forge engine and the supplied Apache Tomcat. The user must have read and executed permissions for the database libraries and the JDBC jar files that are specified on upcoming pages in Installation Manager.
    2. At the prompt Do you want the installer to make the required database modifications?, select this check box to have the installer make the changes to your schema. If this check box is not selected, you must run bfschema -u manually after installation to apply schema changes.
    3. At the prompt Do you wish to start the console after upgrade?, select this check box to have the console start automatically after the installation is complete.
    4. Click Next. The features you selected to install are listed.
  12. Click Update to begin the installation.
  13. When the update has completed successfully, click Finish.
  14. Close Installation Manager.
  15. Start Build Forge. If you are upgrading from version 7.1.1.x, you will not see step logs from your builds until the Character Large Object (CLOB) migration is complete. When you start Build Forge, the migration begins. At the completion of the migration, Build Forge notifies you.

Feedback