This Confluence has been LDAP enabled, if you are an ASF Committer, please use your LDAP Credentials to login. Any problems file an INFRA jira ticket please.

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Preface

This page addresses various issues related to running Tomcat on a Windows platform. Please see the UsefulLinks for more links related to Windows.

Questions

  1. Why do I get Out of Environment Space?
  2. When I start up tomcat (or when it is running), I get the error java.lang.IllegalMonitorStateException: current thread not owner
  3. Can I turn off case sensitivity?
  4. Can I use NTLM authentication?
  5. I want to redeploy web applications, how do I prevent resources from getting locked?
  6. Can I use UNC paths?
  7. Why can't Tomcat see my mapped drive when running as a service?
  8. Why aren't access logs showing up in Tomcat on Vista?
  9. Why do I get a "HTTP/1.x 400 No Host matches server name" error when I change the "webapps" folder in Tomcat on Vista?
  10. How do I add or customize a Windows Service for Tomcat?
  11. What are tomcat6w.exe/tomcat6.exe (or tomcat7w.exe/tomcat7.exe etc..) ?

Answers

Anchor
Q1
Q1

Why do I get Out of Environment Space?

Check the Tomcat README, and this link

Anchor
Q2
Q2

When I start up tomcat (or when it is running), I get the error java.lang.IllegalMonitorStateException: current thread not owner

That weird issue was observed many years ago and now is a history. See the Tomcat Bug Report #13723 and Sun Bug Parade report #4776385 for the answer.

Anchor
Q3
Q3

Can I turn off case sensitivity?

It is possible in Tomcat 6 and earlier, but not recommended.

Anchor
Q4
Q4

Can I use NTLM authentication?

Yes.

Anchor
Q5
Q5

I want to redeploy web applications, how do I prevent resources from getting locked?

Most locking issues will occur with JARs from /WEB-INF/lib, and are usually caused by access through URLs. Tomcat has mechanisms to allow avoiding locking.

...

There is another lock prevention mechanism in Tomcat 5.5 (antiResourceLocking attribute), which will cause the web application files to be copied to the temp folder and run from this location. This has a larger impact on web application startup times, but obviously prevents locking on all resources of the web application. This also allows more flexible management operations as none of the web application resources will be locked, even while the web application is running (as a special note, when making changes to JSPs without reloading the application, the changes have to be duplicated to the path where the web application resources have been copied in the temp folder).

Anchor
Q6
Q6

Can I use UNC paths?

Yes. Make sure that the user that Tomcat is running as is able to access the path. This is particularly important when running Tomcat as a service since the local service account will not have the necessary permissions.

Anchor
Q7
Q7

Why can't Tomcat see my mapped drive when running as a service?

The mapped drives are part of a user's profile and they are not used when running as a service. You should be OK with UNC paths.

Anchor
Q8
Q8

Why aren't access logs showing up in Tomcat on Vista?

By default, the Tomcat Windows Service installer attempts to place Tomcat inside the "Program Files" folder. Default Vista folder permissions cause various logging functions (though mysteriously not every log function) to fail silently. It is best to change Tomcat's install folder to something like "C:\Tomcat". This issue can be hard to spot because by default the access logs are not enabled and the example webapps work just fine.

Anchor
Q9
Q9

Why do I get a "HTTP/1.x 400 No Host matches server name" error when I change the "webapps" folder in Tomcat on Vista?

By default, the Tomcat Windows Service installer attempts to place Tomcat inside the "Program Files" folder. Default Vista folder permissions conflict with the contents of the "webapps" folder, can case a blank page to come up when attempting to access the webapp. By using a HTTP Header inspector like "Live HTTP Headers" you can see a slightly more descriptive error message. It is best to change Tomcat's install folder to something like "C:\Tomcat". This issue can be hard to spot because by default the example webapps work just fine.

Anchor
Q10
Q10

How do I add or customize a Windows Service for Tomcat?

Tomcat uses the Apache Commons Daemon. You can read its documentation at http://commons.apache.org/daemon/procrun.html As a short example, you can create a new Windows Service with the full version number in its name like this:

...

See also the service.bat file that comes in the *windows<arch>.zip distributives of Tomcat.

Anchor
Q11
Q11

What are tomcat6w.exe/tomcat6.exe (or tomcat7w.exe/tomcat7.exe etc..)?

Questions on this topic come regularly at various levels. So this is a longish explanation meant basically for real Tomcat/Windows beginners. Apologies in advance for any shortcuts and approximations. You can sort this out by yourself according to your own needs.

...

The Tomcat Service installer for Windows normally bundles all three versions of the service wrapper and selects one for you automatically, according to the JRE instance that you selected during installation. The ZIP distributives of Tomcat contain only one version of the program, so you have to select the correct distributive to download (*-windows-x86.zip, *-windows-x64.zip or *-windows-i64.zip).

CategoryFAQ