Apache Tomcat 9.0.x Installation Guide For Windows

Apache Tomcat
9.0.x Installation
Guide for Windows
Author:
Mousumi Borah
Version:
v1.0
October 2018
Apache Tomcat 9.0.x Installation Guide for Windows
CONFIDENTIALITY STATEMENT
<Company Name> has prepared this document in good faith. Many factors outside <Company
Name>’s current knowledge or control may affect the recipient’s needs and project plans. Errors in the
document will be corrected once discovered by <Company Name>. The responsibility lies with the
recipient to evaluate the document for applicability. The information in this documentation is
proprietary, confidential and an unpublished work and is provided upon recipient’s covenant to keep
such information confidential. Personal Data supplied in this document may not be used for any
purpose other than for which it was supplied. Personal Data may not be transferred to other parties
without prior consent of <Company Name>. In no event may this information be supplied to third
parties without <Company Name>’s prior written consent.
The following notice shall be reproduced on any copies permitted to be made:
© <Company Name> 2018. All rights reserved.
<Company Name> Head Office: Telephone:
Fax:
Website:
[Type the company address] Page 2

Table of Contents
1 About This Document ........................................................................................................... 6
1.1 Intended Audience ............................................................................................................. 6
2 Document Control ................................................................................................................. 7
2.1 Document Revision History ................................................................................................ 7
2.2 Document Conventions ...................................................................................................... 7
2.3 Typographic Convention .................................................................................................... 7
2.4 Terms and Abbreviations ................................................................................................... 8
3 Overview of Apache Tomcat 9.0.x Server ............................................................................ 9
3.1 Available Versions .............................................................................................................. 9
4 Installing Apache Tomcat 9.0.x ........................................................................................... 10
4.1 Pre-Installation Checklist .................................................................................................. 10
5 Installing Apache Tomcat with the Windows Installer ......................................................... 11
6 Running Apache Tomcat 9.0.x ........................................................................................... 21
6.1 Running Apache Tomcat 9.0.x from Services .................................................................. 21
6.2 Running Apache Tomcat 9.0.x from Bin Folder ............................................................... 24
6.3 Creating a Desktop Shortcut for Apache Tomcat 9.0.x .................................................... 27
7 Accessing a JSP page Through Apache Tomcat 9.0.x Server........................................... 32
8 Uninstalling Apache Tomcat 9.0.x ...................................................................................... 33
Figures
Figure 1 Search Apache Tomcat in Google ......................................................................... 11
Figure 2 Click Latest Version Apache Tomcat ..................................................................... 12
Figure 3 Click 32-bit/64-bit Windows Service Installer ......................................................... 12
Figure 4 Click Keep .............................................................................................................. 13
Figure 5 Click Show in folder or Open ................................................................................. 13
Figure 6 Downloads Folder .................................................................................................. 13
Figure 7 Select Run as Administrator .................................................................................. 14

Figure 8 Welcome to Apache Tomcat Setup Wizard ........................................................... 15
Figure 9 Licence Agreement Screen ................................................................................... 15
Figure 10 Choose Components Screen ............................................................................... 16
Figure 11 Configuration Screen ........................................................................................... 16
Figure 12 Browse For Folder Screen ................................................................................... 17
Figure 13 Java Virtual Machine Screen ............................................................................... 17
Figure 14 Choose Install Location Screen ........................................................................... 18
Figure 15 Installing Screen .................................................................................................. 18
Figure 16 Completing Apache Tomcat Setup Screen ......................................................... 19
Figure 17 Locate the Apache Software Foundation Folder ................................................. 20
Figure 18 Apache Tomcat Version Folder ........................................................................... 20
Figure 19 Type services.msc in Run .................................................................................... 21
Figure 20 Apache Tomcat Service ....................................................................................... 22
Figure 21 Apache Tomcat Service Properties ..................................................................... 22
Figure 22 Service Control Dialog ......................................................................................... 23
Figure 23 Service Status: Running ...................................................................................... 23
Figure 24 Service Status: Running in Services Screen ....................................................... 23
Figure 25 Locate Bin Folder ................................................................................................. 24
Figure 26 Click Run as administrator ................................................................................... 25
Figure 27 Click Start ............................................................................................................. 26
Figure 28 Progress Status ................................................................................................... 26
Figure 29 Service Status: Started ........................................................................................ 27
Figure 30 Select Send toDesktop (create shortcut) ......................................................... 28
Figure 31 Select the Create shortcuts for all users checkbox ............................................. 29
Figure 32 Desktop Shortcut ................................................................................................. 29
Figure 33 Click Start ............................................................................................................. 30
Figure 34 Progress Bar ........................................................................................................ 30
Figure 35 Service Status: Started ........................................................................................ 31

