Novell GROUPWISE 7 - WEB ACCESS, Manual

Page 1: ...ter 53 Scaling Your WebAccess Installation on page 855 Chapter 54 Configuring WebAccess Components on page 869 Chapter 55 Managing User Access on page 915 Chapter 56 Monitoring WebAccess Operations on page 925 Chapter 57 Using WebAccess Startup Switches on page 945 ...

Page 2: ...854 GroupWise 7 Administration Guide novdocx en 11 December 2007 ...

Page 3: ... 860 For information about creating a basic GroupWise WebAccess installation see Installing GroupWise WebAccess in the GroupWise 7 Installation Guide 53 1 WebAccess Configurations A basic installation of GroupWise WebAccess requires the WebAccess Agent and the WebAccess Application as shown in the following diagram The WebPublisher Application is also required if you plan to use GroupWise WebPubli...

Page 4: ...ss Agent in Los Angeles accessing a post office in London Improving availability The WebAccess Agent has 12 threads assigned to process user requests which means that it can process only 12 requests at one time regardless of the number of users logged in If necessary you can increase the number of threads allocated to the WebAccess Agent but each thread requires additional server memory If you rea...

Page 5: ...WebAccess Hosting WebAccess the WebAccess Application on one Web server for your GroupWise users and WebPublisher the WebPublisher Application on another Web server for public Internet use If necessary you can use multiple WebAccess Agents in this configuration as shown below Figure 53 4 The WebAccess Application on One Web Server and the WebPublisher Application on Another Web Server with WebAcce...

Page 6: ...se WebAccess software to a software distribution directory run setup exe from the internet webacces directory 2 Click Yes to accept the license agreement and display the Select Components dialog box 3 Deselect all components except the GroupWise WebAccess Agent then click Next 4 Follow the prompts to create the WebAccess Agent s gateway directory install the WebAccess Agent software and create the...

Page 7: ...is running on your eDirectory server and that it is configured to accept login from the WebAccess Agent Installation program 2 In a terminal window become root by entering sux and the root password The sux command enables the X Window System which is required for running the GUI GroupWise Installation program Installation Advisor and the Setup Advisor If you do not want to use the X Window System ...

Page 8: ...ure the Linux WebAccess Application 5 When the installation and configuration is complete start or restart the Web server 53 3 Configuring Redirection and Failover Support Redirection enables the WebAccess Application to direct user requests to specific WebAccess Agents For example you might want WebAccess Agent 1 to process all requests from users on Post Office 1 and WebAccess Agent 2 to process...

Page 9: ...his is the service provider used by the WebAccess Application to connect to WebAccess Agents The commgr cfg file This file located in the WebAccess Application s home directory which varies by platform By default only the GroupWise Provider object and the commgr cfg file include a WebAccess Agent definition as shown in the following table Table 53 1 WebAccess Agent Default Locations If no other We...

Page 10: ...ble the WebAccess Application fails over to Agent 2 and then Agent 3 both of which are defined in the GroupWise service provider s list Redirection Failover List Example 2 Assume that the WebAccess Agents are defined as follows Using this information the WebAccess Application would create the following redirection failover list Location WebAccess Agent WebAccess URL No agent defined Post office Ag...

Page 11: ...ncryption key The encryption key is randomly generated when the WebAccess Agent object is created in eDirectory which means that every WebAccess Agent has a unique encryption key If a WebAccess Application communicates with more than one WebAccess Agent all the WebAccess Agents must use the same encryption key To modify a WebAccess Agents encryption key 1 In ConsoleOne right click the WebAccess Ag...

Page 12: ... WebAccess Agent at IP address 172 16 6 10 and port number 7204 If the WebAccess Agent is using the same port number that is listed in the commgr cfg file you do not need to include the GWAP port parameter Or if the WebAccess Agent is using the same IP address that is listed in the commgr cfg file you do not need to include the GWAP ip parameter If you want you can use the WebAccess Agent s DNS ho...

Page 13: ...p 172 16 6 12 New York A LI LI A HREF http 172 16 5 18 gw webacc GWAP ip 172 16 6 33 GWAP port 7203 London A LI UL The displayed HTML page would contain the following list of locations San Francisco New York London When a user selects a location the WebAccess Application routes all requests to the WebAccess Agent at the selected location 53 3 4 Assigning a Default WebAccess Agent to a Post Office ...

Page 14: ...ibed in Section 53 3 6 Adding WebAccess Agents to the GroupWise Service Provider s List on page 867 If possible select a WebAccess Agent that has good access to the post office to ensure the best performance 5 Click OK to save the changes 53 3 5 Assigning a Default WebAccess Agent to a Domain The WebAccess Application uses the domain s default WebAccess Agent if 1 no WebAccess Agent has been speci...

