1. Manuals
  2. Brands
  3. Novell Manuals
  4. Software
  5. GROUPWISE 7 ASYNC GATEWAY - INSTALLATION AND...
  6. Installation and administration manual

Novell GROUPWISE 7 ASYNC GATEWAY - INSTALLATION AND ADMINISTRATION Installation And Administration Manual

Hide thumbs Also See for GROUPWISE 7 ASYNC GATEWAY - INSTALLATION AND ADMINISTRATION:
Table of Contents

Advertisement

Quick Links

Download this manual
Novell Confidential
Novell
GroupWise
7
S e p t e m b e r 8 , 2 0 0 6
Async Gateway
®
I N S T A L L A T I O N A N D A D M I N I S T R A T I O N
G U I D E
Manual (ENU) 21 December 2004
w w w . n o v e l l . c o m

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the GROUPWISE 7 ASYNC GATEWAY - INSTALLATION AND ADMINISTRATION and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Novell GROUPWISE 7 ASYNC GATEWAY - INSTALLATION AND ADMINISTRATION

Summary of Contents for Novell GROUPWISE 7 ASYNC GATEWAY - INSTALLATION AND ADMINISTRATION

  • Page 1 Novell Confidential Manual (ENU) 21 December 2004 Novell GroupWise Async Gateway ® w w w . n o v e l l . c o m I N S T A L L A T I O N A N D A D M I N I S T R A T I O N...

  • Page 2: Legal Notices

    Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.
  • Page 3 Manual (ENU) 21 December 2004 Novell Trademarks ConsoleOne is a registered trademark of Novell, Inc., in the United States and other countries. eDirectory is a trademark of Novell, Inc. GroupWise is a registered trademark of Novell, Inc., in the United States and other countries.
  • Page 4 Novell Confidential Manual (ENU) 21 December 2004...

  • Page 5: Table Of Contents

    Novell Confidential Manual (ENU) 21 December 2004 Contents About This Guide What is the GroupWise Async Gateway? What’s New in This Release ..........14 Async Gateway System Requirements NetWare Async Gateway Requirements .
  • Page 6 Novell Confidential Manual (ENU) 21 December 2004 Running the Async Gateway Starting the Async Gateway ..........39 NetWare: Starting the Async Gateway.
  • Page 7 Novell Confidential Manual (ENU) 21 December 2004 Using Async Gateway Startup Switches /bkupdir ............96 /color (NetWare Only).
  • Page 8 Novell Confidential Manual (ENU) 21 December 2004 Stallion 8 Port ONboard (aiostln.nlm) ........105 Stallion 8 Port ONboard2 (aiostln.nlm).
  • Page 9 Novell Confidential Manual (ENU) 21 December 2004 Async Gateway Message Flow Diagrams Message Delivery Between GroupWise Domains ........
  • Page 10 Novell Confidential Manual (ENU) 21 December 2004 Stage 5: Async Gateway..........138 Stage 6: Async Gateway.

  • Page 11: About This Guide

    Novell Confidential Manual (ENU) 21 December 2004 About This Guide ® ® This Novell GroupWise 7 Async Gateway Installation and Administration Guide explains how to install, configure, and run the GroupWise 7 Async Gateway. The guide is intended for administrators with a working knowledge of GroupWise. The guide is divided into the following sections: Chapter 1, “What is the GroupWise Async Gateway?,”...
  • Page 12 Guide, visit the GroupWise 7 Documentation Web site (http://www.novell.com/documentation/ gw7). Documentation Conventions In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and items in a cross-reference path. ® A trademark symbol ( , etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party trademark.

  • Page 13: What Is The Groupwise Async Gateway

    Novell Confidential Manual (ENU) 21 December 2004 What is the GroupWise Async Gateway? ® ® The Novell GroupWise 7 Async Gateway connects GroupWise domains and users by way of modems and phone lines. When you connect GroupWise domains using the Async Gateway, the domains can be part of your local GroupWise system, or you can use the Async Gateway to connect domains in separate GroupWise systems so that the GroupWise systems are connected using the Async Gateway.

  • Page 14: What's New In This Release

    Novell Confidential Manual (ENU) 21 December 2004 Modem GroupWise Client Async Domain Gateway Modem Modem GroupWise Client Modem Message GroupWise Transfer Client Agent Post Office Post Office Agent Agent Post Office Post Office with Library with Library GroupWise GroupWise Client...

  • Page 15: Async Gateway System Requirements

    Server-class PC with a Pentium III or higher processor (17 to 32 ports) Disk Space 9 MB NetWare 5.1, 6.5 SP3 or later, or Novell Open Enterprise Server NetWare Modem AT command-set-compatible, with error correction protocol, 14400 baud or faster GroupWise System 6.5 or later...

  • Page 16: Optional Nlm Programs

    Novell Confidential Manual (ENU) 21 December 2004 NLM Name Description aio.nlm Asynchronous Input/Output (AIO) communication NLM. Should be present in sys:\system as part of NetWare. Must be loaded as a link between NetWare and other AIO device drivers that are configured as NLM programs.

  • Page 17: Windows Async Gateway Requirements

    Novell Confidential Manual (ENU) 21 December 2004 Components Minimum Memory Requirement aiodgmem.nlm 2 KB aiodgxi.nlm 80 KB aiodgxem.nlm 80 KB Windows Async Gateway Requirements The following table shows the minimum recommendations for hardware and software system components on a Windows server.
  • Page 18 Novell Confidential Manual (ENU) 21 December 2004 GroupWise 7 Async Gateway Installation and Administration Guide...

  • Page 19: Installing The Async Gateway

    Novell Confidential Manual (ENU) 21 December 2004 Installing the Async Gateway ® ® The Novell GroupWise 7 Async Gateway can be set up in a GroupWise primary domain or in a GroupWise secondary domain. Make sure you understand the Async Gateway requirements noted in Chapter 2, “Async Gateway System Requirements,”...

  • Page 20: Selecting A Serial Port Configuration

    Novell Confidential Manual (ENU) 21 December 2004 you can increase the number of connections (up to 32) or the number of Async Gateways that you install. ASYNC CONNECTION AND MODEM WORKSHEET Under Item 1: Number of Connections, record the number of async connections you need for your GroupWise system.

  • Page 21: Gathering I/O Port Driver Information For Netware

    When two or more multiple IO boards are installed, list the hardware number assigned by Novell to the AIO-compliant driver you have installed. For more information, including driver names, their hardware type (number), and the number of ports they support, see Appendix A, “Asynchronous Input/Output Drivers,”...

  • Page 22: Selecting A Domain For The Async Gateway

    Gateway and the full path to the domain directory. Under Item 6: eDirectory Information, specify the context where the Domain objects is located, along with the name of the Novell eDirectory tree. Under Item 5: Domain Server Type, mark whether the domain resides on a NetWare or a Windows server.

  • Page 23: Choosing A Gateway Name

    Novell Confidential Manual (ENU) 21 December 2004 You can choose where the NetWare Async Gateway is installed. Although the Installation program allows you to specify different locations for the Async Gateway NLM program, shared NLM programs, and the .ncf file, the simplest choice is to install all files to sys:\system. Installing the gateway files on the same server where the domain is located reduces network traffic, but the gateway files can be installed on a different server if necessary.
  • Page 24 Enabling SNMP If desired, you can monitor the Windows Async Gateway from the Management and Monitoring ® component of Novell ZENworks or any other SNMP management and monitoring program. When properly configured, the Async Gateway sends SNMP traps to network management consoles for display along with other SNMP monitored programs.

  • Page 25: Determining Local Async Link Information

    Novell Confidential Manual (ENU) 21 December 2004 Determining Local Async Link Information You need to define the following information so that other Async Gateways and GroupWise Windows client users working in Remote mode can connect to your local Async Gateway: Local Gateway ID: The login ID that you want remote sites to use when they log in to the local Async Gateway.

  • Page 26: Meeting Installation Prerequisites

    Novell Confidential Manual (ENU) 21 December 2004 Medium Priority Messages Queued: The number of messages that must be in the normal- priority queue before a connection is initiated. Both normal and high priority messages are included in the total count. If, for example, you choose to queue 10 normal priority messages, a connection is initiated if 3 high- and 7 normal- priority messages are queued.

  • Page 27: Ensuring Consoleone Readiness

    Novell Confidential Manual (ENU) 21 December 2004 Ensuring ConsoleOne Readiness Novell ConsoleOne 1.3.6 or later must be installed on your system. In addition, the GroupWise Administrator snap-ins for your version of GroupWise must be installed in ConsoleOne. Ensuring Domain/MTA Availability Make sure that the domain exists where you want to install the Async Gateway and that you are familiar with the domain location and configuration.

  • Page 28: Preparing Ports For The Windows Async Gateway

    Setting Up a Multiport Expansion Board on the NetWare Server Any multiport expansion board you use with the NetWare Async Gateway must have a Novell AIO-compatible port communication driver in NLM format in order to function properly. For information about these drivers, see Appendix A, “Asynchronous Input/Output Drivers,”...
  • Page 29 Novell Confidential Manual (ENU) 21 December 2004 NetWare: Place the file on a NetWare server or on the Windows workstation where you plan to run the Async Gateway Installation program. Windows: Place the file on the Windows server where you plan to install the Async Gateway.

  • Page 30: Installing The Async Gateway Administrator Snap-In To Consoleone

    Novell Confidential Manual (ENU) 21 December 2004 If you are updating an existing installation of the Async Gateway, check in ConsoleOne to make sure that the Database Version field on the Async Gateway Identification page is set to 4.x. “Defining Gateway Information” on page Do not start the Async Gateway at this time.

  • Page 31: Async Gateway Installation And Configuration Worksheets

    Novell Confidential Manual (ENU) 21 December 2004 Select Gateway Administrator Snap-Ins for ConsoleOne Only. Specify the path to a ConsoleOne installation where you want to install the Gateway Administrator snap-in. Select the version of your GroupWise system. Click Next to continue with the installation.

  • Page 32: Async Gateway Installation Worksheet

    Novell Confidential Manual (ENU) 21 December 2004 Item Explanation 3) Modem Information: List the technical details for the type of modem you are using. Serial port name “Gathering Modem Information” on page Modem name Baud rate Flow control Parity bit...

  • Page 33: Async Gateway Link Worksheet

    Novell Confidential Manual (ENU) 21 December 2004 Item Explanation 10) Windows Information: Mark whether you want to enable SNMP. See “Enabling SNMP” on page Enable SNMP? Mark whether you want to install the Windows Async Gateway as an application (with a user interface) or as a service (without a user interface).
  • Page 34 Novell Confidential Manual (ENU) 21 December 2004 Item Explanation 15) Calling Schedule: If necessary, establish a schedule for the Async Gateway to follow when connecting to the remote site. High priority messages queued “Setting Up a Calling Schedule (Optional)” on page...

  • Page 35: Defining Async-To-Async Connections

    Manual (ENU) 21 December 2004 Defining Async-to-Async Connections ® ® Before starting the Novell GroupWise 7 Async Gateway, you must configure the properties unique to the gateway so it can function properly with the ports and modems installed on your gateway server, and so proper async-to-async connections can be made.

  • Page 36: Defining A Domain Connection

    Novell Confidential Manual (ENU) 21 December 2004 If you have configured multiple serial ports, you must fill in the Port Information page for each serial port. Fill in the fields (worksheet item Serial Port: Specify a unique name for the serial port.
  • Page 37 Novell Confidential Manual (ENU) 21 December 2004 Fill in the fields with remote gateway information (worksheet item 13): Remote Gateway ID: Specify the login ID for the Async Gateway at the remote site. Password to Access Remote Gateway: Specify the password for the Async Gateway at the remote site).
  • Page 38 Novell Confidential Manual (ENU) 21 December 2004 GroupWise 7 Async Gateway Installation and Administration Guide...

  • Page 39: Running The Async Gateway

    Novell Confidential Manual (ENU) 21 December 2004 Running the Async Gateway ® ® After you have installed the Novell GroupWise Async Gateway and defined async-to-async links, you are ready to run the gateway. “Starting the Async Gateway” on page 39 “Testing the Async Gateway”...

  • Page 40: Windows: Starting The Async Gateway

    Read, File Scan GroupWise Home Directory Read, Write, Create, Erase, Modify If the gateway resides on a server in another Novell eDirectory tree, you must set up a bindery context so the gateway can attach to the GroupWise server. Gwasync.cfg File Gwasync.cfg is an ASCII text file that stores the startup switches (see...
  • Page 41 Novell Confidential Manual (ENU) 21 December 2004 “Starting the Gateway as a Windows Application” on page 41 “Starting the Gateway as a Windows Service” on page 41 Starting the Gateway as a Windows Application At the Windows server, click Start > Programs.

  • Page 42: Testing The Async Gateway

    Novell Confidential Manual (ENU) 21 December 2004 Testing the Async Gateway If you want to test the Async Gateway after it is installed, or if you suspect that your network links might be incorrect, you can test the connectivity of the gateway by sending a message to an unconfigured address.
  • Page 43 Novell Confidential Manual (ENU) 21 December 2004 “Creating or Changing a Mailbox Password” “Users” in the GroupWise 6.5 Administration Guide Using the basic features of the GroupWise Windows client in Remote mode. See: “Using Remote Mode” in the “GroupWise 7 Windows Client User Guide”...
  • Page 44 Novell Confidential Manual (ENU) 21 December 2004 GroupWise 7 Async Gateway Installation and Administration Guide...

  • Page 45: Configuring The Async Gateway

    “Supporting GroupWise Windows Client Users in Remote Mode” on page 70 “Backing Up and Recovering the Gateway Database” on page 72 Customizing Gateway Configuration Configuration information for the Async Gateway is stored on the Async Gateway object in Novell eDirectory “Defining Gateway Information” on page 45 “Defining Gateway Time Settings”...

  • Page 46: Defining Gateway Time Settings

    Novell Confidential Manual (ENU) 21 December 2004 Fill in the fields: Description: Enter details that will help you identify why or when the gateway was created. Subdirectory: Displays the gateway subdirectory under domain/wpgate that was created when the Async Gateway was installed.

  • Page 47: Defining Log Settings

    Novell Confidential Manual (ENU) 21 December 2004 Fill in the fields: Send/Receive Cycle: This option does not apply to the Async Gateway. Minimum Run: This option does not apply to the Async Gateway. Idle Sleep Duration: Specify the time in seconds that you want the gateway to sleep when it has no files to send, receive, or convert.

  • Page 48: Defining Optional Gateway Settings

    Novell Confidential Manual (ENU) 21 December 2004 Fill in the fields. Log File Path: Specify the directory where you want the Async Gateway to create its log files. The default is the gateway home directory (domain\wpgate\async\000.prc). Logging Level: Select the level of detail to be recorded in the log file from the drop-down list.
  • Page 49 Novell Confidential Manual (ENU) 21 December 2004 Directory Sync/Exchange: None of the options in this field apply to the Async Gateway. Accounting: Click Yes if you want the gateway to keep accounting records for every message it sends or receives. The gateway records this information in an ASCII text file called acct, which is placed in the xxx.prc subdirectory and updated daily at midnight or when the gateway is...

  • Page 50: Defining Gateway Administrators

    Novell Confidential Manual (ENU) 21 December 2004 Enable Recovery: Click Yes to let the gateway attempt to restart itself or reestablish the connection to the foreign system when either fails. Retry Count: Specify the number of times you want the gateway to attempt to recover a connection if the connection fails.

  • Page 51: Defining User Access To The Gateway

    Novell Confidential Manual (ENU) 21 December 2004 Click Add to display the Select GroupWise Object dialog box. All users in your GroupWise system are listed alphabetically by their user IDs. You can select Distribution Lists to list distribution lists instead of users.
  • Page 52 Novell Confidential Manual (ENU) 21 December 2004 Access Control The access.cfg file contains one access control statement. The statement is used to turn access control on or off. Syntax: access control = on |off Example: access control = on There should only be one access control statement in the file. If the file includes multiple statements, the last statement is used.
  • Page 53 Novell Confidential Manual (ENU) 21 December 2004 [Accessgroup:name] The Accessgroup:name header defines the name of an access control group. Any settings under this header apply to users with the same access group name specified in the Gateway Access field on the GroupWise Account page of their User objects in ConsoleOne. This header enables you to apply access control settings to a single user or multiple users.
  • Page 54 Novell Confidential Manual (ENU) 21 December 2004 BLOCK The BLOCK keyword blocks the message when the foreign address matches gwaddresstext. This keyword differs from NOACCESS because a specific remote or domain profile name can be specified. If users try to send messages to an address which has been blocked, they receive an Undeliverable message from the gateway.

  • Page 55: Applying Access Control Settings To Individual Users

    Any text following a semicolon, slash, or pound sign is ignored. Gwaddresstext: Replace this field with the GroupWise address you want to use, such as Novell.Sales.Glen, where Novell.Sales.Glen is the GroupWise proxy address of the GroupWise user.
  • Page 56 Novell Confidential Manual (ENU) 21 December 2004 Using the Access.cfg file You can use the [Accessgroup:name] in the access.cfg file to control access settings for individual users. For the name, you can enter any identifier you choose, such as [ACCESSGROUP:CONTROL]. In the example below, the name is control. Under this header, include the keywords you want to apply to the given users.

  • Page 57: Simplifying Addressing

    Novell Confidential Manual (ENU) 21 December 2004 In the Gateway Access field, assign a name to the user. Use the following syntax: gateway_alias_type.direction IMPORTANT: The BLOCK and ALLOW keywords cannot be used in the Gateway Access field. To use these keywords, use an ACCESSGROUP name in the access.cfg file.

  • Page 58: Creating A Customized Addressing Rule

    Novell Confidential Manual (ENU) 21 December 2004 When a user sends a message, GroupWise checks the address to see if a customized addressing rule applies to its syntax. If no rule exists, the GroupWise client validates the first element in the address syntax.
  • Page 59 Novell Confidential Manual (ENU) 21 December 2004 Addressing Rule Concepts Addressing rules allow your users to select an external address from their personal address books or enter a shortened form of an address that is then resolved to an explicit Async Gateway address.
  • Page 60 Novell Confidential Manual (ENU) 21 December 2004 Fill in the fields: Description: Specify a short description (fewer than 16 characters) for the rule. Name: Specify a name for the rule. Do not use any invalid characters. The name should be descriptive.

  • Page 61: Creating An External Domain Structure

    Novell Confidential Manual (ENU) 21 December 2004 Search String: Replacement String: sales.async:'firefly':manufacturing.po1.%1 Results (explicit address): sales.async:'firefly':manufacturing.po1.maria Scenario Two A user in your system sends a message to her co-worker, Margaret, whose GroupWise account is on another GroupWise system. You have defined .com as a replacement for the marketing.po1 combination, .dev for the marketing.research combination, and .edu for the marketing.training...
  • Page 62 Novell Confidential Manual (ENU) 21 December 2004 domain in your system for every primary or secondary domain in the external system to ensure that your local GroupWise system has the message routing information it needs to send messages to external GroupWise users.
  • Page 63 Novell Confidential Manual (ENU) 21 December 2004 Specify a domain name. Names are not case sensitive For the Async Gateway, keep the default domain type, External GroupWise. Use the drop-down list to select the time zone where the external GroupWise domain is physically located.
  • Page 64 Novell Confidential Manual (ENU) 21 December 2004 Icon Description Unsafe - change currently being replicated Change made to link from another view No rights to change link Click the name of the external GroupWise domain you want to link to.
  • Page 65 Novell Confidential Manual (ENU) 21 December 2004 Icon Description Unmodified Modified - needs to be saved Unsafe - change currently being replicated Change made to link from another view No rights to change link In the Link Configuration Tool, double-click the name of the external domain you want to create an indirect link to.

  • Page 66: Merging Groupwise Domains

    Novell Confidential Manual (ENU) 21 December 2004 Click OK to create the external post office. Simplifying Address Syntax to UserID The same four tasks that were required to simplify address syntax to post_office.user_ID, as described in “Simplifying Address Syntax to Post_Office.UserID” on page 65, are also required for this syntax.

  • Page 67: Setting Up Gateway Accounting

    Novell Confidential Manual (ENU) 21 December 2004 External domains have been created and named in your GroupWise system to reflect the domain structure of the other GroupWise system. For information on the process of merging domains, see: “Merging with GroupWise 5.x, 6.x, and 7.x Systems”...

  • Page 68: Selecting An Accountant

    Novell Confidential Manual (ENU) 21 December 2004 Verify that Accounting is set to Yes. Verify that Correlation Enabled is set to Yes. If necessary, click Apply to save your changes. Continue with Selecting an Accountant. Selecting an Accountant You can select one or more GroupWise users to be Accountants. Every day at midnight, each Accountant receives an accounting file (acct) that contains information about the messages the gateway sent that day.

  • Page 69: Understanding The Accounting File

    Novell Confidential Manual (ENU) 21 December 2004 All users in your GroupWise system are listed alphabetically by their user IDs. You can select Distribution Lists to list distribution lists instead of users. Use the Filter fields above the list to restrict the length of the list.

  • Page 70: Supporting Groupwise Windows Client Users In Remote Mode

    Novell Confidential Manual (ENU) 21 December 2004 Fields Description Sample # of users at this destination Number of users the message was sent to # of Attachments Number of attachments sent with message Accounting Units Byte size of item sent through gateway...

  • Page 71: Defining A Groupwise Remote Profile

    Novell Confidential Manual (ENU) 21 December 2004 The Redial Attempts setting should be set to the default value of 5. If you want the Remote users to use another setting, keep them informed. The Redial Retry Interval setting should be 1 minute. If you want the Remote users to use another setting, keep them informed.

  • Page 72: Backing Up And Recovering The Gateway Database

    Novell Confidential Manual (ENU) 21 December 2004 Days Before Auto-Purge of Messages: The number of days you want to keep non- downloaded messages in the holding queue before they are purged. Minimum Idle Time: The number of minutes that you want the Async Gateway to remain connected while waiting for responses from the GroupWise system.

  • Page 73: Monitoring The Async Gateway

    Manual (ENU) 21 December 2004 Monitoring the Async Gateway ® ® After you have installed, configured, and started the Novell GroupWise 7 Async Gateway, there are several ways in which you can monitor gateway operation. “Using the Async Gateway Server Console” on page 73 “Using the Async Gateway Web Console”...

  • Page 74: Description

    Novell Confidential Manual (ENU) 21 December 2004 Description The Description area of the gateway server console provides the following information: Domain.Gateway: Displays the domain and gateway name you specified when you created the gateway. UpTime: Displays the length of time the gateway has been running.

  • Page 75: Logging

    Novell Confidential Manual (ENU) 21 December 2004 Passthrough: Displays the number of incoming and outgoing passthrough messages the gateway has processed. Comm Queue: Displays the number of outgoing or incoming messages waiting in the messaging queue. Comm Errors: Displays the number of communications errors for incoming and outgoing messages.
  • Page 76 Novell Confidential Manual (ENU) 21 December 2004 Menu Function / Keystroke Description Home, Home, Down- Move to the bottom of the log file. Arrow F10-Options The following additional menu options are available by pressing F10: Menu Function Keystroke F1-Exit Options Return to the main menu options.

  • Page 77: Using The Async Gateway Web Console

    Novell Confidential Manual (ENU) 21 December 2004 Menu Item Description Port Details Display status and other information for a selected port. See “Port Status” on page 77 “Port Details” on page 77 Platform Independent Port Status and Details Port Status Status information is available for each of the 32 possible ports.

  • Page 78: Setting Up The Async Gateway Web Console

    Novell Confidential Manual (ENU) 21 December 2004 “Setting Up the Async Gateway Web Console” on page 78 “Accessing the Async Gateway Web Console” on page 79 “Monitoring the Async Gateway from the Web Console” on page 80 Setting Up the Async Gateway Web Console The Async Gateway Web console can be set up in ConsoleOne.

  • Page 79: Accessing The Async Gateway Web Console

    Click Set Password. Type the password twice for verification. Click Set Password. Do not use a Novell eDirectory username and password because the information passes over the non-secure connection between your Web browser and the Async Gateway. For convenience, use the same username and password for all GroupWise agents and gateways that you plan to monitor from GroupWise Monitor.

  • Page 80: Monitoring The Async Gateway From The Web Console

    Novell Confidential Manual (ENU) 21 December 2004 Examples: http://172.16.5.18:7177 http://asyncserver1:7177 Monitoring the Async Gateway from the Web Console The Async Gateway Web console provides several pages of information to help you monitor the performance of the Async Gateway. The Async Gateway Web console menu lists the pages of information available in the Async Gateway Web console.

  • Page 81: Checking The Operating System Environment

    Novell Confidential Manual (ENU) 21 December 2004 To change the log settings for the current gateway session, click Event Log Settings. All other settings listed on the Configuration page must be changed in ConsoleOne. Checking the Operating System Environment On the Async Gateway Web console menu, click Environment to display information about the operating system where the Async Gateway is running.

  • Page 82: Viewing Gateway Log Files

    Novell Confidential Manual (ENU) 21 December 2004 Viewing Gateway Log Files On the Async Gateway Web console menu, click Log Files to display gateway log files. Click Event Log Settings to change the log settings for the current Async Gateway session.

  • Page 83: Using Async Gateway Log Files

    Novell Confidential Manual (ENU) 21 December 2004 Modify the settings as needed, then click Submit to change them for the current Async Gateway session. For information about the time settings, see “Defining Gateway Time Settings” on page Checking and Changing Optional Gateway Settings On the Async Gateway Web console menu, click Optional Gateway Settings to display the settings listed on the Optional Gateway Settings page in ConsoleOne.

  • Page 84: Configuring Log Settings And Switches

    Novell Confidential Manual (ENU) 21 December 2004 The gateway creates a new log file each day and each time the gateway is restarted. The log file is named mmddlog.nnn, where mmdd is the month and day and nnn is the log file number beginning with 001.

  • Page 85: Viewing The Log File

    “Menu Functions” on page 75 Using SNMP Monitoring Programs The Async Gateway supports the Simple Network Management Protocol (SNMP). You can monitor the Async Gateway from the Management and Monitoring component of Novell ® ZENworks or any other SNMP management and monitoring program. When properly configured, the Async Gateway sends SNMP traps to network management consoles for display along with other SNMP monitored programs.

  • Page 86: Windows: Enabling Snmp Support

    Novell Confidential Manual (ENU) 21 December 2004 contact Novell or your authorized Novell reseller. The Async Gateway can function without the SNMP agent (snmp.nlm). Windows: Enabling SNMP Support During installation of the Windows Async Gateway, you had the opportunity to configure the Async Gateway for SNMP.
  • Page 87 Novell Confidential Manual (ENU) 21 December 2004 To make sure that the Windows machine where the Async Gateway is running is configured to send SNMP traps to the ZENworks for Servers Site Server, add the IP address or host name of the Site Server to the list of trap destinations.

  • Page 88: Understanding Async Gateway Error Messages

    Novell Confidential Manual (ENU) 21 December 2004 Provide your system SNMP community GET string, then click OK. ConsoleOne then notifies the Async Gateway to restart so the new settings can be put into effect. The Async Gateway should now be visible to your SNMP monitoring program.

  • Page 89: Optimizing The Async Gateway

    Novell Confidential Manual (ENU) 21 December 2004 Optimizing the Async Gateway ® ® You can adjust how the Novell GroupWise Async Gateway functions in order to optimize its performance. “Scripting for the GroupWise Async Gateway” on page 89 “Performing Queue Maintenance” on page 93 “Using Forced Dialing”...
  • Page 90 Novell Confidential Manual (ENU) 21 December 2004 Default scripts are named default.scr and are placed in the \domain\wpgate\gateway\gwout\ directory Link-specific scripts are named link.scr and are placed in the individual \domain\wpgate\gateway\gwout\link_id link subdirectories: TIP: The Domain Connections panel in ConsoleOne contains a field for the Remote Phone Number. This field represents the phone number you dial to complete the domain connection.
  • Page 91 Novell Confidential Manual (ENU) 21 December 2004 LISTEN The script receives characters from the line and makes a branching decision based on the IF cases within the LISTEN statement. At least one IF case must be included and a total of four are allowed.
  • Page 92 Novell Confidential Manual (ENU) 21 December 2004 IMPORTANT: There is a difference between sending raw data to a COM port and a modem. If you embed modem commands in your script, such commands should be followed by \r. For example, if you want to instruct a modem to dial the number 555-1212, the instruction would be sent to the modem as follows: SEND "atdt 555-1212\r"...

  • Page 93: Performing Queue Maintenance

    Novell Confidential Manual (ENU) 21 December 2004 PAUSE 1 SEND "athz\r"# Hang up PAUSE 1 LOG "Dialing 555-1414." SEND "atdt 555-1414\r"# Dial alternate number LISTEN FOR 30 IF "CONNECT" GOTO LABEL2 IF TIMEOUT GOTO LABEL4 ENDLISTEN LABEL5: DONE "Aborting Script to Answer Inbound call."...

  • Page 94: Using Forced Dialing

    Novell Confidential Manual (ENU) 21 December 2004 connections that are no longer in the database and creates directories for connections that do not have them. This is disabled until a Check Database function is successfully executed. Click OK when you are finished with database maintenance.
  • Page 95 Novell Confidential Manual (99a) 21 December 2004 Using Async Gateway Startup Switches ® ® The Novell GroupWise Async Gateway allows you to define gateway switches at the command line or within a startup file. Startup switches have two main functions:...

  • Page 96: Using Async Gateway Startup Switches /Bkupdir

    Novell Confidential Manual (99a) 21 December 2004 NetWare Async Gateway Windows Async Gateway ConsoleOne Setting /logdays /logdays GroupWise > Log Settings > Max Log File Days /loglevel /loglevel GroupWise > Log Settings > Logging Level /logmax /logmax GroupWise > Log Settings > Max Log Disk Space...

  • Page 97: Home

    Specifies the password for the Async Gateway to prompt for before allowing gateway status information to be displayed in your Web browser. Do not use an existing Novell eDirectory password because the information passes over the non-secure connection between your Web browser and the Async Gateway.

  • Page 98: Httpuser

    Novell Confidential Manual (99a) 21 December 2004 /httpuser Specifies the username for the Async Gateway to prompt for before allowing gateway 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 non-secure connection between your Web browser and the Async Gateway.

  • Page 99: Logmax

    Novell Confidential Manual (99a) 21 December 2004 /logmax Controls the maximum amount of disk space for all log files. When this limit is reached, the gateway overwrites existing log files starting with the oldest file. The default is 1024 KB or 1 MB.

  • Page 100: Single

    Novell Confidential Manual (99a) 21 December 2004 /single Runs a single send and receive cycle and then terminates the program. Syntax: /single /user (NetWare Only) Designates the user ID of the user on the server where the GroupWise domain and gateway queue directories reside.

  • Page 101: A Asynchronous Input/Output Drivers

    “Gathering I/O Port Driver Information for NetWare” on ® page 21. The list includes the hardware type (assigned by Novell ) and the number of ports each driver supports. If the number of ports varies or is unknown, a 0 is listed.] AIO TCP for IP Drivers (aiotcp.nlm)

  • Page 102: Hardware Descriptions

    Novell Confidential Manual (99a) 21 December 2004 Stallion 8 Port ONboard2 (aiostln.nlm) Stallion 8 Port ONboard/E (aiostln.nlm) Stallion 8-64 Port EasyConnection (EISA) (aioeasy.nlm) Stallion 8-64 Port EasyConnection (ISA) (aioeasy.nlm) Stallion 8-64 Port EasyConnection (MCA) (aioeasy.nlm) Technology Concepts 2 Port PCC/MX (aiotcl.nlm) Technology Concepts 8 Port PCC/8i (aiotcl.nlm)

  • Page 103: Comtrol 4/8/16 Port Hostess-186 (Aiohst.nlm)

    Novell Confidential Manual (99a) 21 December 2004 Comtrol 4/8/16 Port Hostess-186 (aiohst.nlm) Hardware Type: 117 Maximum Number of Ports: 0 Comtrol 4 Port RocketPort Adapter (aiorckt.nlm) Hardware Type: 130 Maximum Number of Ports: 4 Comtrol 8 Port RocketPort Adapter (aiorckt.nlm)

  • Page 104: Digi 16-128 Port C/X Cluster (Aiodgcx.nlm)

    Novell Confidential Manual (99a) 21 December 2004 Digi 16-128 Port C/X Cluster (aiodgcx.nlm) Hardware Type: 106 Maximum Number of Ports: 0 Digi EPC/X System (aiodgepc.nlm) Hardware Type: 108 Maximum Number of Ports: 0 Equinox SSP 1-1024 Port Super Serial Port (aioeqnx.nlm)

  • Page 105: Microdyne 8 Port Wnim3000 (Aiownim3.Nlm)

    Novell Confidential Manual (99a) 21 December 2004 Microdyne 8 Port WNIM3000 (aiownim3.nlm) Hardware Type: 116 Maximum Number of Ports: 8 Multitech ISI608 8 Port (ISA) (aioisix.nlm) Hardware Type: 143 Maximum Number of Ports: 8 Newport Systems 8 Port ACI (aioaci.nlm)

  • Page 106: Stallion 8 Port Onboard2 (Aiostln.nlm)

    Novell Confidential Manual (99a) 21 December 2004 Stallion 8 Port ONboard2 (aiostln.nlm) Hardware Type: 126 Maximum Number of Ports: 8 Stallion 8 Port ONboard/E (aiostln.nlm) Hardware Type: 128 Maximum Number of Ports: 8 Stallion 8-64 Port EasyConnection (EISA) (aioeasy.nlm) Hardware Type: 141 Maximum Number of Ports: 0 Stallion 8-64 Port EasyConnection (ISA) (aioeasy.nlm)

  • Page 107: Pad (Aiopad.nlm)

    Novell Confidential Manual (99a) 21 December 2004 X.25 PAD (aiopad.nlm) Hardware Type: 9 Maximum Number of Ports: 0 Xircom 4/8 Port Access Server (aioxrcm1.nlm) Hardware Type: 140 Maximum Number of Ports: 0 Asynchronous Input/Output Drivers...
  • Page 108 Novell Confidential Manual (99a) 21 December 2004 GroupWise 7 Async Gateway Installation and Administration Guide...

  • Page 109: Creating A Modem Definition

    Novell Confidential Manual (99a) 21 December 2004 Creating a Modem Definition If you find it necessary to create, edit or research the properties of a modem, you can provide the ® modem data commands and settings needed by the Async Gateway in ConsoleOne , as described “Gathering Modem Information”...

  • Page 110: Creating A Modem Initialization String

    Novell Confidential Manual (99a) 21 December 2004 Dialing: Specify modem dialing commands, including any commands for tone or pulse dialing, dial pauses, user codes, or other required dialing commands. Suffix: Command data is usually not required in this field. It is only used for special devices or circumstances, such as a cellular phone connection.
  • Page 111 Novell Confidential Manual (99a) 21 December 2004 After you check the modem documentation for the correct characters to include in the string, you can define the initialization string for the Async Gateway. To create the initialization string: In ConsoleOne, browse to and select the Domain object where you created the gateway.
  • Page 112 Novell Confidential Manual (99a) 21 December 2004 GroupWise 7 Async Gateway Installation and Administration Guide...

  • Page 113: C Async Gateway Error Messages

    GroupWise Async Gateway might generate the messages in the “Error Message List” on page 113. Additional sources of troubleshooting assistance include: Novell Support Knowledgebase (http://support.novell.com/search/kb_index.jsp) ® GroupWise Product Support Forums (http://support.novell.com/forums/2gw.html) GroupWise Support Community (http://support.novell.com/products/groupwise) GroupWise Cool Solutions (http://www.novell.com/coolsolutions/gwmag/index.html) Error Message List...
  • Page 114 Novell Confidential Manual (99a) 21 December 2004 Select Modem to display the driver. Right-click the modem driver, then click Properties. Check the various tabs of the Modem Properties dialog box to make sure that the modem is correctly configured. NGWASYNC: Idle time exceeded (nnn mins), on xxx Source: GroupWise Async Gateway.
  • Page 115 Novell Confidential Manual (99a) 21 December 2004 NGWASYNC: Undeliverable Message from xxx Source: GroupWise Async Gateway. Explanation: An attempt to queue a file from the Message Transfer Agent (MTA) to the gateway failed. The message will be deferred. Action: None. The file will be requeued.
  • Page 116 Novell Confidential Manual (99a) 21 December 2004 GroupWise 7 Async Gateway Installation and Administration Guide...

  • Page 117: D Async Gateway Troubleshooting Strategies

    Manual (99a) 21 December 2004 Async Gateway Troubleshooting Strategies ® ® The following information can help you troubleshoot and maintain the Novell GroupWise Async Gateway. For information about gateway error messages, see Appendix C, “Async Gateway Error Messages,” on page 113.

  • Page 118: Specific Problems

    “Gathering I/O Port Driver Information for NetWare” on page Specific Problems Search the Novell Support Knowledgebase (http://support.novell.com/search/kb_index.jsp) the latest solutions to specific problems. Troubleshooting Modems You can configure modems in different ways. There is no set method for solving your modem connection problems;...

  • Page 119: Creating A Modem Initialization String

    Using Aioterm.nlm to Troubleshoot the NetWare Async Gateway Aioterm.nlm, available from Novell Support (http://support.novell.com), can provide some data about the modem intialization string that you might find helpful in troubleshooting. You should download a file called aiotrm.exe, which is a self-extracting, compressed file including the aioterm.nlm.

  • Page 120: Troubleshooting The Groupwise Windows Client In Remote Mode

    Novell Confidential Manual (99a) 21 December 2004 at&v Error ati4 USRobotics Courier 16800 HST Dual Standard Settings B0 C1 E1 F1 If there is no response from the modem, enter ATE1. If there is still no response from the modem, a problem with the serial expansion board or IO drivers is indicated.

  • Page 121: Specific Item Or Request Problems

    Novell Confidential Manual (99a) 21 December 2004 Specific Item or Request Problems Use the Pending Requests option in the GroupWise Windows client in Remote mode to view the requests that have not been responded to yet. To access the Pending Requests dialog in the GroupWise Windows client, click Remote > Pending Requests.

  • Page 122: The Gateway Is Not Dialing

    Novell Confidential Manual (99a) 21 December 2004 The Gateway Is Not Dialing If the Async Gateway is not dialing, verify the following: Modem commands are followed by “/r” in the script. Check to see if this has been appended to the dialing instructions, and ensure that it is within double quotes (""). See “Sample Script...

  • Page 123: E Async Gateway Directory Structures

    Async Gateway Directory Structures You can use directory structure information after you install and run the gateway to help you find ® ® the various files, databases and directories that comprise the Novell GroupWise Async Gateway. This can be critical to resolving problems.

  • Page 124: Domain\Wpgate\Async Directory

    Novell Confidential Manual (ENU) 21 December 2004 gwout Async Gateway output queue directory connection_ID Domain-specific output queue High-priority compressed message queue Normal-priority compressed message queue Low-priority compressed message queue Holding directory for compressed outbound messages gwhold Message hold directory qfiles...

  • Page 125: Wpcsin Directory

    Novell Confidential Manual (ENU) 21 December 2004 proc file The proc file is the lock file for gateway processes. The proc file is opened and locked when the gateway is started. stat file The stat file stores statistics about the Async Gateway’s functioning.

  • Page 126: Gwout Directory

    Novell Confidential Manual (ENU) 21 December 2004 connection_ID directory Each domain where messages go to and from the Async Gateway has its own subdirectory for gateway processing. cmp directory The cmp directory holds compressed message files that the Async Gateway has received across the modem.

  • Page 127: Wpmodem.db File

    Novell Confidential Manual (ENU) 21 December 2004 wpmodem.db file The wpdomain.db file is a database containing an extensive list of modems, along with configuration data for each modem. ngwasync.mib file The ngwasync.mib file is the Gateway Management Information Base (MIB) containing variables used by SNMP-compliant network management systems.
  • Page 128 Novell Confidential Manual (ENU) 21 December 2004 GroupWise 7 Async Gateway Installation and Administration Guide...

  • Page 129: Async Gateway Message Flow Diagrams

    Novell Confidential Manual (ENU) 21 December 2004 Async Gateway Message Flow Diagrams ® Message flow diagrams help you understand how messages travel to and from your Novell ® GroupWise system through the Async Gateway. “Message Delivery Between GroupWise Domains” on page 129 “GroupWise Client to Async Gateway Message Delivery”...

  • Page 130: Post Office Agent

    Novell Confidential Manual (ENU) 21 December 2004 Post Office Agent The Post Office Agent (POA) is the GroupWise program that delivers messages to users’ mailboxes in each post office. In addition, the POA detects and repairs damaged databases, replicates shared folders between post offices, performs the indexing tasks of document management, and responds to requests from Remote client users.

  • Page 131: Process 8: Mta Delivers Message Status

    Novell Confidential Manual (ENU) 21 December 2004 Process 8: MTA Delivers Message Status The MTA in the recipient’s domain transfers the Delivered status to the Async Gateway in the recipient’s domain. Process 9: Async Gateway Transfers Message Status The Async Gateway in the recipient’s domain transfers the Delivered status message to the Async Gateway in the sender’s domain.

  • Page 132: Process 1: Remote User Sends Message

    Novell Confidential Manual (ENU) 21 December 2004 GroupWise Master Remote User Mailbox GroupWise Remote Recipients in other domains Gateway Process 1: Remote User Sends Message The remote GroupWise user creates a message using the GroupWise Windows client in Remote mode.

  • Page 133: Process 8: Async Gateway Delivers Message

    Novell Confidential Manual (ENU) 21 December 2004 Process 8: Async Gateway Delivers Message The Async Gateway delivers the message to the remote GroupWise user. Message Flow from Async Gateway to Async Gateway WPGATE WPGATE Async Async GWIN GWIN CONN ID...

  • Page 134: Stage 4: Async Gateway In Sender's Domain

    Novell Confidential Manual (ENU) 21 December 2004 domain\wpgate\async\wpcsout\asyxxxx\1-3 Stage 4: Async Gateway in Sender's Domain The Async Gateway in the sender’s domain detects the message in the queue, determines the message priority, and places it in the appropriate connection ID directory and in the appropriate priority subdirectory.

  • Page 135: Stage 10: Poa In Recipient's Post Office

    Novell Confidential Manual (ENU) 21 December 2004 Stage 10: POA in Recipient's Post Office The POA polls its input queue regularly. When it detects a new message, the POA in the recipient’s post office performs the following actions: Adds the message to the message database (msg 0-24.db file) corresponding to the one assigned to the sender.

  • Page 136: Stage 17: Modem Connection Between Gateways

    Novell Confidential Manual (ENU) 21 December 2004 Stage 17: Modem Connection Between Gateways The recipient’s Async Gateway sends the file through the modem connection to the Async Gateway at the sender’s GroupWise site. If the connection is terminated, the file waits in the connection_ID directory until a new connection is established.

  • Page 137: Message Flow From The Groupwise Windows Client In Remote Mode To The Async Gateway

    Novell Confidential Manual (ENU) 21 December 2004 Message Flow from the GroupWise Windows Client in Remote Mode to the Async Gateway WPCSIN WPCSOUT WPCSIN WPCSIN WPGATE ROFDATA ASYXXX OFMSG msg.db GWOUT user.db msg024.db CONNECTION ID wprof.db OFUSER WPGWSEND userxxx.db WPGWRECV...

  • Page 138: Stage 3: Remote User's Groupwise Client

    Novell Confidential Manual (ENU) 21 December 2004 Stage 3: Remote User's GroupWise Client When the user initiates the modem connection, the GroupWise client on the remote computer polls the wpcsin\1 subdirectory and compresses the outgoing messages and/or requests into a file. If the compressed file totals over 50 KB, additional compressed files are created.

  • Page 139: Stage 9: Mta In Remote User's Domain

    Novell Confidential Manual (ENU) 21 December 2004 When the Remote user sends a request for items from the Master Mailbox, the GroupWise client performs the following actions: Gathers the requested items from the Remote user's Master Mailbox (msg 0-24.db file).

  • Page 140: Stage 15: Remote User

    Novell Confidential Manual (ENU) 21 December 2004 The Remote user’s Remote mailbox now contains current copies of requested items from the user’s Master Mailbox, plus any messages received in the user's Master Mailbox from other GroupWise users. Stage 15: Remote User The GroupWise user can now review current GroupWise mail when the connection to the master GroupWise system is no longer available.

Table of Contents