Novell Doc: GroupWise 7 Gateway for Lotus Notes Installation and Administration Guide

3.1 Planning the Notes Gateway Installation

Before installing the Notes Gateway, you should complete the planning tasks listed below. The planning tasks provide concepts and information you need as you install and set up the Notes Gateway. You can use the Section 3.5, Notes Gateway Installation Worksheet to record your installation and setup information.

3.1.1 Deciding Where to Install the Notes Gateway

In order for directory exchange and synchronization to work, you should install the Notes Gateway on a server other than the Notes/Domino server. Although the Notes Gateway can work on the same server with some versions of Notes, it does not work on the same server with other versions of Notes. To ensure full functionality of the Notes Gateway with whatever version of Notes you have installed, plan to install the Notes Gateway on a server other than the Notes/Domino server.

NOTES GATEWAY INSTALLATION WORKSHEET
Under Item 1: Notes Gateway Location, mark whether you will install the Notes Gateway on the Notes/Domino server or another server.

IMPORTANT:The instructions in this guide focus on the configuration where the Notes Gateway is installed on a server other than the Notes/Domino server.

3.1.2 Determining Where to Install the Notes Gateway Administrator Snap-In to ConsoleOne

Notes Gateway administration is performed through ConsoleOne®, version 1.3.6 or later. When you install the Notes Gateway, the Gateway Administrator snap-in files are copied to a ConsoleOne location that you specify. The Gateway Administrator snap-in files extend the functionality of ConsoleOne to let you administer the Notes Gateway.

You should install the Gateway Administrator snap-in files wherever the GroupWise Administrator snap-in files are already installed. Different Gateway Administrator files are installed depending on whether you are using the GroupWise 6.5 or 7.x version of the GroupWise Administrator snap-ins. You can check the GroupWise Administrator snap-in version in ConsoleOne. Click Help > About Snap-Ins > GroupWise Administration.

NOTES GATEWAY INSTALLATION WORKSHEET
Under Item 9: ConsoleOne Path, specify the path for the ConsoleOne location you want to use to administer the Notes Gateway and specify the version of the GroupWise Administrator snap-ins that are already in use.

You can install the Gateway Administrator snap-in files to additional locations after you have installed the gateway, as described in Section 3.4, Installing the Notes Gateway Administrator Snap-In to ConsoleOne.

3.1.3 Gathering GroupWise System Information

The Notes Gateway needs to access the GroupWise domain where you want to link the gateway into your GroupWise system. You might want to create a new domain specifically for the Notes 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. If you want to use a separate domain for the Notes Gateway, create the new domain now. For instructions, see Creating a New Domain in Domains in the GroupWise 7 Administration Guide.

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. If you want to use a separate domain for the Notes Gateway, create the new domain now. For instructions, see Creating a New Domain in Domains in the GroupWise 7 Administration Guide.

3.1.4 Choosing a Gateway Name

When you install the Notes Gateway, a Gateway object is created in the domain where you install the gateway. The default gateway name is Notes.

NOTES GATEWAY INSTALLATION WORKSHEET
Under Item 5: Gateway Name, specify the name you want to use for the Notes Gateway object.

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.

3.1.5 Deciding between Windows Application and Windows Service

You can install the Notes Gateway as a Windows application or a Windows service.

When you install the Notes Gateway as an application, it can be manually started by a user or it can be added to a user’s Startup folder so that it starts automatically when the user logs in to the Windows server. When running as an application, the Notes Gateway displays a server console on the Windows server where you can monitor and control the gateway.

When you install the Notes Gateway as a service, it can be configured to start automatically when the server starts and must run under a specific Windows user account that has rights to run services. By default, when running as a service, the Notes Gateway does not display a user interface on the Windows server. However, it can still be monitored from its Web console, as described in Section 8.2, Using the Notes Gateway Web Console.

NOTES GATEWAY INSTALLATION WORKSHEET
Under Item 7: Gateway Installation Method, mark whether you want to install and run the Notes Gateway as an application or service. If you want to install it as a service, provide a username and password of the Windows account that will own the service. If the user account does not yet exist, create the user account now and give the account rights to run services.

NOTES GATEWAY INSTALLATION WORKSHEET

Under Item 7: Gateway Installation Method, mark whether you want to install and run the Notes Gateway as an application or service. If you want to install it as a service, provide a username and password of the Windows account that will own the service.

If the user account does not yet exist, create the user account now and give the account rights to run services.

If you want to run the Notes Gateway as a service and if the domain it belongs to is on a NetWare® server, you must create an eDirectory account with a username and password that match the Windows user account. The eDirectory user must have Read, Write, Compare, Edit, Modify, and File Scan rights to the domain\wpgate\notes directory.

NOTES GATEWAY INSTALLATION WORKSHEET
Under Item 2: Domain Server Type, mark whether the domain is located on a NetWare server or a Windows server. If it is located on a NetWare server, create the eDirectory account now, using the same username and password as the Windows account, and give the eDirectory account Read, Write, Compare, Edit, Modify, and File Scan rights to the domain\wpgate\notes directory.

NOTES GATEWAY INSTALLATION WORKSHEET

Under Item 2: Domain Server Type, mark whether the domain is located on a NetWare server or a Windows server.

If it is located on a NetWare server, create the eDirectory account now, using the same username and password as the Windows account, and give the eDirectory account Read, Write, Compare, Edit, Modify, and File Scan rights to the domain\wpgate\notes directory.

