Create a Server

Topics marked with * relate to features available only in vFabric Hyperic.

This page has general instructions for creating a platform in Hyperic.

Note: For information about creating a server using the HQApi see HQApi resource command in Web Services API.

When to Create a Server Manually

Most server types that Hyperic manages are auto-discovered, rather than manually added to inventory on the New Server page.

You may need to create a server manually under some circumstances, for instance, if:

  • The plugin that manages the server does not support auto-discovery of server instances.

  • The auto-discovery method used by the plugin failed, because the entry it looked for in the process table or Windows registry was not found. For example, the server's name in the process list is different than the plugin uses to detect server instances.

Need to Know What a "Server" Is?

See Resources, Resource Types and Inventory Types for a more information.

Create a Server

  1. Use Browse > Resources > Platforms to navigate to the platform to which you wish to add a server.

  2. Select New Server from the Tools menu.

    • The New Server page appears.

  3. On the New Server page enter:

    • Name---The name of the server

    • Description---(optional) A description of the server

    • Server Type---Select the server type for the new resource.

    • Install Path---If there are other servers of the type you are creating on the current platform, make sure that the installation path you define for the new server instance is unique, and not the same as any of the other servers of the same type. For autodiscovered servers, the plugin sets the value of the Install Path property, and uses it as the basis for the resource's autoinventory identifier. Note that if you create a server manually, you must specify the Install Path property, but it need not be the actual installation path for the server. The only requirement is that all servers of the same resource type on the same platform have unique Install Path property values.

  4. Click OK.

Inventory Page for a New Server

The screenshot below is the Inventory page for a server that is newly added to inventory. It contains these sections:

  • General Properties---The server's Owner is the username for the Hyperic account that created the server. 

  • Type and Host Properties---The Host Platform is the name of the platform to which you added the server.

  • Services---This section of the page lists services discovered in the server instance.  For an new server instance, no services appear until any required configuration properties are defined.  You can manually add services to a server, but it is uncommon.

  • Groups Containing this Resource---Click Add to List in this section if you wish to assign the server to one or more resource groups.

  • Configuration Properties---The properties in the section vary, depending on the resource type of the server you are created.  

    • Shared For some server types, you need to supply resource connection or authorization credential data in this section in order to monitor and manage the resource.

    • Monitoring---If the server type supports log or configuration tracking, you can configure tracking options in this section.

    • Control---If the server type supports control actions, you configure associated options in this section.


Configure Server for Monitoring

After creating the new server, you may need supply values for one or more configuration properties. See the resource's Inventory page for configuration options and requirements.