Hot redeployment of a Web application on Windows can sometimes fail because of the way that file system locking works on Windows platforms.

About this task

Hot redeployment might also fail when you stop or undeploy a Web application on Windows. The problem can occur when you are using the user interface, or the tcsadmin command-line interface.

Setting the antiJARLocking and antiResourceLocking attributes to true forces tc Runtime to copy files, rather than read them in place. If you try to copy in a new .jsp file directly, tc Runtime does not pick it up.

You can set these two properties in the context.xml file of the application itself, or use this procedure to set the properties in the context.xml file for the entire tc Runtime instance.

Procedure

  1. Update the CATALINA_BASE/conf/context.xml file of the tc Runtime instance and set the two attributes of the <Context> element that are listed below to true.

    Option

    Description

    antiJARLocking

    When set to true, the tc Runtime classloader takes extra measures to avoid JAR file locking when resources are accessed inside JARs through URLs. This action affects the startup time of applications, but is useful on platforms (such as Windows) or configurations in which file locking can occur.

    antiResourceLocking

    :When set to true, tc Runtime prevents any file locking. This action affects startup time of applications significantly, but allows full Web application hot redeploy on platforms (such as Windows) or configurations in which file locking can occur.

    The following context.xml snippet shows how to specify the attributes. Only the relevant part of the file is shown.

    <Context antiJARLocking="true" antiResourceLocking="true">
    
           <WatchedResource>...
  2. Restart the tc Runtime instance for the change to take effect.