This task describes how to perform an update installation.
Before you begin
- If Build Forge® is
running, stop it now.
- If you are running on a Windows platform,
check the installation directory for the bfengine.pid file.
If it exists, remove it. Installation Manager cannot perform the update
if it exists.
- Before updating, you must set your repository URL to the updated
repository. See Specifying the repository URL for
instructions.
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
- Start IBM® Installation
Manager.
- In Installation Manager, click Update.
- 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.
- Select the updates or fixes to install:
- Select the installation from the list.
- Click Next.
Versions are displayed that you can update.
- From the list of versions, select the installation and
click Next.
- Select the I accept the license terms check
box, and click Next. The Update
Packages page is displayed, and your features are selected.
- Click Next.
- 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.
- 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.
- On the Update Packages, Console Start Options panels, enter
information at the following prompts:
- On the JAS Database Configuration panel:
- In the Database type field, enter the type
of database you are updating.
- At the prompt, Do you wish to populate this database
at install time, select either the Yes or No check
box.
- In the Database Host field, enter the IP
address for the host.
- In the Database Port field, enter the port
to use for this database connection. 3306 is
the default.
- In the Database Username field, enter the
user name to be used when logging on to the database.
- In the Password field, enter a password
that is required to log on to the database.
- In the Confirm Password field, re-enter
the password.
- 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.
- Click Next. The second Update Packages,
Console Start Options panel is displayed.
- Console Start Options panel
- In the Database Name field, enter the database
name. bfdotcmd is the default.
- In the Password field, enter a password
that is required to log on to the database.
- In the Confirm Password field, re-enter
the password.
- 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.
- To test the database configuration connection, click Test
connection.
- After the test passes, click Next.
- On the Database Client Library Configuration Information panel,
complete these fields:
- In the Path to the My SQL Client Libraries field, click Browse to
search for and select the path to your SQL client libraries.
- To test the database connection again, click Test connection.
The result of the test connection is displayed.
- Click Next.
- Enter information at the following prompts to continue
the update:
- 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.
- 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.
- 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.
- Click Next. The
features you selected to install are listed.
- Click Update to begin the installation.
- When the update has completed successfully, click Finish.
- Close Installation Manager.
- 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.