Page 15: ...ects to the assigned WebAccess Agent If not it connects to the default WebAccess Agent assigned to the post office s domain or to one of the WebAccess Agents in its service provider list as described in Section 53 3 6 Adding WebAccess Agents to the GroupWise Service Provider s List on page 867 If possible you should select a WebAccess Agent that has good access to the domain s post offices to ensu...

Page 16: ...t includes the WebAccess Agent that is defined in the commgr cfg file listed in the Configuration File field If the first WebAccess Agent is unavailable the GroupWise service provider attempts to use the second third fourth and so on until it is successful 3 Click Add select the WebAccess Agent you want to add to the list then click OK 4 Repeat Step 3 for each WebAccess Agent you want to add to th...

Page 17: ...cess Application on page 879 Section 54 3 Configuring the Novell Speller Application on page 892 Section 54 4 Configuring the WebPublisher Application on page 894 Section 54 5 Configuring the GroupWise Service Provider on page 903 Section 54 6 Configuring the LDAP Service Provider on page 905 Section 54 7 Configuring the GroupWise Document Service Provider on page 907 Section 54 8 Configuring the ...

Page 18: ...n 54 1 4 Securing WebAccess Agent Connections with SSL on page 875 Section 54 1 5 Changing the WebAccess Agent s Network Address or Port Numbers on page 877 Section 54 1 6 Binding the WebAccess Agent to a Specific IP Address on page 878 54 1 1 Modifying WebAccess Settings Using ConsoleOne you can configure the following GroupWise WebAccess settings for the WebAccess Agent The maximum number of thr...

Page 19: ... 925 Encryption Key The encryption key is used to encrypt and decrypt the information sent between the WebAccess Agent and the WebAccess Application If you do not want to use the default encryption key you can type your own key The encryption key must be identical to the encryption keys of any other WebAccess Agents that the WebAccess Application communicates with For more information see Section ...

Page 20: ...ave been shared by the document owner with the WebPublisher proxy user To add a library to the list click Add then browse for and select the library To change the display name or description for the library select the library then click Properties By default the library s Novell eDirectoryTM object name is used for the display name To remove a library from the list select the library then click Re...

Page 21: ... GroupWise libraries reside The agent can access a post office using client server mode direct mode or both By default it uses whichever mode is defined on the Post Office object s Post Office Settings page of the Post Office object Modifying Links to Post Offices on page 873 explains how to set the access mode to client server direct or both Automating Reattachment to NetWare Servers on page 874 ...

Page 22: ... When connecting to the post office in client server mode the WebAccess Agent must know the hostname or IP address and port number of the Post Office Agent running against the post office 5 Click OK 6 Repeat Step 3 through Step 5 for each post office whose link you want to change Automating Reattachment to NetWare Servers You can specify the reattach information for the Windows WebAccess Agent in ...

Page 23: ...he WebAccess Agent Web console For it to do so you must ensure that the WebAccess Agent has access to a server certificate file and that you specified the connection types that you want secured through SSL The following sections provide instructions Defining the Certificate File on page 875 Enabling SSL on page 876 Defining the Certificate File To use SSL the WebAccess Agent requires access to a s...

Page 24: ... blank If you type the filename rather than using the Browse button to select it use the full path if the file is not in the same directory as the WebAccess Agent program Set Password Click Set Password to specify the password for the key If the key does not require a password do not use this option 4 If you want to define which connections will use SSL click Apply to save your changes then contin...

Page 25: ...tions to POAs Disabled The WebAccess Agent does not support SSL connections All connections are non SSL Enabled The POA determines whether an SSL connection or non SSL connection is used 54 1 5 Changing the WebAccess Agent s Network Address or Port Numbers If you change the network address IP address or DNS hostname of the WebAccess Agent s server or move the WebAccess Agent to a new server you ne...

Page 26: ...he default port number is 7211 TCP Port This is the port used to listen for requests from the WebAccess Application and WebPublisher Application The default port is 7205 6 Click OK to save the changes 54 1 6 Binding the WebAccess Agent to a Specific IP Address You can now cause the WebAccess Agent to bind to a specified IP address when the server where it runs uses multiple IP addresses The specif...

Page 27: ...ss Application Sessions on page 888 Section 54 2 5 Controlling Availability of WebAccess Features on page 890 54 2 1 Modifying the WebAccess Application Environment Settings Using ConsoleOne you can modify the WebAccess Application s environment settings The environment settings determine such things as the location where ConsoleOne stores the WebAccess Application s configuration file and how lon...

Page 28: ...s configuration information in the old location File Upload Path When a user attaches a file to an item the file is uploaded to the directory displayed in this field By uploading the file before the item is sent less time is required to send the item when the user clicks the Send button After the user sends the item or cancels it the WebAccess Application deletes the file from the directory Specif...

