If your Xymon installation has many pages and a few levels of nesting it becomes annoying to navigate down the tree sometimes. Of course bookmarks can be used to help with this. For target pages that are of interest to all users of your installation a better and more consistent solution exists: extending the navigational menu at the top of the web interface.

In current versions of Xymon it is very easy to adjust the menu. The whole menu is defined in ~/server/etc/xymonmenu.cfg. To add a custom menu for ACME insert (before the final closing </div>) something like the following into that file:

<div class="outer">
<span class="menutag">ACME<span class="invis">: </span></span>
<a class="inner-1" href="/docs/">ACME docs</a><span class="invis"> | </span>
<a class="inner-1" href="$XYMONSERVERWWWURL/page1">PAGE1-page</a><span class="invis"> | </span>
<a class="inner" href="$XYMONSERVERWWWURL/page1/sub1">&nbsp; sub1</a><span class="invis"> | </span>
<a class="inner" href="$XYMONSERVERWWWURL/page1/sub2">&nbsp; sub2</a><span class="invis"> | </span>
<a class="inner-1" href="$XYMONSERVERWWWURL/page2">PAGE2-page</a><span class="invis"> | </span>
</div>

Or even better: use the modularized configuration (described here How to Modularize the Configuration Files of Xymon):

  • write the custom entries to a new file, e.g. ~/server/etc/xymonmenu-acme.cfg
  • right before the last </div> insert the include-tag for the new file into xymonmenu.cfg

      include xymonmenu-acme.cfg
    

    Note: if the file is not placed in ~/server/etc/ specify the full path or a relative path to the server etc directory.

This will add a new menu item “ACME” at the very right of the menu with the following entries

  • ACME docs
  • PAGE1-page
    • sub1
    • sub2
  • PAGE2-page

Enjoy faster navigation on the web interface!