Figure 36 JSP Page Display ................................................................................................ 32
Figure 37 Type Add or remove programs in Run ................................................................ 33
Figure 38 Click Uninstall ...................................................................................................... 34
Figure 39 Click Uninstall in the Message Box...................................................................... 34
Figure 40 Click Uninstall in the Uninstall Apache Tomcat screen ....................................... 35
Figure 41 Progress Bar in the Uninstalling Screen .............................................................. 35
Figure 42 Click Yes in the Apache Tomcat Uninstall Screen .............................................. 36
Figure 42 Click Close in the Uninstallation Complete Screen ............................................. 36
Tables
Table 1: Document Revision History ...................................................................................... 7
Table 2: Document Conventions ............................................................................................ 7
Table 3: Typographic Conventions ........................................................................................ 7
Table 4: Terms and Abbreviations Used in the Document .................................................... 8
Table 5: Terms and Abbreviations Used in the Document .................................................. 16

1 ABOUT THIS DOCUMENT
This document is intended to familiarize you with the installation of Apache Tomcat® 9.0.x on
Windows and to provide information necessary to obtain the desired functionality as well as utilize the
available features in the best possible way. In addition, this manual has all the information needed to
install and uninstall the Apache Tomcat 9.0.x.
1.1 Intended Audience
 This document is intended to guide technical staff such as developers and technical architects
who will be installing Apache Tomcat 9.0.x on Windows.
 Various code samples are included in this document and these are written in JSP.

2 DOCUMENT CONTROL
2.1 Document Revision History
Please ensure that appropriate version control is maintained to allow efficient and consistent review
by all Parties for this document.
Table 1: Document Revision History
Version Date Reason / Modification Revised by

1.0 22 October 2018 Created the initial draft. Mousumi Borah
2.2 Document Conventions
The different conventions used in this document are explained in the following table:
Table 2: Document Conventions
Name Icon Description

Note This highlights important information or information of interest
needed to be successful in accomplishing a procedure or to
understand a concept.
Caution/Warning The Important icon highlights areas where potential problems

can arise, or occur, to help you avoid damage or loss of data.
2.3 Typographic Convention
Table 3: Typographic Conventions
Convention Description
Code snippet Used for code fragments and parameter names.
Bold font Buttons and tabs that needs to be selected.
Keyboard shortcuts Keyboard shortcuts are shown in FULL CAPS.
Italics Used to emphasise text, to show example values or inputs.
Underlined Blue Used for URL links to external Web pages or documents. If you
click on text in this style, you will be linked to an external
document or Web page.
Blue Text Used for cross references to other sections within this document.
If you click on text in this style, you will be taken to another part of
this document.

2.4 Terms and Abbreviations
The different terms and abbreviations used in this document are explained in the following table.
Table 4: Terms and Abbreviations Used in the Document
Terms / Abbreviations Description / Expansion

