SWORDWeb is a set of tools and ready to install web application for exposing SWORD functionality on a website.
See it in action
http://www.crosswire.org/study/
Installation
These instructions are Linux specific (don't all real websites run on Linux?), but the components used to make SWORDWeb operate all claim to be cross-platform, so please modify these instructions to work on the platform of your choice
Basic steps to get things up on your end:
Prerequisites
(along with the version we're using-- newer versions should work fine):
ORBit (ORBit2-2.12.4)
ORBit C++ (orbitcpp-1.3.9)
orbit configured to NOT use its own accelerated transport, but instead,
the standard IIOP. This is a little tricky. We do this by placing a
file: /usr/etc/orbitrc, containing:
ORBIIOPIPv4=1
ORBIIOPIPv6=1
ORBIIOPUSock=0
This should be alternatively located at /etc/orbitrc, or /usr/local/etc/orbitrc, depending on how you configured ORBit
For the existing web interface:
JDK from Sun (build 1.4.2-b28)
JSP/Servlet Engine (Apache Tomcat/4.1.24)
Instructions:
Obtain sword and swordweb from SVN
$ svn co https://crosswire.org/svn/sword/trunk/ sword
$ svn co https://crosswire.org/svn/swordweb/trunk/ swordweb
Then:
$ cd sword
$ ./autogen.sh
$ ./usrinst.sh
$ make
$ su
# make install
# make install_config
# exit
$
The SWORD engine should now be installed. You should be able to
download any books from our site
(http://www.crosswire.org/sword/modules/ Choose the RawZip download link
for each book) that you wish to make available and unzip them to
/usr/share/sword.
You can test that the engine is working and finding its library with
something like:
$ cd tests
$ make
$ ./mgrtest
Once the engine is working, building the ORB service should be pretty basic:
$ cd bindings/corba/orbitcpp
$ make
At this point you can test that the ORB is working. There is a test
client that makes basic calls to the service. To test, run ./server,
then in another window, run ./testclient The IOR was
outputted to the screen when you ran the ./server.
Once the service is working fine, there is no install script, so you'll
need to move it with a command like:
$ mv server /usr/bin/swordorbserver
Now, if you'd like to get our webclient running, these steps should do
it for you:
$ cd bindings/corba/java
$ vi Makefile (and modify TOMCAT_HOME to point to your jsp engine and instdir to point to the webapp directory where
you will run the webpages)
$ make
$ make install
This should install the java helper classes that bind to the CORBA service.
Then you should be able to move the swordweb stuff into the webapp where
you installed the above classes and things SHOULD work.
There are a few simple examples under swordweb/examples. For learning to use the tools, these are much more concise than the full web application.
Help
Bug Reports / Feedback
| 