Stop Apache Tomcat using JMX

Question

Is there any way to stop Apache Tomcat using Java and JMX?

I suppose that there is a a managed bean which can be used for this?

Answer 1

By its own the Tomcat does not come with the ability to shutdown operation run from the JMX, basically it is not secure !!! But if you really need it you need to create your own ShutdownMBean. It is very easy and straight forward process of creating the MBean and registering it at application deploy. Lets first create the ShutdownMBean whch will have name and will expose a single doShutdown() operation.

public interface ShutdownMBean {
    void doShutdown();
    String getName();
}

The implementation is easy as well, just send SHUTDOWN signal to default shutdown port of Tomcat.

public class Shutdown implements ShutdownMBean{

    @Override
    public void doShutdown() {
        try {
            Socket clientSocket = new Socket("localhost", 8005);
            clientSocket.getOutputStream().write("SHUTDOWN".getBytes());
            clientSocket.getOutputStream().close();
            clientSocket.close();
        } catch (IOException e) {
        }
    }

    @Override
    public String getName() {
        return "Shutdown JMX Hook";
    }

}

And at the end just register the ShutdownMBean after context initialization (I assume you are using Tomcat 7+):

@WebListener
public class ShutdownListener implements javax.servlet.ServletContextListener{

    @Override
    public void contextDestroyed(ServletContextEvent arg0) {

    }

    @Override
    public void contextInitialized(ServletContextEvent arg0) {
        try {
            ShutdownMBean shutdownMBean = new Shutdown();
            MBeanServer server = ManagementFactory.getPlatformMBeanServer();
            ObjectName name = new ObjectName("com.example:type=Shutdown");
            server.registerMBean(shutdownMBean, name);
        } catch (InstanceAlreadyExistsException | MBeanRegistrationException | NotCompliantMBeanException | MalformedObjectNameException e) {
        }
    }
}

Thats it, just deploy your app, connect to your Tomcat using JConsole and you will find doShutdown operation under com.example group