Page 29: ...fills the requests and returns the required information to the WebAccess Application The WebAccess Application merges the information into the appropriate template and displays it to the user To function properly the WebAccess Application must know which service providers are available WebAccess includes three service providers GroupWise service provider GroupWiseProvider object Communicates with ...

Page 30: ...ovider from the list select the provider then click Delete 4 Click OK to save the changes 54 2 3 Modifying WebAccess Application Template Settings When the WebAccess Application receives information from a service provider it merges the information into the appropriate WebAccess template before displaying the information to the user Using ConsoleOne you can modify the WebAccess Application s templ...

Page 31: ... Specify the URL for the GroupWise WebAccess image files These images are merged into the templates along with the GroupWise information This URL must be relative to the Web server s document root directory The default relative URL varies by platform Applets URL In some instances Address Book and Month Calendar for example applets can be used instead of the standard templates Specify the URL for t...

Page 32: ...plates displayed in a different language they can change it on the initial page Define User Interfaces GroupWise WebAccess supports Web browsers on many different devices for example computers and wireless telephones Each device supports specific content types such as HTML HDML and WML When returning information to a device s Web browser the WebAccess Application must merge the information into a ...

Page 33: ... User Agent information signature platform version and so forth For example if a browser s User Agent information includes Windows CE one of the predefined entries the WebAccess Application uses the Basic HTML interface no frames interface Browser Accept Types The Browser Accept Types tab lets you associate a user interface with a Web browser The association is based on the content type the browse...

Page 34: ...the interface s name template directory content type or proxy caching setting Default Select a user interface in the list then click Default to make that interface the default interface The WebAccess Application uses the default interface only if it can t determine the appropriate interface based on the browser s User Agent WebAccess Application object Browser User Agent or the browser s accepted ...

Page 35: ...ccepts click Browser Accept Types The Browser Accept Types tab lets you associate a user interface with a Web browser The association is based on the content type the browser accepts For example if a browser accepts text html one of the predefined entries the WebAccess Application uses the Standard HTML interface frames based interface Many browsers accept more than one content type for example bo...

Page 36: ...on lets you specify a period of time after which the WebAccess Application closes a session that has become inactive A session becomes inactive when the user does not perform any actions such as opening a message that generate calls to the WebAccess Application Having a timeout period not only provides security for user e mail but also ensures that GroupWise WebAccess runs efficiently Select how l...

Page 37: ...Application sends sensitive mailbox information such as message text and passwords to users caching of files by Web browsers and proxy servers can pose an information security risk If you select the Disable Caching option the WebAccess Application includes a disable caching request in the header of each file that it sends By default Web browsers honor this request and does not cache files that inc...

Page 38: ...rectories Change their GroupWise mailbox passwords Use Document Management Services Open attachments in native format Open documents in native format View attachments in HTML format View documents in HTML format All users who log in through a single Web server have the same feature access You cannot configure individual user settings However if you have multiple Web servers you can establish diffe...

Page 39: ...achment in its native application or viewing it as HTML Open Documents in Native Format By default the Save As option enables user to save library documents to their local drives and then open them in their native applications You can turn on this option to enable the Open option The Open option enables users to open documents directly in their native applications without first saving the files to...

Page 40: ...application Exclude Files With These Extensions If you want to exclude certain file types from having the View option specify the file types in the Exclude Files With These Extensions field Include only the extension and separate each extension with a comma for example doc xls ppt The View option is available for any file types not entered in this field This setting applies when viewing either lib...

Page 41: ...ller Application does not have access to Novell eDirectory or the GroupWise domain database Therefore ConsoleOne writes the application s configuration information to the file specified in this field By default this is the spellchk cfg file located in the WebAccess Application s home directory which varies by platform In general you should avoid changing the location of the file If you do change t...

Page 42: ...llation the WebPublisher Application is set up with a default configuration However you can use the information in the following sections to optimize the WebPublisher Application configuration Section 54 4 1 Modifying the WebPublisher Application Environment Settings on page 895 Section 54 4 2 Adding or Removing Service Providers on page 896 Section 54 4 3 Modifying WebPublisher Application Templa...

Page 43: ...pplication Environment to display the Environment page 3 Modify any of the following fields Configuration File The WebPublisher Application does not have access to Novell eDirectory or the GroupWise domain database Therefore ConsoleOne writes the application s configuration information to the file specified in this field By default this is the webpub cfg file located in the WebPublisher Applicatio...

Page 44: ...ice provider is installed and configured at the same time as the WebPublisher Application You can disable the GroupWise Document service by removing the GroupWise Document service provider If you create new service providers to expose additional services through GroupWise WebPublisher you must define those service providers so that the WebPublisher Application knows about them To define service pr...

