Chapter 3. Manually deploying the WebApp on your existing Servlet Container Previous topic Parent topic Child topic Next topic

By following the procedure below step by step, a member of your IT staff (not an end-user) should be able to easily deploy the XMLmind XSL Server WebApp on a Servlet Container.
Tip
Tip
If you don't need to deploy XMLmind XSL Server on your own existing Servlet Container, you may want to try the quick and easy way to deploy and run XMLmind XSL Server.

Before you begin

Required software:
  • Java™ runtime 1.6+ (but not newest Java 9, which has not yet been tested). Note that some Servlet Containers may require a Java runtime more recent than version 1.6.
  • A Servlet Container compatible with the Servlet 2.3+ standard.

Procedure

  1. Stop the Servlet Container.
  2. Copy install_dir/xslsrv/, the expanded .war of the XMLmind XSL Server WebApp, to the WebApp deployment directory of your Servlet Container.
    tomcat.png Tomcat example, assuming that Tomcat has been installed in /opt/tomcat/:
    /# cp -r /opt/xslsrv/xslsrv /opt/tomcat/webapps
    jetty.png Jetty example, assuming that Jetty has been installed in /opt/jetty/:
    /# cp -r /opt/xslsrv/xslsrv /opt/jetty/webapps
    resin.png Resin example, assuming that Resin has been installed in /opt/resin/:
    /# cp -r /opt/xslsrv/xslsrv /opt/resin/webapps
  3. Make sure that the user account used to run the Servlet Container process has read/write privileges on webapps_dir/xslsrv/.
    Example:
    /# chown -R tomcat /opt/tomcat/webapps/xslsrv
    /# chgrp -R tomcat /opt/tomcat/webapps/xslsrv
  4. Restart the Servlet Container.
  5. Test that XMLmind XSL Server is up and running by pointing your Web browser to the xslsrv/exec URL.
    For example, let's suppose that the URL of the Servlet Container is http://localhost:8080/. Type http://localhost:8080/xslsrv/exec in the address bar of your Web browser.
    You should be able to see the following interactive Convert form.
    empty_convert_form.png

What to do next

After deploying XMLmind XSL Server as explained above and testing that it works fine, you may want to: