BuildForge Help

Road Map: Management Console on UNIX/Linux

Use this road map to install the Management Console on a supported UNIX/Linux operating system with a supported database on a separate host.

Note: This road map works for all product editions except the Express Edition, which is Windows only.
The road map tasks are described in the following tables:

Install Prerequisite Products

Several prerequisite products must be installed on the Management Console host. For each task, see the related topic in the installation guide for detailed instructions.

Table 1. Management Console Pre-Installation Tasks for UNIX/Linux
  Task Topic
  Verify that the target UNIX/Linux operating system is supported for the Management Console. Operating System Requirements
  A license server must be running and accessible from the Management Console host. Installing a License Server
  Install the license files in a temporary directory on the license server host Installing Licenses
  Install licenses for separately licensed components, like the Adaptor Toolkit and Quick Report. Installing Licenses
  Choose a supported database to use as the database for the Management Console Database Requirements
  Verify that a network connection exists for the database host and the Management Console host Database Installation and Configuration
  Set up the database for the Management Console:
Create a database, database user, and grant owner access.
  • (DB2 only) Set up a database user name and password in your UNIX/Linux operating system.
  • If you intend to use international data, configure the database to use a UTF-8 character set.

Database Installation and Configuration

International Data Support

DB2 Setup

MySQL Setup

Oracle Setup

  Download, install, and configure Apache web server Apache Installation and Configuration
  Download, install, and configure PHP.

(Proxy server only) To enable Management Console access, add the proxy server name and path to the <php-install>/lib/php.ini file.

PHP Installation and Configuration
  Download, install, and configure Perl. Perl Installation and Configuration

Installation Tasks

Complete the following tasks as a non-root user. Instructions may vary by platform. For each task, see the related topic in the installation guide for detailed instructions.

Table 2. Management Console Installation Tasks for UNIX/Linux
  Task Topic
  Create an installation directory, for example, usr/local/buildforge. Build Forge Installation and Configuration
  Locate the mc-<version>-unix.tar.gz file for your UNIX/Linux operating system on the download site or the product CD. Build Forge Installation and Configuration
  Click the mc-<version>-unix.tar.gz file and save it to the installation directory. Build Forge Installation and Configuration
  Unzip and extract the file contents to the installation directory:

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

Build Forge Installation and Configuration
  Change to the installation directory and run the bfinstall.pl script:

$./bfinstall.pl - - with-dbtype=<database_type>

Install Build Forge

Post-Install Tasks

Post-install tasks are summarized here. Some optional tasks are not listed. For each task, see the related topic in the installation guide for detailed instruction.

Table 3. Management Console Post-Installation Tasks for UNIX/Linux
  Task Topic
  Configure the Management Console to use license server:

In <bf-install>/Platform, create a bfkey.txt file.

Add the license server host name to the bfkey.txt file.

Installing the License Server
  Configure the Management Console to start at system startup:
  • Copy <bf-install>/rc/buildforge script to init.d.
  • Create run-level links from the run-level directory to the buildforge script in init.d
Include Build Forge in System Startup
  Set the owner of <bf-install>/ui/templates_c to the Apache user. Set Permissions for Apache
  Download and install J2SE 5. Apache Tomcat Installation and Configuration
  Download and install Apache Tomcat. Apache Tomcat Installation and Configuration
  Download and unzip the JDBC driver for your database. Copy the jar file only to $CATALINA_HOME/common/lib. Add $CATALINA_HOME to your system PATH. Apache Tomcat Installation and Configuration
  Configure and start Tomcat. Configure Tomcat for Build Forge

Start Up Tasks

Start up tasks are summarized here.

Table 4. Management Console Start Up Tasks
  Task Topic
  Launch the Management Console:
  • Enter http://<hostname>[:<port_number>] (from any Web browser)
  • Enter http://localhost (from the local Web browser)
Build Forge Installation
  Wait for the database schema to load.

It might take a minute or so for the Management Console to load the database schema the first time.

Do not stop the Management Console engine before the load completes; doing so may require removing and reinstalling the database.

Build Forge Installation
  Log on using root/root. Change the root password immediately to restrict console access. Build Forge Installation