3 OVERVIEW OF APACHE TOMCAT 9.0.X SERVER
The Apache Tomcat software is the flexible, powerful and world's most widely used web application
server and servlet container. Apache Tomcat is used to power everything from simple one server
sites to large enterprise networks across a diverse range of industries and organizations. Apache
Tomcat, Tomcat, Apache, the Apache feather, and the Apache Tomcat project logo are trademarks of
the Apache Software Foundation.
Tomcat is an application server from the Apache Software Foundation (ASF) that executes
Java servlets, JavaServer Pages (JSP), Java EL, and WebSocket to provide a "pure Java" HTTP web
server environment. Users can also access resources for configuration and use extensible markup
language (XML) to configure projects.
The original author of Apache Tomcat is James Duncan Davidson and initial release was on 1999.
It has mature, reliable, configurable, highly extensible, fully open codebase and fast start-up.
3.1 Available Versions
The major Tomcat versions are as below.
 Tomcat 9.0.x
 Tomcat 8.5.x
 Tomcat 8.0.x
 Tomcat 7.0.x
 Tomcat 6.0.x
 Tomcat 5.5.x
 Tomcat 4.1.x
 Tomcat 3.3.x
The following versions are no longer supported.
 Tomcat 3.0.x
 Tomcat 3.1.x
 Tomcat 3.2.x
 Tomcat 3.3.x
 Tomcat 4.0.x
 Tomcat 4.1.x
 Tomcat 5.0.x
 Tomcat 5.5.x

4 INSTALLING APACHE TOMCAT 9.0.X
In this guide, we will learn how to install Apache Tomcat 9.0.x, the most recent stable Tomcat branch
as of October 2018 on Widnows machines through 32-bit/64-bit Windows Service Installer. Apache
Tomcat 9.0.x is builds on Tomcat 8.0.x and 8.5.x and implements the JSP 2.3, Servlet 4.0,
WebSocket 1.1, EL 3.0 and JASPIC 1.1 specifications. It required by Java EE 8 platform. In addition
to this, it includes the following major enhancements:
 Support for TLS virtual hosting (SNI)

 Support for using OpenSSL for TLS support with the JSSE connectors (NIO and NIO2)
 Support for HTTP/2 (requires either running on Java 9 (since Apache Tomcat 9.0.0.M18) or
the Tomcat Native library being installed)
There are several ways to set up Apache Tomcat 9.0.x for running on different platforms such as
Windows and Linux. Windows users can either download the 32 or 64-bit binary distribution and
install Tomcat manually, or use the Windows installer. The Apache Tomcat 9.0.x version Windows
installer includes both 32 and 64-bit distributions, and attempts to select the appropriate distribution
based on the JDK you have installed.
It is recommended to use the Windows installer package installer as it includes both 32- and 64-bit
distributions of Apache Tomcat 9.0.x and will automatically choose the appropriate package for your
system. This method is easy and does not require much assistance and installer will guide you
through the entire process. Other set up are beyond the scope of this document. We encourage you
to refer to the below link for installation on the other downloads such as binary downloads.
https://tomcat.apache.org/download-90.cgi
The following sections explain the installation steps in detail.
4.1 Pre-Installation Checklist
 Operating system:
 Windows 10
 Windows 8.1
 Windows 8
 Windows 7
 Windows Server 2012
 Windows Server 2008 R2
 Software: Java Runtime Enterprise Environment that conforms to JRE 1.1 or later.Compatible
JDKs for many platforms (or links to where they can be found) are available at.
http://www.oracle.com/technetwork/java/javase/downloads/index.html

5 INSTALLING APACHE TOMCAT WITH THE WINDOWS INSTALLER
This section describes procedure for downloading and installing Apache Tomcat 9.0.x with the
Windows Installer.
Before installing Apache Tomcat 9.0.x make sure you have JDK or Java Development Kit installed
and configured. Once you have JDK up and running please go ahead to install Apache Tomcat 9.0.x.
Perform these steps to download and install Apache Tomcat 9.0.x with the Windows Installer.
1. In Google search engine, search Apache Tomcat and navigate to apache.tomcat.org.
Figure 1 Search Apache Tomcat in Google
2. In the left side menu, under the Download section, click on the latest version Apache Tomcat. For
example, Tomcat 9.

Figure 2 Click Latest Version Apache Tomcat
3. Scroll down and click 32-bit/64-bit Windows Service Installer.
Figure 3 Click 32-bit/64-bit Windows Service Installer
4. The below message is displayed. Click Keep.

