[size="18">Re-styling Yellowfin with a Web Server[/size]

!This configuration is unsupported and is given as a guide only!

This example configuration uses Apache2 connected to Tomcat using ModJK.
This example is from an Ubuntu 10.04 LTS environment.

What this configuration will do, is mount Tomcat behind Apache.
Tomcat will handle requests that include *.jsp, *.i4 returning the generated application pages.
Other requests for images and other static content.. like styles, will come from apache.

This allows multiple sites (domain names, or subdomains), to connect to the same instance of Tomcat, though allowing images, styles and index pages to be loaded from each different site.

Note:
The Apache2, and Mod JK packages will need to be installed.
These were installed via Ubuntu's package mangement system.

[size="14">Configuration File Modifications:[/size]

You will need to enable the AJP connector in the Tomcat server.xml file.
This is in /Yellowfin/appserver/conf/server.xml

Uncomment this line:
[code]
[/code]

This is the contents of worker.properties in /etc/apache2
Note:This file may need to be created
[code]
worker.list=ajp13
worker.ajp13.port=8009
worker.ajp13.host=localhost
worker.ajp13.type=ajp13
[/code]

This was added to the apache2.conf file in /etc/apache2.
[code]
# mod_jk system properties
JkWorkersFile /etc/apache2/workers.properties
JkLogFile /var/log/apache2/mod_jk.log
JkLogLevel warn
[/code]


This was added above the lines:
[code]
# Include of directories ignores editors' and dpkg's backup files,
# see README.Debian for details.
[/code]


[size="14">Each site available on apache is configured in the sites-available directory.[/size]

Here is a standard definition of a virtual host.
[code]


ServerAdmin support@yellowfin.com.au
ServerName node1.yellowfin.com.au

DocumentRoot /domains/node1.yellowfin.com.au/html

Options FollowSymLinks
AllowOverride None


AllowOverride None
Options FollowSymLinks
Order allow,deny
allow from all


DirectoryIndex index_page.jsp

ErrorLog /var/log/apache2/testing-error.log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/apache2/testing-access.log combined


[/code]

To enable this site to communicate with Tocmat add the following:

[code]


ServerAdmin support@yellowfin.com.au
ServerName node1.yellowfin.com.au

DocumentRoot /domains/node1.yellowfin.com.au/html

Options FollowSymLinks
AllowOverride None


AllowOverride None
Options FollowSymLinks
Order allow,deny
allow from all


DirectoryIndex index_page.jsp

ErrorLog /var/log/apache2/testing-error.log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/apache2/testing-access.log combined

JkMount /*.jsp ajp13
JkMount /*.i4 ajp13
JkMount /cewolf ajp13
JkMount /services/* ajp13
JkMount /js/* ajp13


[/code]

This will send requests matching *.jsp, *.i4 /services/* /js/* through to tomcat.

In the above example the site points to /domains/node1.yellowfin.com.au/html on the filesystem.
In this directory you replicate the Yellowfin /images and /css directories.
Here you can customize the images and styles for this particular site.

This site has also been configured to use index_page.jsp as its initial landing page. This can be configured on a per site basis also.

Please email [color="#1E43C9">support@yellowfin.com.au[/color] if you are experiencing any issues.