Novell GROUPWISE 8 - INTERNET AGENT, Manual

Page 1: ...nsoles on page 1003 Chapter 63 Configuring the Monitor Agent on page 1007 Chapter 64 Configuring the Monitor Application on page 1029 Chapter 65 Using GroupWise Monitor on page 1037 Chapter 66 Compari...

Page 2: ...1002 GroupWise 8 Administration Guide novdocx en 22 June 2009...

Page 3: ...Monitor Consoles on page 1061 For detailed instructions about installing and starting the GroupWise Monitor Agent for the first time see Installing GroupWise Monitor in the GroupWise 8 Installation G...

Page 4: ...e as you can at the Monitor Agent server console Several Monitor features are available at the Monitor Agent Web console that are not available at the Monitor Agent server console or the Monitor Web c...

Page 5: ...indow on the right Using the Agents Groups window you can create and manage agent groups the same as you can at the Monitor Agent server console The Monitor Web console does not include some features...

Page 6: ...1006 GroupWise 8 Administration Guide novdocx en 22 June 2009...

Page 7: ...t is adequate to begin monitoring existing GroupWise agents Post Office Agents Message Transfer Agents Internet Agents and WebAccess Agents You can also customize the configuration to meet your specif...

Page 8: ...3 8 Configuring Authentication and Intruder Lockout for the Monitor Web Console on page 1023 Section 63 9 Configuring Monitor Agent Log Settings on page 1024 Section 63 10 Configuring Proxy Service Su...

Page 9: ...st displays all agents that are not currently being monitored 2 Select one or more agents in the Monitored list then click Remove to move them to the Filtered Out list 3 Click OK Agents in the Filtere...

Page 10: ...subnet At the Windows Monitor Agent server console 1 Click Configuration Add from Network or On Linux at the Monitor Agent Web console click Preferences Add Agents 2 Type the subnet portion of the IP...

Page 11: ...t the Monitor Agent Web console click Preferences Remove Agents 2 Select the agents you want to remove then click Remove 3 Click OK 63 2 Creating and Managing Agent Groups You might find it convenient...

Page 12: ...em Section 63 2 1 Creating an Agent Group on page 1012 Section 63 2 2 Managing Agent Groups on page 1013 Section 63 2 3 Viewing Your Agent Group Hierarchy on page 1013 Section 63 2 4 Configuring an Ag...

Page 13: ...the currently selected group or the agents in subgroups as well By default only the agents in the selected folder are listed in the agent window Right click an agent group then click Show Subgroup Ag...

Page 14: ...an customize how the Monitor Agent communicates with your Web browser At the Windows Monitor Agent server console 1 Click Configuration HTTP or At the Linux Monitor Agent Web console click Preferences...

Page 15: ...Monitor Agent must use SNMP to monitor these older agents If you need to monitor older agents see Section 63 3 2 Configuring the Monitor Agent for SNMP on page 1016 If all monitored agents in the grou...

Page 16: ...erences Setup then scroll down to the SNMP Settings section 2 Specify the number of seconds after which the Monitor Agent polls all monitored GroupWise agents for updated information using SNMP 3 In t...

Page 17: ...the poll cycle as needed At the Windows Monitor Agent server console 1 Select the root agent group to set the poll cycle default for all monitored agents or Select any agent group to set the poll cycl...

Page 18: ...dows Monitor Agent server console 1 Select the root agent group to set up e mail notification defaults for all monitored agents or Select any agent group to set up e mail notification for the agents i...

Page 19: ...urns to Normal If you want to be notified of more specific states see Section 63 5 2 Customizing Notification Thresholds on page 1019 8 Select the amount of time that you want to elapse before repeat...

Page 20: ...e The MIB files list the meanings of the MIB variables and what type of values they represent The meaning of the MIB variable selected in the Expression field is displayed above the field 6 Select an...

Page 21: ...save the new notification settings 63 6 Configuring Audible Notification for Agent Problems If the server where the Monitor Agent runs is located where someone can respond immediately to a GroupWise...

Page 22: ...The Monitor Agent launches the default media player for whatever type of sound file you select Basic sound files are available in the c windows media directory 5 Click OK to return to the Notification...

Page 23: ...ions is selected and all options are dimmed Deselect Use Parent Notification Options to set up notification for an agent group or individual agent 3 Select Send SNMP Traps then click OK 4 Make sure th...

Page 24: ...use the httpssl and httpcertfile startup switches along with a certificate file when starting the Monitor Agent For more information see Chapter 67 Using Monitor Agent Startup Switches on page 1063 In...