Figure 4 Click Keep
5. Click Show in folder or Open. Clicking Open directly initiates the download.
Figure 5 Click Show in folder or Open
6. Clicking Show in folder navigates to the Downloads folder where the installation file is located.
Figure 6 Downloads Folder
7. Right click and select Run as administrator.

Figure 7 Select Run as Administrator
8. Click Install in the next dialog box and the Welcome to Apache Tomcat Setup wizard is
displayed. Click Next.

Figure 8 Welcome to Apache Tomcat Setup Wizard
9. Click I Agree in the License Agreement screen.
Figure 9 Licence Agreement Screen
10. In the Choose Components screen, select the Full option from the Select the type of install drop
down. Click Next.

Figure 10 Choose Components Screen
11. In the Configuration screen, define the basic Tomcat configuration. Click Next.
Figure 11 Configuration Screen
The following table lists the basic configuration fields and their description of parameters.
Table 5: Terms and Abbreviations Used in the Document
Fields Description

Fields Description
Server Shutdown Port Indicates the server shutdown port.
HTTP/1.1 Connector Port Indicates the HTTP/1.1 connector port.
AJP/1.3 Connector Port Indicates the AJP/1.3 connector port.
Windows Service Name Indicates the Windows service name.
Create shortcuts for all Indicates whether to create shortcuts for all users.
users
Tomcat Administrator Login Optional. Indicates Tomcat administrator login credentials.

(optional)
User Indicates user name.
Name
Password Indicates password.
Roles Indicates roles. For example, admin-gui, manager-gui.
12. Click Next to save the changes.
13. In the Java Virtual Machine page, click button to open the Browse For Folder dialog box.
Select the desired Java folder and Click OK.
Figure 12 Browse For Folder Screen
14. Click Next.
Figure 13 Java Virtual Machine Screen

15. In the Choose Install Location screen, select the Destination Folder location by clicking on the
Browse… button. Click Install.
Figure 14 Choose Install Location Screen
16. The Installing screen displays the installation progress.
Figure 15 Installing Screen

17. In the Completing Apache Tomcat Setup screen, click Finish.
Figure 16 Completing Apache Tomcat Setup Screen
18. Installation is complete.

19. To check the installation, open C:\Program Files (x86) and locate the Apache Software
Foundation folder.

Figure 17 Locate the Apache Software Foundation Folder
20. Under this folder the Apache Tomcat version folder is displayed.
Figure 18 Apache Tomcat Version Folder

6 RUNNING APACHE TOMCAT 9.0.X
Once installed, you can run Apache Tomcat 9.0.x from these areas.
 Services
 Bin folder of Apache Software Foundation folder
 Creating a desktop shortcut for Apache Tomcat 9.0.x
Running the Windows installer automatically installs Apache Tomcat as a Windows Service. Windows
Services are processes that are owned by the system, and work in the background without user
interference. Running Apache Tomcat 9.0.x as a service allows you to start it automatically on login.
6.1 Running Apache Tomcat 9.0.x from Services
Perform these steps to run Apache Tomcat 9.0.x from Services.
1. Open Run by clicking Windows key+R and type services.msc.
Figure 19 Type services.msc in Run
2. In the Services screen, you can find the Apache Tomcat service. By default is it is set to
Automatic in the Startup Type.

Figure 20 Apache Tomcat Service
3. Right click and select Properties.

4. Select the Manual option from the Startup type drop down. Click Start.
Figure 21 Apache Tomcat Service Properties
5. The service is started and the progress bar indicates its progress.

Figure 22 Service Control Dialog
6. The service status is displayed as Running. Click OK.
Figure 23 Service Status: Running
7. In the Services screen, the Startup Type is Manual and Status is Running.
Figure 24 Service Status: Running in Services Screen

6.2 Running Apache Tomcat 9.0.x from Bin Folder
There is another way of opening Tomcat Service instead of going to the Services.
Perform these steps to run Apache Tomcat 9.0.x from Bin folder.
1. Locate the Bin folder in the C:\Program Files (x86)Apache Software Foundation<Apache
Tomcat version>.
Figure 25 Locate Bin Folder

