The Web browser client and the Tomcat Web server subcomponent of the Management Console communicate over an HTTP connection. Tomcat is required to use the Quick Report reporting feature, a separately licensed option in Build Forge.
This section describes how to configure Tomcat for SSL to secure the HTTP connection. To do this, you must download some additional software, configure Tomcat for SSL, and create self-signed certificates.
These instructions assume that the Tomcat Web server subcomponent is installed on the Management Console host.
Stop the Build Forge engine if it is running on the Management Console host
$ /<rc_path>/buildforge stop
$ ps aux | grep buildforge $ kill ${<PID>}
Execute the Java keytool command to create a keystore and self-signed certificate. (The keytool is included with the Java 1.5 JDK.)
%JAVA_HOME%\bin\keytool -genkey -alias tomcat -keyalg RSA -keystore <path_to_keystore>
$JAVA_HOME/bin/keytool -genkey -alias tomcat -keyalg RSA -keystore <path_to_keystore>
After executing the keytool command, you are prompted for a keytool password. You are also prompted for a key password for the certificate. The keytool password and the key password for the certificate must be the same. (You must provide the keytool password later when you configure Tomcat.)
Configure your secure socket in the $CATALINA_HOME/conf/server.xml file. $CATALINA_HOME is the Tomcat installation directory.
Complete these steps for your Windows or UNIX/Linux installation:
<!-- <Connector port="8443" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThread="75" enableLookups="false" disableUploadTimeout="true" acceptCount="100" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS"/> </Connector> -->
keystoreFile="<path_to_keystore_file>" keystorePass="<password>" algorithm="IbmX509"
In Windows, select
.Look for Tomcat start up errors.
<path_to_rc_file>/buildforge start
$ /<bf-install>/Platform/buildforge.pl &
Use one of the following options to test the Tomcat HTTPS connection to the Web browser.
The default Tomcat home page should display.