Comments 0

Document transcript

6.3 EE Release Notes for Centos Virtual ApplianceGroundWork Monitor 6.3 Enterprise Release Notes for the CentOSVirtual ApplianceThis document describes the contents of GroundWork Monitor Enterprise 6.3 Release. Please read this document completely before proceedingwith installation or upgrade.ContentsGroundWork Monitor 6.3 Enterprise Release Notes for the CentOS Virtual ApplianceContentsSECTION 1 - CHANGES FROM THE PREVIOUS RELEASENew 'Views' applicationNetwork data collectionAudible alarms in Event ConsoleDashboardsJBoss PortalGroundWork AgentsOther changes in this releaseSECTION 2 - INSTALLATIONSECTION 3 - UPGRADINGSECTION 4 - FIXED ISSUES SINCE RELEASE 6.2SECTION 5 - KNOWN ISSUES AND LIMITATIONSSECTION 6 - ANNOUNCEMENTS AS OF VERSION 6.3SECTION 7 - ADDITIONAL INFORMATIONSECTION 8 - SYSTEM BACKUP INSTRUCTIONSObtaining Source CodeSECTION 1  CHANGES FROM THE PREVIOUS RELEASEGroundWork Monitor Enterprise Release 6.3 includes new features, minor improvements and bug fixes. The changes made in this releaseinclude:New 'Views' applicationUsers can now create live diagrams that include visual representations of operations with monitoring data. The views application can be used toshow geographical differences, logical organization, network and connectivity-­oriented views or the key measurements for important businessprocesses. 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 whenusing the views application:Functions to view and edit diagrams have been separated under different menu items (Views and Administration respectively.) This is toenable 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 collectionThis release includes the Cacti network data collection project; previously this component was available as an optional add-­on. Inclusion of thecacti 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 ConsoleThe event console application can now generate audible alarms when the operator is away from the console. Disabled by default, this featuregenerates 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 > EnablingPre-­processing of Log Messages_.DashboardsThe 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 PortalThe portal configuration has changed to provide better session handling for the following applications:Configuration (Monarch).Advanced reports.Views.Traffic graphing (Cacti).GroundWork AgentsSupport 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 featureis disabled by default but can be enabled by adding this entry to:send_nsca.cfgwide_plugin_output=onOther changes in this releaseImproved 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 theflag.--wpGreatly 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 vulnerabilitiesresolved in this release.When installing or upgrading to release 6.3 customers and partners are required to provide a valid license key. Customers upgrading theirproduction systems are advised to ensure they have received their license keyto their maintenance window.priorSECTION 2  INSTALLATIONDownloading GroundWork Monitor EnterpriseCustomers with an existing GWOS subscription may download this release from:https://support.groundworkopensource.comGWOS Quickstart customers may download the release from the GWOS Exchange () by logging in andhttp://www.gwos.com/exchangenavigating to the My Account then Files page, or by logging in to the customer resource center using the links provided at time of purchase.InstallationThe Centos Powered Virtual Appliance can be run on a number of virtualization platforms. It is supported on VMware, and the following releasenotes pertain to a typical setup of the appliance.Getting started with a VMware ESX 3.5 exampleSome features of the Virtual Appliance will not be enabled by default. This sequence is typical of configuring a Virtual Appliance to work on ESX3.5 servers.1) Decompress the Virtual Appliance2) Use the VMware converter to load the appliance files into ESX. Make sure to selectas the source.VMware Workstation3) 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 insertcharacters, 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 thepassword 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. Optionallysystem-config-datereconfigure NTP.8) After NTP syncs the system to the new timezone, restart the groundwork services:service groundwork stoprm /usr/local/groundwork/nagios//nagiosstatus.savvarrm /usr/local/groundwork/cacti/htdocs/rra/*.rrdservice groundwork startThis 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 validatingGroundWork 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 the32-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 configurationand 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 nagiosLogin Access to PortalFor the GW Monitor 6.3 release, there are three users and roles that are provided with a new installation. These users are: admin, operator anduser. To login, use the same login name for the password. For example, to login as the user "operator", the password is operator. Changing thedefault 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 ifdesired. The admin user, with the administrator role has access to all of the portlets. The other two users will have access to subset of theavailable portlets.FeatureAdministrator RoleOperator RoleUser RoleDashboardsYesYes (read-only)Yes (read-only)My GroundWorkYesYesYesEvent ConsoleYesYes