Page 45: ... click Properties 2 Click Application Templates to display the Templates page 3 Modify any of the following fields Template Path Select the location of the template base directory The template base directory contains the subdirectories for each of the templates provided with GroupWise WebAccess Currently only one template is provided for WebPublisher This is an HTML template that uses frames the t...

Page 46: ...m Enable Template Caching To speed up access to the template files the WebPublisher Application can cache the files to the server s memory Select this option to turn on template caching Cache Size Select the maximum amount of memory in kilobytes you want to use when caching the templates The default cache size 1024 KB is sufficient to cache all templates shipped with GroupWise WebPublisher If you ...

Page 47: ...dard HTML interface uses frame based HTML templates located in the frames directory that support the text html content type Browser User Agents The Browser User Agents tab lets you associate a user interface with a Web browser The association is based on the browser s User Agent information signature platform version and so forth Browser Accept Types The Browser Accept Types tab lets you associate...

Page 48: ...blisher Application uses the default interface only if it can t determine the appropriate interface based on the browser s User Agent WebAccess Application object Browser User Agent or the browser s accepted content types WebAccess Application object Browser Accept Types Delete Select a user interface in the list then click Delete to remove the interface This only removes the entry from the list I...

Page 49: ...ccept Types tab The Browser Accept Types tab lets you associate a user interface with a Web browser The association is based on the content type the browser accepts Many browsers accept more than one content type for example both text html and text plain If the list contains more than one acceptable content type the WebPublisher Application uses the browser s preferred content type which is the ty...

Page 50: ...thout first saving the files to the local drive This option requires that 1 each user s Web browser knows the correct application or plug in to associate with the document according to its file extension or MIME type and 2 the application or plug in is available to the user Otherwise the user is prompted to save the file to disk or specify the application to open it This option and the View Docume...

Page 51: ...ile that can be viewed in HTML format If a file exceeds the maximum size it must be opened in native format if allowed rather than viewed in HTML format The default maximum size is 1024 KB 4 Click OK 54 5 Configuring the GroupWise Service Provider The GroupWise service provider receives GroupWise requests from the WebAccess Application and communicates with the WebAccess Agent to fill the requests...

Page 52: ... Search Select how long you want the GroupWise service provider to wait for the WebAccess Agent to return information when a user performs a Busy Search Configuration File The WebAccess Agent s configuration file commgr cfg contains the agent s IP address and the encryption key required by the GroupWise service provider to communicate with the WebAccess Agent By default the commgr cfg file is stor...

Page 53: ... then click Down to move it down in the list Delete Select a WebAccess Agent in the list then click Delete to remove it from the list Customize Settings in XML Click this button to launch the XML editor You can use the editor to add modify or delete GroupWise service provider settings 4 Click OK to save the changes 54 6 Configuring the LDAP Service Provider The LDAP service provider is installed a...

Page 54: ...cess eDirectory or the GroupWise databases for this information ConsoleOne writes the information to the ldap cfg file By default the ldap cfg file is stored in the WebAccess Application s home directory which varies by platform You should avoid changing the location of the file If you do change the location of the file you need to make sure to modify the ldap cfg path in the Java servlet engine s...

Page 55: ... Web server The GroupWise Document service provider receives GroupWise document requests from the WebPublisher Application and communicates with the WebAccess Agent to fill the requests Figure 54 9 Document Service Provider The WebAccess installation program creates a Novell eDirectory object for the GroupWise Document service provider in the same context as the WebPublisher Application The object...

Page 56: ...e multiple WebAccess Agents in your GroupWise system and you are optimizing WebPublisher to provide greater scalability and availability you might need to change the setting For information see Section 53 3 Configuring Redirection and Failover Support on page 860 GroupWise WebAccess Agents This list displays the WebAccess Agents the GroupWise Document service provider can communicate with when att...

Page 57: ...ted data WebAccess cannot convert them In earlier versions of GroupWise the WebAccess Agent sometimes shut down when it could not convert a document This occurrence then interrupted the activities of all WebAccess users The Document Viewer Agent isolates the document conversion task from the WebAccess Agent The Viewer Agent can simultaneously convert multiple documents into HTML format If it encou...

Page 58: ... and port number can access the Viewer Agent Web console but you can configure the Viewer Agent to prompt for a username and password if desired The following switches configure the Viewer Agent Web console http httpport httpuser httppw After enabling the http switch and restarting the WebAccess Agent use the following URL to display the Viewer Agent Web console http server_address 7439 For more i...

Page 59: ...estart the WebAccess Agent to put the new settings into effect 54 8 4 Document Cache You can configure the Viewer Agent to cache documents that have already been converted to HTML This speeds up document display when the same document is viewed multiple times and by multiple users To enable document caching enable the cache startup switch in the Viewer Agent startup file This creates a cache subdi...

Page 60: ...es configure the performance of the Viewer Agent minworkers maxworkers maxtime maxsize addrspacename After editing the Viewer Agent startup file stop and restart the WebAccess Agent to put the new settings into effect 54 8 6 Agent Log Files As with the other GroupWise agents the Viewer Agent creates log files that include error messages and other information about Viewer Agent functioning Log file...

Page 61: ...ation Server IIS on Windows 2003 on page 914 54 9 1 Apache 2 on NetWare 6 5 1 Download Apache 2 0 2 2 for NetWare http mirrors combose com apache httpd binaries netware from the Apache Software Foundation http www apache org 2 Extract deflate nlm from the distribution and copy it to the sys apache2 modules directory 3 Change to the sys apache2 conf directory and open the httpd conf file in a text ...

Page 62: ...pression on Apache see Apache Module mod_deflate http httpd apache org docs 2 0 mod mod_deflate html on the Apache Software Foundation http www apache org Web site 54 9 3 Apache 2 on SUSE Linux Enterprise Server 9 The steps for Apache 2 on SUSE Linux Enterprise Server 9 are essentially the same as those for Novell Open Enterprise Server as described in Section 54 9 2 Apache 2 on Open Enterprise Se...

Page 63: ...anage classes of service Section 55 1 1 Class Membership on page 915 Section 55 1 2 Creating a Class of Service on page 916 Section 55 1 3 Adding Users to a Class of Service on page 918 Section 55 1 4 Maintaining the Access Database on page 918 55 1 1 Class Membership When you create a class of service you assign membership in the class at a domain level post office level distribution list group l...

Page 64: ...ss of service that allows access to WebAccess and another class that prevents access the class that allows access applies to the user 55 1 2 Creating a Class of Service 1 In ConsoleOne right click the WebAccess Agent object then click Properties 2 Click Access Control Settings to display the Access Control Settings page 3 Click Create to display the Create New Class of Service dialog box 4 Type a ...

Page 65: ...est from the user it opens the user s connection again In general you should leave the timeout interval set to the default 20 minutes You can also have users automatically logged out of WebAccess after a specified period of activity WebAccess logout is handled by the WebAccess Application running on the Web server not by the WebAccess Agent For information see Section 55 2 Setting the Timeout Inte...

Page 66: ...ibution Lists or Users to display the list you want 5 In the list select the domain post office distribution list or user you want then click Add to add the object as a member in the class 6 Repeat Step 3 through Step 5 for each object you want to add 55 1 4 Maintaining the Access Database The Access database stores the information for the classes of service you have set up to control user access ...

Page 67: ... database has been validated click OK If inconsistencies are found see Recovering the Access Database on page 919 Recovering the Access Database When you recover the Access database a new database is created and all salvageable records are copied to the new database Because some records might not be salvageable after the recovery you should check the classes of services you have defined to see if ...

Page 68: ...ession to a directory on the Web server where it is stored for 24 hours If the logged out user attempts to continue the session he or she is prompted to log in again after which the WebAccess Application renews the session For example suppose a user is composing a message when the timeout interval expires and then attempts to send the message The user is prompted to log in again after which the me...

Page 69: ...u cannot set individual user timeout intervals However if you have multiple Web servers you can set different timeout intervals for the Web servers by completing the above steps for each server s WebAccess Application 55 3 Configuring User Access to WebAccess Features By default WebAccess users can Spell check messages Search LDAP directories Change their GroupWise mailbox passwords Use Document M...

Page 70: ... Change Passwords Enable this option if you want users to be able to change their Mailbox passwords Disable this option to remove all Password features from the user interface Access Document Management Enable this option if you want users to be able to use the Document Management features Disable this option to remove all Document Management features from the user interface for example the Docume...

Page 71: ...ts in HTML format Disable this option to require users to save an attachment to a local drive and view it in its native application WebAccess uses Stellent Outside In HTML Export to convert files to HTML format For a list of the supported file format conversions download the following document from the Stellent Web site Outside In Supported Platforms and File Formats http www stellent com stellent...

Page 72: ...o image set the WebAccess Customize Image enable property to TRUE WebAccess Customize Image enable true 2c Modify the image properties as desired The customization properties file contains descriptions of each property 3 If you want to change the WebAccess colors 3a Locate the CUSTOMIZABLE COLORS SCHEME FOR GROUPWISE WEBACCESS section in the file 3b To turn on customization of the colors set the W...

