Page 1 Novell GroupWise Gateway ® for Lotus Notes 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 ConsoleOne is a registered trademark of Novell, Inc. eDirectory is a trademark of Novell, Inc. GroupWise is a registered trademark of Novell, Inc., in the United States and other countries. ManageWise is a registered trademark of Novell, Inc., in the United States and other countries.
Page 5: Table Of Contents
Contents About This Guide What Is the GroupWise Gateway for Lotus Notes? What’s New in This Release ..........11 Notes Gateway System Requirements Installing the Notes Gateway Planning the Notes Gateway Installation .
Page 6 Configuring the Notes Gateway Enabling Directory Synchronization and Exchange ........45 Configuring Addressing Instead of Using Directory Synchronization and Exchange .
Page 7 /lnsmb............89 /log .
Page 8 GroupWise 7 Gateway for Lotus Notes Installation and Administration Guide...
Page 9: About This Guide
About This Guide ® ® This Novell GroupWise 7 Gateway for Lotus Notes Installation and Administration Guide explains how to install, configure, and run the GroupWise 7 Gateway for Lotus Notes. The guide is divided into the following sections: Chapter 1, “What Is the GroupWise Gateway for Lotus Notes?,” on page 11 Chapter 2, “Notes Gateway System Requirements,”...
Page 10 Administration Guide, visit the GroupWise Gateways Documentation Web site (http:// www.novell.com/documentation/gwgateways). 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 11: What Is The Groupwise Gateway For Lotus Notes
What Is the GroupWise Gateway for Lotus Notes? ® The GroupWise 7 Gateway for Lotus Notes connects a GroupWise system and a Notes system by creating a link between a GroupWise domain and a Notes domain, as shown in the following diagram.
Page 12 New independent directory synchronization thread so that heavy directory synchronization loads do not impede message delivery GroupWise 7 Gateway for Lotus Notes Installation and Administration Guide...
Page 13: Notes Gateway System Requirements
Service Pack 3 or later Windows Server 2003 Updated with Updated with Service Pack 1 Service Pack 1 or later Any version Latest version ® Novell Client 1.3.6 Latest version ® ConsoleOne Available Disk Space 20 MB 40 MB Available Memory...
Page 14 The GroupWise 7 Gateway for Lotus Notes can connect your Notes system to GroupWise 6.5 and GroupWise 7.x systems. GroupWise 7 Gateway for Lotus Notes Installation and Administration Guide...
Page 15: Installing The Notes Gateway
Installing the Notes Gateway ® Before you install the GroupWise 7 Gateway for Lotus Notes, both the GroupWise system and the Notes system should be running smoothly. Then complete the following tasks to connect the two systems through the Notes Gateway: “Planning the Notes Gateway Installation”...
Page 16: Determining Where To Install The Notes Gateway Administrator Snap-In To Consoleone
Gateway. This keeps Notes Gateway activity separate from domains where post offices are located. NOTES GATEWAY INSTALLATION WORKSHEET ® Under Item 3: eDirectory Information, list the Novell eDirectory tree and context where the Domain object is located. Under Item 4: Domain Information, list the domain name and domain directory.
Page 17: Deciding Between Windows Application And Windows Service
When you install the Notes Gateway, a subdirectory for the gateway software and queues is created under the domain directory. By default, the directory name is the same as the object name. If you use the default object name of Notes, the gateway subdirectory will be domain\wpgate\notes.
Page 18: Determining Gateway Links Between Systems
If desired, you can monitor the Notes Gateway from the Management and Monitoring component ® of Novell ZENworks or any other SNMP management and monitoring program. When properly configured, the Notes Gateway sends SNMP traps to network management consoles for display along with other SNMP monitored programs.
Page 19: Meeting Installation Prerequisites
Make sure that the Novell Client is installed. The Installation program creates a Gateway object in eDirectory. The Novell Client is required to access eDirectory. If necessary, you can download the Novell Client from the Novell Product Downloads site (http://download.novell.com/filedist/pages/ PublicSearch.jsp).
Page 20: Installing The Notes Gateway Software
Installing the Notes Gateway Software. Installing the Notes Gateway Software Download the GroupWise Gateway for Lotus Notes from the Novell Product Downloads site (http://download.novell.com/filedist/pages/PublicSearch.jsp) into an empty directory. Run setupnotes700.exe to extract the Notes Gateway files into the directory. Run install.exe to start the Notes Gateway Installation program.
Page 21: Installing The Notes Gateway Administrator Snap-In To Consoleone
Follow the prompts, using the information from items 2 through 9 on the “Notes Gateway Installation Worksheet” on page 23 to install the Notes Gateway IMPORTANT: Do not start the Notes Gateway after installation. Skip to “Configuring the Notes Side of the Notes Gateway” on page Installing the Notes Gateway Administrator Snap-In to ConsoleOne After you have installed the Notes Gateway, you can install the Notes Gateway Administrator snap-in to ConsoleOne to additional locations as needed.
Page 22: Notes Gateway Installation Worksheet
Specify the path to a ConsoleOne installation where you want to install the Notes Gateway Administrator snap-in. Select the version of the GroupWise Administrator snap-ins that are already in use for your GroupWise system. Click Next to continue with the installation. Notes Gateway Installation Worksheet Item Explanation...
Page 23 Item Explanation 6) Monitoring Options: Mark how you want to monitor the Notes Gateway. See “Deciding How to Monitor the Notes Gateway” on page Notes Gateway Web console SNMP monitoring program 7) Gateway Installation Method: Mark whether you want to install the Notes Gateway as a Windows application or an Windows service.
Page 24 GroupWise 7 Gateway for Lotus Notes Installation and Administration Guide...
Page 25: Configuring The Notes Side Of The Notes Gateway
Configuring the Notes Side of the Notes Gateway After you install the Notes Gateway software but before you start the Notes Gateway for the first ® time, you must prepare your Notes system to link to your GroupWise system: “Adding the Notes Software Directory to the Path Variable” on page 25 “Adding the GroupWise Address Book to Notes”...
Page 26: Defining The Groupwise System As A Notes Foreign Domain
Address Books are searched in the order in which they appear in this line. If there is no Names= line, then Notes searches only the Notes public Address Book (names.nsf). If there is no Names= line in your notes.ini file, create one. The location of the Names= line is not important;...
Page 27 Leave Foreign as the default domain type, then fill in the following fields: Foreign Domain Name: Specify a name for the GroupWise system (worksheet item 10). This name must be unique in the Notes system. Domain Description: Optionally, provide descriptive details about the GroupWise domain. Click Mail Information.
Page 28: Registering The Notes Gateway As A Notes User
Click Save and Close. If you are not installing the Notes Gateway on the Notes/Domino server (the recommended configuration), continue with Registering the Notes Gateway As a Notes User to set up access for the gateway to the Notes/Domino server. If you are installing the Notes Gateway on the Notes/Domino server (not recommended), skip Chapter 5, “Configuring the GroupWise Side of the Notes Gateway,”...
Page 29 Click Registration Server, select the Notes certifier server (worksheet item 11), then click OK to return to the Register Person dialog box. Fill in the First Name, Middle Initial, Last Name, and Password fields (worksheet item 11). Select Advanced, then click Mail. Click Mail Server, select the Notes/Domino server that the Notes Gateway will communicate with (worksheet item...
Page 30: Setting Up Server And Database Access For The Notes Gateway User
Double-click the Notes Gateway user to display the user’s information. Right-click the userid file at the bottom of the page, then click Save. Save the file wherever you typically save ID files for your Notes system. Continue with Setting Up Server and Database Access for the Notes Gateway User.
Page 31 Run the Notes/Domino Administrator as a user with Manager access to Notes databases (worksheet item 11). Open the Notes public Directory: Click File > Database > Open. In the Server field, select the Notes domain where you want to open the public Directory. In the Database field, select the Directory for that domain.
Page 32: Providing Access To Notes Databases
Select the Notes Gateway user (worksheet item 11), click Add, then click OK. Click Security. In the Create Databases and Templates field, click the drop-down list. Select the Notes Gateway user (worksheet item 11), click Add, then click OK. The Notes Gateway creates the wpnames.nsf file and the gateway mail file one time only. This means that you can change the access rights of the Notes Gateway user after these databases have been created.
Page 33 Database Access Description names.nsf Editor or Manager The Notes public Directory. For instructions to set rights, “Providing Access Rights to the Public Directory” on page 33 wpnames.nsf Manager or Editor The GroupWise secondary Directory containing all GroupWise users; you will not be able to grant this access until after the database has been created or you have copied it from the domain\wpgate\notes...
Page 34: Starting The Notes Client On The Notes Gateway Server
Click the Person icon, select the Notes Gateway user (worksheet item 11), click Add, then click OK. From the User Type drop-down list in the Access Control List, select Person. From the Access drop-down list, select either Manager or Editor. Click OK.
Page 35: Configuring The Groupwise Side Of The Notes Gateway
Configuring the GroupWise Side of the Notes Gateway ® After you have configured the Notes side of the gateway, you must configure the GroupWise side ® of the gateway by configuring the Notes Gateway object in ConsoleOne “Providing Gateway Information” on page 35 “Setting Required Parameters”...
Page 36: Setting Required Parameters
Subdirectory: Displays the name of the Notes Gateway root directory specified during installation. The default is Notes. Time Zone: Displays the time zone of the domain where the gateway is installed. Database Version: Select 6.5 or 7.x depending on the version of your GroupWise system. Platform: Displays Windows as the default platform.
Page 37 After the non-GroupWise (NotesSystem) domain is created, you can use the GroupWise View by expanding the GroupWise System object in ConsoleOne to view the external domain, post offices, and users that represent the Notes system in your GroupWise system Notes ID Password: Specify the password for the Notes user registered for the gateway (worksheet item 11), as set up in “Registering the Notes Gateway As a Notes User”...
Page 38 GroupWise 7 Gateway for Lotus Notes Installation and Administration Guide...
Page 39: Running The Notes Gateway
Running the Notes Gateway After you have installed the Notes Gateway software and configured both sides of the gateway, you are ready to start the gateway. “Starting the Notes Gateway” on page 39 “Acquainting E-Mail Users with the Notes Gateway” on page 40 “Stopping the Notes Gateway”...
Page 40: Starting The Notes Gateway As A Windows Service
When running as an application, the Notes Gateway server console appears on the server while it is running. For instructions on interpreting the information displayed on the Notes Gateway server console, and for information about other monitoring alternatives, see Chapter 8, “Monitoring the Notes Gateway,”...
Page 41: Addressing Messages
“Addressing Messages” on page 41 “Understanding What GroupWise Send Options Are Available through the Gateway” on page 41 Addressing Messages If you plan to set up directory synchronization and exchange, as described in “Enabling Directory Synchronization and Exchange” on page 45, GroupWise users can select Notes users from the GroupWise Address Book and Notes users can select GroupWise users from a Notes version of the GroupWise Address Book.
Page 42: Stopping The Notes Gateway
Sign Digitally Encrypt for Recipients Stopping the Notes Gateway Occasionally, it might be necessary to stop the gateway to perform maintenance on the Windows server or for some other purpose. When you stop the gateway, any messages being sent from GroupWise users are queued in one of the domain\wpgate\notes\wpcsout\ngaxxxx\0-7 directories.
Page 43: Uninstalling The Notes Gateway As A Service
Uninstalling the Notes Gateway As a Service At the Windows server where you installed the Notes Gateway, click Start > Settings > Control Panel. Double-click Add/Remove Programs, select domain.gateway (Notes Gateway), then click If a message informs you that some files could not be deleted, delete the domain\wpgate\notes directory.
Page 44 GroupWise 7 Gateway for Lotus Notes Installation and Administration Guide...
Page 45: Configuring The Notes Gateway
Configuring the Notes Gateway ® After the Notes Gateway is up and running between the GroupWise system and the Notes system, there are a variety of ways to refine its configuration to meet the specific needs of your e-mail users. “Enabling Directory Synchronization and Exchange”...
Page 46 Click GroupWise > Optional Gateway Settings to display the Optional Gateway Settings page. In the Directory Sync/Exchange field, select Both. Click Apply to save the setting. Click Required Parameters to display the Required Parameters page. Make sure that the GroupWise Foreign Domain and Notes ID Password fields are filled in, as described in “Setting Required Parameters”...
Page 47: Configuring Addressing Instead Of Using Directory Synchronization And Exchange
Now that you have enabled directory exchange and synchronization, Notes users will be added to these external post offices as external GroupWise users. Make sure that Outbound Conversion is set to None. Click OK. ConsoleOne passes the directory synchronization and exchange information to the Notes Gateway so that it can start transferring user information.
Page 48 Right-click the GroupWise Post Office object that represents the Notes domain, then click New > External User. Type a username, then click OK. Right-click the new External User object, then click Properties. Fill in fields as needed to provide information about the user that you want to appear in the GroupWise Address Book.
Page 49 You use the Gateway Aliases page to define the explicit address required to route messages to the user in the Notes system. Click Add to display the Create Alias dialog box. Fill in the following fields: Gateway Alias Type: From the list, select the Notes Gateway. The gateway alias type was defined during configuration of the gateway.
Page 50: Adding Individual Notes Users To Personal Address Books
Adding Individual Notes Users to Personal Address Books GroupWise users can also add Notes users to their personal address books if the Notes users are not already defined in the GroupWise Address Book. In the GroupWise Windows client, click Tools > Address Book to open the Address Book. Select a personal address book.
Page 51: Changing The Link Protocol Between The Notes Gateway And The Mta
where gateway_name is the name of the Notes Gateway established during installation as described in “Choosing a Gateway Name” on page Examples: Notes:Provo.SJones Notes:"SJones@Provo" Explicit Addressing from Notes to GroupWise To send a message to a GroupWise user using explicit addressing, Notes users must use the following syntax in the To line: Syntax: domain.post_office.userID@foreign_domain...
Page 52: Controlling Gateway Access
In the TCP/IP Address field, click Edit, specify the IP address or DNS hostname of the server where the Notes Gateway is running (which is not necessarily the server where the Notes Gateway software is installed), then click OK to return to the Network Address page. In the Message Transfer Port field, specify a unique port number;...
Page 53: Using The Access.cfg File In The Gateway Directory
Using the Access.cfg File in the Gateway Directory access.cfg file is an ASCII text file that can be edited with a standard text editor. It is located in the gateway root directory (for example, domain\wpgate\notes). The access.cfg file enables you to implement the following specific types of access control: Provide specific access control based on GroupWise domains and post offices Provide specific access control based on access groups that you define...
Page 54 “[AccessGroup:group_name]” on page 55 [Default:In|Out] This section lists the access control settings for users who are not covered by access control settings for a particular GroupWise domain, post office, or access group. Syntax: [Default:In] [Default:Out Examples: [Default:In] MaxSize=100000 [Default:Out] AllowRuleGenerated=No This example limits incoming messages to 100 KB but does not limit the size of outgoing messages.
Page 55 This example allows users in the Temps post office to exchange messages with users in the Notes NetTech domain only. It restricts incoming and outgoing messages to 10 KB. It prevents rule- generated messages. [AccessGroup:group_name] This section lists the access control settings for individual GroupWise users who are assigned to the access group in ConsoleOne, as described in “Using the Gateway Access Field on Individual User Objects”...
Page 56 NoAccess This keyword restricts access to the Notes Gateway for those GroupWise users specified by the section header. Users cannot send or receive messages through the gateway, depending on the direction specified in the header. Examples: [Corporate.Temps:In] NoAccess [Corporate.Temps:Out] NoAccess This example prevents all GroupWise users in the Temps post office from exchanging messages with Notes users.
Page 57: Using The Gateway Access Field On Individual User Objects
[Corporate.Temps:Out] Allow NetTech [Default:In] Allow SJones@XYZCorp Allow CN=Sophie Jones/O=Sales@XYZCorp The first example allows GroupWise users in the Temps post office to exchange messages with the NetTech Notes domain but no others. The second example allows all users to receive messages from a specified user.
Page 58 whose access you want to control. If you have many users whose access you want to control, you should use the access.cfg file, as described in “Using the Access.cfg File in the Gateway Directory” on page If desired, create an access control group in the access.cfg file.
Page 59: Setting Up Accounting
Click OK to save the access control information for the selected user. ConsoleOne passes the access control information to the Notes Gateway so that the access control settings are in force immediately. Setting Up Accounting Every day at midnight, the Notes Gateway creates an accounting file (acct) in the domain\wpgate\notes\000.prc directory.
Page 60: Defining An Accountant
Defining an Accountant On the Notes Gateway object, click GroupWise > Gateway Administrators to display the Gateway Administrators page. The Gateway Administrators page lets you select a GroupWise user to be the Accountant for the Notes Gateway. Each night at midnight, the gateway mails the accounting file (acct) to the Accountant.
Page 61 O,05/18/05, 20:42:55,, Mail,3,Corporate,Temps,LTanaka,,Reminder,Connector,Notes,, Mail,SJones@Provo,1,0,2593 Each item sent through the gateway is recorded on a separate line, with the fields separated by commas. Two or more commas in a row indicate that a field has no data. The following table describes the fields in the order in which they are found in the accounting file. Field Description Example...
Page 62: Establishing Gateway Administrators
Establishing Gateway Administrators A gateway administrator is any GroupWise user you assign to receive information and error messages from the Notes Gateway. The gateway does not require an administrator, but if you want to define one, the administrator must either be a user who is associated with GroupWise or with a GroupWise distribution list.
Page 63: Enabling Message Status For Sent Items
In the Administrator Role box, select the type of administrator you want the user to be. Operator Accountant Postmaster Foreign Operator Click OK to save the Notes Gateway administrator list. ConsoleOne passes the administrator information to the Notes Gateway so that the administrators start receiving the appropriate types of messages.
Page 64: Binding The Notes Gateway To A Specific Ip Address
to Notes delivery, non-delivery, and receipt reports. For tracking purposes, each message receives its own record in the correlation database (domain\wpgate\notes\gwcorr.db). Correlation Age: Specify the number of days you want a message’s record to remain in the correlation database. After a message’s record has been deleted, any status information returned on the message is sent to the user as a new message rather than as status information on the old message.
Page 65: Configuring Internet Connectivity
Configuring Internet Connectivity By default, the Notes Gateway uses the Notes Internet connector for sending messages from Notes users to Internet users. As an alternative, you can configure the gateway to use an Internet Agent in your GroupWise system for Internet connectivity. Use the switch in the Notes Gateway startup file (notes.cfg) to specify the Internet Agent (domain_name.agent_name).
Page 66 GroupWise 7 Gateway for Lotus Notes Installation and Administration Guide...
Page 67: Monitoring The Notes Gateway
Monitoring the Notes Gateway By monitoring the Notes Gateway, you can determine whether or not its current configuration is meeting the needs of the users it services. You have a variety of tools to help you monitor the operation of the Notes Gateway: “Using the Notes Gateway Server Console”...
Page 68: Information Box
“Log Message Box” on page 69 “Menu Summary” on page 69 Information Box The top portion of the console provides the following information about the gateway. Domain.Gateway: The domain where the gateway is installed and the name of the gateway. UpTime: The length of time the gateway has been running.
Page 69: Log Message Box
Exit Stop the Notes Gateway. Configuration Gateway Display the gateway configuration settings from the Settings ® Notes Gateway object in Novell eDirectory . For more information, see Chapter 5, “Configuring the GroupWise Side of the Notes Gateway,” on page 35 and various sections in Chapter 6, “Running the Notes...
Page 70: Using The Notes Gateway Web Console
Using the Notes Gateway Web Console The Notes Gateway Web console enables you to monitor and control the Notes Gateway from any location where you have access to a Web browser and the Internet. This provides substantially more flexible access than the Notes Gateway server console, which can be accessed only from the Windows server where the Notes Gateway is running.
Page 71 In the HTTP Port field, provide a unique port number for communication between the Notes Gateway and your Web browser. You might want to use a port number close to those used by the MTA and POA, for example, 7175. Make a note of the HTTP port number.
Page 72: Accessing The Notes Gateway Web Console
Click Set Password. Type the password twice for verification. Click Set Password. Do not use an eDirectory username and password because the information passes over the insecure connection between your Web browser and the Notes Gateway. For convenience, use the same username and password for all agents and gateways that you plan to monitor from GroupWise Monitor.
Page 73 Monitoring Gateway Status When you first access the Gateway Web console, the Status page is displayed. The information is the same as is displayed on the Gateway server console on the Windows server where the gateway runs. For more information, see “Status Box”...
Page 74 Viewing Gateway Log Files On the Notes Gateway Web console menu, click Log Files to display gateway log files. Click Event Log Settings to change the log settings for the current Notes Gateway session. For information about Notes Gateway log files, see “Using Notes Gateway Log Files”...
Page 75: Using Notes Gateway Log Files
Checking and Changing Optional Gateway Settings On the Notes Gateway Web console menu, click Optional Gateway Settings to display the settings listed on the Optional Gateway Settings page in ConsoleOne. Modify the settings as needed, then click Submit to change them for the current Notes Gateway session.
Page 76 If you have any problems that require assistance from Novell Support, it is likely that the technician who helps you will request a copy of this file. Log files are stored in the gateway’s 000.prc directory (domain\wpgate\notes\000.prc) and can be viewed from the gateway server console and the Web console.
Page 77: Using Snmp Monitoring Programs
Notes Gateway server console on the server where the gateway is running, as listed in “Menu Summary” on page Using SNMP Monitoring Programs You can monitor the Notes Gateway from the Management and Monitoring component of Novell ® ZENworks or any other SNMP management and monitoring program. When properly configured, the Notes Gateway sends SNMP traps to network management consoles for display along with other SNMP monitored programs.
Page 78: Copying And Compiling The Notes Gateway Mib File
Copying and Compiling the Notes Gateway MIB File An SNMP-enabled Notes Gateway returns information contained in a Management Information Base (MIB). The MIB is an ASCII data structure that defines the information gathered. It also defines the properties that can be monitored and managed on the SNMP-enabled Notes Gateway. You can view the contents of the Notes Gateway MIB for a description of the SNMP variables available for it.
Page 79: Notifying The Notes Gateway Administrator About Bad Messages
Click the pencil icon to provide the TCP/IP address or hostname of the server where the Notes Gateway runs, then click Apply. Click GroupWise > Identification. Provide your system SNMP community GET string, then click OK. ConsoleOne then notifies the Notes Gateway to restart so the new settings can be put into effect.
Page 80: Understanding Notes Gateway Error Messages
gateway. You can use the /badmsg switch in the Notes Gateway startup file to indicate how you want the Notes Gateway to handle messages that are damaged or undeliverable. By default, bad messages are moved to the domain\wpgate\notes\gwprob directory (the equivalent of /badmsg-move).
Page 81: Optimizing The Notes Gateway
Optimizing the Notes Gateway You can adjust how the Notes Gateway functions in order to optimize its performance. Before attempting optimization, you should run the Notes Gateway long enough to observe its efficiency and its impact on other network applications running on the same server. See Chapter 8, “Monitoring the Notes Gateway,”...
Page 82: Adjusting The Number Of Sender And Receiver Threads
Fill in the following fields: Send/Receive Cycle: Specify the maximum amount of time you want the gateway to spend sending and receiving messages during one cycle. The default (120 seconds) causes the gateway to send messages for a maximum of 60 seconds and to receive messages for 60 seconds.
Page 83: Automating Network Reattachment
Notes Gateway Web Console You can check the number of sender and receiver threads that are currently available and in use on Status page. Automating Network Reattachment When the Notes Gateway loses its link to the server where the GroupWise domain directory resides or its link to the Notes/Domino server, it can attempt to reestablish the link.
Page 84: Reducing Network Traffic
Reducing Network Traffic By default, the Notes Gateway’s queue directories are located in the domain\wpgate\notes directory on the server where the domain is located. To reduce network traffic, you can redirect the gateway’s queue directories to the Windows server where the gateway is running. If you choose to place the queue directories on the gateway server’s local drive, make sure the gateway server has sufficient disk space, memory, and processing power to handle the load.
Page 85 Using Notes Gateway Startup Switches Startup switches let you set various operational parameters for the gateway. Some startup switches ® override configuration information, such as logging level, that you can set in ConsoleOne . Other switches provide configuration options not available anywhere else. To use a startup switch, you can include it on the command line immediately following the ngate executable command.
Page 86: Using Notes Gateway Startup Switches /Badmsg
Startup Switch ConsoleOne Setting /logdays Maximum Log File Age /loglevel Log Level /logmax Maximum Log File Size /noalias /single /work /badmsg Indicates what the gateway should do with bad message files (undeliverable or damaged). See “Notifying the Notes Gateway Administrator about Bad Messages” on page 79.
Page 87: Corr
Specifies the password for the Notes 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 insecure connection between your Web browser and the Notes Gateway.
Page 88: Httpport
Syntax: /httppassword-password Example: /httppassword-GWiseNotes See also /httpuser, /httpport, and /httprefresh. /httpport Sets the HTTP port number used for the Notes Gateway to communicate with your Web browser. The setting must be unique on the server where the Notes Gateway runs. See “Using the Notes Gateway Web Console”...
Page 89: Lnsmb
“Binding the Notes Gateway to a Specific IP Address” on page Syntax: /ip-network_address Example: /ip-172.16.5.18 /ip-notessvr.provo.novell.com /lnsmb Specifies the name of the Notes mailbox used to transfer messages between systems. The default is mail.box. The variable n can range from 1 to 10. Syntax: /lnsmb-mailn.box...
Page 90: Loglevel
Syntax: logdays-days Example: /logdays-30 See also /log, /loglevel, and /logmax. /loglevel Overrides the log level specified in ConsoleOne. Possible options are Off, Normal, Verbose, and Diagnostic. See “Using Notes Gateway Log Files” on page Syntax: /loglevel-level Example: /loglevel-verbose See also /log, /logdays, and /logmax. /logmax Overrides the maximum log file disk space specified in ConsoleOne.
Page 91: Single
Example: /rt-3 See also /st. /single Instructs the gateway to run for one send/receive cycle, then shut down. For information about the send/receive cycle, see “Adjusting the Gateway’s Send/Receive Cycle” on page Syntax: /single Specifies the number of sender threads that the Notes Gateway should start. The default it 4. Valid values range from 1 to 4.
Page 92 GroupWise 7 Gateway for Lotus Notes Installation and Administration Guide...
Page 93: A Notes Gateway Error Messages
This section helps you resolve error messages that appear in Notes Gateway log files and other places where gateway status information is displayed: “Error Messages” on page 93 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)
Page 94 Unable to replicate Lotus Notes Address Book information to GroupWise. Unsupported datatype in Name and Address Book document Undeliverable file moved to: path\filename Unknown return value VIM init error. Directory exchange and migrate utilities inactive You are not authorized to use the remote console on this server Error accessing VIM link Source: GroupWise Notes Gateway;...
Page 95 Action: Make sure that the Notes Gateway user is listed as an Administrator on the Notes/Domino server that the gateway communicates with. See “Providing Access to the Notes/Domino Server” on page Error reading character set translation file Source: GroupWise Notes Gateway; startup. Possible Cause: The gateway is not able to find the path to the domino...
Page 96 Foreign Domain missing or not configured in Name and Address Book Source: GroupWise Notes Gateway; initialization. Possible Cause: The gateway cannot find the foreign domain that represents the GroupWise system in the Notes system. Action: Create a foreign domain for the GroupWise system on the Notes/Domino server. See “Defining the GroupWise System As a Notes Foreign Domain”...
Page 97 No route to the gateway Source: Notes client; sending a message to a GroupWise user through the Notes Gateway. Explanation: When a Notes user tries to initiate a mail message to a GroupWise user, or if the Notes user replies to a GroupWise message, this message is displayed in the Notes client, and the message does not get delivered.
Page 98 If your Notes system is configured to replicate the wpnames.nsf file to multiple servers, delete it from all the Notes/Domino servers. Delete the 000.prc directory from the gateway home directory, after making copies of the log files if necessary. From the gateway root directory, copy the wpnames.nsf database to the domino\data directory on the Notes/Domino server that the Notes Gateway communicates with.
Page 99 An uncommon error occurred. Action: Record the conditions under which you encountered the error. For the latest error message solutions, look up the error message in the Novell Support Knowledgebase (http:// support.novell.com/search/kb_index.jsp). VIM init error. Directory exchange and migrate utilities inactive Source: GroupWise Notes Gateway;...
Page 100 GroupWise 7 Gateway for Lotus Notes Installation and Administration Guide...
Page 101: B Notes Gateway Directory Structure
Notes Gateway Directory Structure The following directory structure diagrams help you understand the Notes Gateway: “Domino Server Directory Structure” on page 101 “Notes Gateway Server Directory Structure” on page 102 “Notes Gateway Directory Structure under the Domain” on page 102 Domino Server Directory Structure When you run the Notes Gateway, it accesses some standard Lotus Notes files.
Page 102: Notes Gateway Server Directory Structure
names.nsf file names.nsf file is the Notes public Address Book. wpnames.nsf file wpnames.nsf file is the Notes version of the GroupWise Address Book that is accessed by Notes users when sending messages to GroupWise users. notesgateway.nsf file notesgateway.nsf mail file is the Notes mailbox that belongs to the Notes Gateway foreign domain.
Page 103 000.prc Directory for message processing Not used in version 3.0 of the Notes Gateway gwwork Working directory for processing messages mmddlog.nnn Notes Gateway log files acct Accounting file Settings file for screen colors, log levels, and so on stat Statistics file for Notes Gateway operation proc Process lock file indicating that the Notes Gateway is running pulse.tmp...
Page 104: Domain\Wpgate\Notes Directory
gwsetup.exe Notes Gateway Installation program setup.inf Installation information file gwstrs.fil Notes Gateway resource file wp_ga_us.trs Installation program resource file *.dll Supporting Windows DLL programs domain\wpgate\notes directory The Notes Gateway root directory is the default location for all Notes Gateway files. During installation, you choose the domain where you want to install the Notes Gateway and you choose the name of the root directory.
Page 105 pulse.tmp file The pulse.tmp file is re-created by the Notes Gateway every time it completes a cycle (after an idle loop). If you are not at the Notes Gateway server console but need to know if the Notes Gateway is running, you can delete the pulse.tmp file. If the Notes Gateway is running, it re-creates the file. gwhold directory gwhold directory is where delayed delivery messages are held until their delivery times arrive.
Page 106 GroupWise 7 Gateway for Lotus Notes on the GroupWise Gateways Documentation Web site (http://www.novell.com/ documentation/gwgateways/index.html). GroupWise 7 Gateway for Lotus Notes Installation and Administration Guide...
Page 107 GroupWise 7 Gateway for Lotus Notes on the GroupWise Gateways Documentation Web site (http://www.novell.com/ documentation/gwgateways/index.html). ngate.exe file ngate.exe file is the Notes Gateway executable file. You run this program to start the Notes Gateway.
Page 108 *.htm files *.htm files are the Notes Gateway help topics that are available in ConsoleOne. gwsetup.exe file gwsetup.exe file is the Notes Gateway Setup program that is called by the Installation program (install.exe). setup.inf file setup.inf file contains information used by the Installation program. gwstrs.fil file gwtrs.fil file is the strings resource file used by the Notes Gateway server console on the...

This manual is also suitable for:

Groupwise 7 gateway for lotus notes

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

1 What Is the Groupwise Gateway for Lotus Notes

2 Notes Gateway System Requirements

3 Installing the Notes Gateway

4 Configuring the Notes Side of the Notes Gateway

5 Configuring the Groupwise Side of the Notes Gateway

6 Running the Notes Gateway

7 Configuring the Notes Gateway

8 Monitoring the Notes Gateway

9 Optimizing the Notes Gateway

10 Using Notes Gateway Startup Switches /Badmsg

A Notes Gateway Error Messages

B Notes Gateway Directory Structure

Quick Links

Related Manuals for Novell GROUPWISE 7 GATEWAY - INSTALLATION AND ADMINISTRATION

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

This manual is also suitable for:

Table of Contents