If you deploy viewlets using a different web server, the JAR files listed in GUID-7721F55C-8ACE-40C0-8FE4-8D125EF0E64C.html#GUID-7721F55C-8ACE-40C0-8FE4-8D125EF0E64C___SA_DASHBOARD_CONFIG_CHAP2_88508 are required. The properties files are optional, but recommended as they simplify configuration of viewlets. Copy the necessary files listed in GUID-7721F55C-8ACE-40C0-8FE4-8D125EF0E64C.html#GUID-7721F55C-8ACE-40C0-8FE4-8D125EF0E64C___SA_DASHBOARD_CONFIG_CHAP2_88508 to the host where the web server is running.

Note:

If you intend to display Map viewlets, the web server must be capable of executing servlets.

In addition, the files in Additional files needed for third-party web server must be installed on the server.

Table 1. Additional files needed for third-party web server

Operating system

Files needed

Solaris/Linux

libagraphj.so

libblayj.so

libclayj.so

libclidemoj.so

libdgraphj.so

libhlayj.so

libjagraphj.so

libjclayj.so

libjdgraphj.so

libjhlayj.so

libjmgraphj.so

libjolayj.so

libjslayj.so

libjtlayj.so

libjutilsj.so

libmgraphj.so

libnlayj.so

libolayj.so

libslayj.so

libtlayj.so

libtsgltextj.so

libtsgltj.so

libutilsj.so

HP-UX

libagraphj.sl

libblayj.sl

libclayj.sl

libclidemoj.sl

libdgraphj.sl

libhlayj.sl

libjagraphj.sl

libjclayj.sl

libjdgraphj.sl

libjhlayj.sl

libjmgraphj.sl

libjolayj.sl

libjslayj.sl

libjtlayj.sl

libjutilsj.sl

libmgraphj.sl

libnlayj.sl

libolayj.sl

libslayj.sl

libtlayj.sl

libtsgltextj.sl

libtsgltj.sl

libutilsj.sl

Architecture when using a third-party web server illustrates the flow of information when using a web server other than the VMware Smart Assurance Servlet Engine to serve viewlets.

Figure 1. Architecture when using a third-party web server

To deploy the Dashboard viewlets with another web server (for example, a future version of Tomcat 6.x or 7.x), perform the following steps:

Note:

Version numbers and directory paths in these steps are for example only.

  1. Install Tomcat 6.x or 7.x.

  2. Set JAVA_HOME. For example, JAVA_HOME=C:\Program Files\JAVA\jdk1.6.0_15. Add the line to the catalina.bat file in the following location:

    • C:\tomcat-6.x\bin for Tomcat 6.x.

      • C:\tomcat-7.x\bin for Tomcat 7.x.

  3. Copy BASEDIR\smarts\tomcat\webapps\tss, \webapps\webconsole, and \webapps\templates to the new directory. For example, to the following location:

    • C:\tomcat-6.x\webapps for Tomcat 6.x.

      • C:\tomcat-7.x\webapps for Tomcat 7.x.

  4. Create a "lib" folder under the following location:

    • C:\tomcat-6.x\webapps\tss\WEB-INF for Tomcat 6.x.

      • C:\tomcat-7.x\webapps\tss\WEB-INF for Tomcat 7.x.

        and copy the JAR files from BASEDIR\smarts\tomcat\webapps\webconsole to this new folder. You need only copy the JAR files that begins with “tsg.”

  5. Ensure that BASEDIR\smarts\lib is in the system path (used in the library path for UNIX installs) when Tomcat is started. This directory includes libraries that the servlet needs.

    Note:

    This only works if the web server is on the same host as the Dashboard or Global Console. If they are not, you must copy libraries from the BASEDIR\smarts\lib of the Dashboard or Global Console to the machine where the server is installed. Additional files needed for third-party web server lists these files.

  6. Start the Tomcat engine using your standard web server startup command: 

    ..\tomcat-6.x\bin\startup.bat
..\tomcat-7.x\bin\startup.bat