Skip to main content

By clicking Submit, you agree to the developerWorks terms of use.

The first time you sign into developerWorks, a profile is created for you. Select information in your profile (name, country/region, and company) is displayed to the public and will accompany any content you post. You may update your IBM account at any time.

All information submitted is secure.

  • Close [x]

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerworks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

By clicking Submit, you agree to the developerWorks terms of use.

All information submitted is secure.

  • Close [x]

developerWorks Community:

  • Close [x]

Install and configure a development Web server in UNIX

Build a fast, functional, and free Web server while jump-starting your UNIX skills

Matthew Skamser, Software Consultant, Solution Destination, Inc.
author photo
Matthew L. Skamser is an IT consultant and Studio B author with more than 10 years of experience architecting, administering, troubleshooting, and tuning Web applications in enterprise server environments. His clients have included IBM, Lockheed Martin/United States Air Force, and WorldBank. He has multiple IBM Certified Systems Expert certifications and received his bachelor's degree in Computer Information Systems from Northern Arizona University. You can reach Matthew at

Summary:  Get a detailed, step-by-step approach to installing and configuring a development or test Apache Tomcat server. Along the way, pick up helpful tips on how to build and administer your Web or application server in a UNIX® environment.

Date:  15 Jul 2008
Level:  Intermediate PDF:  A4 and Letter (358 KB)Get Adobe® Reader®

Activity:  29066 views

Setting up Tomcat Web Application Manager

The Tomcat Web Application Manager provides many capabilities to help manage your Web applications. It allows you to deploy and "undeploy" Web applications in multiple ways, list applications, reload them, and even stop and start them.

Grant specific user access

To implement Tomcat Web Application Manager, you must first grant access to a specific user in the tomcat-users.xml file. To do so, use the code in Listing 9.

Listing 9. Grant access to Tomcat Web Application Manager by adding a user and role
vi tomcat-users.xml
Add these two lines below in between the two <tomcat-users> tags
	<role rolename="manager"/>
	<user username="tomcat1" password="test1234" roles="manager"/>

Just in case you're wondering, the above user and password are completely arbitrary. You do not need to create that user with the password on your UNIX server and can set these to whatever you wish. You will, however, use that information to log in to the management console.

For additional security, limit the access to that tomcat-users.xml file to only the owner of the file. To do so, you must set the permissions at 700 or below—for example:

# chmod 600 tomcat-users.xml

Restart the Tomcat server

For the changes above to take effect, you must restart your Tomcat server. To do so, use the code in Listing 10.

Listing 10. Restart your Tomcat server
./ ;tail -f ../logs/catalina.out

You should see something similar to this when you tail your catalina.out log file:

May 15, 2008 4:08:12 PM org.apache.jk.server.JkMain start
INFO: Jk running ID=0 time=0/74  config=null
May 15, 2008 4:08:12 PM org.apache.catalina.startup.Catalina start
INFO: Server startup in 6271 ms

Open the Tomcat Web Application Manager console

Go back to your Tomcat management console. Click the Tomcat Manager link in the Administration section of the left navigation pane. When successful, you will see the a window similar to Figure 4.

Figure 4. Tomcat Web Application Manager startup page
Tomcat Web Application Manager

Tomcat also has a status application, which displays the status of the Tomcat server, including memory utilization of the JVM and the number of threads. You can access this very useful tool by clicking Server Status at the top right-hand side of the Tomcat Web Application Manger.

7 of 11 | Previous | Next


Zone=AIX and UNIX
TutorialTitle=Install and configure a development Web server in UNIX