VMware vFabric User`s Manual
Contents
1. Emergency requests are handled by the first available engineer If you are reporting an emergency and you receive a recorded message do not use the voicemail option Transfer your call to the operator who will take a message and immediately contact an engineer Non emergency requests received by telephone are placed in the normal support queue for evaluation and response 24x7 Emergency Technical Support GemStone offers at an additional charge 24x7 emergency technical support This support entitles customers to contact us 24 hours a day 7 days a week 365 days a year if they encounter problems that cause their production application to go down or that have the potential to bring their production application down Contact your GemStone account manager for more details 12 GemStone Systems Inc Preface GemStone Support Web Site The GemStone support web site at http techsupport gemstone com provides a variety of information to help you use GemStone products Use of this site requires an account but registration is free of charge To get an account just complete the Registration Form found in the same location You ll be able to access the site as soon as you submit the web form The following types of information are provided at this web site gt Help Request is an online form that allows designated technical support contacts to submit requests for information or assistance via E mail to GemStone Technical Support2. Runtime Requirements 1 2 Installing and Uninstalling GFMon Setting Environment Variables 1 3 GFMon License Files 1 4 GFMon Product Tree GFMon Product Documentation Chapter 2 GFMon Overview Chapter 3 System Configuration Starting an Admin Agent Using Locators Starting an Admin Agent Using Multicast Running Multiple Instances of GFMon Disconnecting From the Admin Agent in GFMon GemFire Enterprise Developer s Guide o vvo O 12 12 13 15 16 16 16 16 17 17 18 18 19 20 20 21 23 24 24 25 25 Chapter 4 Monitoring the Gem Fire Distributed System Using GFMon 27 4 1 Accessing Information Left Panel Summary Panel Overview Panel Data Panel Members Panel Alerts Panel Preferences Panel Status Bar 4 2 Error Notifications Displayed by GFMon Glossary Index 28 29 30 31 37 39 41 44 47 48 49 5I GemStone Systems Inc Figure 4 1 Figure 4 2 Figure 4 3 Figure 4 4 Figure 4 5 Figure 4 6 Figure 4 7 Figure 4 8 Figure 4 9 Figure 4 10 Figure 4 11 Figure 4 12 Figure 4 13 Figure 4 14 Figure 4 15 Left Panel Summary Panel Overview Panel System Alert Statistic Alert Information Alert Details for Member Panel Data Panel Members Panel Alerts Panel Details for Events in the GFMon Event Viewer Preferences Connections Tab Preferences General Tab Status Bar The Progress View GemFire Enterprise Developer s Guide 29 30 31 32 32 33 35 37 39 41 42 44
3. gt Technotes provide answers to questions of general interest submitted by GemStone customers They may contain coding examples links to other sources of information or downloadable code gt Bugnotes identify performance issues or error conditions that you may encounter when using a GemStone product A bugnote describes the cause of the condition and when possible provides an alternative means of accomplishing the task In addition bugnotes identify whether a fix is available either by upgrading to another version of the product or by applying a patch Bugnotes are updated regularly gt Patches provide code fixes and enhancements that have been developed after product release A patch generally addresses a specific group of behavior or performance issues Most patches listed on the GemStone Web site are available for direct downloading gt Tips and Examples provide information and instructions for topics that usually relate to more effective or efficient use of GemStone products Some Tips may contain code that can be downloaded for use at your site gt Release Notes and User s Manual for your product software are provided in PDF format gt Community Links provide customer forums for discussion of GemStone product issues Technical information on the GemStone web site is reviewed and updated regularly We recommend that you check this site on a regular basis to obtain the latest technical information for GemStone products We
4. Choose Stats window is displayed GemFire Enterprise System Administrator s Guide 41 Accessing Information Chapter 4 3 From the drop down menu choose the statistic type The available statistics for the type you have chosen are displayed in the Statistic Name section 4 Select the Statistic Name s and click the right arrow to move them to the Statistics Type Statistic name section If you want to deselect any values select the values in the Statistics Type Statistic name section and click the left arrow button 5 Click Select The statistics that you have selected are displayed in the Select Statistics table You can add more values to the table by repeating the above steps To remove a value select the check box in the Remove column and click Remove 6 Ifyou have selected more than one statistic value you must apply a function to the statistics to create alerts In the Trigger section select the check box beside Apply Function The drop down list is populated with the available functions 7 Inthe Trigger section select the function that you want to use and specify either the Number for which the statistic value must be greater than or less than or the Range within which the statistic value must fall You cannot apply a function if you have selected only one statistic value 8 Click Save to save the alert definition The alert name is now displayed in the Available Alert Definitions section 9 To modify an aler
5. MBean information By providing a summary of all the relevant statistics in the system GFMon gives the end user a bird s eye view of the overall health of the system For example severe and warning messages written to the GemFire log are automatically converted to JMX strings and are displayed in GFMon These alerts would indicate problems in the operating environment of one or more system members prompting you to take action GemFire Enterprise System Administrator s Guide 21 Chapter 2 22 GemStone Systems Inc System Configuration This chapter describes system configuration required to deploy VMware vFabric M GemF ire GFMon Before you begin with the procedure in this chapter configure the distributed system with instructions provided in the GemFire documentation Ensure that the distributed system has a running Admin Java Management Extensions JMX agent with RMI enabled Setting Up a Cache Server 1 GemFire Enterprise System Administrator s Guide 23 Start the cache server To specify the cache server configuration properties during start up you can use the Java command line API or the gemfire properties file For more information about configuring the cache server see the GemFire documentation After you have configured the cache server identify the locator or the multicast information through which membership discovery should occur You can start the cache server by specifying the multicas
6. Time 2011 02 14 19 08 54 GMT 05 30 Last Time 2011 02 14 19 08 54 GMT 05 30 Count 1 Statistic Name Last Value Mean Value Range Min Max creates 1668335 1 668 335 1668335 1668335 destroys 1659502 1 659 502 1659502 1659502 gets 1659563 1 659 563 1659563 1659563 puts 3958412 3 958 412 3958412 3958412 updates 1371021 1 371 021 1371021 1371021 32 GemStone Systems Inc Monitoring the GemFire Distributed System Using GFMon Accessing Information gt Information Alert When you double click on an information alert distinguished by red color a pop up window including the following information is displayed gt Member name The name of the member for which this alert has been raised if applicable gt Alert Time The date and time of the alert gt Severity Level of severity of the alert gt Detail Message The information alert message in detail Figure 4 6 Information Alert EF Information Alert at 19 20 01 x Member Name GemFireApplication1 Alert Time 2009 04 15 19 20 01 GMT 05 30 Severity Nia Detail Message Crashed Alerts are aggregated that is the event triggering the alert is shown as a single entry with updates only in the Last Raised Time column Distinct Statistic alerts defined by the user are aggregated for each member System alerts are aggregated across the members by the type of event that triggers the alert The color in the System Status section in the Left Panel chang
7. also welcome suggestions and ideas for improving and expanding our site to better serve you Training and Consulting Consulting and training for all GemStone products are available through GemStone s Professional Services organization gt Training courses are offered periodically at GemStone s offices in Beaverton Oregon or you can arrange for onsite training at your desired location gt Customized consulting services can help you make the best use of GemStone products in your business environment Contact your GemStone account representative for more details or to obtain consulting services GemFire Enterprise Developer s Guide 13 Preface 14 GemStone Systems Inc Product Installation This chapter covers system requirements and licensing for VMware vFabric GemFire GFMon and lists the product tree Systems that meet the requirements described here are suitable for installing and running GFMon This chapter covers the following gt System Requirements page 16 gt Installing and Uninstalling GFMon page 18 gt GFMon License Files page 19 gt GFMon Product Tree page 20 Ifyou are upgrading an existing GFMon installation be sure to check the Release Notes for upgrade and migration instructions To contact GemStone Technical Support gt On the web http techsupport gemstone com gt By e mail techsupport gemstone com gt By phone 800 243 4772 or 503 533 3503 GemFire Enterprise
8. by RMI GFMon fails to connect to the agent After entering the host name click Connect to connect to the distributed system After connecting to the distributed system the label for Connect button changes to Disconnect To disconnect from the distributed system click Disconnect When you disconnect from the agent in GFMon or if the JMX agent shuts down the data in the panels is not cleared When you connect to any distributed system again the panels are cleared and populated with the new data GemFire Enterprise System Administrator s Guide 29 Accessing Information Chapter 4 gt The System Status section displays the state of the distributed system to which you are connected The following colors are displayed gt Green the system is functioning normally gt Yellow user defined statistic alerts are raised and or system alerts with severity Warning are raised gt Red system alerts with severity Error or Severe are raised and or a member has crashed To reset the GFMon System Status indicator click Reset State For more information point the mouse pointer at any lights displayed in the System Status section Tool tips When you place the mouse pointer over various GFMon user interface UI elements tool tips appear and provide to you additional information about the specific UI element Summary Panel The top most section in the Overview Data Members or Alerts panel displays the host and port of the admin ag
9. configuration attributes 21 23 D disk space installation requirement 16 distributed system configuring 21 23 documentation where installed 20 G GFMon Accessing Information 28 documentation 20 installing 15 Launch 25 product tree 20 installation 15 requirements 16 running the installer 18 GemFire Enterprise Developer s Guide L Linux system requirements 16 O operating system installation requirement 16 overview of system administration 28 P platform installation requirement 16 product directory contents 20 product documentation where installed 20 product tree 20 R RAM installation requirement 16 requirements for installation 16 S swap space installation requirement 16 system administration overview 28 installation requirements 16 T Technical Support contacting 15 typographical conventions 9 W Windows system requirements 16 51 Index 52 GemStone Systems Inc
10. documentation for your GFMon products is provided in PDF format and can be viewed with any frames capable web browser These guides can be accessed through the index page in the GFMon docs directory Windows lt productDir gt docs UserManual_GFMon pdf Linux lt productDir gt docs UserManual_GFMon pdf You can also access the user manual through the GFMon tool To launch the user manual click Help gt User Manual Ensure that a web browser is installed On systems running Linux a web browser is launched and you are given the option to open the file with an associated PDF viewer In addition to the current document the Release Notes placed in the GFMon product directory describe differences between the current release and previous product releases GemStone Systems Inc GFMon Overview A GemFire distributed system is a collection of cache servers and data stores that provide consistent access to stored data A typical GemFire deployment consists of a combination of processes gt Cache Servers Data stores gt Locators gt Clients gt WAN gateways For more information about GemFire see the GemFire documentation Each process in the distributed system consumes resources like CPU memory disk and bandwidth and provides the ability to access and manipulate data that is stored in the distributed system cluster Each data store is comprised of multiple data regions Regions can be replicated or partition
11. for a member in the GemFire Enterprise System Administrator s Guide 39 Accessing Information Chapter 4 Alerts panel This section displays the alerts that originated on the member since the last reset For details double click on an alert to display a pop up window similar to Figure 4 5 gt Member s Clients This table lists the details of the clients connected to each member Select a member in the Member Summary Viewer table to view the following attributes for each of the member s clients gt Client ID a unique auto generated ID identifies the client gt Client Name a Client short name extracted from the client ID Displays N A if the name can t be extracted from the Client ID gt Host The name of the host the client is running on gt Queue Size The queue size for this client on the server that this client is connected to gt Gets number of gets sec that the client is executing on the cache gt Puts number of puts sec that the client is executing on the cache gt Cache Misses The number of times a get operation on the client cache resulted in the data being fetched from a server because it was not already present in the client cache gt CPU Usage CPU usage of the client gt Threads total number of threads in the client application gt Cache Listener Invocations the number of times the cache listener has been invoked Client statistics are displayed only if statistic sampling and time
12. lt cachePerfStats gt destroys nase A oO CachePerfStats lt cachePerfStats gt gets oO CachePerfStats lt cachePerfStats gt puts Agent Port Oo CachePerfStats lt cachePerfStats gt updates 27454 z w System Status Trigger Apply Function Sum Threshold Number Greater Than x 10000 0 Reset State O Range T Delete aoo GFMon Event Yiewer GEMFIRE Node Discovered Mon Feb 14 17 37 33 GM bridgegemfire_1_4_nase_ Added Node Left Mon Feb 14 17 39 08 GM bridgegemfire_1_ _nase_ Left Internal Warning Mon Feb 14 17 39 09 GM bridgegemfire_1_2_nase_ _ time statistics are not enabled Node Joined Mon Feb 14 17 39 09 GM bridgegemfire_1_2_nase_ Joined Async Op Completed Mon Feb 14 17 41 03 GM bridgegemfire_1_2_nase_ Executed Async Operation updateAlertDefinition Stat Alert Mon Feb 14 17 41 20 GM bridgegemfire_1_2_nase_ Alert Mon Feb 14 17 39 27 GM _ bridgegemfire_1_2_nase_ warning 2011 02 14 17 39 27 202 IST gatew Node Left Mon Feb 14 17 40 46 GM bridgegemfire_1_4_nase_ Left Internal Warning Mon Feb 14 17 40 49 GM bridgegemfire_1_4_nase_ _time statistics are not enabled Node Joined Mon Feb 14 17 40 49 GM bridgegemfire_1_4_nase_ Joined A To create custom alerts in GFMon 1 Inthe Create Alert Definitions section enter a name for the alert 2 In the Select Statistics section click Add The
13. reporting a fatal error The error pop up window is shown when the following conditions occur gt The JMX agent that GFMon is connected to shuts down A pop up window titled Fatal Error is displayed with the following message JMX Agent has shutdown GFMon is started and running with a gemfire jar file which is incompatible with the version of the gemfire jar file of the running JMX Agent In this condition a pop up window titled Fatal Error is displayed For example if you run GFMon with the gemfire jar file of GemFire version 5 7 to monitor a GemFire version 5 7 1 or GemFire version 5 8 distributed system the message is GFMon could not connect to the GemFire Distributed System This version of GFMon is compatible with GemFire Enterprise 5 7 GFmon encountered a Class Mismatch Please shutdown GFMon and restart with a compatible GemFire version GFMon encounters an error during run time while retrieving data from the admin agent A pop up window titled Fatal Error is displayed with a message depending on the error that has occurred To fix the issue close the pop up window and perform the following procedure l 2 Turn off GFMon Reset the environment variable GEMFIRE to point to the GemFire product location from which the admin agent is running Restart GFMon GemStone Systems Inc alert administrative event cache cache xml cache server canned chart connection distributed ca
14. you have selected is a Gateway the Gateway Hub section is displayed This section displays the listening port and the Gateway ID The Find Points table displays the following gt ID The ID of the Gateway end point gt Host Port The host name and port ID of the Gateway end point gt Connected Whether the gateway is connected or not GemStone Systems Inc Monitoring the GemFire Distributed System Using GFMon Data Panel Accessing Information The Data panel provides a bird s eye view of the GemFire data regions using pie charts The Data panel also provides details like scope and data policy of each region across the members Figure 4 8 Data Panel R Gemrire Monitoring File Help GFMon Connected To Agent nase 27454 Overview B Data All Regions EE Members egio Globalvillage_4 a Alerts GlobalVillage_1 Globalvillage_2 Globalvillage_2 Globalvillage_2_0 Globalvillage_O Globalvillage_5 Globalvillage_5_0 Globalvillage_5 E Preferences Quick Connect Agent Host Globalvillage_3 Globalyillage_3_0 rae Globalvillage_1 Globalvillage_1_0 Globalyillage_4 Globalvillage_ _0 Agent Port Globalvillage_3 Globalvillage_0 Globalvillage_0_0 27454 v System Status Servers 4 5 No Data 5 No Data 85 5 No Data 4 5 No Data 93 5 No Data 4 5 No Data 91 5 No Data 4 5 No Data 4 5 No Data 4 5 No Data 78 5 No Data 4 5 No Data Gateways 2 Clients Total Entries TotalRepl
15. 2 Overview B Data SE Members E Alerts E Preferences Queues CPUm of Clients Quick Connect Agent Host rae E bridgegemfire_1_2_nase gatewaygemfire_1_1_na gatewaygemfire_1_2_na bridgegemfire_1_1_nase Agent Port nase 20508 46477 5 v System Status nase 20604 46475 nase 20627 46455 bridgegemfire_ nase 21431 46441 gatewaygemfir nase 21405 46440 gatewaygemfir nase 20519 46485 bridgegemfire_ Member s Clients Member Name bridgegemfire_2_3_nase_20604 nase 21097 loner 3 edgegemfir nase pune No Data No Data No Data No Data No Data nase 21201 loner 1 edgegemfir mase pune No Data No Data No Data No Data No Data Member Alerts Viewer Member Name bridgegemfire_2_3_nase_2060 average messages 2011 02 14 173 sum Ops 2011 02 14 17 GEMFIRE The bar chart in the Members panel displays the number of clients CPU usage percentage and the Queues for each member in the distributed system at current time gt Member Summary Viewer This table lists the member attributes like ID Name Total Regions Root Regions Clients Queues Total memory in MB Gets sec Puts sec Threads and Network Usage KB The member ID is a unique auto generated value that identifies the member gt Member Alerts Viewer This table displays the Definition ID and Time for the alerts for the member selected in the Members Summary Viewer You can configure alerts
16. 45 47 47 List of Figures 6 GemStone Systems Inc Table 1 1 Operating System Support Matrix 16 Table 1 2 Runtime Requirements 17 Table 4 1 Event types Logged in the GFMon Event Viewer 43 GemFire Enterprise Developer s Guide 7 List of Tables 8 GemStone Systems Inc About This Guide This guide describes the VMware vF abric GemFire Monitor GFMon functions that monitor the GemFire product which is typically used for distributed caching and data distribution For information about the GemFire product see the GemFire documentation located on www gemstone com How This Documentation Is Organized This guide contains the following sections gt Chapter 1 Product Installation on page 15 lists system requirements and tells how to install GFMon gt Chapter 2 GFMon Overview on page 21 describes the role of GFMon in managing your GemFire distributed systems gt Chapter 3 System Configuration on page 23 tells how to set up your GFMon system gt Chapter 4 Monitoring the GemFire Distributed System Using GF Mon on page 27 describes the functionality of various panels in GFMon gt Glossary on page 49 provides a list of terms and their definitions Typographical Conventions This document uses the following typographical conventions gt Methods types file names and paths folder names code listings and prompts are shown in Courier New typeface For example gfPut gt Parameters and variables
17. 753 bridgegemfire_ nase 17 33 5 04 1 min 51 secs 2 F M gt gt Alerts The Alerts table displays a summary of alerts triggered by events occurring in the distributed system The table displays both System alerts and the Statistics alerts defined by the user To clear an alert in the Alerts section right click and select Clear Double click on any of the alerts in the Overview Panel gt Alerts or Member Panel gt Member Alerts Viewer to see more information about the alerts The following pop up windows are displayed GemFire Enterprise System Administrator s Guide 31 Accessing Information Chapter 4 gt System Alert pop up When you double click on a system alert a pop up window including the following information is displayed gt Member Names The names of the members for which the system alert has been raised gt First Time The time at which the alert was raised for the first time gt Last Time The time at which the alert was raised for the last time gt Severity Displays the severity of the alert Severity can be either Warning Error or Severe gt Detail Message The detail log message for the alert Figure 4 4 System Alert ER System Alert at 19 16 29 Ea Member Names 4atewaygemfire_1_2 nase_21277 First Time 2011 02 14 19 16 29 GMT 05 30 Last Time 2011 02 14 19 16 29 GMT 05 30 Severity warning Detail Message Pool unexpected socket closed on se
18. GEMSTONE GEMFIRE ENTERPRISE VMware vFabrice Gem Fire GFMon User s Manual Version 2 5 February 2011 Send comments on this guide to docs gemstone com GemStone Systems Inc www gemstone com INTELLECTUAL PROPERTY OWNERSHIP This software product or any part of it may not be reproduced displayed photocopied transmitted or otherwise copied in any form or by any means now known or later developed such as electronic optical or mechanical means without express written authorization from GemStone Systems Inc Warning This computer program and its documentation are protected by copyright law and international treaties Any unauthorized copying or distribution of this program its documentation or any portion of it may result in severe civil and criminal penalties and will be prosecuted under the maximum extent possible under the law Use duplication or disclosure by the Government is subject to restrictions set forth in the Commercial Software Restricted Rights clause at 52 227 19 of the Federal Acquisitions Regulations 48 CFR 52 227 19 except that the government agency shall not have the right to disclose this software to support service contractors or their subcontractors without the prior written consent of GemStone Systems Inc COPYRIGHTS Copyright 1997 2011 VMware Inc All rights reserved This product is protected by U S and international copyright and intellectual property laws VMware products are c
19. System Administrator s Guide 15 System Requirements Chapter 1 1 1 System Requirements This version of GFMon is designed to run with full capabilities on platforms running Linux and Microsoft Windows Supported Platforms This section lists the platforms that GFMon supports If you are interested in a platform that is not listed please contact your GemStone sales representative GemStone will evaluate whether it can support the platform either as is or under a special agreement or whether there are reasons that prevent deploying on a particular platform GFMon supports the following configurations Table 1 1 Operating System Support Matrix Operating System JDKs and JREs Sun JSE 1 6 0 17 Sun JSE 1 6 0 23 Red Hat Enterprise Linux 5 patch 3 kernel ver X sion 2 6 18 128 EL with GTK 2 10 4 20 e15 Windows XP 32 bit SP3 X Windows XP 64 bit SP2 X Microsoft Windows Server 2003 SP2 X GFMon does not run in 64 bit mode but you can run GFMon in 32 bit mode on 64 bit systems These sections list the operating systems used for building and testing GFMon GFMon may work with later system releases upon which it has not been tested Windows GFMon has been tested successfully on gt Windows XP 32 bit SP3 gt Windows XP 64 bit SP2 gt Windows Server 2003 SP2 Linux GFMon has been tested successfully on gt Red Hat Enterprise Linux 4 patch 7 kernel version 2 6 9 78 EL gt R
20. This section provides a tabular view of the following region attributes gt Scope For any region that is not partitioned the region scope determines whether and how region data is distributed between the local cache and the rest of the distributed system gt Data Policy The data policy attribute for each member determines which data is stored in the local cache gt Interest Policy For each member the interest policy defines the entry operations that are delivered to the local cached region gt Disk Attributes Disk attributes determine where and how region data is overflowed or persisted to a disk You can define attributes templates inside the lt cache gt and lt region gt elements and assign IDs for later retrieval gt Cache Loader A cache loader automatically loads data from an outside source such as a database In a distributed region that is not partitioned one member may host the cache server for the entire distributed region Loading into a partitioned region requires a cache loader in every partition 38 GemStone Systems Inc Monitoring the GemFire Distributed System Using GFMon Accessing Information Members Panel The Members panel displays the characteristics of each member in the distributed system alerts specific to the selected distributed system member Figure 4 9 Members Panel GemFire Monitoring File Help GFMon Connected To Agent nase 27454 Servers 4 Gateways 2 Clients 1
21. ame the Name of the member You can provide this name while starting GemFire through the gemfire properties file or the name is inferred from the member ID gt Host the host on which the member is running gt Heap Usage displays the used heap memory of the member VM as a percentage of the maximum heap memory gt CPU Usage displays the percentage of the process CPU utilization gt Clients number of clients in the cache server if applicable gt Uptime total time the node has been up and running The Members Summary section displays the member ID for each member Other information panels display the member name If you do not configure a member name GFMon constructs the member name from the member ID 34 GemStone Systems Inc Monitoring the GemFire Distributed System Using GFMon Accessing Information Double click on a row in the Members Summary section to open the Details for member screen The Details for member screen provides additional information about each member Figure 4 7 Details for Member Panel FicemFire Monitoring File Help GFMon overview B Data ES Members Be Alerts E Preferences Quick Connect Agent Host nase ha Agent Port neea v System Status g Details for member Rate of Cache Operations CPU 14 46 getsisec 433 67 Globalvillage_0 Globalviilla Globalvillage_0 Globalvillage_4 Globalvilla Globalvillage_1 Glo
22. archive to a location in the file system to install the software The gfmon bat and gfmon files are created in this location Use these files to run GFMon on Microsoft Windows and Linux respectively By default gfmon bat and gfmon files use the environment variable java to point to the JDK version that is available in the system If you want to execute GFMon using a specific version of JDK you can specify the location of the java executable file using the environment variable GF_ JAVA You can obtain the instruction file from your GemStone salesperson or from the GemStone website at http www gemstone com download To access the website you need to enter your login and password If you are new to GemStone products to register and create a login and password to get into the download center You can uninstall GFMon by deleting the entire product tree Setting Environment Variables 18 Set the environment variable GEMFIRE to point to the GemFire product directory This directory must be the same as the GemFire product directory which is being used by the JMX admin agent that GFMon connects to monitor the distributed system The GF Mon start up scripts use the gemfire jar in the GEMFIRE 1ib directory to launch GF Mon To use a specific JVM set the environment variable GF_JAVA to the required JVM binary For example on Windows platforms execute the following command set GF_JAVA C jdk1 5 0 bin java exe On Linux platforms execu
23. are shown in italic font For example gfConnect sysDir connectionName writeProtectAllowed gt In examples showing both user input and system output the lines you type are distinguished from system output by boldface type prompt gt gemfire GemFire Enterprise System Administrator s Guide 9 Preface gt Ifyou are viewing this document online the page section and chapter references are hyperlinks like this reference to nstalling and Uninstalling GF Mon on page 18 and this reference to Chapter 4 Monitoring the GemFire Distributed System Using GFMon on page 27 Blue text denotes a hyperlink Other Useful Documents The GemFire online Java API documentation can be accessed through the file index html in the GemFire s docs directory This file is located under your Gemfire GFE installation as docs japi The GemFire documentation describes the major services and functions in GemFire and describes the system administration functions required to install deploy and manage the GemFire product The Visual Statistics Display guide describes how to use the Visual Statistics Display VSD tool which is used to analyze archived historical data Contact GemStone Technical Support for instructions about acquiring VSD and its documentation 10 GemStone Systems Inc Preface Technical Support GemStone provides several sources for product information and support The GemFire documentation and the GFMon online Java API provide exte
24. balviilla Globalvillage_3 Globalvillage_4 Globalvillage_3 Globalviilla Globalvillage_5 Globalvillage_2 Globalvilla Globalvillare 2t nase 21405 46440 52109 Gets Sec Puts Sec 17 52 17 54 17 56 18 00 Mi es sasana 500 L ULN EE IE A et A g 18 02 18 04 18 06 18 08 Memory 24 of 127 MB putsisec 985 17 Entry Size MB Data Policy Disk attrs Backup Persiste Entries Time to tries Time to 0 Replicate Replicate Replicate Replicate Replicate Replicate Replicate Replicate Replicate Denlicato Asynchronous Asynchronous Asynchronous Asynchronous Asynchronous Asynchronous Asynchronous Asynchronous Asynchronous fewnehraneiic Gateway Hub Listening Port 26731 bridgeds_1 Queue Size End Points bridgeds_1_vmid_30 bridgeds_1_vmid_31 GemFire Enterprise System Administrator s Guide 10 60 250 233 22710 10 60 250 233 23692 S4 35 Accessing Information Chapter 4 gt 36 Rate of Cache Operations This graph plots the get and put operations occurring per second over the period of time specified Regions Configurations This table lists the attributes of the regions in the distributed cache The table includes region attributes like name data policy disk attributes and backup persistence The table also shows entry count and entry size Gateway Hub If the member that
25. ber for the agent that the netstat reported or use the information in the agent log file 2 Click Connect to initiate the connection Running Multiple Instances of GFMon You can run multiple instances of GFMon by invoking the GFMon script directly You are not required to provide a different log file directory as a parameter as in GFMon version 2 0 Disconnecting From the Admin Agent in GFMon To disconnect from the agent that is running on the GemFire distributed system click Disconnect on the left panel of the user interface GemFire Enterprise System Administrator s Guide 25 Chapter 3 26 GemStone Systems Inc Monitoring the GemFire Distributed System Using GFMon GFMon allows you to manage and monitor a GemFire distributed system in real time You can view the following information gt Overall health indicators of the distributed system gt Overall system information gt Information on various configurational aspects of the distributed system gt Aggregate and detailed information on various operational aspects of the distributed system gt System alerts that allow you to take the appropriate corrective action gt Summary of alerts that have occurred across the distributed system GFMon also provides the following features gt A rich graphical user interface GUI with information on memory and CPU usage across the servers in the distributed system gt Ability to create custom alerts by specifying sy
26. buted System Using GFMon Accessing Information Status Bar The status bar at the bottom of your GFMon window provides various alerts Figure 4 14 Status Bar wow owe ry wee ow wim wm repr pee one ase 2 11 NjA For a peer ase 1 71 N A for a peer ase 2 29 o Be ery N A for a peer ase 1 59 eee 17 55 08 NjA for a peer ase 1 66 NjA For a peer N A for a peer The following icons are displayed at various times indicate the following N This Icon appears when a JMX connection is established A A These icons are displayed when any alerts occur ate _ S This icon is displayed when any background jobs are in progress This icon is displayed after you connect to the distributed system and contains information about the agent connection agent disconnection and the alerts that you save Click this icon to expand or collapse the Progress view shown in the illustration below Figure 4 15 The Progress View vo m i Successfully Created Updated StatAlertDefinition lt Dataflow gt Finished at 4 43 PM x Create Update Stat lertDefinition Successfully connected to host port lt pc42 2050 gt Finished at 4 30 PM x Connect to JMX Agent GemFire Enterprise System Administrator s Guide 47 Error Notifications Displayed by GFMon Chapter 4 4 2 Error Notifications Displayed by GFMon 48 During failure situations described below GFMon displays a pop up window
27. che distributed system event expressions GFMon JMX A message triggered by certain events in the GemFire distributed system You can customize alerts to notify you about the events of your interest See event A data cache created by an application or cache server This is the point of access for Java applications for all caching features and the only view of the cache that is available to the application Cache creation requires a connection to the distributed system An XML file that declares the initial configuration of a cache This file is used to customize the behavior of the GFMon cache server process and can be used by any Java application Applications can also configure the cache through the GFMon Java APIs A long lived configurable GFMon distributed system member process Charts that a pre configured in GFMon These charts cannot be modified The connection used by a Java application to access a GFMon system A collection of caches spread across multiple machines and multiple locations that functions as a single cache for the individual applications One or more GFMon system members that have been configured to communicate with each other forming a single logical system Also used for the Java object that is instantiated to create the connection between the distributed system members An action recognized by the GFMon system members which can respond by executing callback methods The GFMon API produces two typ
28. e directory in the lt GFMon product directory gt folder gt For Windows save the Dr Watson output This is located in the C Documents and Settings All Users Application Data Microsoft Dr Watson directory You can configure Dr Watson as the default debugger by typing the drwtsn32 I command from a Windows command prompt gt Process core dump files and crash dump files on UNIX systems gt For Linux you can use gdb to extract a stack from a core dump file Call Technical Support if you need assistance If the GFMon application on your virtual machine VM is hung and you do not have to close it retain the application while you contact Technical Support If you cannot leave the VM running and it is running under Unix or Cygwin on Microsoft Windows signal it twice with this command letting five to ten seconds pass between the two signals kill QUIT pid This sends the stack dumps of the VM to the log file for inspection For Windows systems call Technical Support for assistance in obtaining stack dumps Do not delete any files until you call Technical Support GemFire Enterprise Developer s Guide 11 Preface Contacting Technical Support When contacting GemStone Technical Support please be prepared to provide the following information gt Your name company name and GemFire license number gt The GFMon product version you are using gt The hardware platform and operating system you are using gt A descri
29. ed Applications can perform a wide variety of operations on the data ranging from map like data access and update to running queries and transactions on the data The distributed system maintains group membership information and also stores statistics about every relevant aspect of the system Each member can be configured to write out its statistics to a pre configured file These files can be inspected using GemFire tools for offline inspection of the data Every statistic that is written by GemFire is also available as a JMX MBean GemFire provides an agent process that can be started in each system The agent which is an MBean server provides JMX access to important statistical runtime information about the system The agent supports HTTP and RMI adaptors You can use JMX at run time to mine the statistics you need to monitor Many GemFire customers choose to directly interface with the agent process GFMon is a graphical monitoring tool that allows you to easily view useful pertinent information about the state of the system at any moment GFMon runs as a JMX client that connects to the agent process retrieves relevant statistics and presents them to the end user GFMon uses the same API that any JMX client would use to collect information about the GemFire system GFMon requires an agent process to start up See Chapter 3 System Configuration on page 23 for details on how to start an agent process that connects to the system and receives
30. ed Hat Enterprise Linux 5 patch 3 kernel version 2 6 18 128 EL If you are not sure of the kernel version on your system use this command to list it prompt gt uname r Java Runtime Requirements A Java Runtime Environment JRE 1 5 0 or later must be installed for GFMon to run GFMon does not include a bundled JRE or JDK so you can choose the version that best suits your unique system requirements You can download the appropriate JDK or JRE from http java sun com 16 GemStone Systems Inc Product Installation System Requirements Other Software Requirements Adobe Acrobat Reader is required for viewing the documentation distributed as PDF files Download a free copy at http www adobe com products acrobat readstep html A web browser is required to launch the User Manual from the GFMon Help menu Runtime Requirements GFMon has machine related runtime requirements which are covered in this section Table 1 2 Runtime Requirements Hardware Software Requirement Version Operating System See Operating System Support Matrix Processor Intel 2 GHz Pentium 4 or equivalent System memory 1 GB RAM recommended Software on the system on which the Admin Agent is GemFire 5 7 or later configured GemFire Enterprise System Administrator s Guide 17 Installing and Uninstalling GFMon Chapter 1 1 2 Installing and Uninstalling GFMon GFMon is distributed as a ZIP archive Extract the ZIP
31. ent to which GFMon is connected or disconnected The number of servers gateways and clients in the distributed system are also displayed in this summary panel Figure 4 2 Summary Panel Connected To Agent nase 27454 Servers 4 Gateways 2 Clients 12 30 GemStone Systems Inc Monitoring the GemFire Distributed System Using GFMon Accessing Information Overview Panel The Overview panel provides the aggregated system health information of all members in the distributed system the agent that you are connected to summary view of alerts from all members in the distributed system and basic member information Figure 4 3 Overview Panel Gr Gem Fire Monitoring JO x File Help GFMon Connected To Agent nase 27454 Overview B Data EEE Members alerts E Preferences Servers 4 Gateways 2 Clients 12 Alerts Quick Connect Agent Host System Memory Usage nee a Aggregate Heap Usage Agent Port k Disconnect v System Status Reset State Resources Utilization Summary CPU Usage ill Heap Usage 17 33 10 29 gatewaygemfire_1_1_ gatewaygemfire_1_2_ bridgegemfire bridgegemfire_1_4_n Members Summary nase 4609 lt v4 gt 14250 4 gatewaygemfir nase 15 64 15 21 11 mins 1 sec 4 nase 3853 lt v7 gt 61835 3 bridgegemfire_ nase 4 58 4 58 10 mins 53 secs 3 G E M Fi R E nase 3821 lt v13 gt 60
32. es of events cache events for detail level management of applications with data caches and administrative events for higher level management of the distributed system and its components An operation can produce administrative events cache events or both Expressions perform calculations on the specified values and return a single value instead of an entire row A tool to monitor a GFMon distributed system Java Management eXtensions A set of specifications for dynamic application and network management in the J2EE development and application environment 49 Glossary multicast statistics alert statistics enabled system alert system member 50 A form of UDP communications where a datagram is sent to multiple processes in one network operation See alert Statistic alerts notify the user about GFMon distributed system statistics Region attribute Specifies whether to collect statistics for the region See alert Statistic alerts notify the user about GFMon critical distributed system statistics A process that has established a connection to a distributed system This can be an application or a GFMon member such as a locator or cacheserver The minimal GFMon process configuration is a member that is connected to a distributed system GemStone Systems Inc A Admin Agent 24 Configuring 24 administration overview 28 Adobe Acrobat Reader installation requirement 17 B basic administrator tasks 28 C
33. es to yellow or red on occurrence of alerts You may reset this to green to acknowledge that the alerts have been examined On reset the aggregation of the existing alert entries in the table is stopped and they are greyed out New alerts even if they are caused due to events that triggered earlier alerts get displayed as new rows in the table You may still click on the greyed rows to view their details The maximum number of rows in this and other tables in GFMon can be configured from the Preferences Panel gt System Memory Usage This section displays the aggregate memory used across all active servers The histogram on the right renders the memory used as a percentage of the total available memory across the servers over time The vertical bar on the left shows a snapshot of the current memory usage If the System Memory Usage data is not available then the X axis is labeled Heap Memory Data is not Available GemFire Enterprise System Administrator s Guide 33 Accessing Information Chapter 4 gt Resources Utilization Summary This section provides an animated bar chart of individual memory and CPU usage on each member in the distributed system The CPU usage bar and memory bar for each node are grouped together gt Members Summary This section displays a tabular view of vital member statistics like gt ID the Member ID is a unique auto generated value that identifies the member in the distributed system gt N
34. he distributed system Starting an Admin Agent Using Locators To start the agent using locators specify the connection string of the locator This can be a comma delimited host port list specified in the agent properties file or on the command line as part of the start up arguments agent start locators bishop 10334 mcast port 0 When you are using locators to connect set the mcast port to 0 Ensure that locator s is are running for the given configuration Starting an Admin Agent Using Multicast To start the agent using multicast specify the mcast port connection string This can be specified in agent properties file or on the command line as part of the start up arguments agent start mcast port 10334 24 GemStone Systems Inc System Configuration Starting GFMon and Connecting to the Admin Agent To start GFMon 1 Set the environment variable GEMFIRE to the lt GemFire product directory gt This directory must be the same as the GemFire product directory which is being used by the admin agent that GFMon connects to monitor the distributed system The GFMon start up scripts use the gemfire jar inthe GEMFIRE 1ib directory to launch GFMon 2 Use gfmon bat to launch GFMon on Microsoft Windows platforms and gfmon to launch GFMon on Linux platforms To connect to the admin agent 1 Inthe Quick Connect section enter the host name of the host on which the Admin Agent is running and the RMI port num
35. icas Total Memory MB Entry Count _ Memory 15 38 No Data 15 01 No Data 15 95 No Data 0 75 No Data 17 45 No Data 0 75 No Data 17 07 No Data 0 75 No Data 0 75 No Data 0 75 No Data 14 63 No Data 0 75 No Data Bi E 12 Region Members Details Yiewer g Globalvillage_1 bridgegemfire_1_3_nase_20468 bridgegemfire_1_4_nase_20491 bridgegemfire_1_2_nase_20456 gatewaygemfire_1_2_nase_21277 gatewaygemfire_1_1_nase_21304 bridgegemfire_1_1_nase_20445 Distributed Ack a Distributed Ack Replicate All Distributed Ack Replicate all Distributed Ack Replicate All Distributed Ack Replicate All Distributed Ack Replicate All Asynchronous writes to disk Asynchronous writes to disk Asynchronous writes to disk Asynchronous writes to disk Asynchronous writes to disk after a threshold of 1000ms or 0 byt Asynchronous writes to disk The All Regions table lists Total Memory and Memory only for regions that have a cap set on memory use For partitioned regions this is set using the local max memory partitioned attribute For other regions this is set by specifying Iru memory size eviction for the region When memory use is not limited these memory statistics are not captured in GemFire and are not displayed in GFMon GemFire Enterprise System Administrator s Guide 37 Accessing Information Chapter 4 gt Region Members Details Viewer
36. min agent see Configuring an Admin Agent on page 24 The refresh interval configured in the Preferences panel does not impact the refresh interval of the admin agent from GemFire version 6 0 onwards GemFire versions prior to GemFire 6 0 do not support the refresh interval property for the admin agent gt Number of quick connect host port entries to keep in history Define the number of entries the Agent host and Agent port fields must retain in the Quick Connect section gt X scale time range for Time Charts in minutes Define the time for which the charts must be plotted gt Reconnect Specify the number of times and time interval GFMon must attempt to reconnect in the Number of retries and Reconnect Interval in milliseconds fields if the connection is lost gt Maximum number of rows in a table The maximum number of rows that are kept in a table For example you can configure the number of entries in the Alerts table in the Overview panel and the GFMon Event Viewer table in the Alerts panel After selecting the option or changing the value that you require click Reset or Apply as applicable The changes that you apply reflect immediately except changes to Log File Directory and Refresh Interval The changes to Refresh Interval reflect when you connect to the agent subsequently The changes Log File Directory reflect only when you launch GFMon for the next time GemStone Systems Inc Monitoring the GemFire Distri
37. nsive documentation and should always be your first source of information for GemFire The current document provides functional information about VMware vFabric GemFire GFMon GemStone Technical Support engineers will refer you to these documents when applicable However you may need to contact Technical Support for the following reasons gt Your technical question is not answered in the documentation gt You receive an error message that directs you to contact GemStone Technical Support gt You want to report a bug gt You want to submit a feature request Questions concerning product availability pricing license keyfiles or future features should be directed to your GemStone account manager Preserving Artifacts for Technical Support Before you call Support save all the artifacts including gt Log files A log file with the following name format yyyy MM dd HH mm ss SSS_ lt any random _number gt gfmon log for example 2009 01 19 19 10 36 234 8632816 gfmon 1og and is located in the log file directory To customize the log file location see Preferences Panel on page 44 The default location of the log file is lt user home OR current working directory gt GemStone GemFire GFMon logs directory Send the full log to Technical Support not just the stack Even at the default logging level the log contains data that may be important such as the operating system and license gt All the contents of the workspac
38. olumn 3 Highlight the row of the system name and click Connect or Disconnect as required At any given time you can connect to one distributed system only Figure 4 13 Preferences General Tab F GemrFire Monitoring Mi Lx File Help GFMon i Connections General l Overview B Data Preferences S Members E Alerts Log File Directory t Documents and Settings abhishek GemStone GemFire GFMon logs E Preferences Logging Level info had Quick Connect Agent Host Refresh Interval Millis 6000 nase No of quick connect host port Agent Port entries to keep in history s 27454 F X Scale Time range for Time Charts in minutes gt 10 ao Maximum number of rows in table gt 1 100 v System Status Reconnect No of connection retries 5 Reconnect Interval Millis 2000 9 Reset State R Reset Apply You can use General tab to set various preferences of your GFMon tool You can configure the following preferences GemFire Enterprise System Administrator s Guide 45 Accessing Information Chapter 4 46 gt Log file Directory Use the Browse option to specify the directory where you want the GFMon log files to be stored Ensure that the GFMon application has read and write access to the log files The default log file directory is lt parent directory gt GemStone GemFire GFMon logs The lt parent directory gt i
39. one Systems Inc Monitoring the GemFire Distributed System Using GFMon Accessing Information The following events are logged in the event viewer Table 4 1 Event types Logged in the GFMon Event Viewer Event Type Purpose Node Joined When a node joins the system Node Crashed When a node crashes Node Left When a node leaves the system Alert When a system alert occurs Internal Error When a GFMon error occurs Internal Warning When a GFMon warning occurs Reconnecting to the Agent When GFMon attempts to reconnect to JMX agent This happens when JMX agent shuts down unexpectedly Shutdown of the Agent When the attempt to reconnect to JMX agent fails Use the Clear and Clear All buttons at the bottom right corner of the GFMon Event Viewer panel to clear the selected event or to clear all events respectively GemFire Enterprise System Administrator s Guide 43 Accessing Information Preferences Panel Chapter 4 The Preferences panel allows you to set connection and general preferences and save them for future use On Windows platforms these preferences are saved in the system registry in the logged in the HKEY CURRENT USER Software JavaSoft Prefs Gemstone GemFir Monitor 2 5 lt Logged In User Name gt node On Linux platforms these preferences are saved in the home lt Logged In User Name gt java userPrefs GemStone GemFire Monitor lt encoded version info gt lt Logged In Use
40. overed by one or more patents listed at http www vmware com go patents The Java Software technologies are Copyright c 1994 2000 Sun Microsystems Inc Copyright Eclipse Contributers and others 2000 2008 Copyright c 1999 2006 The Apache Software Foundation c Copyright 2000 2009 by Object Refinery Limited and Contributors JFreeChart Copyright 2000 2009 by Object Refinery Limited and Contributors All other marks and names mentioned herein may be trademarks of their respective companies PATENTS VMware vFabric GemFire GFMon is protected by U S patent 6 360 219 Additional patents pending TRADEMARKS VMware is a registered trademark or trademark of VMware Inc in the United States and or other jurisdictions All other marks and names mentioned herein may be trademarks of their respective companies GemStone GemFire Monitor and the GemStone logo are trademarks or registered trademarks of GemStone Systems Inc in the United States and other countries Other company or product names mentioned herein may be trademarks or registered trademarks of their respective owners Preface How This Documentation Is Organized Typographical Conventions Other Useful Documents Preserving Artifacts for Technical Support Contacting Technical Support 24x7 Emergency Technical Support GemStone Support Web Site Chapter 1 Product Installation 1 1 System Requirements Windows Linux Java Runtime Requirements Other Software Requirements
41. ption of the problem or request gt Exact error messages received if any gt Any artifacts in the preceding list Your GemStone support agreement may identify specific individuals who are responsible for submitting all support requests to GemStone If so please submit your information through those individuals All responses will be sent to authorized contacts only For non emergency requests you should contact Technical Support by web form or E mail You will receive confirmation of your request and a request assignment number for tracking Replies will be sent by E mail whenever possible regardless of how they were received GemStone Support Website http techsupport gemstone com This is the preferred method of contact The Help Request link is at the top right corner of the home page please use this to submit help requests This form requires an account but registration is free of charge To get an account just complete the Registration Form found in the same location You will be able to access the site as soon as you submit the web form E mail mailto techsupport gemstone com Please do not send files larger than 100K for example core dumps to this address A special address for large files will be provided as appropriate Telephone 800 243 4772 or 503 533 3503 We recommend that you call only for more serious requests that require immediate evaluation such as a production system that is non operational
42. r Name gt prefs xml file The format of the name of the encoded_version_info directory will be similar to _ 3 g w Figure 4 12 Preferences Connections Tab FicemFire Monitoring _ Oj Ea File Help GFMon Overview B Data EEE Members Alerts Preferences Quick Connect Agent Host nase zj Agent Port k Disconnect v System Status Reset State GEMFIRE E GFMon Preferences Connections General Connection Preferences Specify your connection by host name or IP address Connect to stored sessions New localhost_1099 localhost New nase_24601 nase DS London nase DS NY halibut D E W Disconnect IE Delete DS Name Host name Port No disconnected disconnected connected disconnected 44 GemStone Systems Inc Monitoring the GemFire Distributed System Using GFMon Accessing Information You can use the Connections tab to create connection preferences and store them for future use To create and use connection preferences 1 Inthe Specify your connection by host name or IP address field enter system name host name and port number 2 Click Save The information that you entered is populated in the Connect to stored sessions section If you connect to a new agent it is automatically populated in the Connect to stored sessions section The un saved connections are denoted by an appended asterisk in the Status c
43. rameter as part of the start up arguments or as part of the agent properties file agent start rmi enabled true rmi port 1099 2 Record the agent host name and the RMI port number from the agent 1log file To configure the RMI port to any valid port set rmi port in the agent properties file to a valid port number The Agent uses a default port of 1099 as the listener port for incoming RMI connections from JMX clients including GF Mon However if an RMI port is specified either through the command line or via agent properties and the port is not available the JMX Agent reports an error during start up 3 You can verify the RMI port value from the agent 1og file which is created once the agent starts To verify the host name and port number that you will need to specify in GF Mon you can also list the active connections using this command netstat a 4 GemFire refreshes statistic resources periodically and propagates these values to the admin agent GFMon gets updated values of these statistics from the admin agent If your admin agent connects to asystem running GemFire version 6 0 or more you can optionally set this refresh interval while starting the agent The default value for refresh interval is 5 seconds agent start rmi enabled true rmi port 1099 refresh interval 5 where the refresh interval is specified in seconds After you start the GemFire JMX agent use the agent host name and the RMI port of the agent to connect to t
44. rver ry connection com gemstone gemfire cache client internal pooling PooledConnection 84 fF20 Connection DESTROYED Server unreachable could not connect after 0 attempts xl System alerts include log entries that are tagged as Severe Error or Warning System alerts also consist of alerts indicating unexpected disconnection of a member from the distributed system unexpected disconnection of the Admin Agent and errors occurring in GFMon gt Statistics Alerts Pop up When you double click on a statistic alert a pop up window including the following information is displayed gt Member Name The name of the member for which the alert has been raised gt First Time The time at which the alert was raised for the first time gt Last Time The time at which the alert was raised for the last time Count The number of times this alert has been raised gt Statistic Name The names of different statistics selected for that alert definition gt Last Value The value for the statistic when the alert was raised for the last time gt Mean Value This is the mean value for the statistic it is calculated by taking the sum of values for each alert divided by the count for the alert gt Range Provides the minimum and maximum value for the statistic in the given time First time and Last time Figure 4 5 Statistic Alert EF Statistics Alert at 19 08 54 Ea Member Name Yatewaygemfire_2_1_nase_21405 First
45. s either the user s home directory or current working directory depending on the access assessed in the same order The log file name format is yyyy MM dd HH mm ss sss_ lt random_ number gt gfmon 1log For example 2009 01 19 19 10 36 234 8632816 gfmon 1log is located in the log file directory For each instance of GFMon a new log file with a different name that depends on the timestamp and the random number is created gt Logging Level Select the logging level from the available options in the drop down menu The default value is info The valid logging levels are all finest finer fine config info warning error severe and none The logging level all provides information of all severity levels while the logging level severe provides the information that is logged at severe level Setting log level to one of the ordered levels causes all messages of that level and greater severity to be printed Lowering the log level reduces system resource consumption while still providing some logging information for failure analysis gt Refresh Interval in milliseconds Specify the refresh interval to update the data displayed in GFMon views If GFMon connects to an admin agent running GemFire version 6 0 it is recommended to set the GFMon refresh interval to a value greater than the agent s refresh interval property default value for which is 5 seconds For more information about configuring the GemFire refresh interval property in the ad
46. statistics are enabled in the GemFire distributed system The following properties must be configured in the gemfire properties file statistic sampling enabled true enable time statistics true 40 GemStone Systems Inc Monitoring the GemFire Distributed System Using GFMon Accessing Information Alerts Panel You can create custom alerts in the Alerts panel Custom alerts in GFMon allow you to receive a notification when a specified system statistic of an active member in a distributed system reaches a defined threshold GemFire JMX Admin Agent alerts GFMon and the RMI clients when the customized alert reaches the specified threshold For more information about receiving e mail alerts see the GemFire documentation For detailed description of system statistics see the information on Statistics in the GemFire documentation Figure 4 10 Alerts Panel Fi GemFire Monitoring Of x File Help GFMon Connected To Agent nase 27454 Servers 4 Gateways 2 Clients 12 Overview Create Alert Definition Available Alert Definitions B Data H Name sum s Ba Members suo average messages Definition with Multiple Statistics by applyi Alerts Select Statistics sum ops Definition with Multiple Statistics by applyi entry creates Definition with a Single Statistic for value Preferences Quick Connect PEE tok oO CachePerfStats lt cachePerfStats gt creates g oO CachePerfStats
47. stem statistic thresholds GFMon uses JMX to retrieve information from the distributed system This chapter covers gt Accessing Information page 28 gt Error Notifications Displayed by GFMon page 48 GemFire Enterprise System Administrator s Guide 27 Accessing Information 4 1 Accessing Information 28 Chapter 4 This section provides guidance on accessing real time information from a distributed system running Gemfire and setting GFMon preferences through the GFMon panels gt gt gt Left Panel page 29 Summary Panel page 30 Overview Panel page 31 Data Panel page 37 Members Panel page 39 Alerts Panel page 41 Preferences Panel page 44 Status Bar page 47 GemStone Systems Inc Monitoring the GemFire Distributed System Using GFMon Accessing Information Left Panel The left panel helps you to navigate through various sections of the GFMon tool Figure 4 1 Left Panel Fi GemFire Monitoring File Help GFMon Overview 3 Data t Members j lerts Preferences Quick Connect Agent Host Agent Port 27454 X kA Disconnect System Status ee 3 Reset State gt Click the specific option in the GFMon section to navigate across the various information panels gt Use the Quick Connect section to specify the Agent Host and the Agent Port to which the connection must be established If the agent host name is not compliant with RFC 952 as mandated
48. t definition select the alert from the Available Alert Definitions section and click Edit You can change the alert definition by editing the desired parameter To delete an alert definition select the alert from the Available Alert Definitions section and click Delete All alerts are displayed in the Alerts section of the Overview panel The GFMon Event Viewer table displays warnings that are logged in the GFMon s log file You can view the internal warnings and node information in the GFMon Event Viewer and see the log file for details Double click any item in the table to get more information about the event The Info Type scroll bar allows you to scroll through all the events in the table Use the Message scroll bar to scroll through the complete message Figure 4 11 Details for Events in the GFMon Event Viewer MM Mon Feb 14 18 57 50 GMT 05 30 2011 Info Type Jntemal Waming al when Mon Feb 14 18 57 50 GMT 05 30 2011 x On Member bridgegemfire_1_3_nase_20468 t PE Message ime statistics are not enabled By default the GFMon Event Viewer displays the ast 100 events only Go to the General tab in the Preferences panel to configure preferences gt To change the number of events viewable in the GFMon Event Viewer change the Maximum number of rows viewable in a table preference gt To change the logging severity detail level of the GFMon s log file change the Logging Level preference 42 GemSt
49. t port number or the locator connection string through the command line or through the gemfire properties file To set up the server multicast mcast port use the property mcast port To set up the locator connection string use the property Locators which is a comma delimited host port string When you are using locators to connect set the mcast port to 0 For information about discovering members in a distributed system see the GemFire documentation The default gemfire properties specification is overridden by the customized properties specified in the gfTest file In the example below the command line specification for mcast port overrides any setting that might be provided in the gfTest file or in any Properties object java DgemfirePropertyFile gfTest Dgemfire mcast port 10334 test Program In the example below the command line specification for locators overrides any setting that might be provided in the gfTest file or in any Properties object java DgemfirePropertyFile gfTest Dgemfire locators bishop 10334 Dgemfire mcast port 0 test Program Chapter 3 Configuring an Admin Agent After you have configured a distributed system configure an agent to connect to the distributed system To configure an Admin Agent see the information on using JMX in the GemFire documentation 1 Inthe agent configuration the rmi enabled parameter must be set to true Start the agent specifying the RMI listen port and RMI enabled pa
50. te export GF_JAVA jdk1 5 0 bin java To specify JVM arguments use the environment variable JAVA_ARGS On Windows platforms set JAVA_ARGS Xms256m On Linux platforms export JAVA_ARGS Xms256m To specify multiple arguments or arguments with equal to use double quotes For example on Windows platforms set JAVA_ARGS Xms256m Xmx512m On Linux platforms export JAVA_ARGS Xms256m Xmx512m GemStone Systems Inc Product Installation GFMon License Files 1 3 GFMon License Files GFMon is licensed as a package along with VMware vFabric GemFire You do not need a separate license file to run the GFMon application GemFire Enterprise System Administrator s Guide 19 GFMon Product Tree Chapter 1 1 4 GFMon Product Tree Name Contents configuration Directory containing configuration files required by GFMon Also contains run time plug ins and log files docs Directory containing product installation instructions release notes and user manual gfmon bat Batch file that rans GFMon in Windows operating systems gfmon Script file that rans GFMon in Linux operating systems open source li cense txt GFMon open source and third party license file plugins Plug ins required for the GFMon application workspace This folder is created after you launch the GFMon application Contains the log files and application metadata GFMon Product Documentation 20 The
Download Pdf Manuals
Related Search