Deploying WorldServer through Tomcat (on Windows)

The WorldServer installer for Windows installs Tomcat and deploys WorldServer for you. However, there may be situations when you have to deploy WorldServer manually (for example, in your testing environment). You can deploy WorldServer through Apache Tomcat version 8, which is provided in the 3rdparty folder of the WorldServer distribution kit.

About this task

You can use this procedure both to deploy WorldServer on a new environment and to upgrade Tomcat on an existing WorldServer environment. In the latter case, however, you have to uninstall your existing Tomcat version before you start upgrading to a new one and you no longer need to configure the .properties files at the end, because they have already been configured.

Procedure

  1. Download the apache-tomcat-8.0.36.zip file from the internet or copy it from the WorldServer distribution kit.
  2. Extract the contents of the apache-tomcat-8.0.36.zip file to your <WS_HOME> folder (where <WS_HOME> is the WorldServer installation folder – by default, C:\Program Files\Idiom\WorldServer).
  3. If you haven't already done so, set the CATALINA_HOME environment variable:
    > set CATALINA_HOME=<WS_HOME>\tomcat
  4. Copy the WorldServer WAR files from the WorldServer installation folder to the Tomcat webapps folder:
    > copy c:\Program Files\Idiom\WorldServer\ws.war
     > copy c:\Program Files\Idiom\WorldServer\ws-legacy.war
     > copy c:\Program Files\Idiom\WorldServer\ws-api.war 
    c:\Program Files\Idiom\WorldServer\apache-tomcat-8.0.36\webapps
  5. Start Tomcat.
    > cd c:\Program Files\Idiom\WorldServer\apache-tomcat-8.0.36\bin
    > startup.bat
    The contents of the ws.war, ws-legacy.war, and ws-api.war files are extracted and the Tomcat console displays a log such as the following:
    Oct 12, 2016 9:34:30 AM org.apache.coyote.http11.Http11BaseProtocol
    init
    INFO: Initializing Coyote HTTP/1.1 on port 8080
    ...
    INFO: Starting service Catalina
    ...
    INFO: Starting Servlet Engine: Apache Tomcat/8.0.36
    ...
    INFO: Deploying web application archive ws.war
    ...
    INFO: Deploying web application archive ws-legacy.war
    ...
    INFO: Deploying web application archive ws-api.war
    ...
    Oct 12, 2016 9:34:37 AM org.apache.catalina.startup.Catalina start
    INFO: Server startup in 21310 ms

Results

You have now finished deploying WorldServer on Windows.

What to do next

At this point, you must configure the .properties files. After that, you can also install the Report Center and the File Type Support (FTS) Server.