2. Right click the Tomcat<version name>w.exe file and select Run as administrator.
Figure 26 Click Run as administrator

3. The Apache Tomcat <version name> Properties dialog window is displayed. Click the Start
button to start the Apache Tomcat service.
Figure 27 Click Start
4. The Apache Tomcat service is started and the progress bar indicates its progress.
Figure 28 Progress Status
5. The Service Status is displayed as Started. Click OK.

Figure 29 Service Status: Started
6.3 Creating a Desktop Shortcut for Apache Tomcat 9.0.x
To make the Apache Tomcat 9.0.x start process much easier, you can create a desktop shortcut icon.
Perform these steps to create a desktop shortcut.
1. Right click the Tomcat<version name>w.exe file inside the Bin folder and select Send
toDesktop (create shortcut).

Figure 30 Select Send toDesktop (create shortcut)
2. Alternatively, select the Create shortcuts for all users checkbox while installing the Apache
Tomcat. Refer to section Installing Apache Tomcat 9.0.x.

Figure 31 Select the Create shortcuts for all users checkbox
3. The desktop shortcut is created.
Figure 32 Desktop Shortcut
4. To start it, right click and select Run as an administratror.

5. The Apache Tomcat <version name> Properties screen is displayed. Click Start.

Figure 33 Click Start
6. The progress bar displays the service start progress.
Figure 34 Progress Bar
7. The Service Status is displayed as Started. Click OK.

Figure 35 Service Status: Started

7 ACCESSING A JSP PAGE THROUGH APACHE TOMCAT 9.0.X SERVER
If your installation is successful, you should be able to use your web browser to access a JSP page at
http:/localhost:8080/.
To run a JSP in Apache Tomcat 9.0.x in a Windows environment, perform these steps.
1. In your text editor, type a simple JSP page. The below code snippet displays the code for
displaying the current date.
<%@ page language="java" contentType="text/html"%>

<%@ page import="java.text.*,java.util.*" %>
<html>
<head>
<title>Date JSP</title>
</head>
<% SimpleDateFormat sdf=new SimpleDateFormat("MM/dd/yyyy"); %>
<body>
<h1>Welcome to Tomcat! Today is <%= sdf.format(new Date()) %></h1>
</body>
</html>
2. Save your file as DateJSP.jsp.

3. Copy your file to this location: C:\Program Files (x86)\Apache Software Foundation\Tomcat
9.0\webapps\ROOT or create a folder under webapps folder. For example, app1.
4. Start Apache Tomcat 9.0.x.
5. Start your browser if it is not already running.
6. In the address area of the browser, type localhost:8080/DateJSP.jsp and submit that address to
the browser.
7. The output of your JSP page will be displayed.
Figure 36 JSP Page Display

8 UNINSTALLING APACHE TOMCAT 9.0.X
This section describes the procedure to uninstall Apache Tomcat 9.0.x.
Perform the following steps to uninstall Apache Tomcat 9.0.x.
1. Open Run by clicking Windows key+R and type Add or remove programs.
Figure 37 Type Add or remove programs in Run
2. The Apps & Features screen is displayed. Locate Apache Tomcat 9.0 and click Uninstall.

Figure 38 Click Uninstall
3. The below message is displayed. Click Uninstall.
Figure 39 Click Uninstall in the Message Box
4. The Uninstall Apache Tomcat screen is displayed. Click Uninstall.

Figure 40 Click Uninstall in the Uninstall Apache Tomcat screen
5. The Uninstalling screen displays the progress bar which indicates uninstallation progress.
Figure 41 Progress Bar in the Uninstalling Screen
6. The Apache Tomcat Uninstall dialog box prompts to remove all files from the Apache Tomcat 9.0
directory. Click Yes.

Figure 42 Click Yes in the Apache Tomcat Uninstall Screen
7. The Uninstallation Complete screen displays the uninstallation complete message and click
Close.
Figure 43 Click Close in the Uninstallation Complete Screen

Apache Tomcat 9.0.x Installation Guide For Windows

