README

This is a Command Line Interface for Tomcat 7.0, which requires Java 6.
This library might also work for other versions of Tomcat running on 
Java 6.

Decompress the archive:

  tar -zxvf tomcat-cli-$VERSION.tar.gz
  cd tomcat-cli-$VERSION
  
The archive contains a single script and two jar files, one each of
the source code and the compiled classes.

  ./tomcat-cli.sh help
  ./tomcat-cli.sh help <command>

Connect to the local JMX connector on the specified process:
  ./tomcat-cli.sh status --pid:<PID>

Connect to the local JMX connector using the specified url:
  ./tomcat-cli.sh status --url:<jmxurl>

Connect to the localhost JMX connector on the specified port:
  ./tomcat-cli.sh status --port:<portnum>

Inject the Java 6 Management Agent into the specified process:
  ./tomcat-cli.sh status --inject:<PID>
  
Connect to a process by guessing which is Tomcat:
  ./tomcat-cli.sh status --guess

Extended information can be displayed by adding the following switches to the status command:

 --webapps --connectors --threads --verbose 



#########################################################################################################
# SAMPLE OUTPUT FROM STATUS

 tomcat-cli.sh status -i:26857 -H:www -w

 Connected to Apache Tomcat/6.0.26 [26857@localhost, uptime:1d 8h 58m 19s 603ms]
 Server: Catalina
 Service:Catalina
  Engine:Catalina [defaultHost=www, jvmRoute=tomcat1]
   Host:www
    application ---- path ------------ state sessions - startup ------------ started
    help             /help             ok    7          84ms     2010-09-02 12:45:06
    ROOT             /                 ok    224        613ms    2010-09-02 12:45:05
    shop             /shop             ok    12         232ms    2010-09-02 12:45:06
    registration     /registration     ok    4          151ms    2010-09-02 12:45:04
    account-old                        stopped!                                        
    account          /account          ok    2          70ms     2010-09-02 12:45:07