Relocating the Webtop to Your Own JSP Container

The webtop is a JavaServer Pages (JSP) application that you can relocate to your own JSP container. The JSP container can be on the same host as an SGD server or on a different host.

To use your own JSP container, the container must support the following:

Version 2.2 of the Java Servlet specification

Version 1.2 of the JavaServer Pages specification

Note Once you relocate the webtop to your JSP container, you have to manually upgrade the webtop by following the procedure on this page for each new release.

To relocate the webtop, do the following:

Re-configure the ports used by the SGD Web Server.

If your JSP container is on the same host as an SGD server, you might have to re-configure the ports used by the SGD Web Server.

The SGD Web Server might be listening on the standard HTTP or HTTPS ports (TCP ports 80 or 443), depending on the ports selected for the
SGD installation. Configure your web server to listen on ports TCP ports 80 or 443 and configure the SGD Web Server to use different ports (by editing the /opt/tarantella/webserver/apache/version/conf/httpd.conf file).

The Tomcat component of the SGD Web Server uses port TCP ports 8005 and 8009. If these ports are used elsewhere, for example by your JSP container, you must change the Tomcat configuration. Edit the /opt/tarantella/webserver/tomcat/version/conf/server.xml file and change the server shutdown port (TCP port 8005) and the Coyote/JK2 AJP 1.3 Connector port (TCP port 8009).

Copy the webtop web application to your JSP container.

Copy all the files in the following directories into the web applications directory on the new host:

Note These directories contain symbolic links, make sure you preserve the links when you copy the directories.

Copy the required library and class files.

The webtop requires some additional library and class files, which must be copied to your container.

Copy the following Jar files from the /opt/tarantella/webserver/tomcat/<version>/common/lib directory to the global library directory on your container:

axis.jar

commons-discovery.jar

commons-logging.jar

jaxrpc.jar

saaj.jar

xerces.jar

Copy the following class files from the /opt/tarantella/webserver/tomcat/<version>/common/classes directory to the global class directory on your container:

com/tarantella/tta/webservices/client/listener/SSListener.class

Configure the web services endpoints.

The webtop uses the SOAP protocol (over HTTP) to access the services provided by an SGD server.
The webtop uses a Resources.properties file to determine which server and port to send the web services requests to. This is currently set to http://localhost.

On the new host, edit the Resources.properties file in the
sgd/WEB-INF/classes/com/tarantella/tta/webservices/client/apis directory. Replace http://localhost:port with http://server:port where server is the DNS name of an SGD server and port is the port that the SGD Web Server listens on. Do this for each of the web services listed in the properties file.