Installation Manager installs and configures Apache Tomcat as the application server for Build Forge. Using the provided Apache Tomcat application server is the quickest way to configure an application server for Build Forge.
As an alternative to the standard configuration, you have the option to use an existing Apache Tomcat instead of the one provided by Build Forge. This section describes the prerequisite software, pre-installation setup, installation, and post-install requirements for this alternative. The instructions provided assume that you have experience setting up and configuring Apache Tomcat.
$CATALINA_HOME is the Tomcat installation root and must be set as an environment variable. See the installation documentation for your JDBC driver.
Click the download link next to DB2 Driver for JDBC and SQLJ; IBM account registration is required. You also need to locate and install a licensing .jar, db2jcc_license_cu.jar.
Click the link for MySQL Connector/J 5.0 or 5.1. Select the JDBC driver version that corresponds to your MySQL version.
Click the download link next to your version of Oracle; account registration is required.
Click the Download SQL Server JDBC Driver link.
These instructions identify the information that you need to configure Apache Tomcat through Installation Manager.
✓ | Field | Description |
---|---|---|
Redirection URL | Enter the host name and port number of your application server. You must specify rbf-services as the context path. For example: http: | https://<app_server_host>:<app_server_port>/rbf-services. | |
Specify the directory where you want to install the BF Services Plug-ins | Specify a directory local to the application server host. Installation Manager installs the Build Forge services layer application plug-in extensions in this directory. The user who is running the application server must have read, write, and execute permission to this directory. |
After you have completed installation through Installation Manager, complete the following post-installation steps.
The location of the rbf-services.war is dependant upon your operating system. UNIX and Linux place this file in /opt/buildforge/PrepForExternal; Windows places this file in C:\Program Files\IBM\Build Forge\PrepForExternal. See Updating the buildforge.conf file and complete the relevant steps.
Set the JVM maximum heap size option -Xmx to 1024 M.
Use the CATALINA_OPTS or the JAVA_OPTS environment variable in catalina.bat or catalina.sh to set this JVM option.
$CATALINA_HOME/bin/catalina.sh start
.