Page 73: ...ng properly Section 56 1 1 Using the WebAccess Agent Server Console on page 925 Section 56 1 2 Using the WebAccess Agent Web Console on page 929 Section 56 1 3 Using Novell Remote Manager on page 932 Section 56 1 4 Using an SNMP Management Console on page 932 Section 56 1 5 Assigning Operators to Receive Warning and Error Messages on page 932 Section 56 1 6 Using WebAccess Agent Error Message Docu...

Page 74: ...ilable for use See Section 54 1 1 Modifying WebAccess Settings on page 870 Users In The Users In field displays the number of users who currently are logged in During startup if you have enabled WebPublisher the WebAccess Agent logs in one time for each available thread these logins are reflected in the Users In fields The Total field displays the total number of users who have logged in during th...

Page 75: ...gnostic displays Verbose logging plus thread information The default is Normal logging Use Diagnostic only if you are troubleshooting a problem with WebAccess File Logging Turns disk logging on or off When disk logging is turned on the WebAccess Agent creates a new log file each day and each time it is restarted The log file is named mmddweb nnn where mm is the month dd is the day and nnn is a seq...

Page 76: ...rmation that is displayed You can specify the logging level through ConsoleOne through startup switches or by using the F2 function key See Modifying WebAccess Agent Log Settings in ConsoleOne on page 939 Modifying WebAccess Agent Log Settings through Startup Switches on page 940 and F2 on page 929 The verbose and diagnostic logging levels do not degrade WebAccess Agent performance but log files s...

Page 77: ...Console You can use a Web browser interface referred to as the Web console to monitor the WebAccess Agent Figure 56 4 WebAccess Agent Web Console Through the Web console you can view the following information Status Displays how long the WebAccess Agent has been up the number of client server users who have logged in the number of threads dedicated to handling requests and the number of successful...

Page 78: ... change the port number and increase security after installation in ConsoleOne 1 In ConsoleOne right click the WebAccess Agent object then click Properties 2 Click GroupWise Network Address to display the Network Address page 3 In the HTTP Port field specify a port number We recommend that you use port 7211 if it is not already in use on the WebAccess Agent s server Assigning a port number enables...

Page 79: ...gent_port or https IP_address agent_port where IP_address is the IP address of the server where the WebAccess Agent is running and agent_port is the port number assigned to the agent If you used the default port during installation the port number is 7211 2 If prompted enter the Web console username and password 3 Select Status Configuration Environment or Log Files to view the desired information...

Page 80: ...vell ZENworks Server Management Before you can monitor the WebAccess Agent through an SNMP management console you must compile the WebAccess Agent s MIB Management Information Base file The Internet Agent s MIB file named gwweb mib is located in the agents snmp directory on the GroupWise 7 Administrator CD or in the GroupWise software distribution directory The MIB file contains all the Trap Set a...

Page 81: ... OK to add the user to the Gateway Administrators list 4 Make sure Operator is selected as the Administrator Role 5 If desired add additional operators 6 Click OK 56 1 6 Using WebAccess Agent Error Message Documentation WebAccess Agent error messages are documented with the source and explanation of the error possible causes of the error and actions to take to resolve the error See WebAccess Agent...

Page 82: ... the WebAccess Application s log files and configuration files and view Java information such as the version and classpath settings The following sections provide information to help you use the Web console Section 56 2 1 Enabling the WebAccess Application Web Console on page 934 Section 56 2 2 Using the WebAccess Application Web Console on page 935 56 2 1 Enabling the WebAccess Application Web Co...

Page 83: ...gent Server Console The Document Viewer Agent server console functions just like the WebAccess Agent server console For more information see Section 56 1 1 Using the WebAccess Agent Server Console on page 925 56 3 2 Using the Document Viewer Agent Web Console Like the WebAccess Agent the Document Viewer Agent also has a Web console Enabling the Document Viewer Agent Web Console on page 935 Viewing...

Page 84: ...t editor 7 Restart the WebAccess Agent to put the new settings into effect Each time you update the WebAccess software the existing gwdva dva file is backed up as gwdva nnn Therefore after updating the WebAccess software you need to rename the modified gwdva nnn file back to gwdva dva or repeat the editing changes in the updated gwdva dva file Viewing the Document Viewer Agent Web Console 1 In a W...

Page 85: ...uarantine on page 911 For detailed information about each field on the Status Configuration Environment Log Files Problem Files or Quarantine Files page select the page then click Help You cannot use the Web console to change any of the Viewer Agent s settings Changes must be made through the Viewer Agent startup file 56 4 Using WebAccess Log Files Error messages and other information about WebAcc...

Page 86: ...og file is named mmddweb nnn where mm is the month dd is the day and nnn is a sequenced number 001 for the first log file of the day 002 for the second and so forth Where WebAccess Agent log files are located by default varies by platform For information about modifying log settings see the following sections Modifying WebAccess Agent Log Settings in ConsoleOne on page 939 Modifying WebAccess Agen...

