How to Build a Hinjun

2006-11-02T14:28:49+00:00

How to build a SOCKET engine, that is. The SOCKET engine depends on one or more consumer factories. Presently there is one sole factory, codenamed Rose, which itself has a dependency on an XSLT view factory. In order to build the SOCKET engine, therefore, three projects are involved.

Firstly, check out the three projects from sourceforge, http://sourceforge.net/projects/socket. The top directories of the three projects should lie in the same directory for minimal configuration duties. You will need ant to build the projects. If you are using an IDE, ant will normally be included. I am using ant 1.6.5.

1. Check out 'socket-engine' as a project named 'socket-engine'.
2. Check out 'rose-imp' in socket-consumer-factory as a project named 'rose'.
3. Check out 'socket-view' as a project named 'socket-view'.

4. Build socket view: right-click build.xml in an IDE and run the 'all' target.

5. In the rose directory, copy the sample.build.properties into the file build.properties. If the socket-view project is not on the same directory level as rose, then this file should be edited accordingly.
6. Build rose by right-clicking build.xml and choosing the 'all' target.

7. In the socket-engine directory, copy the sample.build.properties into the file build.properties. If the rose project is not on the same directory level as socket-engine, then this file should be edited accordingly.
8. Build socket-engine by right-clicking build.xml and choosing the 'all' target.

You have now built the hinjun socket-engine.war which you will find in the build/wars directory.

Drop the WAR into your friendly neighbourhood Tomcat (5.5.x) and point your SOCKET clients to http://www.myserver.ac.uk/socket-engine/engine/http