6.3 EE Release Notes for Centos Virtual Appliance

thingsplaneServers

Dec 9, 2013 (3 years and 7 months ago)

315 views

6.3 EE Release Notes for Centos Virtual Appliance
GroundWork Monitor 6.3 Enterprise Release Notes for the CentOS
Virtual Appliance
This document describes the contents of GroundWork Monitor Enterprise 6.3 Release. Please read this document completely before proceeding
with installation or upgrade.
Contents
GroundWork Monitor 6.3 Enterprise Release Notes for the CentOS Virtual Appliance
Contents
SECTION 1 - CHANGES FROM THE PREVIOUS RELEASE
New 'Views' application
Network data collection
Audible alarms in Event Console
Dashboards
JBoss Portal
GroundWork Agents
Other changes in this release
SECTION 2 - INSTALLATION
SECTION 3 - UPGRADING
SECTION 4 - FIXED ISSUES SINCE RELEASE 6.2
SECTION 5 - KNOWN ISSUES AND LIMITATIONS
SECTION 6 - ANNOUNCEMENTS AS OF VERSION 6.3
SECTION 7 - ADDITIONAL INFORMATION
SECTION 8 - SYSTEM BACKUP INSTRUCTIONS
Obtaining Source Code
SECTION 1  CHANGES FROM THE PREVIOUS RELEASE
GroundWork Monitor Enterprise Release 6.3 includes new features, minor improvements and bug fixes. The changes made in this release
include:
New 'Views' application
Users can now create live diagrams that include visual representations of operations with monitoring data. The views application can be used to
show geographical differences, logical organization, network and connectivity-­oriented views or the key measurements for important business
processes. Example diagrams illustrating use of the tool are included in this release.
The views application is based on the Nagvis visualization project. The following accommodations were made to ensure a smooth workflow when
using the views application:
Functions to view and edit diagrams have been separated under different menu items (Views and Administration respectively.) This is to
enable regular users to access diagrams but not modify them, since this is an administrative function.
Live monitoring data in retrieved using the published GroundWork Monitor interfaces.
Authentication and authorization for the views application is integrated into the JBoss portal application.
UI elements have been modified to closely match the appearance of the rest of the application.
Network data collection
This release includes the Cacti network data collection project; previously this component was available as an optional add-­on. Inclusion of the
cacti project provides:
Efficient data collection from large numbers of SNMP enabled devices.
Powerful graphing based on cacti-­templates.
Status viewer, dashboards, reports and event console combine data from multiple sources including cacti into a consistent view.
Audible alarms in Event Console
The event console application can now generate audible alarms when the operator is away from the console. Disabled by default, this feature
generates sounds via the operators system speakers for the currently displayed event console view.
In addition the event console can optionally consolidate events so that only the current (most recent) event is displayed for each host/service.
Instructions for enabling this feature are included in the bookshelf under _DEVELOPER REFERENCE > Configuring Event Console > Enabling
Pre-­processing of Log Messages_.
Dashboards
The default dashboards have been modified in this release as follows:
The first dashboard has been redesigned to include a quick navigation component.
The Webmetrics dashboard has been moved from the top-­level navigation to a dashboard sub-­page.
A trouble-­view dashboard has been added.
JBoss Portal
The portal configuration has changed to provide better session handling for the following applications:
Configuration (Monarch).
Advanced reports.
Views.
Traffic graphing (Cacti).
GroundWork Agents
Support for Oracle Weblogic 10.x has been added to the GroundWork Java agent (JDMA.)
Support for long plug-­in results (greater than 512 bytes) has been added to the Linux and Windows agents (GDMA.) For compatibility, this feature
is disabled by default but can be enabled by adding this entry to
:
send_nsca.cfg
wide_plugin_output=on
Other changes in this release
Improved handling of long lists of objects, particularly in the configuration application.
Overrides are preserved when cloning a host (GWMON-­8882).
Service templates can now be copied (GWMON-­7979).
Can now search for commands (GWMON-­8582).
Easier to spot warning messages on pre-­flight check (GWMON-­8826).
Better handling of schema changes during upgrade (GWMON-­8977).
Monarch groups are now exposed via the dassMonarch configuration API (GWMON-­8044).
Profile importer now includes profile description.
Long plugin output (up to 4096 bytes) is now supported in NSCA using the
flag.
--wp
Greatly reduced commit times for installations with lots of dependencies defined (GWMON-­9045).
Version 1.4.15 of the nagios plug-­ins is now included.
The fping feeder is now included in the distribution package.
Customized link text for context links in the status viewer is now supported.
Groundwork acknowledges the National Australia Banks Security Assurance team for the discovery and reporting of security vulnerabilities
resolved in this release.
When installing or upgrading to release 6.3 customers and partners are required to provide a valid license key. Customers upgrading their
production systems are advised to ensure they have received their license key
to their maintenance window.
prior
SECTION 2  INSTALLATION
Downloading GroundWork Monitor Enterprise
Customers with an existing GWOS subscription may download this release from:
https://support.groundworkopensource.com
GWOS Quickstart customers may download the release from the GWOS Exchange (
) by logging in and
http://www.gwos.com/exchange
navigating to the My Account then Files page, or by logging in to the customer resource center using the links provided at time of purchase.
Installation
The Centos Powered Virtual Appliance can be run on a number of virtualization platforms. It is supported on VMware, and the following release
notes pertain to a typical setup of the appliance.
Getting started with a VMware ESX 3.5 example
Some features of the Virtual Appliance will not be enabled by default. This sequence is typical of configuring a Virtual Appliance to work on ESX
3.5 servers.
1)     Decompress the Virtual Appliance
2)     Use the VMware converter to load the appliance files into ESX. Make sure to select
as the source.
VMware Workstation
3)     Boot the Virtual appliance, and start the Console, so that you can interact with it from the command line.
4)     Wait a few minutes for the initial boot process to finish.
5)     Follow the instructions on the screen to log in and change the groundwork user password. Note: sometimes the VMware console can insert
characters, making this process cumbersome. You might need to try several times.
6)    To work around this issue, ssh to the VM from another client. You will be able to login as user root, password groundwork, and change the
password from the ssh session. The rest of these steps can also be done from the ssh session.
7)   To configure the timezone, execute the following from the command line:
. The default time zone is UTC.  Optionally
system-config-date
reconfigure NTP.
8)   After NTP syncs the system to the new timezone, restart the groundwork services:
service groundwork stop
rm /usr/local/groundwork/nagios/
/nagiosstatus.sav
var
rm /usr/local/groundwork/cacti/htdocs/rra/*.rrd
service groundwork start
This will make all the timestamps in the interface reflect your local time.
For this release of 6.3, VMware tools 3.50-153875.i386.rpm is installed once the user sets a new password. This is sufficient for validating
GroundWork Monitor; however the VMware Tools package may be upgraded by following the instructions provided by VMware for your product.
Note: You will need to set the version of Linux to Red Hat Linux 5 32-bit to automatically upgrade VMware tools in vSphere.
GroundWork Monitor includes all prerequisites and components within a single installation package. Since this virtual appliance is built using the
32-bit version of Centos Linux and GroundWork Monitor this image cannot make use of more than 4GB of RAM.
The software components of GroundWork Monitor are installed under /usr/local/groundwork with the exception of the log rotation configuration
and the start/stop script named /etc/init.d/groundwork. It is used as follows:
/etc/init.d/groundwork {start|stop}
This script can also be used to restart individual services. For example:
/etc/init.d/groundwork restart nagios
Login Access to Portal
For the GW Monitor 6.3 release, there are three users and roles that are provided with a new installation. These users are: admin, operator and
user. To login, use the same login name for the password. For example, to login as the user "operator", the password is operator. Changing the
default passwords upon installation is recommended.
The "admin" user is a specially privileged user. It is used in the creation of shared dashboards, and should never be deleted. It may be disabled if
desired. The admin user, with the administrator role has access to all of the portlets. The other two users will have access to subset of the
available portlets.
Feature
Administrator Role
Operator Role
User Role
Dashboards
Yes
Yes (read-only)
Yes (read-only)
My GroundWork
Yes
Yes
Yes
Event Console
Yes
Yes
 
Status Viewer
Yes
Yes
Yes (no actions)
Reports
Yes
 
Yes
Configuration
Yes
 
 
Auto-discovery
Yes
 
 
Administration
Yes
 
 
Nagios
Yes
Yes
 
Resources
Yes
Yes
Yes
At first login, the admin user must copy-and-paste their license key into the portal application under Administration, GroundWork License. Each
license is valid for the subscription duration purchased. Each GWOS installation has a single license file that controls access to the application
user interface. The license file affects only user access to the GWOS portal; it does not affect the ability to start/stop application components or
the data gathering, processing or notification features of the solution. License key validity is checked at user login and is affected by:
The subscription start and end-date
The number of monitored devices configured
Network Service is enabled
SECTION 3  UPGRADING
Upgrades are not supported with the Enterprise Quick Start Virtual Appliances. If you are interested in upgrading, please contact
.
sales@gwos.com
SECTION 4  FIXED ISSUES SINCE RELEASE 6.2
This section summarizes the minor issues fixed since release 6.2
Key
Component/s
Summary
GWMON-9364
Status Viewer
Service View / Host View have extra space around information portlets
GWMON-9361
Status Viewer
Hostgroup names with many characters shift the Network View to the right
GWMON-9356
Status Viewer
Status view tree portlet expansion behavior very bad
GWMON-9345
Status Viewer
Heading of pop up window "schedule check for all services of this host" is displayed
improperly.
GWMON-9341
Administration
Mange Plugins link should not be visible by default. Instead a property in the
foundation.properties should drive it
GWMON-9333
Documentation
Bookshelf needs to be updated for Remote RRD configurations
GWMON-9332
Documentation
HTTPS/SSL Documentation needs additional steps
GWMON-9331
Bookshelf
Need to remove all documentation in bookshelf that mentions NMS start up scripts
GWMON-9325
Dashboards
Dashboard landing pages link need to be adjusted
GWMON-9319
Foundation
Need DeactivationTime property added to Foundation
GWMON-9315
NMS - Cacti
RRD directory is restored with 'root.root' ownership, nagios can not update
GWMON-9300
Status Viewer
Vertical alignment between status history and performance graphs is broken
GWMON-9299
Status Viewer
Overlapping controls when searching in status viewer
GWMON-9292
Configuration
host_service and performanceconfig field widths do not match other tables
GWMON-9281
Status Viewer
The host notes filed is not resizing correctly when the field is loaded with a lot of data.
GWMON-9267
Plugins
Check_hostgroup_foundation.pl does not deal with unscheduled downtime status correctly.
GWMON-9265
Status Viewer
After re-naming host to big host name, big host name is crossing the Tree View portlet area.
GWMON-9249
Upgrades
Upgrade from 5.3 to 6.3, Advance Reports links are not accessible
GWMON-9248
NMS
Cacti Dead Hosts notification option box is checked, should be off
GWMON-9247
NMS
Downed Host Detection should include ping and snmp and a retry count > 1
GWMON-9246
NMS
RRDtool reference in settings for Cacti is pointing to 1.2, should be 1.4
GWMON-9237
Status Viewer
Customize Link text for Custom URLs in Status viewer
GWMON-9230
Documentation
Console public filter syntax is incorrectly documented - OpStatus valid value is ACCEPTED
not ACCEPT
GWMON-9229
JDMA
"GWMON-8934 JDMA-Eliminate manual copy of profiles to the GW Server"
GWMON-9216
Status Viewer
Creating more than 10 Status tabs runs off the view
GWMON-9167
Build Process
Gwdiags should get php environment info since Nagvis and Cacti are now included by default
GWMON-9166
Bookshelf
Linux GDMA page improperly refers to installing windows client
GWMON-9165
Bookshelf
Custom reports documentation is inconsistent
GWMON-9158
Foundation NMS
If remote RRD is used, Cacti Graph commands for the host are ignored
GWMON-9152
Status Viewer
Action portlet extends to the right of the other portlets in Service or Host views
GWMON-9129
Browser
IE8 only: Too much space between Top level navigation and "Welcome,admin" text
GWMON-9116
Dashboards
HostList and Service List portlet should change title to Troubled Host/service View if show no
OK/UP is selected
GWMON-9114
Advance Reports
Hostgroup-availability advanced reports for "Linux Servers" displays blank page
GWMON-9112
Bookshelf
Syslog profile documentation in Bookshelf is inaccurate
GWMON-9109
Profiles
Check_vsphere_* plugins have wrong shebang line
GWMON-9095
Bookshelf
Bookshelf Oracle Database Profile "check_oracle_tablespace" description is wrong
GWMON-9091
Build Process
Log reports.LogMessageType table contains an invalid record
GWMON-9077
BitRock Performance
Process_service_perfdata_file program should have option to send perf data to parent
foundation for EPR reports
GWMON-9074
Dashboards
The default setting for Service List and Host portlets in the dashboard & my Groundwork
should be to not show OK or UP messages
GWMON-9073
Console
Processing incoming Events and update Operation Status if the Event is a status change
GWMON-9071
Foundation Parent-Child
Performance
Nagios2collage_socket.pl sends substituted XML to parent servers when used with Remote
RRD configuration
GWMON-9062
BitRock Plugins
Check_syslog_enhanced.pl shebang line uses wrong perl interpreter
GWMON-9057
Tools
Gwdiags should read db.properties for db credentials
GWMON-9056
JBoss Portal
Service list portlet does not inherit admin user permissions
GWMON-9033
Performance
Performance data feeder does not send Remote RRD graph commands to standby servers
GWMON-9021
Configuration
Hosts might not be populated in hostgroups correctly in Foundation after a commit
GWMON-9017
Status Viewer
Feeder -The pound character can be introduced into Host Comments resulting in Java
exception in Status Viewer
GWMON-9009
Configuration
Monarch groups If the local build folder does not exist it should be created.
GWMON-9000
JDMA
JDMA agent UI for Web Sphere has a typo in the index page that says "jboss
components".Please see attached
GWMON-8995
BitRock GDMA Nagios
Parent-Child
Send_nsca configuration file should include an option to set the packet version
GWMON-8989
Foundation
The foundation database may contain comments with # characters on upgrade
GWMON-8984
Foundation
The event log feeder does not convert every xml entity
GWMON-8978
Console
NPE - Event Console when creating a new tab
GWMON-8973
Administration
Adding more than 25 host groups or service groups to an MSP role restriction has no effect.
GWMON-8972
Console
Event Console events should allow for sorting by severity (high to low rather than
alphabetical)
GWMON-8954
Configuration
Long-running Commit operations fail in the JBoss encapsulation environment
GWMON-8949
Documentation
VMware ESX Server Profile (API) doc is in wrong Bookshelf section
GWMON-8939
Bookshelf
LDAP configuration. Bookshelf should include a note that rolesCtxDn entry needs to be
identical to baseCtxDN entry
GWMON-8936
BitRock
The VMWare VSphere ESX 4.0 profile tar package is corrupt
GWMON-8932
Dashboards JBoss Portal
Memory leak in IE browser when viewing Enterprise View dashboard
GWMON-8908
BitRock Installer Status
Viewer
Related links feature in Status Viewer loses configuration in upgrade
GWMON-8905
Dashboards My GroundWork
Status Viewer
Seurat View: UI related CSS issues
GWMON-8894
JBoss Portal Status Viewer
HostListPortlet Pagination
GWMON-8890
Status Viewer
Host list not sorting troubled services to the top in all cases
GWMON-8889
Status Viewer
Resized tree view appears to break after a while
GWMON-8873
Documentation
Bookshelf article on nagios WAP links to an internal groundwork host
GWMON-8836
Status Viewer
Status viewer displays soft state change event when hard events have been processed
GWMON-8799
Advance Reports
Host state transition>service state transition >clicking on service link does not display
anything
GWMON-8759
Advance Reports
Selecting any hostgroup in epr hostgroup report shows SQLException: Parameter metadata
not available for the given statement in log
GWMON-8747
Reports
"Event History" Report has MSP implemented for its parameters window, but not for report
itself
GWMON-8716
My GroundWork
Adding Seurat portlet with info portlets to a dashboard misplaces the cancel icon on the action
pop-ups in info portlets
GWMON-8714
Performance
SLES ps command truncates output. This causes launch_perfdata_processing to fail.
GWMON-8688
JBoss Portal
After restart of gwservices server users should be redirected to the login page and not receive
a security check failure error page
GWMON-8582
Configuration
Monarch Commands could use a Search function
GWMON-8563
Status Viewer
Cancel icon is not displayed on the selected node tab
GWMON-8399
Configuration
Service Instances problem when using automation tools
GWMON-8324
Configuration
Eliminate multiple nested vertical scroll bars
GWMON-8303
Bookshelf
"About Performance Graphs" page in Bookshelf needs updating
GWMON-8120
Status Viewer
Add advanced viewing options to the host list portlet
GWMON-8075
BitRock
Error on importing/uploading few profiles
GWMON-8044
Configuration DassMonarch
GDMA
Dassmonarch.pm must provide methods to manipulate monarch groups
GWMON-7903
Status Viewer
Pop up window- close button is displayed on wrong position
GWMON-7753
Auto Discovery
Preflight failed with the error "Could not register service"
1.
GWMON-7518
Status Viewer
"Error Occurred " is displayed in Action portlet - Very Intermittent
GWMON-7419
Auto Discovery
When trace route option is turned off, max hops and timeout should be disabled
GWMON-7381
Configuration
Monarch doesn't create backup of cgi.cfg
GWMON-7076
Auto Discovery Configuration
Different font sizes on Auto Discovery and Configuration page
GWMON-5462
Foundation
Foundation Perl API sample scripts need cleanup
GWMON-1944
Status Viewer
Scheduled downtime comment for host and service do not show up in the Status View UI
SECTION 5  KNOWN ISSUES AND LIMITATIONS
For the 6.2 release, we have changed the role names for the roles admin, operator and user to gwadmin, gwoperator and gwuser
respectively. For customers using LDAP and Active Directory, please make sure to create a new groups called gwadmin, gwoperator and
gwuser and then move the existing users to the correct groups before upgrading to 6.3.
The "My GroundWork" application provides access to the dashboard builder and is, by default, accessible to all users and is not affected
by the 'read-only dashboards' flag. The builder can be used to access functionality that can be used to modify the monitoring system (via
the ServiceInfoPortletInstances and HostInfoPortletInstances portlets to execute commands.) If this access is not desired it is
recommended that the default portlet permissions be modified to disallow access to the "My GroundWork" application or to the individual
portlets mentioned above. (GWMON-8702).
The Event history Overview report does not honor the restricted user views function at this time. (GWMON-9053).
IE browser issue: Importing backgrounds and applying them to a new Nagvis map generate a JavaScript error. (GWMON-9375).
Status viewer context links displayed on Firefox on Mac systems may display incorrectly. (GWMON-9374).
It is advised not to restart the MySQL process without also restarting the gwservices process at the same time. There is a dependency
between these two services and if they become out of sync with one another the GroundWork server will generate Java IO Exception
errors. (GWMON-8783).
Placing portlets in the bottom region of the default-dashboard layout results in the portlet being displayed without a frame or an edit
button. (GWMON-9200).
Snmptrapd has a bug that swaps client and source IP addresses. (GWMON-9346).
In the Event History report, leaving the supported filter blank for any values will not generate the report. (GWMON-8758).
Intermittently after Cacti upgrades, the Thold Templates panel shows errors list of templates and a list of errors from database "undefined
index" for name and thold_type. (GWMON-9286).
When using the IE8 browser in the configuration application some controls on the left-side panel may not display. This issue can be
worked around by adding the GroundWork Monitor server to the Local Intranet Zone within IE8.
Additional minor known issues
Key
Summary
Component/s
GWMON-2149
BitRock
5.1 core install gives httpd warning about determining server's fqdn
GWMON-2996
Configuration
Host group downtime cannot be deleted
GWMON-4815
Auto
Discovery
Auto Discovery does not correctly parse multiple community strings from the snmp discovery method
GWMON-4977
BitRock
Installer shouldn't assume it can write to current working directory
GWMON-5265
Plugins
Check_cpu sar out input incorrect on RedHat
GWMON-5434
Foundation
Web Services API uses 'Device Identification' as primary key for all message types, nagios, syslog,
etc, but some different devices can have same ip address
GWMON-5454
Configuration
Applying a host profile in the host interface does not apply services associated with host profile.
GWMON-5491
Console
Console All Events view does not differentiate between Nagios alerts and notification messages.
GWMON-5675
Reports
Top Five report gets top five only on maximum value saved over the period
GWMON-5716
Reports
HTTP ERROR: 404 on exporting data in Advanced Reports.
1.
GWMON-5843
NMS
Admin role on NMS child interface should not have access to any configuration applications
GWMON-6044
BitRock
PHP script shebang invocation no longer works
GWMON-6182
Portal
Non-US language versions of groundwork cause INVALID DATE STRING exceptions when special
chars in date string
GWMON-6216
Console
Event Console date selection is based off GMT but displays local time zone
GWMON-6485
Configuration
Can't use the Multiple Instances feature of a service check where the check command has no
arguments
GWMON-6599
Dashboard
Mouse over displays scrambled text in Dashboard and is not visible properly
GWMON-7086
Foundation
renaming a host does not update hostnames of new events in event console
GWMON-7220
Portal
Repeated "Network Connection Interrupted" error
GWMON-7455
Configuration
Uploading Group resource macros fails and removes existing configuration
GWMON-7632
Dashboards
Event portlet cannot be configured for host, service, servicegroup
GWMON-7742
Reports
All host groups host groups status report contains incorrect information
GWMON-7755
Configuration
Monarch groups do not honor contact group assignments (host/host templates)
GWMON-7628
My
GroundWork
With user's login, My Groundwork->Configure page should not have Event portlet
GWMON-7838
Nagios
Nagios views from 5.3 - scheduling queue, server status and view config views are not available in 6.0
GWMON-7889
JBoss Portal
Creating different roles with same display names gives HTTP Status 500 error
GWMON-7994
Configuration
Possible to define a service twice on a host
GWMON-8088
Status
Viewer
German language setting in FF3 causes faces exceptions
GWMON-8111
BitRock
Setenv.sh breaks when PATH contains "groundwork" but env is not set properly
GWMON-8146
Configuration
The Check period field does not display in any Host details screen of Monarch
GWMON-8163
Performance
Wide character in print at perfchart.cgi line 1277
GWMON-8165
JBoss Portal
SetEnvIf Referrer does not provide adequate protection
GWMON-8200
Configuration
Extended Host Info Data Disappears
GWMON-8210
Plugins
check_jvm.pl calls to a hard-coded URI
GWMON-8218
JBoss Portal
Potential exposure to man in the middle attack when using https
GWMON-8219
Status
Viewer
Actions pop-up does gets cut off in Event Console
GWMON-8220
Dashboard
Portlet popup displays outside of the viewable area
GWMON-8225
BitRock
Migration procedure does not account for network_service tables
GWMON-8235
Nagios
Nagios Notification Report does not properly access report history for all hosts.
GWMON-8241
Status
Viewer
Status Viewer - host bar graph appears to show data not related to host state but from syslog
messages
GWMON-8272
Bookshelf
Audit Monarch Commit is missing feeder modification in Bookshelf and portlet.xml definition requires
update
GWMON-8280
Console
Event console displays events from the wrong filter if action taken while viewing custom filter
GWMON-8296
Foundation
HostStatusProperty.StringValue buffer is STILL too small to hold a large number of cacti graph URL's
GWMON-8311
Status
Viewer
Scheduled Downtime author is set to admin regardless of user logged in.
GWMON-8313
Status
Viewer
EventPortlet only shows Nagios events for hosts or hostgroups
GWMON-8425
Dashboard
my groundwork dashboard layout changes affect all my groundwork pages
1.
1.
2.
3.
GWMON-8444
Auto
Discovery
cacti host profile sync failing to import host
GWMON-8471
JBoss Portal
When a Nagios page is left open for a long period of time, a permissions error is eventually displayed
GWMON-8472
Dashboard
Portlet arrangement issues
GWMON-8481
Status
Viewer
If user name contains a dot (.), status viewer generates stack traces
GWMON-8494
Build
Process
mysql memory usage increases continuously
GWMON-8495
JBoss Portal
Redirect users to the login page in the event of gwservices restart during a session
SECTION 6  ANNOUNCEMENTS AS OF VERSION 6.3
As previously announced, GroundWork Monitor versions 5.1.x are now end-of-life. Customers using these versions are advised to contact
GroundWork Support regarding upgrade options.
Ground Monitor versions 5.2.x will be end-of-life with the next release. Customers using these versions are advised to plan their migration at this
time.
Customers using CentOS 4 or RedHat Enterprise Linux 4 are advised that support for these platforms may be discontinued in future releases.
SECTION 7  ADDITIONAL INFORMATION
ABOUT THE NETWORK SERVICE
This version of GroundWork Monitor includes the Network Service component. This component provides the following capabilities:
Provides GroundWork Monitor administrators with software update notifications in their home screen.
Provides environment statistics to GroundWork about the GroundWork Monitor installation
Provides the license key hash to GroundWork for each GroundWork Monitor installation
The Network Service communicates with servers in the
domain every 12 hours via HTTPS (on TCP port 443). All
checkforupdates.com
communication is initiated by the GroundWork Monitor Enterprise server.
The complete set of information sent to GWOS is:
The type of GroundWork Monitor product installed (e.g. Community Edition or Enterprise Edition) and version.
The Operating System vendor and version and basic hardware information (RAM, CPU)
The size of the monitored environment: number of configured devices and hosts, host groups, service checks, users and service checks
being used.
The license key hash (checksum)
If you need to enable the Network Service on an existing GroundWork Monitor Enterprise installation execute the following binary as the root user:
/usr/local/groundwork/network-service/bin/network-service-manager.bin
Proxy Server Configuration
The Network Service will not be able to receive updates if a non-transparent proxy is used. To configure the proxy settings complete the following:
Install the product and enable the Network Service during installation.
Login using a secure shell on the GroundWork server.
cd /usr/local/groundwork/network-service/scripts/
./network-service-ctl.sh stop
cd /usr/local/groundwork/network-service/bin/
edit
file and add the following:
agent.conf
proxy_host=xxx.yyy.zzz.wwwproxy_port=pppp
3.
4.
Save your changes.
Now restart the network service:
./network-service-ctl.sh stop
./network-service-ctl.sh start
SECTION 8  SYSTEM BACKUP INSTRUCTIONS
This section outlines the recommended back up procedures to be completed before upgrading to GroundWork Monitor 6.3.
Custom Changes
It is recommended that a complete backup of
be taken before upgrading. If this is not possible the following should be
/usr/local/groundwork
considered the bare minimum set of files to be preserved.
Component
Location
Plugins
/usr/local/groundwork/nagios/libexec
CGI graphs
/usr/local/groundwork/apache2/cgi-bin/graphs
Eventhandlers
/usr/local/groundwork/nagios/eventhandlers
SNMPTT configuration
snmptt.conf, snmptt.ini
Custom syslog filters
syslog.conf, syslog-ng.conf
Logrotate
logrotate.conf, any changes under /etc/logrotate.d
Foundation configuration
foundation.properties
NSCA configuration
nsca.cfg
Distributed deployment configuration
MonarchDeploy.pm
User directory
The contents of the 'nagios' user home directory
User directory
The contents of the 'nobody' user home directory
The last configuration file
/usr/local/groundwork/nagios/etc/config-last.log
Apache
All modified apache configuration files
Core
The contents of /usr/local/groundwork/etc
Core
The contents of /usr/local/groundwork/backup
Core
The contents of /usr/local/groundwork/jobs
RRD files
/usr/local/groundwork/rrd
Nagios configuration
/usr/local/groundwork/nagios/etc
Back up existing RRD files and your current Nagios configuration. This will create three tar files in the current directory.
tar cfz GWMON-xxx-rrd.tar.gz /usr/local/groundwork/rrd
tar cfz GWMON-xxx-nagios.tar.gz /usr/local/groundwork/nagios/etc
tar cfz GWMON-xxx-users.tar.gz /usr/local/groundwork/users
MySQL Databases
GroundWork recommends that all MySQL databases be backed up before upgrading. Here are the upgrade procedures to migrate the databases
to the latest version of GroundWork Monitor. Create a back up directory (e.g.
) and enter the following commands to
/usr/local/backup-gwmon/
create the back ups:
Monarch (Configuration)
mysqldump -uroot monarch > /usr/local/backup-gwmon/monarch_-YYYYMMDD-HHMMSS_.sql
Guava (Framework)
mysqldump -uroot guava > /usr/local/backup-gwmon/guava_-YYYYMMDD-HHMMSS_.sql
Foundation (Monitor Data)
mysqldump -uroot GWCollageDB > /usr/local/backup-gwmon/GWCollageDB_-YYYYMMDD-HHMMSS_.sql
Log Reporting
mysqldump -uroot logreports > /usr/local/backup-gwmon/logreports_-YYYYMMDD-HHMMSS_.sql
GroundWork Configuration Files
Monarch
Back up the following files and folders before removing GroundWork Monitor and restore after the 6.3 installation.
tar cfz GWMON-xxx-monarchbackup.tar.gz /usr/local/groundwork/core/monarch/backup
tar cfz GWMON-xxx-performance_views.tar.gz /usr/local/groundwork/core/performance/performance_views
If you have done custom work to these files back up the following:
tar cfz GWMON-xxx-monarchcallout.tar.gz /usr/local/groundwork/core/monarch/lib/MonarchCallOut.pm
tar cfz GWMON-xxx-monarchexternals.tar.gz /usr/local/groundwork/core/monarch/lib/MonarchExternals.pm
Apache
If you have configured Apache for secure SSL authentication any HTTPS certificates need to be preserved (the directory of the HTTPS
certificates may differ from the example below):
tar cfz ssl-keys.tar.gz /usr/local/groundwork/apache2/conf/ssl.key
syslog-ng
tar cfz GWMON-xxx-syslog-ng-data.tar.gz /usr/local/groundwork/
/log/syslog-ng
var
Obtaining Source Code
GroundWork Monitor includes Open Source software. The source for these packages is available for download from the following location:
ftp://archive.groundworkopensource.com/pub/groundwork-core/
Modifications to these software projects in source form, are available for download from the following location:
http://archive.groundworkopensource.com/groundwork-opensource/
Copyright 2004-2010 GroundWork Open Source, Inc. ("GroundWork"). All rights reserved. Use is subject to GroundWork commercial license
terms. GroundWork Monitor products are released under the terms of the various public and commercial licenses. For information on licensing
and open source elements please see
. GroundWork, GroundWork Open Source,
http://www.gwos.com/products/pro-ipingredients.html
GroundWork Monitor Professional, GroundWork Monitor Open Source, GroundWork Community Edition, GroundWork Monitor Enterprise,
GroundWork Foundation, GroundWork Status Viewer, Monarch, and GroundWork Guava are trademarks of GroundWork Open Source, Inc.
Other trademarks, logos and service marks (each, a "Mark") used in GroundWorks products, including Nagios, which is a registered trademark of
Ethan Galstad, are the property of other third parties. These Marks may not be used without the prior written consent of GroundWork Open
Source or the third party that owns the respective Mark.