3.1.6 Deciding How to Monitor the Notes Gateway

If you install the Notes Gateway as a Windows application, the Notes Gateway server console is displayed on the Windows server where the Notes Gateway is running, which allows you to monitor the Notes Gateway from that location. If you install the Notes Gateway as a Window service, the Notes Gateway server console is not displayed, so you must plan some other way to monitor it.

Using the Notes Gateway Web Console

You can also monitor the Notes Gateway from its 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 or an SNMP monitoring program.

NOTES GATEWAY INSTALLATION WORKSHEET
Under Item 6: Monitoring Options, mark Notes Gateway Web console. After installing the Notes Gateway, follow the instructions in Section 8.2, Using the Notes Gateway Web Console to set up the Notes Gateway Web console.

Using an SNMP Monitoring Program

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.

NOTES GATEWAY INSTALLATION WORKSHEET
Under Item 8: Enable SNMP?, mark whether you want to configure the Notes Gateway for SNMP.

You must enable SNMP during gateway installation. You cannot add this functionality after installation. In order for the option to be offered during installation, the Windows server where you install the gateway must have the SNMP service installed.

The SNMP service is usually not included during the initial Windows operating system installation. To add or configure the SNMP service on the server where you will install and run the Notes Gateway, you must be logged in as a member of the Administrator group.

To add the SNMP service to a Windows 2000/2003 server:

From the Control Panel, double-click Add/Remove Programs.
Click Add/Remove Windows Components.
Select Management and Monitoring Tools.
Click Details, then select Simple Network Management Protocol.

3.1.7 Determining Gateway Links between Systems

In order for the Notes Gateway to perform directory synchronization and exchange in addition to message exchange, you must set up a representation of the Notes system in your GroupWise system and a representation of your GroupWise system in your Notes system.

In GroupWise, non-GroupWise systems are represented by non-GroupWise domains.

NOTES GATEWAY INSTALLATION WORKSHEET
Under Item 12: Non-GroupWise Domain for Notes System in GroupWise, specify the name you want to use in GroupWise to represent the Notes system. This non-GroupWise domain will be created automatically the first time you start the Notes Gateway.

In Notes, non-Notes systems are represented by foreign domains.

NOTES GATEWAY INSTALLATION WORKSHEET
Under Item 10: Foreign Domain for GroupWise System in Notes, specify the name you want to use in Notes to represent the GroupWise system. Under Item 11: Notes/Domino Server Access Information, specify the information that the Notes Gateway will need in order to access the Notes system: Notes/Domino Server: Specify the fully qualified name of the Notes/Domino server (hostname/notes_domain) that will route messages through the Notes gateway. Notes Administrator: Specify the name of a Notes user that has Manager rights to the Notes public Address Book and other Notes databases. Administrator Password: Specify (or know) the password for the Notes/Domino Administrator program. Certifier Server: Specify the fully qualified name of the Notes/Domino server (hostname/notes_domain where new Notes users are registered. Certifier Password: Specify (or know) the password required to create new Notes users. User for the Notes Gateway: Specify a user that the Notes Gateway can use to log into the Notes/Domino server and access the Notes public Address Book. Notes users need a first name, middle initial, and last name. If you do not want to user the account of a regular Notes user, you could create a user named "Gateway 4 Notes" or "Gateway 2 GroupWise." If the user you want the Notes Gateway to log in as does not yet exist, create that user in your Notes system before you install the Notes Gateway. User Password: Choose a password for the Notes Gateway user account. Notes Gateway Mail File: Specify the name of the mail file used for communication between the Notes system and the GroupWise system, for example, notesgateway. The file will be created when you start the Notes Gateway and will have a .nsf extension appended to it (for example, notesgateway.nsf).

NOTES GATEWAY INSTALLATION WORKSHEET

Under Item 10: Foreign Domain for GroupWise System in Notes, specify the name you want to use in Notes to represent the GroupWise system.

Under Item 11: Notes/Domino Server Access Information, specify the information that the Notes Gateway will need in order to access the Notes system:

Notes/Domino Server: Specify the fully qualified name of the Notes/Domino server (hostname/notes_domain) that will route messages through the Notes gateway.
Notes Administrator: Specify the name of a Notes user that has Manager rights to the Notes public Address Book and other Notes databases.
Administrator Password: Specify (or know) the password for the Notes/Domino Administrator program.
Certifier Server: Specify the fully qualified name of the Notes/Domino server (hostname/notes_domain where new Notes users are registered.
Certifier Password: Specify (or know) the password required to create new Notes users.
User for the Notes Gateway: Specify a user that the Notes Gateway can use to log into the Notes/Domino server and access the Notes public Address Book. Notes users need a first name, middle initial, and last name. If you do not want to user the account of a regular Notes user, you could create a user named "Gateway 4 Notes" or "Gateway 2 GroupWise."

If the user you want the Notes Gateway to log in as does not yet exist, create that user in your Notes system before you install the Notes Gateway.
User Password: Choose a password for the Notes Gateway user account.
Notes Gateway Mail File: Specify the name of the mail file used for communication between the Notes system and the GroupWise system, for example, notesgateway. The file will be created when you start the Notes Gateway and will have a .nsf extension appended to it (for example, notesgateway.nsf).