MCIC for Tomcat on SuSE

Previous  Top

Introduction
The Metatude Channel Integration Component (MCIC) runs on a java-servlet enabled web server. Tomcat is a widely used web-server for servlet based applications and Apache is the most popular web-server for any kind of web applications. Apache can serve as a frontend for the Tomcat server. This document describes the installation of the MCIC and Tomcat on a RedHat Linux based system. You already need to have installed Apache 2.

This chapter of the manual describes how to install Tomcat and the MCIC on SuSE Linux 9.0 Professional.

Installation of Tomcat
Start the YaST Control Center. Go to Software and choose Install and remove Software. Do a search for tomcat. Two packages will be found. These need to be installed. Additionally, Java must be installed. These are the names of the new packages that need to be added:

apache2-jakarta-tomcat-connectors
jakarta-tomcat
java2

After you've installed these packages, Tomcat will be available on your system. Next, you need to start the Tomcat service. Do this in the YaST Control Center. Go to System and choose Runlevel Editor. Enable the Tomcat Service here.

Installation of the MCIC
Install MCIC as follows:

·	Go to the directory /Channel_Integration_Component_for_Apache on your Server software CD.

·	Execute the file install.bin

·	The installation process is now started.

·	You need to accept the terms of the license agreement and indicate the directory where the Tomcat is installed. For SuSE Linux the directory is /opt/jakarta/tomcat

·	After these questions you can press the button 'install', after which the installation takes place.

·	After completion of the installation process press the button 'done'

Set the preferences of the MCIC
Open the file MCICPreferences.dat with with any text editor. It is located at /opt/jakarta/tomcat/webapps/metatude if you chose the default installation path.

·	On the first line of the file, put the IP address or hostname of the MDS

·	On the second line of the file, put the port number of the MDS (default is 6382)

·	Save the text file

Restart Tomcat for the installation to take effect.

Configuring Apache
Open the YaST Control Center and go to System. Choose Editor for /etc/sysconfig Files. In the tree menu on the left, go to: Network/WWW/Apache2/APACHE_MODULES.
Add jk to the list of modules for Apache and save your configuration.

Edit the file /etc/apache2/conf.d/tomcat_jk.conf. Just before the </IfModule> statement, add the following lines:

Alias /metatude "/opt/jakarta/tomcat/webapps/metatude"
<Directory "/opt/jakarta/tomcat/webapps/metatude">
    Options Indexes FollowSymLinks
    allow from all
</Directory>

JkMount /metatude/* ajp13

<Location "/metatude/WEB-INF/">
    AllowOverride None
    deny from all
</Location>

Save the file and restart Apache.

Now you can request dialogues through your web-browser from the MCIC.

Optionally, you can set a specific stylesheet for a dialogue

·	Create or copy a stylesheet

·	Rename the stylesheet to project_XXX.xsl, where XXX is the project ID. The project ID for a project is shown in the Metatude Project Manager, when you click 'edit' in the 'Projects' tab.

·	Put the stylesheet in the MCIC directory, located at /opt/jakarta/tomcat/webapps/metatude/xsl.