Status ViewerYesYesYes (no actions)ReportsYes

YesConfigurationYes

Auto-discoveryYes

AdministrationYes

NagiosYesYes

ResourcesYesYesYesAt first login, the admin user must copy-and-paste their license key into the portal application under Administration, GroundWork License. Eachlicense is valid for the subscription duration purchased. Each GWOS installation has a single license file that controls access to the applicationuser interface. The license file affects only user access to the GWOS portal; it does not affect the ability to start/stop application components orthe 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-dateThe number of monitored devices configuredNetwork Service is enabledSECTION 3  UPGRADINGUpgrades are not supported with the Enterprise Quick Start Virtual Appliances. If you are interested in upgrading, please contact.sales@gwos.comSECTION 4  FIXED ISSUES SINCE RELEASE 6.2This section summarizes the minor issues fixed since release 6.2KeyComponent/sSummaryGWMON-9364Status ViewerService View / Host View have extra space around information portletsGWMON-9361Status ViewerHostgroup names with many characters shift the Network View to the rightGWMON-9356Status ViewerStatus view tree portlet expansion behavior very badGWMON-9345Status ViewerHeading of pop up window "schedule check for all services of this host" is displayedimproperly.GWMON-9341AdministrationMange Plugins link should not be visible by default. Instead a property in thefoundation.properties should drive itGWMON-9333DocumentationBookshelf needs to be updated for Remote RRD configurationsGWMON-9332DocumentationHTTPS/SSL Documentation needs additional stepsGWMON-9331BookshelfNeed to remove all documentation in bookshelf that mentions NMS start up scriptsGWMON-9325DashboardsDashboard landing pages link need to be adjustedGWMON-9319FoundationNeed DeactivationTime property added to FoundationGWMON-9315NMS - CactiRRD directory is restored with 'root.root' ownership, nagios can not updateGWMON-9300Status ViewerVertical alignment between status history and performance graphs is brokenGWMON-9299Status ViewerOverlapping controls when searching in status viewerGWMON-9292Configurationhost_service and performanceconfig field widths do not match other tablesGWMON-9281Status ViewerThe host notes filed is not resizing correctly when the field is loaded with a lot of data.GWMON-9267PluginsCheck_hostgroup_foundation.pl does not deal with unscheduled downtime status correctly.GWMON-9265Status ViewerAfter re-naming host to big host name, big host name is crossing the Tree View portlet area.GWMON-9249UpgradesUpgrade from 5.3 to 6.3, Advance Reports links are not accessibleGWMON-9248NMSCacti Dead Hosts notification option box is checked, should be offGWMON-9247NMSDowned Host Detection should include ping and snmp and a retry count > 1GWMON-9246NMSRRDtool reference in settings for Cacti is pointing to 1.2, should be 1.4GWMON-9237Status ViewerCustomize Link text for Custom URLs in Status viewerGWMON-9230DocumentationConsole public filter syntax is incorrectly documented - OpStatus valid value is ACCEPTEDnot ACCEPTGWMON-9229JDMA"GWMON-8934 JDMA-Eliminate manual copy of profiles to the GW Server"GWMON-9216Status ViewerCreating more than 10 Status tabs runs off the viewGWMON-9167Build ProcessGwdiags should get php environment info since Nagvis and Cacti are now included by defaultGWMON-9166BookshelfLinux GDMA page improperly refers to installing windows clientGWMON-9165BookshelfCustom reports documentation is inconsistentGWMON-9158Foundation NMSIf remote RRD is used, Cacti Graph commands for the host are ignoredGWMON-9152Status ViewerAction portlet extends to the right of the other portlets in Service or Host viewsGWMON-9129BrowserIE8 only: Too much space between Top level navigation and "Welcome,admin" textGWMON-9116DashboardsHostList and Service List portlet should change title to Troubled Host/service View if show noOK/UP is selectedGWMON-9114Advance ReportsHostgroup-availability advanced reports for "Linux Servers" displays blank pageGWMON-9112BookshelfSyslog profile documentation in Bookshelf is inaccurateGWMON-9109ProfilesCheck_vsphere_* plugins have wrong shebang lineGWMON-9095BookshelfBookshelf Oracle Database Profile "check_oracle_tablespace" description is wrongGWMON-9091Build ProcessLog reports.LogMessageType table contains an invalid recordGWMON-9077BitRock PerformanceProcess_service_perfdata_file program should have option to send perf data to parentfoundation for EPR reportsGWMON-9074DashboardsThe default setting for Service List and Host portlets in the dashboard & my Groundworkshould be to not show OK or UP messagesGWMON-9073ConsoleProcessing incoming Events and update Operation Status if the Event is a status changeGWMON-9071Foundation Parent-ChildPerformanceNagios2collage_socket.pl sends substituted XML to parent servers when used with RemoteRRD configurationGWMON-9062BitRock PluginsCheck_syslog_enhanced.pl shebang line uses wrong perl interpreterGWMON-9057ToolsGwdiags should read db.properties for db credentialsGWMON-9056JBoss PortalService list portlet does not inherit admin user permissionsGWMON-9033PerformancePerformance data feeder does not send Remote RRD graph commands to standby serversGWMON-9021ConfigurationHosts might not be populated in hostgroups correctly in Foundation after a commitGWMON-9017Status ViewerFeeder -The pound character can be introduced into Host Comments resulting in Javaexception in Status ViewerGWMON-9009ConfigurationMonarch groups If the local build folder does not exist it should be created.GWMON-9000JDMAJDMA agent UI for Web Sphere has a typo in the index page that says "jbosscomponents".Please see attachedGWMON-8995BitRock GDMA NagiosParent-ChildSend_nsca configuration file should include an option to set the packet versionGWMON-8989FoundationThe foundation database may contain comments with # characters on upgradeGWMON-8984FoundationThe event log feeder does not convert every xml entityGWMON-8978ConsoleNPE - Event Console when creating a new tabGWMON-8973AdministrationAdding more than 25 host groups or service groups to an MSP role restriction has no effect.GWMON-8972ConsoleEvent Console events should allow for sorting by severity (high to low rather thanalphabetical)GWMON-8954ConfigurationLong-running Commit operations fail in the JBoss encapsulation environmentGWMON-8949DocumentationVMware ESX Server Profile (API) doc is in wrong Bookshelf sectionGWMON-8939BookshelfLDAP configuration. Bookshelf should include a note that rolesCtxDn entry needs to beidentical to baseCtxDN entryGWMON-8936BitRockThe VMWare VSphere ESX 4.0 profile tar package is corruptGWMON-8932Dashboards JBoss PortalMemory leak in IE browser when viewing Enterprise View dashboardGWMON-8908BitRock Installer StatusViewerRelated links feature in Status Viewer loses configuration in upgradeGWMON-8905Dashboards My GroundWorkStatus ViewerSeurat View: UI related CSS issuesGWMON-8894JBoss Portal Status ViewerHostListPortlet PaginationGWMON-8890Status ViewerHost list not sorting troubled services to the top in all casesGWMON-8889Status ViewerResized tree view appears to break after a whileGWMON-8873DocumentationBookshelf article on nagios WAP links to an internal groundwork hostGWMON-8836Status ViewerStatus viewer displays soft state change event when hard events have been processedGWMON-8799Advance ReportsHost state transition>service state transition >clicking on service link does not displayanythingGWMON-8759Advance ReportsSelecting any hostgroup in epr hostgroup report shows SQLException: Parameter metadatanot available for the given statement in logGWMON-8747Reports"Event History" Report has MSP implemented for its parameters window, but not for reportitselfGWMON-8716My GroundWorkAdding Seurat portlet with info portlets to a dashboard misplaces the cancel icon on the actionpop-ups in info portletsGWMON-8714PerformanceSLES ps command truncates output. This causes launch_perfdata_processing to fail.GWMON-8688JBoss PortalAfter restart of gwservices server users should be redirected to the login page and not receivea security check failure error pageGWMON-8582ConfigurationMonarch Commands could use a Search functionGWMON-8563Status ViewerCancel icon is not displayed on the selected node tabGWMON-8399ConfigurationService Instances problem when using automation toolsGWMON-8324ConfigurationEliminate multiple nested vertical scroll barsGWMON-8303Bookshelf"About Performance Graphs" page in Bookshelf needs updatingGWMON-8120Status ViewerAdd advanced viewing options to the host list portletGWMON-8075BitRockError on importing/uploading few profilesGWMON-8044Configuration DassMonarchGDMADassmonarch.pm must provide methods to manipulate monarch groupsGWMON-7903Status ViewerPop up window- close button is displayed on wrong positionGWMON-7753Auto DiscoveryPreflight failed with the error "Could not register service"1.GWMON-7518Status Viewer"Error Occurred " is displayed in Action portlet - Very IntermittentGWMON-7419Auto DiscoveryWhen trace route option is turned off, max hops and timeout should be disabledGWMON-7381ConfigurationMonarch doesn't create backup of cgi.cfgGWMON-7076Auto Discovery ConfigurationDifferent font sizes on Auto Discovery and Configuration pageGWMON-5462FoundationFoundation Perl API sample scripts need cleanupGWMON-1944Status ViewerScheduled downtime comment for host and service do not show up in the Status View UISECTION 5  KNOWN ISSUES AND LIMITATIONSFor the 6.2 release, we have changed the role names for the roles admin, operator and user to gwadmin, gwoperator and gwuserrespectively. For customers using LDAP and Active Directory, please make sure to create a new groups called gwadmin, gwoperator andgwuser 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 affectedby the 'read-only dashboards' flag. The builder can be used to access functionality that can be used to modify the monitoring system (viathe ServiceInfoPortletInstances and HostInfoPortletInstances portlets to execute commands.) If this access is not desired it isrecommended that the default portlet permissions be modified to disallow access to the "My GroundWork" application or to the individualportlets 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 dependencybetween these two services and if they become out of sync with one another the GroundWork server will generate Java IO Exceptionerrors. (GWMON-8783).Placing portlets in the bottom region of the default-dashboard layout results in the portlet being displayed without a frame or an editbutton. (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 "undefinedindex" 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 beworked around by adding the GroundWork Monitor server to the Local Intranet Zone within IE8.Additional minor known issuesKeySummaryComponent/sGWMON-2149BitRock5.1 core install gives httpd warning about determining server's fqdnGWMON-2996ConfigurationHost group downtime cannot be deletedGWMON-4815AutoDiscoveryAuto Discovery does not correctly parse multiple community strings from the snmp discovery methodGWMON-4977BitRockInstaller shouldn't assume it can write to current working directoryGWMON-5265PluginsCheck_cpu sar out input incorrect on RedHatGWMON-5434FoundationWeb Services API uses 'Device Identification' as primary key for all message types, nagios, syslog,etc, but some different devices can have same ip addressGWMON-5454ConfigurationApplying a host profile in the host interface does not apply services associated with host profile.GWMON-5491ConsoleConsole All Events view does not differentiate between Nagios alerts and notification messages.GWMON-5675ReportsTop Five report gets top five only on maximum value saved over the periodGWMON-5716ReportsHTTP ERROR: 404 on exporting data in Advanced Reports.1.GWMON-5843NMSAdmin role on NMS child interface should not have access to any configuration applicationsGWMON-6044BitRockPHP script shebang invocation no longer worksGWMON-6182PortalNon-US language versions of groundwork cause INVALID DATE STRING exceptions when specialchars in date stringGWMON-6216ConsoleEvent Console date selection is based off GMT but displays local time zoneGWMON-6485ConfigurationCan't use the Multiple Instances feature of a service check where the check command has noargumentsGWMON-6599DashboardMouse over displays scrambled text in Dashboard and is not visible properlyGWMON-7086Foundationrenaming a host does not update hostnames of new events in event consoleGWMON-7220PortalRepeated "Network Connection Interrupted" errorGWMON-7455ConfigurationUploading Group resource macros fails and removes existing configurationGWMON-7632DashboardsEvent portlet cannot be configured for host, service, servicegroupGWMON-7742ReportsAll host groups host groups status report contains incorrect informationGWMON-7755ConfigurationMonarch groups do not honor contact group assignments (host/host templates)GWMON-7628MyGroundWorkWith user's login, My Groundwork->Configure page should not have Event portletGWMON-7838NagiosNagios views from 5.3 - scheduling queue, server status and view config views are not available in 6.0GWMON-7889JBoss PortalCreating different roles with same display names gives HTTP Status 500 errorGWMON-7994ConfigurationPossible to define a service twice on a hostGWMON-8088StatusViewerGerman language setting in FF3 causes faces exceptionsGWMON-8111BitRockSetenv.sh breaks when PATH contains "groundwork" but env is not set properlyGWMON-8146ConfigurationThe Check period field does not display in any Host details screen of MonarchGWMON-8163PerformanceWide character in print at perfchart.cgi line 1277GWMON-8165JBoss PortalSetEnvIf Referrer does not provide adequate protectionGWMON-8200ConfigurationExtended Host Info Data DisappearsGWMON-8210Pluginscheck_jvm.pl calls to a hard-coded URIGWMON-8218JBoss PortalPotential exposure to man in the middle attack when using httpsGWMON-8219StatusViewerActions pop-up does gets cut off in Event ConsoleGWMON-8220DashboardPortlet popup displays outside of the viewable areaGWMON-8225BitRockMigration procedure does not account for network_service tablesGWMON-8235NagiosNagios Notification Report does not properly access report history for all hosts.GWMON-8241StatusViewerStatus Viewer - host bar graph appears to show data not related to host state but from syslogmessagesGWMON-8272BookshelfAudit Monarch Commit is missing feeder modification in Bookshelf and portlet.xml definition requiresupdateGWMON-8280ConsoleEvent console displays events from the wrong filter if action taken while viewing custom filterGWMON-8296FoundationHostStatusProperty.StringValue buffer is STILL too small to hold a large number of cacti graph URL'sGWMON-8311StatusViewerScheduled Downtime author is set to admin regardless of user logged in.GWMON-8313StatusViewerEventPortlet only shows Nagios events for hosts or hostgroupsGWMON-8425Dashboardmy groundwork dashboard layout changes affect all my groundwork pages1.1.2.3.GWMON-8444AutoDiscoverycacti host profile sync failing to import hostGWMON-8471JBoss PortalWhen a Nagios page is left open for a long period of time, a permissions error is eventually displayedGWMON-8472DashboardPortlet arrangement issuesGWMON-8481StatusViewerIf user name contains a dot (.), status viewer generates stack tracesGWMON-8494BuildProcessmysql memory usage increases continuouslyGWMON-8495JBoss PortalRedirect users to the login page in the event of gwservices restart during a sessionSECTION 6  ANNOUNCEMENTS AS OF VERSION 6.3As previously announced, GroundWork Monitor versions 5.1.x are now end-of-life. Customers using these versions are advised to contactGroundWork 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 thistime.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 INFORMATIONABOUT THE NETWORK SERVICEThis 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 installationProvides the license key hash to GroundWork for each GroundWork Monitor installationThe Network Service communicates with servers in thedomain every 12 hours via HTTPS (on TCP port 443). Allcheckforupdates.comcommunication 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 checksbeing 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.binProxy Server ConfigurationThe 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 stopcd /usr/local/groundwork/network-service/bin/editfile and add the following:agent.confproxy_host=xxx.yyy.zzz.wwwproxy_port=pppp3.4.Save your changes.Now restart the network service:./network-service-ctl.sh stop./network-service-ctl.sh startSECTION 8  SYSTEM BACKUP INSTRUCTIONSThis section outlines the recommended back up procedures to be completed before upgrading to GroundWork Monitor 6.3.Custom ChangesIt is recommended that a complete backup ofbe taken before upgrading. If this is not possible the following should be/usr/local/groundworkconsidered the bare minimum set of files to be preserved.ComponentLocationPlugins/usr/local/groundwork/nagios/libexecCGI graphs/usr/local/groundwork/apache2/cgi-bin/graphsEventhandlers/usr/local/groundwork/nagios/eventhandlersSNMPTT configurationsnmptt.conf, snmptt.iniCustom syslog filterssyslog.conf, syslog-ng.confLogrotatelogrotate.conf, any changes under /etc/logrotate.dFoundation configurationfoundation.propertiesNSCA configurationnsca.cfgDistributed deployment configurationMonarchDeploy.pmUser directoryThe contents of the 'nagios' user home directoryUser directoryThe contents of the 'nobody' user home directoryThe last configuration file/usr/local/groundwork/nagios/etc/config-last.logApacheAll modified apache configuration filesCoreThe contents of /usr/local/groundwork/etcCoreThe contents of /usr/local/groundwork/backupCoreThe contents of /usr/local/groundwork/jobsRRD files/usr/local/groundwork/rrdNagios configuration/usr/local/groundwork/nagios/etcBack 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/rrdtar cfz GWMON-xxx-nagios.tar.gz /usr/local/groundwork/nagios/etctar cfz GWMON-xxx-users.tar.gz /usr/local/groundwork/usersMySQL DatabasesGroundWork recommends that all MySQL databases be backed up before upgrading. Here are the upgrade procedures to migrate the databasesto 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_.sqlGuava (Framework)mysqldump -uroot guava > /usr/local/backup-gwmon/guava_-YYYYMMDD-HHMMSS_.sqlFoundation (Monitor Data)mysqldump -uroot GWCollageDB > /usr/local/backup-gwmon/GWCollageDB_-YYYYMMDD-HHMMSS_.sqlLog Reportingmysqldump -uroot logreports > /usr/local/backup-gwmon/logreports_-YYYYMMDD-HHMMSS_.sqlGroundWork Configuration FilesMonarchBack 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/backuptar cfz GWMON-xxx-performance_views.tar.gz /usr/local/groundwork/core/performance/performance_viewsIf 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.pmtar cfz GWMON-xxx-monarchexternals.tar.gz /usr/local/groundwork/core/monarch/lib/MonarchExternals.pmApacheIf you have configured Apache for secure SSL authentication any HTTPS certificates need to be preserved (the directory of the HTTPScertificates may differ from the example below):tar cfz ssl-keys.tar.gz /usr/local/groundwork/apache2/conf/ssl.keysyslog-ngtar cfz GWMON-xxx-syslog-ng-data.tar.gz /usr/local/groundwork//log/syslog-ngvarObtaining Source CodeGroundWork 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 licenseterms. GroundWork Monitor products are released under the terms of the various public and commercial licenses. For information on licensingand open source elements please see. GroundWork, GroundWork Open Source,http://www.gwos.com/products/pro-ipingredients.htmlGroundWork 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 ofEthan Galstad, are the property of other third parties. These Marks may not be used without the prior written consent of GroundWork OpenSource or the third party that owns the respective Mark.