3. Configuring and Monitoring tc Runtime Instances Using Hyperic HQ

vFabric Hyperic is a comprehensive enterprise application management tool. It manages and monitors all instances of vFabric tc Server on any computer, all Spring-powered applications, and a variety of other non-SpringSource platforms and application servers such as Apache Tomcat. HQ provides a single console with powerful dashboards from which you can easily check the health of your applications. With Hyperic HQ, you can:

In addition to the preceding tc Runtime-related actions, Hyperic HQ performs these standard tasks:

Getting Started with tc Server describes how to install and use Hyperic and provides a tutorial that demonstrates the most common tasks.

When using the HQ user interface, click on the Help link at the top of most pages for detailed online-help. You can also browse the vFabric HQ Documentation for additional information.

3.1 User Permissions Required to Use the tc Server HQ Plugin Features

For simplicity, it is often assumed in this documentation that you log in to the HQ user interface as the HQ super-user (hqadmin) when you want to manage a tc Runtime instance. This is not required, of course. You can also log in as a non-super user and still use the tc Server HQ plugin features, as long as the user has the correct permissions.

In HQ, users are assigned roles, which in turn are assigned permissions, such as View and Control. For general information about what each permission means with respect to server resources (such as a tc Runtime instance) in HQ, see Role Permissions in HQ Enterprise in the Hyperic documentation. For general information about the default users in HQ and creating new ones, see HQ User Accounts.

The following table describes the additional effects that some of the HQ permissions have on the tc Server HQ plugin features. Use this table to determine which role you should assign a user that will be managing tc Runtime instances.

Table 3.1. HQ Permission Effects on tc Server HQ Plugin Features

PermissionAdditional Effect on tc Server HQ Plugin Features
ViewAllows the user to:
  • View the deployed Web applications in the Views > Application Management tab.

  • View the current configuration of a tc Runtime instance in the Views > Server Configuration tab.

ModifyAllows the user to:
  • Update the fields in the Views > Server Configuration tab and then push the data to the configuration files associated with the tc Runtime instance, such as server.xml.

  • Use the application lifecycle commands of the Views > Application Management tab to start, stop, reload, or undeploy a Web application.

ControlAllows the user to use the commands in the Control tab to start, stop, and restart a tc Runtime instance.