Web Server Setup

If you want to use the Gold web GUI, you will need to make some modifications to the tomcat configuration to support the use of SSL connections.

Configure your environment with the following environment variables:

[root]# export CATALINA_HOME=/usr/local/jakarta-tomcat-4.1.29

[root]# export JAVA_HOME=/usr/local/j2sdk1.4.2_01

Edit the server.xml file under $CATALINA_HOME/conf:

[root]# vi $CATALINA_HOME/conf/server.xml

Uncomment the SSL connector. This will allow secure connections. You can specify the port, timeout, etc. according to your preferences. It might look something like this:

  <Connector className="org.apache.catalina.connector.http.HttpConnector" port="8443" minProcessors="5" maxProcessors="75" enableLookups="true" redirectPort="8443" acceptCount="10" debug="0" scheme="https" secure="true" connectionTimeout="60000">
    <Factory className="org.apache.catalina.net.SSLServerSocketFactory" clientAuth="false" protocol="TLS"/>
  </Connector>
        

Create a certificate keystore by executing the following command and specify a password value of "changeit". For more help, see <http://jakarta.apache.org/tomcat/tomcat-4.1-doc/ssl-howto.html>.

[root]# $JAVA_HOME/bin/keytool -genkey -alias tomcat -keyalg RSA

Startup Tomcat. The make gui-install step should have copied the gold.war file into the $CATALINA_HOME/webapps directory. When tomcat is started up, it should unpack the jar into a gold directory here after a few seconds.

[root]# $CATALINA_HOME/bin/startup.sh

Edit the servlet container's gold.conf file

[root]# vi $CATALINA_HOME/webapps/gold/etc/gold.conf # At a minimum you will want to specify the server.host and log4j.appender.Log.File

Restart Tomcat

[root]# $CATALINA_HOME/bin/shutdown.sh

[root]# $CATALINA_HOME/bin/startup.sh