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

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

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 Development Kit 17 (JDK 17) or later as described above. Set the environment variable named JRE_HOME to the pathname of the directory into which you installed the JDK, e.g. C:\JDK17.

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.