Page 25: ...disk space is used the Monitor Agent overwrites existing Monitor Agent event log files starting with the oldest The default is 102400 KB 100 MB of disk space for all Monitor Agent event log files Maxi...

Page 26: ...d exit the Monitor Application configuration file 5 Start the Monitor Agent with the proxy startup switch For information about startup switches see Chapter 67 Using Monitor Agent Startup Switches on...

Page 27: ...d Novell Messenger System 2 Fill in the following fields in the GroupWise Monitor Startup dialog box or the Add Novell Messenger System dialog box Novell Messenger System Object Browse to and select t...

Page 28: ...or the Linux GroupWise Agents in Installing GroupWise Agents in the GroupWise 8 Installation Guide relies on the Monitor Agent to know when an agent has stopped and needs to be restarted To enable com...

Page 29: ...page 1032 Section 64 4 Modifying Monitor Application Template Settings on page 1033 64 1 Modifying Monitor Application Environment Settings Using ConsoleOne you can modify the Monitor Application s e...

Page 30: ...nging the location of the file IMPORTANT On Linux do not change the location of the gwmonitor cfg file Logout URL By default if users are required to log in to the Monitor Web console they are returne...

Page 31: ...of days you want to retain the log files The Monitor Application retains the log file for the specified number of days unless the maximum disk space for the log files is exceeded The default age is 3...

Page 32: ...nitor Web console users and then passes the requests to the appropriate service provider The service provider fills the requests and returns the required information to the Monitor Application The Mon...

Page 33: ...tion Template Settings When the Monitor Application receives information from a service provider it merges the information into the appropriate Monitor template before displaying the information to th...

Page 34: ...Specify the URL for the GroupWise Monitor image files These images are merged into the templates along with the GroupWise information This URL must be relative to the tomcat_directory webapps The def...

Page 35: ...when displaying the initial Monitor Web console page Define User Interfaces GroupWise Monitor supports Web browsers on many different devices for example computers and wireless telephones Each device...

Page 36: ...1036 GroupWise 8 Administration Guide novdocx en 22 June 2009...

Page 37: ...nitor Web Console on page 1041 Section 65 3 Generating Reports on page 1042 Section 65 4 Measuring Agent Performance on page 1052 Section 65 5 Collecting Gateway Accounting Data on page 1055 Section 6...

Page 38: ...on page 1040 Section 65 1 5 Polling the Agents for Updated Status Information on page 1040 65 1 1 Viewing All Agents After you have separated your agents into groups you can still view all agents in y...

Page 39: ...nitored agents again click View All Agents or On Linux at the Monitor Agent Web console click System 65 1 3 Viewing an Agent Server Console An active agent server console displays on each server where...

Page 40: ...Console on page 949 65 1 5 Polling the Agents for Updated Status Information By default the Monitor Agent polls the monitored agents every five minutes You can change the default poll cycle as descri...

Page 41: ...where web_server_address represents the IP address or hostname of the Web server where the Monitor Application is installed Figure 65 3 GroupWise Monitor Web Console Features of the Monitor Web conso...

Page 42: ...3 7 Message Tracking Report on page 1050 Section 65 3 8 Performance Tracking Report on page 1051 Section 65 3 9 Connected User Report on page 1051 Section 65 3 10 Gateway Accounting Report on page 10...

Page 43: ...nreachable domains All domains must be open to obtain an accurate link map of your GroupWise system 1 Make sure all domains in your GroupWise system are open You cannot obtain an accurate link map of...

Page 44: ...n page 1044 Setting Up Maps on page 1045 Setting Up Regions on page 1046 Adding Agents to a Map on page 1047 Using an Image Map to Monitor Agents on page 1048 NOTE The image map report cannot be gener...

Page 45: ...hat are available in the maps directory The filename of each map is displayed below it 3 Click the map that you want to set up specify a custom name for the map then click Create This makes the map av...

Page 46: ...es are located 1 Set up at least two maps in Monitor as described in Making Maps Available in Monitor on page 1044 2 In the Monitor Agent Web console click Map to display the maps that are available i...

Page 47: ...ding Agents to a Map Adding Agents to a Map 1 In the Monitor Agent Web console click Map to display the maps that are available in Monitor The custom name of each map is displayed below it 2 Click Edi...

Page 48: ...locations 7 Continue with Using an Image Map to Monitor Agents Using an Image Map to Monitor Agents 1 In the Monitor Agent Web console click Map View 2 Click a map to view agent status or If the map h...

Page 49: ...messages a user has sent outside his or her post office The user traffic report lists all messages sent by a specified user during a specified date time range along with date time and size information...

