Defining Extended Info

This page reviews the configuration of extended info templates.
{toc:minLevel=4|maxLevel=5|printable=false}

h4. Configuring Extended Host Info Templates

Extended host and service information entries are basically used to make the output from the status, statusmap, statuswrl, and extinfo CGIs look good. They have no effect on monitoring and are completely optional. For example, under _Generating Extended Host Info Templates from Logos for the Nagios GUI's_ below, the figure shows a server icon next to each Host. This icon image is designated in the _Extended Host Info Template_ as server.png in the _Status Map Image_ property field.

h5. Defining Template Properties

# Select *Hosts* from the _Configuration_ page.
# Expand the *Host extended info* drop-down menu.
# Select *New*.
# In the *Extended Host Info Template Properties* screen described in the table below.
# Select *Add* to add the new extended host info template.
# You will be prompted that the template has been saved. Select *Continue*. {Note}To copy an existing template select *Copy* from the Extended Host Info Template options. This will let you name and edit the copied properties for a new template. To modify or delete a template select *Modify*. You will then be able to edit and *Save* a modified template. Select *Delete* to remove a selected template, *Rename* to change the name, or *Cancel* to exit out without any changes.{Note}

h5. How Do I Apply an Extended Host Info Template to a Host Profile?

You can apply an extended host info template within a host profile which will add the template properties to all hosts associated with the host profile.
# Select *Profiles* from the _Configuration_ page.
# Expand the *Host Profiles* option.
# Select *Modify*, (for new host profiles follow the same procedure).
# Select the *Host Profile* to add an extended host info template.
# Select the drop-down box for *Extended Host Info Template* and select an existing template.
# Select *Save*.
# Next you can assign hosts to use this host profile with the extended host info template by selecting the *Assign Hosts* tab. After adding the hosts make sure you *Save* your changes. As a last step make sure you select the *Apply* tab, check the *Apply Detail to Hosts* and select *Apply*.
\\
{Note}Assigning a host profile directly from within the hosts option versus the host profile creates the association so that the host can be managed from the host profile, but there is no other effect on the host configuration. In other words, if you are in hosts and adding or changing a host profile the host profile will update ONLY the Service properties and not the host detail (including extended host info template).{Note}{tip}Tip: Work within the host profile when possible.{tip}

h5. How Do I Apply an Extended Host Info Template to a Host?

You can also add the template properties directly to an individual host.
# Select *Hosts* from the _Configuration_ page.
# Select a host to add the an extended host info template.
# Select the drop-down box for *Extended Host Info Template* and select an existing template.
# Select *Save*.

h5. Generating Extended Host Info Templates from Logos for the Nagios GUI's

Use the logos in {{/usr/local/groundwork/nagios/share/images/logos}} (you can place your own logos here also if you wish) and run {{/usr/local/groundwork/tools/profile_scripts/gen_hostextinfo.pl}} to generate extended host info templates. You will need three types of files; gif, png, and gd2, for complete templates. The file names should be identical (except for the extensions). The file names should also be descriptive of the object to which they will be assigned.

{Note}gd is a graphics library. It allows your code to quickly draw images complete with lines, arcs, text, multiple colors, cut and paste from other images, and flood fills, and write out the result as a {{png}} or {{jpeg}} file. There is a useful tool to create gd2 files from png files: {{/usr/local/groundwork/common/bin/pngtogd2}}.{Note}

After running {{gen_hostextinfo.pl}} you will find the templates ready to import under *Configuration*, *Profiles*, *Profile Importer*.

Figure: Extended Host Info Template - Status Map Image !c_hostsstatusmap.gif!