Appendix D - Setup when Tomcat is NOT installed as a Windows Service

1 minute read

It is possible to run Tomcat without installing it as a Windows service. This section briefly explains a few differences from the ‘Tomcat installed as a Windows service’ procedure described above.

Download and Unzip Tomcat

Download the Tomcat zip file and unzip to some folder. Hereafter, the alias TOMCAT refers to the folder where Tomcat is unzipped.

Java setup

Install the 64-bit Java Runtime Environment 8 (JRE 8) or later as described above. Set the environment variable named JRE_HOME to the pathname of the directory into which you installed the JRE, e.g. C:\JRE8.

Verify Tomcat installation

Start up Tomcat by executing the following command:

TOMCAT\bin\startup.bat

After startup, verify that you can reach the default web application included with Tomcat by visiting:
http://localhost:8080/

Shut down Tomcat by executing the following command:

TOMCAT\bin\shutdown.bat

SICS configuration

Configure the SICS settings for Tomcat as described above. This typically means reviewing the settings in
\META-INF\context.xml
\WEB-INF\classes\sics-database-sources.xml
\WEB-INF\web.xml

Tomcat memory settings

Create the file TOMCAT\bin\setenv.bat containing this line:

SET CATALINA_OPTS=-Xmx1024m -Xms1024m

Tomcat admin user definition

Edit the file TOMCAT\conf\tomcat-users.xml and add these lines under <tomcat-users>:

<role rolename="manager-gui" />
<user username="admin" password="admin" roles="manager-gui" />

Deploy SICS API Server

Start up Tomcat. Access the URL:
http://localhost:8080/manager/html
(You need to log in as admin/admin.)

Deploy SicsServer.war as described above.

Configure the SICS API Server Environment

As described above.

Verify Correct Startup of SICS API Server

As described above.