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:
- Welcome Click Next.
- License Click I Agree.
- 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.
- 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
- If you elected to install DB2 Express above:
- Install DB2 Express. The installer starts
automatically and displays a progress bar.
- Reboot Now When you are asked when to reboot,
reboot now. DB2 Express requires a reboot before you can access it through
Build Forge.
- 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.
- Log in. Use user name root, password root.
Change the root password immediately.