Page 87: ... Level There are four logging levels Off Normal Verbose and Diagnostic Off turns logging off Normal displays initial statistics user logins warnings and errors Verbose displays normal logging plus user requests and Diagnostic displays Verbose logging plus thread information The default is Normal logging Use Diagnostic only if you are troubleshooting a problem with WebAccess The verbose and diagnos...

Page 88: ...ettings through Startup Switches on page 940 To modify the log settings 1 At the NetWare WebAccess Agent s server console press F10 select Logging Options then set the log settings as needed 2 Press Esc to save the information Modifying Log Settings through the Windows WebAccess Agent Server Console You can use the Windows WebAccess Agent s console to modify the logging level All other log setting...

Page 89: ...formation written in not applicable to the Speller Application When logging is turned on the WebAccess applications create a new log file each day and each time it is restarted as part of the Web server startup WebAccess Application mmddwas nnn WebPublisher Application mmddwps nnn Speller Application spellchk log In the log filenames mm is the month dd is the year and nnn is a sequenced log file n...

Page 90: ...Speller Application Logging Level There are four logging levels None Normal Verbose and Diagnostic None turns logging off Normal displays warnings and errors Verbose displays Normal logging plus information messages and user requests and Diagnostic displays all possible information The default is Normal logging Use Diagnostic only if you are troubleshooting a problem with WebAccess The verbose and...

Page 91: ...g files 6 If you want to change the maximum size for log files remove the comment characters from the logmax switch then specify the maximum size in kilobytes for each log file 7 Save the gwdva dva file then exit the text editor 8 Restart the WebAccess Agent to put the new settings into effect 56 4 4 Viewing WebAccess Log Files You can view the log file for the current WebAccess Agent session or y...

Page 92: ... the Document Viewer Agent Web Console on page 936 56 4 5 Interpreting WebAccess Log File Information On startup the WebAccess records the WebAccess settings currently in effect Thereafter it logs events that take place including errors To look up error messages that appear in WebAccess log files see WebAccess Agent Error Messages in GroupWise 7 Troubleshooting 1 Error Messages ...

Page 93: ...ation of the startup file varies by platform The startup file is referenced from platform specific files that are used to start the WebAccess Agent You can also add startup switches to these platform specific files The table below summarizes WebAccess Agent startup switches for all platforms and how they correspond to configuration settings in ConsoleOne Switch starts with a b c d e f g h i j k l ...

Page 94: ...ttpport GroupWise Network Address HTTP Port httpuser httpuser httpuser GroupWise Optional Gateway Settings HTTP User Name ip ip ip GroupWise Network Address log log log GroupWise Log Files Log File Path logdays logdays logdays GroupWise Log Files Max Log File Age logdiskon logdiskon logdiskon N A loglevel loglevel loglevel GroupWise Log Settings Logging Level logmax logmax logmax GroupWise Log Set...

Page 95: ... and description of the startup switches When this switch is used the WebAccess Agent does not start NetWare sys system Linux opt novell groupwise agents share Windows c webacc NetWare strtweb ncf Linux grpwise wa Windows strtweb bat NetWare WebAccess Agent Linux WebAccess Agent Windows WebAccess Agent Syntax vol dir file svr vol dir file dir file drive dir file svr sharename dir file Example load...

Page 96: ...port number used for the WebAccess Agent to communicate with your Web browser The default is 7211 the setting must be unique See Using the WebAccess Agent Web Console on page 929 NetWare WebAccess Agent Linux WebAccess Agent Windows WebAccess Agent Syntax home svr vol dir home svr vol dir home dir home drive dir home svr sharename dir Example home provo1 home mail provo1 home server2 mail provo1 h...

Page 97: ...bAccess Agent Linux WebAccess Agent Windows WebAccess Agent Syntax httpuser unique_name httprefresh unique_name httprefresh unique_name Example httpuser GWWebCon httpuser GWWebCon httpuser GWWebCon NetWare WebAccess Agent Linux WebAccess Agent Windows WebAccess Agent Syntax ip IP_address ip full_DNS_name ip IP_address ip full_DNS_name ip IP_address ip full_DNS_name Example ip 172 16 5 18 ip webacs...

Page 98: ...ult For more information about the WebAccess Agent s logging see Section 56 4 1 Controlling WebAccess Agent Logging on page 937 See also log logdays loglevel and logmax 57 1 13 loglevel Specifies the level of information to write to the screen and to disk There are three levels Normal Verbose and Diagnostic The default level is Normal You can use Verbose to receive more information You should use ...

