Tfactory

tFactory is a system aimed to manage Apache Tomcat™ instances in a simple, standardized and easy way via a Web Graphic User Interface (tFactory Server) that interact with agents (tFactory Agent) installed on remote servers. tFactory usually fit well in scenarios when you hate to ask questions like:

• Which ports are available in a remote server?
• Which ports does the current instances have configured on remote server?
• Can you create a new instance in less than 1 minutes with custom settigns?
• Can you give me a report of all the instances in our environment with his respective ports configuration now?
• Can you create a image template and be distributed on remote servers in less than 2 minute?
• What are we going to do if operations guys don't know how to use use/learn Chef, Puppet or other hightech cool tool that can help to manage Apache Tomcat™ intances?

Table of content

• Creator
• Features
• Installation
• User manual
• Contributing
• Documentation
• Bugs and feature requests
• Roadmap
• Copyright and license

Creator

César Hernández. @CesarHgt

Features

• Add/Remove remote servers to manage.
• Monitor remote t-factory-agent status.
• Register/Deregister instances already created on remote servers.
• Creation of new instances on remote servers with auto and manual selection of available ports.
• Instance template catalog capability.
• Monitor changes on configuration (currently server.xml file) of remote instances.
• Internationalized GUI (currently EN_US and ES_GT).

Installation

Installing tFactory Server

• Download the latest release (.war) file and deploy it on any Tomcat 7 instance. JRE 7 or latest should be used.
• Personalize the file %TOMCAT_HOME%/web-apps/t-factory-server/WEB-INF/classes/conf-files/global-configuration.properties according to your environment and needs.
• Download or copy your instance(s) template to be distribute with the tFactory server.
• Restart the tomcat instance.
• Go to your browser http://localhost:8080/t-factory-server

Installing tFactory Agent on remote servers

• Download the latest release (.war) file and deploy it on any Tomcat 7 instance. JRE 7 or latest should be used.
• To check the installation go to your browser http://localhost:8989/t-factory-agent/api/agent

User Manual

Under construction. You are welcome to improve the User Manual.

Contributing

You are wellcome to improve the software. Be sure to check: opening issues, coding standards, and notes on development code.

Documentation

You are wellcome to improve documentation. By the moment you can find enough documentation by the generation of the javaDoc of this project.

Bugs and feature requests

You can check open and closed issues.

Roadmap

This is the list of the upcoming features. (Looking forward to have your coding contribution):

• Add Persistences layer (currently all is stored in memory)
• Authentication and Authorization
• Log4j incorporation
• Configure memory parameters to instances when they are created from the tFactory server.
• Configure jmx port parameter to instances when they are created from the tFactory server.
• Datasource managements.
• GUI edition of global configurations.

Copyright and license

Code released under Apache License Version 2.0