Page 50: ...Agent uses XML to communicate with If the Monitor Agent must use SNMP to communicate with a domain that domain is not included in the list 3 Select the other end of the link which could be another dom...

Page 51: ...the Monitor Agent for performance tracking See Section 65 4 Measuring Agent Performance on page 1052 65 3 9 Connected User Report The Connected Users report lists all users that are currently connect...

Page 52: ...es flow through your GroupWise system Perform the following steps to set up agent performance testing Section 65 4 1 Setting Up an External Monitor Domain on page 1052 Section 65 4 2 Selecting an MTA...

Page 53: ...ith Section 65 4 2 Selecting an MTA to Communicate with the Monitor Agent on page 1053 65 4 2 Selecting an MTA to Communicate with the Monitor Agent The Monitor Agent needs to send its performance tes...

Page 54: ...ting section 2 Fill in the fields Domain to send messages to Select the external Monitor domain that you configured for system performance testing You might need to restart the Monitor Agent in order...

Page 55: ...em or Select one domain to generate a performance testing report for it 3 Click Run to generate the performance testing report 65 4 6 Receiving Notification of Agent Performance Problems If you want t...

Page 56: ...e external domain for collecting agent performance data 2 Name the external domain to reflect its role in your GroupWise system For example you could name it ExternalMonitorDomain It does not matter w...

Page 57: ...Post Office and External User for Monitor 65 5 3 Setting Up an External Post Office and External User for Monitor The setup for gateway accounting requires an external post office and an external user...

Page 58: ...itor Agent 4a At the Monitor Agent Web console click Log Gateway Accounting Logs 4b Select the Internet Agent or gateway then click View Accounting Logs If logs are listed then data is successfully ar...

Page 59: ...ield type the name of the GroupWise administrator who is responsible for this agent The name is displayed to the right of the agent status in the status window of the Monitor Agent console and the Mon...

Page 60: ...Agent Web console 2 Type the name of an agent or Select Problems to list all agents whose status is other than Normal or Select one or more types of agent to list 3 Select the number of instances you...

Page 61: ...or Agents No No Yes Assigning Responsibility for Specific Agents Yes Yes Yes Configuring the Monitor Agent for HTTP Yes Yes Yes Configuring the Monitor Agent for SNMP Yes Yes Yes Configuring Polling o...

Page 62: ...cx en 22 June 2009 Link Traffic Report Yes Yes No Message Tracking Report Yes Yes No Performance Tracking Report Yes Yes No Connected User Report No Yes No Gateway Accounting Report No Yes No Trends R...

Page 63: ...u start the Monitor Agent by running the grpwise ma script you can edit the MA_OPTIONS variable to include any switches you want to set Windows You can create a batch file like the following c Program...

Page 64: ...ault is 120 The actual duration of the poll cycle can vary from the specified number of seconds because the actual duration includes ipa ipa N A ipp ipp N A lang lang N A log log Log Log Settings Log...

Page 65: ...See also hapassword and hapoll 67 4 help Displays the Monitor Agent startup switch Help information When this switch is used the Monitor Agent does not start 67 5 home Specifies a domain directory wh...

Page 66: ...ies the full path to the public certificate file used to provide secure SSL communication between the Monitor Agent and the Monitor Web console displayed in your Web browser See Section 63 8 Configuri...

Page 67: ...nection between your Web browser and the Monitor Agent See Section 63 8 Configuring Authentication and Intruder Lockout for the Monitor Web Console on page 1023 See also httpmonpassword 67 11 httpport...

Page 68: ...See also ipp 67 14 ipp Specifies the TCP port number associated with the network address of an MTA with which the Monitor Agent can communicate to obtain information about agents to monitor Typically...

Page 69: ...See Section 63 9 Configuring Monitor Agent Log Settings on page 1024 67 17 monwork Specifies the location where the Monitor Agent creates it working directory The default location varies by platform L...

Page 70: ...t uses to log into eDirectory to obtain Messenger information See Section 63 11 Monitoring Messenger Agents on page 1026 See also nmuser nmhome and nmaddress Example monwork tmp monwork temp monwork m...

Page 71: ...ts on page 1017 67 24 proxy Routes all communication through the Monitor Agent and the Monitor Application on the Web server As long as the Web server can be accessed through the firewall the Monitor...

Page 72: ...tcpwaitconnect Sets the maximum number of seconds the Monitor Agent waits for a connection to a monitored agent The default is 5 Linux Monitor Agent Windows Monitor Agent Syntax tcpwaitconnect seconds...