Page 99: ...time The default is 250 57 1 16 password Used by the NetWare WebAccess Agent only Specifies the Novell eDirectoryTM password to use to access the network servers where the GroupWise domain directory and post office directories reside See also user NetWare WebAccess Agent Linux WebAccess Agent Windows WebAccess Agent Syntax loglevel level loglevel level loglevel level Example loglevel verbose logle...

Page 100: ...ser requests at one time For more information see Section 54 1 Configuring the WebAccess Agent on page 870 57 1 20 user Used by the NetWare WebAccess Agent only Specifies the eDirectory username to use to access the network servers where the GroupWise domain directory and post office directories reside Must be used with password See also password NetWare WebAccess Agent Linux WebAccess Agent Windo...

Page 101: ...b c d e f g h i j k l m n o p q r s t u v w x y z NetWare WebAccess Agent Linux WebAccess Agent Windows WebAccess Agent Syntax work svr vol dir work svr vol dir work dir work drive dir work svr sharename dir Example work webwork work mail webwork work server2 mail webwork work server2 mail webwork work webwork work webwork work m webwork work server2 c mail webwork NetWare sys system Linux opt nov...

Page 102: ...N A loglevel loglevel loglevel N A logmax logmax logmax N A maxcache maxcache maxcache N A maxhold maxhold maxhold N A maxprobtime maxprobtime maxprobtime N A maxsize maxsize maxsize N A maxtime maxtime maxtime N A maxtrancache maxtrancache maxtrancache N A maxtrantime maxtrantime maxtrantime N A maxworkers maxworkers maxworkers N A minworkers minworkers minworkers N A port port port N A relay rel...

Page 103: ... 8 3 Document Quarantine on page 911 See also hold maxhold domain and relay 57 2 5 hold Enables the document quarantine feature of the Viewer Agent which is disabled by default See Section 54 8 3 Document Quarantine on page 911 See also maxhold email domain and relay 57 2 6 http Enables the Viewer Agent Web console See Enabling the Document Viewer Agent Web Console on page 935 NetWare Viewer Agent...

Page 104: ...Agent to prompt for before allowing Viewer Agent status information to be displayed in a Web browser Providing a username is optional Do not use an existing eDirectory username because the information passes over the insecure connection between your Web browser and the Viewer Agent See Enabling the Document Viewer Agent Web Console on page 935 NetWare Viewer Agent Linux Viewer Agent Windows Viewer...

Page 105: ...t Viewer Agent Logging on page 943 Typically you find multiple log files in the specified directory The first 4 characters represent the date The next 3 characters identify the agent A three digit extension allows for multiple log files NetWare Viewer Agent Linux Viewer Agent Windows Viewer Agent Syntax ip IP_address ip IP_address ip IP_address Example ip 172 16 5 18 ip 172 16 5 18 ip 172 16 5 18 ...

Page 106: ...nal information helpful for troubleshooting Verbose logging does not degrade Viewer Agent performance but log files saved to disk consume more disk space when verbose logging is in use See Section 56 4 3 Controlling Document Viewer Agent Logging on page 943 See also log logdays and logmax 57 2 15 logmax Sets the maximum amount of disk space for all Viewer Agent log files When the specified disk sp...

Page 107: ...t cannot be converted remains on the list of problem documents The default is 5 Section 54 8 4 Document Cache on page 911 See also cache maxcache maxtrancache and maxtrantime 57 2 19 maxsize Specifies in kilobytes the maximum size to which a file can grow during the conversion process The default is 1024 Section 54 8 5 Agent Performance on page 912 NetWare Viewer Agent Linux Viewer Agent Windows V...

Page 108: ...tion 54 8 4 Document Cache on page 911 See also cache maxcache maxtrancache and maxprobtime 57 2 23 maxworkers Specifies the maximum number of worker threads that the Viewer Agent starts The default is 15 The maximum number of threads is limited only by available memory resources on the server Section 54 8 5 Agent Performance on page 912 NetWare Viewer Agent Linux Viewer Agent Windows Viewer Agent...

Page 109: ... also ip 57 2 26 relay Specifies the IP address of a relay host if your system includes one This is necessary if you have configured the Viewer Agent to notify an administrator whenever a document is quarantined See Section 54 8 3 Document Quarantine on page 911 See also hold maxhold email and domain Example maxworkers 20 maxworkers 40 maxworkers 60 NetWare Viewer Agent Linux Viewer Agent Windows ...

Page 110: ...n page 910 NetWare sys system gwdva dir temp Linux opt novell groupwise agents bin gwdva dir temp Windows c webacc gwdva dir temp NetWare Viewer Agent Linux Viewer Agent Windows Viewer Agent Syntax temp svr vol dir temp svr vol dir temp dir temp drive dir temp svr sharename dir Example temp dva temp temp server2 mail dva temp temp server2 mail dva temp temp gwsystem temp temp dva temp temp m dva t...