GWME-7.2.1-00 4118 Rollup Patch Details

Overview

The 7.2.1 Rollup Patch installer includes fixes for issues in several areas, including the GroundWork Foundation database, the downtime scheduler, NoMa notification, NOCBoard dashboard, LDAP integration, and also the SLA Dashboard and reporting tools.

Important Directives

Because this rollup patch does affect configuration files, in some cases you must make additions or edits in order to benefit from the new features and fixes in the patch. The following is a list of such edits you may want to make, depending upon how you use GroundWork, and whether you make use of a particular feature.

NOCBoard
  1. GWMON-13406 Window for NocBoard Query speed up
    File to edit:
    /usr/local/groundwork/config/foundation.properties
    

    These parameters denote the acceptable size of the search window in time, and affect how much data is cached.
    If you select a bigger period in NocBoard than you have set here, performance will suffer. Make sure the window size is right for your installation.

    ############################################################################
    # LogMessage Window Service Configuration
    ############################################################################
    logmessage.window.enabled=true
    logmessage.window.size.hours=24
    logmessage.window.update.interval.seconds=5
    

Changes to this file are effective after you restart GroundWork Services.

/etc/init.d/groundwork restart gwservices
LDAP Users
  1. GWMON-13447 Map LDAP groups to GW Roles (fixes for LDAP mapping issues)
    File to edit:
    /usr/local/groundwork/config/foundation.properties
    

Adding the ldap mapping enable parameter and the "|" or function on the roles container search term extends the places that GroundWork will look for users and role mappings. This can add significant redundancy to your authentication/authorization setup with LDAP or AD.

# Whether LDAP Mapper should be enabled
core.security.ldap.mapping_enabled = true
...
core.security.ldap.config.windows2012.roles_ctx_dn = ou=GWRoles,dc=company,dc=com|cn=other,dc=company,dc=com

File to edit:

/usr/local/groundwork/config/ldap-mapping-directives.properties

You can add the mapping of LDAP only groups to GW portal only groups, for example: "aga", "another aga", "ago", "agu", below.
Notice that a space in an LDAP group name requires the replacement of that space with the string "\u0020"

#Portal admin group mapping
GWRoot=gw-portal-administrator

#groundwork admin group mapping
GWAdmin=gw-monitoring-administrator

#Portal operator group mapping
GWOperator=gw-monitoring-operator

#Portal user group mapping
GWUser=gw-portal-user

agr=GWRoot
another\u0020aga=GWAdmin
ago=GWOperator
agu=GWUser

Changes to these files are effective after you restart GroundWork Services.

/etc/init.d/groundwork restart gwservices
  1. GWMON-13501 LDAP Group to Role equivalent recursive tour de mort fix.

You may use a notation for ldap mapping that sets GROUPNAME=GROUPNAME (where the ldap group and the GW role are identically spelled).

The following is a description of the main issues that are addressed by applying the Rollup Patch installer version 7.2.2-gw4118. Note that this list will change as we release new versions. Each patch installer creates a backup directory that contains all the changed files for that patch. You may view the changed files on your system at

 /usr/local/groundwork/backup-gwNNNN/files

where NNNN is the number of the patch prior to the one currently installed. Thus the files changed by patch 4114, for example, will appear when you install patch 4118 in

 /usr/local/groundwork/backup-gw4114/files

Changes from default install made by prior versions

Status Viewer Spinner Changes
Path Issues with RStools
LogMessageWindow changes for NOCBoard Initialization
Feeder Changes

GroundWork Nagios and Cacti feeder programs have been updated in this patch to fix a few minor issues. Please see: https://kb.groundworkopensource.com/display/DOC721/GWME-7.2.1-02+Nagios+Feeders for a description. The fact that the feeders are patched in the roll-up means that it’s not necessary to apply both the rollup-patch and the TB 7.2.1-02. Here is a list of the changes made:

SLA Dashboard Fixes
New features on SLA dashboards
Improvements to SLA dashboards
NOCBoard Fixes

The relatively new NOCBoard dashboard is documented here: https://kb.groundworkopensource.com/display/DOC721/NOCBoard
This development is still in progress, so we didn’t release 7.2.1 with the NOCBoard enabled. If you do set it up, though, you will appreciate the fixes that went in since release, and are included in the roll-up patch installer:

API/Foundation Fixes

These issues were resolved in most cases to enhance performance, but also to support features for acknowledging and commenting on hosts and services from more places in the user interface:

Status Viewer Fixes

Some minor issues with the Status view were addressed:

Cloud Hub Fixes

We made some additional features available in the Cloud Hub that the roll-up patch includes. There are some fixes there as well.

LDAP fixes
Monarch fixes
Iframe Portlet Issue

Changes between 4114 and 4118

Aliasing Changes
Unified Monitoring Fixes
Jolokia Support
Deletion of Downtime
BSM Message is now configurable.
Performance Enhancements for SLA Dashboards