Line
1	$Id: tomcat_config.txt 206 2007-03-14 18:52:48Z mmb $
2
3	This file details the required changes to the default Tomcat configuration
4	that are required for the midware web services to work.
5
6	Deployment
7
8	In production the midware webapp will be deployed to webapps/midware-x.xx/ and
9	there will be a symlink webapps/midware which links to the latest version.
10
11	For development, to create a midware webapp in Tomcat that has a document root
12	outside the Tomcat webapps directory, put this in server.xml:
13
14	<Context path="/midware" reloadable="true"
15	docBase="C:\Documents and Settings\mboedicker\workspace\midware"
16	workDir="C:\Documents and Settings\mboedicker\workspace\midware\work">
17	</Context>
18
19	This is useful for keeping the code in your Eclipse workspace directory.
20
21	---
22
23	SSL client
24
25	To connect to the PSX API over SSL you need the right key in the trust store.
26	Set the path to the trust store file in the web application's web.xml file.
27
28	---
29
30	SSL server
31
32	Tomcat will only be able to be accessed using SSL. Change the SSL connector
33	section of the Tomcat server.xml file to the following:
34
35	<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
36	    maxThreads="150" scheme="https" secure="true"
37	    clientAuth="false" sslProtocol="TLS"
38	    keystoreFile="/home/tomcat/security/eCare.keystore"
39	    keystorePass="terakeet"
40	    truststoreFile="/home/tomcat/security/eCare.truststore" />
41
42	The keystores in /home/tomcat/security/ can be found in the midware/dist
43	directory after the midware is built.
44
45	---
46
47	Authentication
48
49	Set up users and roles in tomcat-users.xml. The users and roles should match
50	the users and roles set up in the web application's web.xml file.
51
52	<?xml version='1.0' encoding='utf-8'?>
53	<tomcat-users>
54	  <role rolename="address" />
55	  <role rolename="costguard" />
56	  <role rolename="sonuspsx" />
57	  <user username="customer1" password="tomcat" roles="costguard,sonuspsx,address" />
58	</tomcat-users>