Uploaded by

Document Informationclick to expand document informationApache Tomcat 9.0.x Installation Guide for Windows

Document Informationclick to expand document information

Copyright:

Available Formats

Apache Tomcat 9.0.x Installation Guide For Windows

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Apache Tomcat 9.0.x Installation Guide For Windows

Uploaded by

Copyright:

Available Formats

Apache Tomcat

The following notice shall be reproduced on any copies permitted to be made:

© <Company Name> 2018. All rights reserved.

<Company Name> Head Office: Telephone:

[Type the company address] Page 2

1 About This Document ........................................................................................................... 6

1.1 Intended Audience ............................................................................................................. 6

2 Document Control ................................................................................................................. 7

2.1 Document Revision History ................................................................................................ 7

2.2 Document Conventions ...................................................................................................... 7

2.3 Typographic Convention .................................................................................................... 7

2.4 Terms and Abbreviations ................................................................................................... 8

3 Overview of Apache Tomcat 9.0.x Server ............................................................................ 9

3.1 Available Versions .............................................................................................................. 9

4 Installing Apache Tomcat 9.0.x ........................................................................................... 10

4.1 Pre-Installation Checklist .................................................................................................. 10

5 Installing Apache Tomcat with the Windows Installer ......................................................... 11

6 Running Apache Tomcat 9.0.x ........................................................................................... 21

6.1 Running Apache Tomcat 9.0.x from Services .................................................................. 21

6.2 Running Apache Tomcat 9.0.x from Bin Folder ............................................................... 24

6.3 Creating a Desktop Shortcut for Apache Tomcat 9.0.x .................................................... 27

7 Accessing a JSP page Through Apache Tomcat 9.0.x Server........................................... 32

8 Uninstalling Apache Tomcat 9.0.x ...................................................................................... 33

Figure 1 Search Apache Tomcat in Google ......................................................................... 11

Figure 2 Click Latest Version Apache Tomcat ..................................................................... 12

Figure 3 Click 32-bit/64-bit Windows Service Installer ......................................................... 12

Figure 4 Click Keep .............................................................................................................. 13

Figure 5 Click Show in folder or Open ................................................................................. 13

Figure 6 Downloads Folder .................................................................................................. 13

Figure 7 Select Run as Administrator .................................................................................. 14

[Type the company address] Page 3

Figure 8 Welcome to Apache Tomcat Setup Wizard ........................................................... 15

Figure 9 Licence Agreement Screen ................................................................................... 15

Figure 10 Choose Components Screen ............................................................................... 16

Figure 11 Configuration Screen ........................................................................................... 16

Figure 12 Browse For Folder Screen ................................................................................... 17

Figure 13 Java Virtual Machine Screen ............................................................................... 17

Figure 14 Choose Install Location Screen ........................................................................... 18

Figure 15 Installing Screen .................................................................................................. 18

Figure 16 Completing Apache Tomcat Setup Screen ......................................................... 19

Figure 17 Locate the Apache Software Foundation Folder ................................................. 20

Figure 18 Apache Tomcat Version Folder ........................................................................... 20

Figure 19 Type services.msc in Run .................................................................................... 21

Figure 20 Apache Tomcat Service ....................................................................................... 22

Figure 21 Apache Tomcat Service Properties ..................................................................... 22

Figure 22 Service Control Dialog ......................................................................................... 23

Figure 23 Service Status: Running ...................................................................................... 23

Figure 24 Service Status: Running in Services Screen ....................................................... 23

Figure 25 Locate Bin Folder ................................................................................................. 24

Figure 26 Click Run as administrator ................................................................................... 25

Figure 27 Click Start ............................................................................................................. 26

Figure 28 Progress Status ................................................................................................... 26

Figure 29 Service Status: Started ........................................................................................ 27

Figure 30 Select Send toDesktop (create shortcut) ......................................................... 28

Figure 32 Desktop Shortcut ................................................................................................. 29

Figure 33 Click Start ............................................................................................................. 30

Figure 34 Progress Bar ........................................................................................................ 30