Secure Global Desktop 4.40 Administration Guide > Clients and Webtops > Relocating the Webtop to Your Own JSP Container

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:

1. 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).
2. 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:

   • /opt/tarantella/webserver/tomcat/<version>/webapps/sgd
   • /opt/tarantella/webserver/tomcat/<version>/webapps/axis

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

3. 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
4. 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.
   • If the webtop is relocated to a different host or you are using SGD security services, secure the SOAP connections to an SGD server.
5. Restart your JSP container and the SGD Web Server.
   • You must restart your JSP container to apply the global library and class file changes.
   • If you made any configuration changes to the SGD Web Server, you must restart it to apply the changes.
6. Log in to the relocated webtop.

Note If you use third-party authentication, you might want to configure a new trusted user for the relocated webtop.

Copyright © 1997-2007 Sun Microsystems, Inc. All rights reserved.