After you installed the ManageCat Controller UI, you can login to the Controller using the http://localhost:8080/controller address . 


Adding License

License file name is managecat.lic and it must be put into the "Tomcat7/" folder in the installation directory.


Download Agents

To manage your servers, you have to download ManageCat Agents from the home page of the Controller UI according to your Apache Tomcat versions. Currently only Tomcat 6,7 and 8 are supported. For the Tomcat 6, only Tomcat starting from 6.0.31 and upwards are supported but it may also work in older versions.  We strongly encourage you to update your Tomcat to the latest versions. If you want to use ManageCat for versions below 6.0.31, please let us know how it works.


Installation and Configuration

Installation of the agents are very easy. Agents is distributed as a WAR archive (console.war). Deploy this WAR archive to your Tomcat which enables agent starting to communicate with the ManageCat Controller. Agent configuration parameters are specified as Java System Properties. You can also add system properties to Tomcat catalina.properties file or add as java system parameters with -Dname=value.


Required Configuration Parameters


  • com.managecat.controller.url : URL address of the controller instance. Default is http://localhost:8080/controller/

  • com.managecat.collector.url : URL address of the collector instance. Default is http://localhost:8080/collector/

  • com.managecat.console.agent.servername : User friendly server name of the agent. Must be unique among the same hosts, for example : Tomcat_7.50

  • com.managecat.console.agent.hostname : Host name of the Tomcat server. This host name is used by Controller instance to communicate with the agent.

  • com.managecat.console.agent.groupname : Group name of the Tomcat server. Every Tomcat instance must belong to a group. If this parameter is not provided, monitored server instance  will belong to a default-group.

  • com.managecat.console.agent.port :  HTTP/S port of the Tomcat server connector. This port is used by  Controller instance to communicate with the agent, for example: 8080  etc.

  • com.managecat.console.agent.contextname : Context name of the deployed agent web application. This name is used by Controller instance to communicate with the agent, for example:  console etc. If you copy downloaded "console.war"  agent archive directly into the Tomcat deploy folder, context name will  be "console". If you change the application context name, you  must provide updated context name.
  • com.managecat.console.agent.accountkey  : Your system account key. You can access your account key in 'Misc/License Information' menu item after you login into the system.


Accessing the Account Key:




After you add these parameters to your Tomcat catalina.properties or other system properties files, you have to restart Tomcat instance. 


NOTE : If you use HTTPS port of the Tomcat, you also have to configure "com.managecat.console.agent.secure=true" property.


If you successfully installed agent, you will see a log like this in your Tomcat logs:


Jan 02, 2015 10:46:17 AM com.managecat.console.common.servlet.MultiTenantConsoleContextListener$ConnectorRunnable run

INFO: Successfully registered the agent AGENT_NAME with the controller. Registration is taken : 1234 ms


Open Controller and Connect to Your Server:

  • Open controller UI from your favoite browser
  • Click "Managed Servers" link from the menu,
  • You will see the servers in the Server Groups tree view.



You can click one of the server, then you will see the server properties in the table.



You can connect to the server view with clicking the "Connect" image. The new popup window will be opened. (If your browser not allow to open popups, you must enable to open popups.)


Below is the Server UI opened after you connect to the server.



Congratulations. Your installation of the agent is successful. You can also read User Manuals to get much more infromation.