The smartWeb platform is implemented as an application for the Java EE application server Tomcat running on the Java platform. This application server is also part of the D2000 installation and runs on Java delivered with the D2000 version. In the first step, it is necessary to decide whether we want to install Smart Web. On a Tomcat server supplied within the D2000 or on the separately managed Tomcat server independent of the D2000. Both alternatives have their advantages and disadvantages, which can be summarized as follows:


Feature

Tomcat within the D2000

Standalone Tomcat Server

Easy to deploy(plus) Tomcat does not need to be installed and managed separately from the D2000 because it runs as a D2000 process with a .WSC extension(mínus) Tomcat must be installed and managed independently of the D2000
Deployment flexibility in the DMZ(mínus) Deployment in a DMZ is not appropriate due to the need to install and configure a separate instance of D2000(plus) Ideal for stand-alone installation in DMZ
Ad-hoc upgrade Tomcat Server(mínus) upgrade Tomcat is tied with the D2000(plus) Tomcat can be upgraded ad-hoc independently of the D2000

Installing Smart Web application on Tomcat within D2000

The installation procedure is as follows:

  1. Configure and run SELF.WSC process:
    1. copy folder D2000_EXE/templates/config/proc/_.wsc in to the folder D2000_APP/<application name>/config/proc/
    2. rename _.wsc to the self.wsc
  2. Copy file D2000_EXE/web/smartWeb.war to the folder  D2000_APP/<application name>/config/proc/self.wsc/base/webapps/
  3. Unzip file D2000_EXE/web/tutorial-application.zip to the folder D2000_APP/<application name>/config/proc/self.wsc
  4. Start process SELF.DCS, by d2connector.exe from D2000_EXE/bin folder
  5. Start process SELF.WSC, by wssc.exe from D2000_EXE/bin folder
  6. In the CNF environment enable autostart for these processes and restart your application
  7. Open tutorial application on the http://localhost:8080/smartweb link

Installing a Smart Web application on a Tomcat standalone

The installation procedure is as follows:

  1. Download and install AdoptOpenJDK version 11
  2. Set the system environment variable JAVA_HOME to the root directory where the JDK was installed
  3. To use strong ciphers in the HTTPS protocol it is necessary to download Java Cryptography Extension (JCE) files and copy them to the lib/security JDK directory. If it is not necessary to configure the HTTPS protocol, this step can be skipped
  4. Download and install Tomcat version 9 according to standard procedure 
  5. Copy file D2000_EXE/web/smartWeb.war in to the webapps Tomcat folder
  6. Unzip file D2000_EXE/web/tutorial-application.zip to the Tomcat parent folder
  7. Start process SELF.DCS, by d2connector.exe from D2000_EXE/bin folder
  8. Run Tomcat server
  9. Open tutorial application on the http://localhost:8080/smartweb link

Change the context directory of a URL link

To change the context directory of a URL link from http://localhost:8080/smartweb to the, for example, http://localhost:8080/myApp you need to do the following:

  1. Stop Tomcat server
  2. Rename file /webapps/smartweb.war 
  3. Run Tomcat server