Custom setup needed for ContestQsos with SOAP-2_2 and jakarta tomcat 3.2.4
W. Wright, W5XD, 11 November, 2002

These "instructions" have been tested on a Windows machine. They should more or less work on a Linux
server, with the appropriate switching of / and \

1. Download and install JDK 1.3.1 (http://java.sun.com/j2se/1.3) jre is NOT enough for tomcat!
2. Download and unzip jakarta-tomcat-3.2.4 (http://jakarta.apache.org/builds/jakarta-tomcat/release/v3.2.4/bin/)
3. Download and unzip soap-2_2 (http://xml.apache.org/dist/soap/version-2.2/)
4. Download mail.jar, and activation.jar, xerces.jar (per http://xml.apache.org/soap/docs/index.html) 
5. Download WriteLogServer.zip
6. Copy soap.war to the jakarta-tomcat-3.2.4\webapps directory

7. Choose a directory for the WriteLogServer to live in, copy WriteLogServer.zip to that directory and unzip it.
We'll call it <WriteLogServerDirectory>
In <WriteLogServerDirectory> you must edit either deploy.cmd (Windows) or deploy.sh (Linux) and 
add in the full path names to mail.jar, activation.jar, xerces.jar and soap.jar
Also, change the localhost:80 to localhost:8080 where they appear

8. copy WriteLogServer.jar to jakarata-tomcat-3.2.4\lib directory

9. Edit jakarta-tomcat-3.2.4\conf\tomcat-users.xml to contain a line that looks like this:
  <user name="W5XD" password="wayne" roles="ContestLogbook" />
A line for each station contributing to the logbook must eventually be added. One
will be enough to test.

10. a. Before starting the webserver, go to jakarta-tomcat-3.2.4\bin, and edit
startup.bat (or startup.sh). Set the classpath to include all these:

set CLASSPATH=<full path>xerces.jar;<full path>mail.jar,<full path>activation.jar;<full path>soap.jar
(use ":" for linux instead of ";")

You can copy and paste the CLASSPATH line modified in #7

11. b.
Start the webserver for the first time by taking a new command window, 
make sure java 1.3.1's \bin directory is on your PATH, cd to
the jakarta bin directory, and start it, like this:

(for Windows:) set PATH=%PATH%;<path-to-jdk>\jdk1.3.1_01\bin
cd <path-tomcat>\jakarta-tomcat-3.2.4\bin
startup

The web server will create the \webapps\soap\WEB-INF directory, and
will create the \webapps\ROOT directory

12.  Copy <WriteLogServerDirectory>/ContestQsos.wsdl into the new ROOT directory

13. If you previously modified the file 
jakarta-tomcat-3.2.4\webapps\soap\WEB-INF\web.xml per obsolete instructions,
then find the <!-- W5XD START --> and <!-- W5XD finish ->> and delete them--
Do not password protect the SOAP server because it destroys performance.

Instead, password protect the .wsdl file itself by modifying:
jakarta-tomcat-3.2.4\webapps\ROOT\WEB-INF\web.xml

The following goes between the <web-app> and </web-app>

<!--- W5XD START --> 
    <security-constraint>
      <web-resource-collection>
         <web-resource-name>Protected Area</web-resource-name>
				<url-pattern>*.wsdl</url-pattern>
			 <http-method>DELETE</http-method>
			  <http-method>GET</http-method>
			 <http-method>POST</http-method>
			 <http-method>PUT</http-method>
      </web-resource-collection>
      <auth-constraint>
         <role-name>ContestLogbook</role-name>
      </auth-constraint>
    </security-constraint>

    <login-config>
      <auth-method>BASIC</auth-method>
      <realm-name>CQ_CONTEST</realm-name>
    </login-config>

<!-- W5XD finish -->

14. Shut down the web server using jakarta-tomcat-3.2.4\bin\shutdown, and restart it (so that it
sees the changes made in the previous step)


15. Invoke the deploy command for the WriteLogServer. This requires four steps:
a. cd to <WriteLogServerDirectory>
b. make sure java is on your PATH "set PATH=%PATH%;<path-to-java>\jdk1.3.1_01\bin"
c. invoke deploy.cmd (or deploy.sh on Linux)
java org.apache.soap.server.ServiceManagerClient -auth W5XD:wayne http://localhost:8080/soap/servlet/rpcrouter deploy d:\path-to-deploymnetdescriptor\DeploymentDescriptor.xml
d. Check your results by browsing to http://localhost:8080/soap/admin/index.html. You should get several buttons, including one labeled "List". 
Click it and you should see "urn:ContestQsos" and "urn:ContestRigs"

16. (only works from the PC side) 
Test that WriteLog can connect to it. Tools Connect to Internet Log book, URL: http://localhost:8080/ContestQsos.wsdl
Station: W5XD
Password: wayne (user name and password must be an entry from (9) above.

17. For use on the internet, the last few lines in the file jakarta-tomcat-3.2.4\webapps\ROOT\ContestQsos.wsdl must be modified:
[before]
    <soap:address location="http://localhost:8080/soap/servlet/rpcrouter/"/>
[after]
    <soap:address location="http://[WWW.REAL-ADDRESS.COM]/soap/servlet/rpcrouter/"/>

... and \jakarta-tomcat-3.2.4\conf\server.xml must also be modified to use port 80 instead of 8080:

[before]
        <!-- Normal HTTP -->
        <Connector className="org.apache.tomcat.service.PoolTcpConnector">
            <Parameter name="handler" 
                value="org.apache.tomcat.service.http.HttpConnectionHandler"/>
            <Parameter name="port" 
                value="8080"/>
        </Connector>

[after]
       ... the same except 8080 changed to 80

18. While the "deploy.cmd" script edited in (7) and used (15) might never need be run again (because the
jakarta installation remembers the deployment), you should change the localhost:8080 in them to 
localhost:80 if you are running jakarta-tomcat on port 80.

19. The web server deployed as above is completely vulnerable to attack. While this won't make it
perfect, here are some things you can do to customize the installation:

a.