Use this road map to install the Management Console on a supported UNIX/Linux operating system with a supported database on a separate host.
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.
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.
|
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 |
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.
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 are summarized here. Some optional tasks are not listed. For each task, see the related topic in the installation guide for detailed instruction.
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:
|
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 are summarized here.
Task | Topic | |
---|---|---|
Launch the Management Console:
|
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 |